• 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