• 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
  • v2.1.6 24a36d6fb4

    dvs released this 2026-09-27 09:07:18 +00:00 | 2 commits to main since this release

    ChaosCrypt 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

    修复

    1. -p 与 -P 两组都注册 --pwd,导致 CLI 无法启动
    2. 密钥文件密码错误被误报为文件损坏(E002),现区分密码错误(E003)与文件损坏
    3. export_key_text 生成的密钥未装入实例,无法直接使用
    4. 非十六进制密文被静默接受并解出乱码,与成功无法区分;现于处理前抛 E010
    5. TUI 在管道输入下直接失败(getpass 需要 TTY)
    6. 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
  • 2.0.0 c352eef2ba

    dvs 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
  • v1.0.0 0c62d5fb05

    dvs 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