-
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 ——