• v4.2.6 dd49043171

    dvs released this 2026-09-27 14:07:02 +00:00 | 0 commits to main since this release

    ChaosCrypt v4.2.6

    自描述格式 + 字节管线 + 大规模性能优化。

    本次发布不兼容旧格式,是第一个适合实际部署(而非试验)的版本。


    🔖 每个文件都自我描述

    密钥文件与密文现在都以头部开头,声明自己是如何生成的:

    69CES
    385aeff1f4179a744c8fb0c5ae4702d325f6230d059f4251135c2536409dee93
    {"alg":"chaoscrypt","kind":"ciphertext","mode":"turbo","out":"hex","mid":"bt",...}
    2025ea4e4b4b93803f2ccadeaf318d1957ce42ff5409410f660348be96a4c0f2
    <载荷>
    

    读取方不必再被口头告知模式、编码等信息 —— 它从文件本身读取。

    这消除了一整类静默损坏:用错参数解密会得到乱码,而乱码与"密码错误"无法区分。头部彻底消除了这种歧义。

    无头部输入一律拒绝(E017),而不是去猜。


    🚀 性能:约 60 MB/s 加密 / 70 MB/s 解密

    turbo 与 raw 获得字节管线:XOR 层之间改用原始字节传递,不再来回转十六进制。

    优化前 优化后
    密文膨胀 5.33x 2.00x(hex)或 1.33x(base64)
    1 MiB 加密 12.05 s 0.017 s
    吞吐 0.08 MB/s ~60 MB/s

    约 700 倍提升,且吞吐从 64 KiB 到 1 GiB 保持平稳(线性算法)。

    实测数据(raw,bt 中间件,hex 输出):

    尺寸 加密 解密
    1 MiB 57.3 MB/s 61.0 MB/s
    16 MiB 63.4 MB/s 69.0 MB/s
    128 MiB 59.4 MB/s 64.5 MB/s
    1024 MiB 47.9 MB/s 31.7 MB/s

    🎛️ 四种模式 × 两种编码 × 两种中间件

    模式 算法 密文 与旧版载荷兼容
    reference 原版算法 5.33x ✅
    fast(默认) 原版算法,批量优化 5.33x ✅ 逐字节相同
    turbo SHAKE256 密钥流,字节管线 2.00x / 1.33x ❌
    raw SHAKE256 + 长密钥层 2.00x / 1.33x ❌

    turbo / raw 额外支持:

    • encoding: hex(默认,2.00x)或 base64(1.33x)
    • mid: bt(默认,字节)或 hex(十六进制文本,速度约 1/3、体积 4 倍)

    🔄 旧文件仍可读取(兼容 API)

    cc = ChaosCrypt(key_file="my.key", key_password="kf-pwd", auto_load=True)
    
    plain = cc.decrypt_legacy(old_ciphertext, "user-pwd")
    cc.load_legacy_keys(old_key_text, "key-password")
    plain = cc.decrypt_legacy_auto(old_ciphertext, "user-pwd")
    
    # 一次性迁移
    open("new.key", "w").write(cc.wrap_legacy(old_key_text, is_key=True))
    

    兼容 API 是包装,不是放宽底层 —— 载荷被套上极简头后仍走正常路径,
    所以严格路径依然严格(无头输入给 decrypt 依然报 E017)。


    🐞 修复

    1. 密钥派生不再是 O(n²)(_get_dynamic_key 的 str +=,从 866 ms 降到 3 ms,输出不变)
    2. 两个 hex 中间件管线不对称,导致 mid="hex" 的 turbo/raw 密文无法解回
    3. change_key_password / export_key_text 写出的文件缺少头部,导致无法再次加载
    4. 构造函数接受 encoding="base64" 而头部记录 out="base" —— 现两种拼写均接受
    5. 非十六进制载荷现在报 E010(格式错误)而非 E011(解密失败)—— 语义更准确
    6. TUI 编码菜单引用了缺失的翻译项

    🛡️ 安全

    • 与 4.2.6 之前不兼容:无头输入报 E017,旧文件需走兼容 API
    • fast 不是弱化模式:与原算法算术相同、输出逐字节相同,冻结向量强制保证
    • raw 的 hex 中间件是四者中最弱的(结构层最少),已在 SECURITY.md 明确说明
    • 头部是元数据,不提供保密性、未经认证;如需防篡改,应对整个文件(含头部)计算 MAC

    📚 文档

    文档 内容
    SECURITY.md 设计、密钥空间、威胁模型、攻击面分析(18 章)
    docs/FORMAT.md 格式规范(含完整示例与旧文件标准)
    docs/benchmark.md 实测性能与 profiling
    docs/API.md / docs/CLI.md / docs/ARCHITECTURE.md / docs/BUILDING.md 参考手册

    全部 11 个 Markdown 文件均为英文。


    📦 安装

    pip install chaoscrypt
    

    无第三方运行时依赖,要求 Python 3.8+。


    许可:MIT。代码按原样提供,不提供任何担保。
    未经审计,非标准化算法,仅限混淆式加密、个人自用与研究教学。

    Downloads