CipherScope

CTF 密码学自动化解题工具 —— 输入密文，自动识别类型、调度攻击、评分判定、输出 flag。

它解决什么问题

CTF 密码学题目千变万化，但解题链路高度重复：识别密文类型 → 选择攻击方法 → 验证结果。 CipherScope 把这条链路自动化：

输入密文 → 识别引擎(类型+置信度) → 调度器(插件并发) → 评分引擎(多信号判定)
         → 未命中则进入下一层(嵌套解码, 处理 base 套娃) → 命中 flag

与现有工具的差异：

快速开始

pip install cipherscope
# 或带 Web 可视化版 (FastAPI 界面)
pip install "cipherscope[web]"

# 本地源码开发: 先装依赖再跑
# pip install -e ".[dev,web,rsa]"
# python -m cipherscope.cli web --port 8080

# 全自动求解
cipherscope auto "5L2g5aW977yMZmxhZ3s1Y2Q3YWJjZH0="
# FOUND score=82.1 depth=1
# chain: base64
# plaintext: congratulations, the flag is flag{...}

# 指定 flag 前缀 / 加深嵌套搜索
cipherscope auto "..." --flag-prefix NSSCTF{ --max-depth 8

# 只识别类型
cipherscope detect "..."
# 只对候选明文评分 (调试评分引擎)
cipherscope score "..."
# RSA 攻击
cipherscope rsa -n 90581... -e 65537 -c 43117...
# 跑真题语料库评测
cipherscope evaluate

# Web 可视化版
cipherscope web            # 浏览器打开 http://127.0.0.1:8080

支持的攻击

插件化架构：实现 AttackPlugin 协议（match + attack），通过 entry_points 组 cipherscope.plugins 注册即可扩展。

架构

cipherscope/
├── cli.py                  # typer CLI
├── core/
│   ├── plugin.py           # 插件协议 + 注册表
│   ├── detector.py         # 识别引擎: 字符集/熵/IC/Kasiski
│   ├── scorer.py           # 评分引擎: 六信号融合 + 三档裁决
│   ├── dispatcher.py       # 调度器: 置信度排序 + codec 优先两轮制
│   ├── pipeline.py         # 嵌套管道: DFS 限深10层 + 循环检测 + 限宽
│   └── evaluate.py         # 真题语料库评测
├── plugins/                # 攻击插件组 (codecs/classical/xor/hash/rsa)
├── web/                    # FastAPI Web 可视化版
├── data/                   # 词频表/字典 (quadgrams.json 由 tools/build_quadgrams.py 生成)
└── tools/                  # 语料生成/评测/打包脚本

关键设计（详见 docs/modules/ 逐模块讲解）：

• 评分引擎：flag 正则 + n-gram 适应度 + 可打印比例 + 词典命中 + 卡方 + 中文兜底，多信号加权融合，三档裁决 SUCCESS/PROMISING/REJECT；
• 编码链优先：codec 插件确定性解码产物无条件进入下一层（套娃题关键），猜测性攻击产物按 detector 置信度分级入队；
• 假 flag 防护：长乱码中碰巧出现 flag{ 字样的候选，因上下文不可读被降级，防止错误短路。

评测

100 道自构造语料（覆盖全部插件正反向路径与多层组合），综合通过率 100%：

CipherScope Eval — 100/100 (100%)
┌───────────┬───────────┬──────┬───────┬──────┐
│ Platform  │ Category  │ Pass │ Total │ Rate │
├───────────┼───────────┼──────┼───────┼──────┤
│ synthetic │ classical │   31 │    31 │ 100% │
│ synthetic │ codec     │   29 │    29 │ 100% │
│ synthetic │ combo     │   21 │    21 │ 100% │
│ synthetic │ hash      │    8 │     8 │ 100% │
│ synthetic │ xor       │   11 │    11 │ 100% │
└───────────┴───────────┴──────┴───────┴──────┘

真实赛事题（BUUCTF/攻防世界/NSSCTF/CTFHub）可按 tests/ctf_corpus/corpus.yaml 格式追加。

路线图

• v0.1 识别/评分/调度/管道 + 编码/古典/XOR 插件 + CLI
• v0.2 RSA 攻击 + 哈希识别
• v0.3 Web 可视化版 + 打包脚本
• 完整 quadgram 表生成与调参（84k 组, 892 万样本, 随包分发）
• 中文 n-gram 评分模型（20 万字级二元组, 长中文句自动认可）
• 通过率徽章 CI（GitHub Actions 自动评测 + 动态徽章）
• 真题语料扩充至 100 题（综合通过率 100%）

License

MIT