一、背景与设计原则
| 维度 | 说明 |
|---|---|
| 模式 | 6人本+0-3补位NPC，120±10分钟 |
| 架构 | GM后台全局管理 + DM唯一系统发言人 + 人类/NPC同权 |
| 交互 | 统一聊天框 +/指令系统（9指令覆盖全流程） |
| 底线 | 确定性优先——调查掉落/物品效果/锚点剧情/线索保底均为剧本预置数据，LLM仅用于NPC自然语言生成，不改动结构化结果 |
二、12阶段状态机（产品↔代码映射）
| 产品阶段 | 时长 | 代码stage | sub_stage | 核心产出 |
|---|---|---|---|---|
| 0 准备初始化 | 3min | prepare→assign_roles | gm_init | 剧本加载、角色分配、NPC运行时初始化 |
| 1 剧本分发规则 | 5min | opening | script_handout | 私有剧本/规则/初始物品推送 |
| 2 自我介绍 | 10min | free_talk | self_intro | 6人按序发言、NPC人设化介绍 |
| 3 探索1 | 15min | search | explore_r1 | 调查/私聊/交易/权力/物品全开放 |
| 4 讨论1 | 15min | free_talk | discuss_r1 | 公共线索公示、自由发言/展示/质询 |
| 5 锚点1 | 10min | action | anchor_r1 | 固定剧情推进、解锁新场景/权力/提示 |
| 6 探索2 | 15min | search | explore_r2 | 新场景/线索池、NPC激进策略 |
| 7 讨论2 | 15min | free_talk | discuss_r2 | 成熟推理、凶手嫁祸、DM引导 |
| 8 锚点2 | 10min | action | anchor_r2 | 最终剧情、全量线索公示、预告投票 |
| 9 最终讨论 | 15min | free_talk | final_discuss | 仅发言/展示/私聊，禁调查交易 |
| 10 匿名投票 | 5min | vote | final_vote | 私聊DM投票、实时统计 |
| 11 结局复盘 | 12min | settlement→replay | ending/review | 多结局分支、时间线复盘、表现点评 |
状态三元组：
round_no(0/1/2) +sub_stage+stage。LangGraph按sub_stage驱动节点跳转。
三、核心阶段规则精要
阶段0-1（不可见/分发）
GM加载剧本包（角色6、三级线索40-50、物品20-30、权力1-2/役、事件2-3/役）→随机分役→NPC初始化obtained_clues/held_items/suspicion_rank/trust_rank/secret_exposure=0→生成gm_plan事件触发计划。
DM私发剧本（姓名/关系图/3天时间线/核心秘密/权力指令/胜利条件）、公发规则与指令表、私发初始物品。3分钟阅读倒计时。
阶段3 探索（指令全开）
| 指令 | 语法 | 限制 | GM校验 |
|---|---|---|---|
| 调查 | /调查 [场景] | 轮≤3个 | investigate_count、场景∈unlocked_locations |
| 线索/物品 | /线索/物品 | 无 | 返回自有列表 |
| 查看 | /查看 [物品] | 无 | 返回完整描述 |
| 用权力 | /使用 [权力] [目标] | 局1次 | power_used标记、目标合法 |
| 用物品 | /使用 [物品] [目标] | 按说明 | 类型/次数/目标合法 |
| 交易 | /交易 [玩家] [物品] | 仅线索物品非关键 | item_type=线索物品is_key=false |
| 私聊 | /私聊 [玩家] [内容] | 无 | 写入game_private_messages |
NPC行为优先级：权力(前3min) → 调查(秘密相关→怀疑玩家→公共) → 主动私聊(≤2/轮，分享/试探/交换) → 交易(向信任者，绝不交关键物品) → 响应。
红线：关键线索保底（阶段结束未获→DM自动公示）、所有效果预置固定逻辑。
阶段5/8 锚点（DM固定文案）
源自script_anchors：讨论总结 → 固定剧情(如"警方发现沾血水果刀为凶器") → 解锁新场景/权力/提示 → 预告剩余轮次。LLM不改写核心事实。
阶段10 投票：仅/投票 [玩家]私聊DM。好人投嫌疑Top1，凶手投除自己外Top1。平票二轮、弃票随机。
阶段11 结局矩阵
真凶被投出+关键线索≥80%→完美；真凶被投出+<80%→普通；真凶逃脱→失败。
四、DM提示文案规范（禁止裸错误栈）
| 场景 | 标准文案 |
|---|---|
| 非探索期调查 | 本阶段不可调查，请等待主持人宣布探索开始。 |
| 调查达上限 | 你已调查过 3 个场景，请等待讨论阶段。 |
| 场景不存在 | 未找到场景「地下室」，本轮可调查：书房、花园、大厅。 |
| 权力用完 | 你的专属权力已使用过，每局限用 1 次。 |
| 关键物品交易 | 「带血的水果刀」为关键物品，不可交易。 |
五、验收基线（8条）
- 6人+3补位全流程120分钟跑通（调试模式可压缩）
- 所有DM锚点为预置文案，LLM不改写核心事实
- 人类/NPC同指令同权限，NPC不越权（不交凶器/不泄核心秘密）
- 关键线索阶段结束前必进入「可推理」状态
- 投票结束判定完美/普通/失败三档并生成复盘
- 断线重连恢复阶段/私有数据/物品/未读，无白屏残留
- 9指令允许/禁止阶段门控100%自动化通过
- 只读指令幂等（重复
/线索不重发不重复计数）
