三国杀（SGS）离线知识库

一个完整的《三国杀》离线知识库，包含 3930+ 武将文件、290+ 游戏牌文件、术语/规则/牌堆/战功参考列表，以及 11 道谜题。所有数据均来自萌娘百科，已全部填充完毕，无空白文件。

数据仓库

本 skill 的脚本（scripts/）与数据（references/，约 4230 个文件）均托管在 ModelScope： https://www.modelscope.cn/datasets/suxinchun/Sanguosha

何时使用

• 查询三国杀武将的技能、版本、台词、上线情况
• 查询游戏牌（基本牌/装备牌/锦囊牌）的效果与牌面信息
• 查询规则、术语、牌堆结构
• 查询战功、编号、主公技
• 查询三国杀谜题（深度推理或广度探索）

目录结构

sgs/
├── SKILL.md              ← 本文件
├── scripts/              ← Python 查询脚本
│   ├── query-general.py  ← 查武将技能
│   ├── query-card.py     ← 查游戏牌
│   └── list-generals.py  ← 按扩展包列出武将
└── references/                 ← 4230 个 .md 数据文件
    ├── 武将牌/           3930 文件（12大扩展包体系）
    ├── 游戏牌/           290 文件（基本/装备/锦囊）
    ├── 列表/             6 个参考列表
    ├── 谜题/             11 道谜题
    ├── 特殊卡牌/         1 文件（暗魂）
    └── sgs/              项目文档

查询工作流

查武将技能

python scripts/query-general.py <武将名> [版本过滤词]

行为：

• 单版本 → 直接输出武将的技能信息（基本信息 + 简略描述）
• 多版本 → 列出所有版本的相对路径，用户选编号后查询

示例：

python scripts/query-general.py 神甘宁      → 单版本，直接输出
python scripts/query-general.py 曹操        → 多版本，列出 28 个版本
python scripts/query-general.py 曹操 11     → 查第 11 个版本

查游戏牌

python scripts/query-card.py <牌名>

示例：

python scripts/query-card.py 诸葛连弩
python scripts/query-card.py 酒
python scripts/query-card.py 桃园结义
python scripts/query-card.py 八卦阵

按扩展包查看武将

python scripts/list-generals.py [扩展包关键词] [势力]

示例：

python scripts/list-generals.py                 → 列出所有分类
python scripts/list-generals.py 手杀            → 手杀系列武将（按势力分组）
python scripts/list-generals.py 手杀 魏         → 手杀魏势力武将
python scripts/list-generals.py 标包 神         → 标包神势力武将

支持别名： OL、一将、其他、十周年、国战、小程序、标包、SP、欢乐杀、线下、手杀、海外服

直接读文件

也可以直接用 cat/记事本打开对应文件：

• 术语表 → references/列表/术语.md
• 规则表 → references/列表/规则.md
• 技能解析 → references/列表/技能.md
• 牌堆结构 → references/列表/牌堆结构.md
• 战功+编号 → references/列表/战功表.md
• 主公技 → references/列表/四服主公武将及对应主公技技能与版本汇总表.md
• 谜题 → references/谜题/三国杀谜题问题.md / 三国杀谜题答案.md
• 项目教训 → references/sgs/教训.txt

武将命名约定

| 规则 | 示例 | |------|------| | 单版本 | 曹操.md | | 多版本 | 神关羽(风).md、谋司马懿.md | | 双将 | 张昭&张纮.md | | 文件名/ → · | 何太后(20·22·24).md | | 其他版本 | 放在 【其他版本】/武将名/ 下 |

数据开发约束（修改数据时遵守）

• ❌ 不用正则解析嵌套 {{...}} 模板 → 用括号计数法
• ❌ 不设超时 → 脚本跑完自然返回
• ❌ 批量前必须备份整个 references/
• ✅ 先拿 1 个文件测试完整流程再全量
• ✅ str.find 逐行扫描替代 re.MULTILINE
• ✅ 路径拼接确保带 .md 后缀
• ✅ 基础数据（称号/体力/编号）与技能一起提取
• ✅ 汇报缺失写清原因（完整路径+原因+是否试过别名）