-
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
-
released this
2026-09-27 09:07:18 +00:00 | 2 commits to main since this releaseChaosCrypt v2.1.6
从单文件脚本重构为完整的可安装发行库。算法本身未做任何改动。
三种使用方式
pip install chaoscrypt① 库导入
from chaoscrypt import ChaosCrypt cc = ChaosCrypt() cc.create_key("密钥文件密码", "my.key") token = cc.encrypt("hello world", "加密密码") assert cc.decrypt(token, "加密密码") == "hello world"② 命令行(有参数)
chaoscrypt keygen -k my.key -P keypass chaoscrypt encrypt "hello" -p userpass -k my.key -P keypass chaoscrypt decrypt "1a2b..." -p userpass -k my.key -P keypass chaoscrypt file encrypt photo.png -p userpass -k my.key -P keypass chaoscrypt info -k my.key -P keypass --json③ 交互界面(无参数)
chaoscrypt # 中英双语 TUI
新增
- 库 API ——
ChaosCrypt门面类 +ChaosCryptCore纯算法核心 - 统一错误体系 —— 16 个具名错误类,均为
ChaosCryptError子类,格式ChaosCrypt_ERR_<Detail>_<Code> - 完整 CLI ——
keygen/encrypt/decrypt/file/info/chpwd/tui,支持--json、stdin/stdout 管道、密码三种来源(内联 / 环境变量 / 文件) - 双语 TUI —— 默认英文,运行时可切中文;密码用
getpass不回显,非 TTY 环境自动降级以保持可脚本化 - 二进制与文件支持 ——
encrypt_bytes/decrypt_bytes、encrypt_file/decrypt_file - 密钥管理 ——
change_key_password可换密码而不动密钥材料;export_key_text/load_from_text支持不落盘传递密钥 - 完整文档 ——
SECURITY.md含设计、密钥空间、威胁模型与攻击面分析;docs/覆盖 API、CLI、架构与构建 - 测试套件 —— 92 项测试,覆盖往返、二进制、密钥管理、错误类型、CLI、TUI、i18n 与旧版互通
- 打包配置 ——
pyproject.toml、setup.py兼容层、MANIFEST.in、py.typed
修复
-p与-P两组都注册--pwd,导致 CLI 无法启动- 密钥文件密码错误被误报为文件损坏(E002),现区分密码错误(E003)与文件损坏
export_key_text生成的密钥未装入实例,无法直接使用- 非十六进制密文被静默接受并解出乱码,与成功无法区分;现于处理前抛 E010
- TUI 在管道输入下直接失败(
getpass需要 TTY) - TUI 生成新密钥文件后仍读取默认文件名
变更
- 源码树重构:包位于
chaoscrypt/,tests/、examples/、legacy/并列其下;文档与构建产物置于仓库根目录 - 代码注释统一为英文;公开接口补充参数、返回值与异常说明
- 界面默认语言改为英文
- 移除
ChaosCryptChat - 署名更新为 Dvs (DvsXT),项目链接指向 Gitea
兼容性
与原始实现双向完全互通,已由测试强制保证:
- 旧密钥文件可直接加载
- 旧密文可直接解密
- 新库产物可被旧脚本读取
- 密钥文件格式与默认文件名(
encryption.key)保持不变
安装
pip install chaoscrypt无第三方运行时依赖,要求 Python 3.8+。
本页附件提供 wheel 与源码包,也可直接下载安装:
pip install chaoscrypt-2.1.6-py3-none-any.whl
安全声明
ChaosCrypt 未经审计,亦非标准化算法。适用于混淆式加密、个人自用与研究教学,不适用于生产系统、受监管数据或长期密钥。需要标准化密码学时,请使用 AES-GCM 或 ChaCha20-Poly1305。
算法层面:复合密钥空间约 10^5621;无简洁代数结构,差分/线性/代数攻击无有效路径;无数论结构,Shor 算法不适用;Grover 加速后剩余搜索空间仍远超物理可实现范围。详见
SECURITY.md。许可:MIT。代码按原样提供,不提供任何担保。
Downloads
- 库 API ——
-
ChaosCrypt v2.0.0 Stable
released this
2026-08-27 10:46:01 +00:00 | 8 commits to main since this release🎉 ChaosCrypt v2.0.0 发布
✨ v2.0 新增:💬 ChaosCryptChat 混沌加密聊天
基于 ChaosCrypt 混沌加密内核构建的端到端加密聊天系统:
- 🔗 端到端加密:消息客户端本地加密,服务器只中继密文、不持有群密钥
- ☁️ 双群模式:端到端 P2P 直连 + 中央服务器(解决 NAT 穿透)
- 🎤 语音消息:录音 → 混沌加密 → 发送 → 解密播放
- 🖼️ 图片/文件:二进制数据混沌加密传输,任意文件类型
- 👥 群管理:建群/加群/群名/公告/踢人/群主审批
- 🚫 消息撤回:2 分钟内可撤回
- 🔑 每用户密钥认证:防止冒充
- 📜 SQLite 历史记录:重启不丢
- 🛡️ HMAC 完整性校验:防篡改
📦 项目结构
ChaosCrypt/ ├── chaoscrypt.py # 混沌加密主程序 ├── README.md # 文档 ├── SECURITY.md # 安全分析 └── ChaosCryptChat/ # 💬 加密聊天(v2.0 新增) ├── qtmain.py # PyQt5 聊天客户端 └── server.py # ☁️ 中央服务器🔐 安全声明
- 总密钥空间 ≈ 10⁵⁶²¹,抗量子攻击
- 聊天内容端到端加密,服务器无法解密
- ⚠️ 仅供学习研究使用,请妥善保管密钥与密码
Downloads
-
ChaosCrypt v1.0.0 Stable
released this
2026-08-25 10:08:20 +00:00 | 11 commits to main since this release🔐 ChaosCrypt v1.0.0
混沌加密系统 - 抗量子、抗数学攻击的对称加密系统。
✨ 核心特性
- 🔑 双因素保护:密钥文件 + 用户密码
- 🧩 完全随机密钥
- 🔁 可重用 OTP
- 🛡️ 抗量子攻击
- 🚫 无第三方依赖(纯 Python 3.6+)
📦 包含
- chaoscrypt.py 主程序
- README.md / SECURITY.md
Downloads