三国杀(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后缀 - ✅ 基础数据(称号/体力/编号)与技能一起提取
- ✅ 汇报缺失写清原因(完整路径+原因+是否试过别名)
Scan to join WeChat group