月影之刃

狼人杀 AI 对局的可靠性问题

让 LLM 直接充当狼人杀裁判，会遇到两类典型故障：规则判定漂移（女巫能否首夜自救、狼刀与救药的结算顺序）和视角泄露（把狼人频道的讨论原样广播给全场）。市面上多数 Agent 对局要么让 LLM 兼职法官，要么规则散落在提示词里，一局结束后复盘都无从下手。

架构：规则引擎与 LLM 决策分离

月影之刃的做法是把两件事拆干净：

• 规则引擎（game/engine.py）负责阶段流转、技能结算、胜负判定；
• LLM 只做两件事：夜晚给出建议动作、白天生成发言。

6 人局配置为 1 个真人 + 5 个 AI，身份随机分配。主持人旁白采用文字版狼人杀风格，全程按「天黑请闭眼 → 狼人请睁眼 → 女巫请睁眼 → 天亮了」推进，每个阶段只向玩家展示其身份可见的信息。

阶段流转与指令约束

指令层做了三重校验，直接对齐触发逻辑的可用性与规范性：

• 身份校验：刀 仅限狼人、验 仅限预言家、救/毒 仅限女巫，越权返回 🔒；
• 阶段校验：夜晚才能 刀/验/救/毒/过，白天才能 发言/投，错阶段返回 ⏰；
• 参数校验：带参指令走前缀 + 编号匹配，座位号限定 1~6，菜刀 3号、经验 2号 这类无关文本不会误触发。

视角隔离是本期的核心体验：狼人频道只展示给真人狼人，队友提议附带采纳标记（✅ 已采纳 / ❌ 未采纳）；预言家查验、女巫刀口同样仅本人可见，其余玩家只能感知到「有人动了手」。

适用边界与注意点

• 面向 6 人局（1 真人 + 5 AI），没有多真人联机入口；
• AI 狼队采纳真人建议的默认概率为 60%，可在 game/config.py 调整，不要指望狼刀完全听指挥；
• 所有输出为结构化文本，便于 Agent 直接播报，但没有图形界面；
• 存档位于 game/state/，狼人频道的私密信息写在 secrets.json，重置用 reset 指令。