-
released this
2026-09-27 14:07:02 +00:00 | 0 commits to main since this releaseChaosCrypt 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 ✅ 逐字节相同 turboSHAKE256 密钥流,字节管线 2.00x / 1.33x ❌ rawSHAKE256 + 长密钥层 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)。
🐞 修复
- 密钥派生不再是 O(n²)(
_get_dynamic_key的str +=,从 866 ms 降到 3 ms,输出不变) - 两个 hex 中间件管线不对称,导致
mid="hex"的turbo/raw密文无法解回 change_key_password/export_key_text写出的文件缺少头部,导致无法再次加载- 构造函数接受
encoding="base64"而头部记录out="base"—— 现两种拼写均接受 - 非十六进制载荷现在报
E010(格式错误)而非E011(解密失败)—— 语义更准确 - 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