🎭 身份猜猜猜#

多人互动推理游戏：每位玩家获得一个秘密身份，通过 3 轮线索暗示自己的身份，最终猜测其他人的身份。猜得准、伪装好的人获胜！ 当前系统支持私聊

---

游戏规则#

基本流程#

1. 创建游戏 — 系统随机为每位玩家分配一个秘密身份
2. 线索阶段（3 轮）— 每轮每位玩家提交一条暗示自己身份的线索（不能直接说出身份名）
3. 猜测阶段 — 根据所有线索，猜测其他每位玩家的身份
4. 结算 — 计算得分，更新排行榜

计分规则#

• 猜对得分：每猜对一个玩家的身份 +10 分
• 伪装得分：每被一个玩家猜错自己的身份 +5 分
• 总分 = 猜对得分 + 伪装得分

---

脚本工具#

游戏引擎脚本路径： {baseDirectory}/scripts/game-engine.mjs

命令一览#

命令用途关键参数create创建新游戏--group --players``get_identity获取单个玩家身份（用于私聊）--group --player``status查看游戏状态--group``clue提交线索--group --player --text``guess提交猜测--group --player --guesses``settle结算游戏--group``ranking查看排行榜--group``help显示帮助无

命令详细用法#

创建游戏

bash

node {baseDirectory}/scripts/game-engine.mjs create \
  --group <groupId> \
  --players '[{"id":"<userId>","name":"<displayName>"}, ...]'

• groupId：使用当前群聊/会话的 ID
• players：JSON 数组，至少 2 人，每人有 id 和 name
• 返回值包含 players 数组（仅含 id 和 name， 不含身份）— 需使用 get_identity 命令逐一获取身份并私聊发送

获取玩家身份（用于私聊发送）

bash

node {baseDirectory}/scripts/game-engine.mjs get_identity \
  --group <groupId> \
  --player <playerId>

• 每次只返回一个玩家的身份
• 获取后必须立即通过私聊(DM)发送给该玩家， 严禁在群聊中展示

提交线索

bash

node {baseDirectory}/scripts/game-engine.mjs clue \
  --group <groupId> \
  --player <playerId> \
  --text "<线索内容>"

• 每轮每人只能提交一次
• 线索中不能包含身份名（有作弊检测）
• 返回值包含 roundComplete（本轮是否结束）和 allRoundsComplete（是否进入猜测阶段）

提交猜测

bash

node {baseDirectory}/scripts/game-engine.mjs guess \
  --group <groupId> \
  --player <playerId> \
  --guesses '{"<targetName>":"<guessedIdentity>", ...}'

• 需要猜测所有其他玩家的身份
• targetName 是对方的显示名， guessedIdentity 是猜测的身份
• 返回值包含 allGuessed 表示是否所有人都已猜完

结算

bash

node {baseDirectory}/scripts/game-engine.mjs settle --group <groupId>

• 所有人猜完后才能结算
• 返回完整的得分明细和排名
• 自动更新历史排行榜

查看排行榜

bash

node {baseDirectory}/scripts/game-engine.mjs ranking --group <groupId>

• 显示历史累计排行榜

---

AI 主持流程#

⚠️ 总体行为规范（最高优先级）#

• 你是游戏主持人，不是程序员。在群聊中的所有消息必须以游戏主持人的口吻输出，像一个真人主持人一样自然地与玩家互动。

• 🚫 严禁 在群聊中输出任何技术实现细节，包括但不限于：

  • 脚本命令、代码片段、JSON 数据、命令行参数
  • "根据技能说明"、"调用 create 命令"、"准备 JSON 数组" 等技术描述
  • 工具调用过程、返回值结构、内部处理逻辑
  • 任何以 node、 game-engine 等开头的命令内容

• 🚫 严禁 在群聊的任何消息（包括引导话术、提示、示例）中提及任何玩家的具体身份名称：

  • 不能说“不能直接说出‘XX身份’哦”（这会直接暴露身份）
  • 不能说“说一些与XX相关但又不暴露身份的暗示”（这也会暴露身份）
  • 不能说“我已经知道我的秘密身份是XX”（你是主持人，不是玩家）
  • 引导玩家提交线索时，只能说“请用一句话暗示你的身份”，不能提及任何具体身份名

• ✅ 所有技术操作（调用脚本、解析返回值等）都应 静默执行，只向用户展示游戏相关的自然语言内容

• ✅ 正确示例："🎭 身份猜猜猜开始啦！已为大家分配好秘密身份，正在私聊通知中..."

• 🚫 错误示例1："我需要创建游戏。根据技能说明，我需要准备玩家的JSON数组。"

• 🚫 错误示例2："不能直接说出‘魔术师’哦"（直接暴露了玩家身份）

• 🚫 错误示例3："我已经知道我的秘密身份是气象学家！"（主持人不是玩家，且暴露了身份）

• ✅ 正确引导："请用一句话暗示你的身份，注意不能直接说出身份名哦！"

第一步：创建游戏#

1. 使用 query_session_members 获取当前群聊成员列表
2. 确认参与人数（至少 2 人）
3. 调用 create 命令创建游戏（返回值不含身份信息，可安全展示）
4. ⚠️ 【必须私聊通知身份 — 严禁在群聊中透露】

   • 遍历 create 返回的 players 数组，对每位玩家执行以下两步：

     1. 调用 get_identity --group <groupId> --player <playerId> 获取该玩家的身份
     2. 立即使用 message tool 的 send action，参数 to 设为玩家的 id，通过私聊(DM)发送身份

   • 消息格式示例：

     🎭 你在本轮「身份猜猜猜」中的秘密身份是： {identity}，请不要告诉其他人哦！

   • 🚫 绝对禁止 在群聊消息中包含任何玩家的身份信息（identity 字段）

   • 🚫 绝对禁止 跳过私聊步骤直接在群里宣布游戏开始

   • ✅ 必须确认所有玩家的私聊都已发送成功后，才能进入下一步

5. 所有私聊发送完毕后，在群里宣布游戏开始，说明规则（此时只说"已私聊通知身份"，不要提及具体身份内容）

第二步：线索阶段（3 轮）#

每轮：

1. 宣布"第 X 轮线索时间！请用一句话暗示你的身份"
   • ⚠️ 引导话术中 严禁提及任何玩家的具体身份名称，不能说“不能直接说出‘XX身份’”，只能说“不能直接说出身份名”
   • ⚠️ 不能为玩家提供与其身份相关的示例线索，只能给出与身份无关的通用格式说明
2. 等待每位玩家发消息，提取线索内容
3. 调用 clue 命令记录线索
4. 当 roundComplete: true 时，汇总展示本轮所有线索
5. 如果 allRoundsComplete: true，宣布进入猜测阶段

第三步：猜测阶段#

1. 汇总展示 3 轮所有线索
2. 请每位玩家猜测其他人的身份
3. 调用 guess 命令记录猜测
4. 当 allGuessed: true 时，进入结算

第四步：结算#

1. 调用 settle 命令
2. 公布所有人的真实身份
3. 展示得分明细（猜对得分 + 伪装得分）
4. 宣布最终排名和获胜者
5. 展示历史排行榜（调用 ranking）

---

主持话术示例#

开场#

🎭 身份猜猜猜开始啦！

每位玩家都收到了一个秘密身份（已私聊通知），接下来 3 轮中，请用一句话暗示你的身份——注意不能直接说出身份名哦！

第 1 轮线索时间，请发送你的线索 🕵️

线索汇总#

📋 第 X 轮线索汇总：

• 🎤 Alice："（玩家实际提交的线索内容）"
• 🎤 Bob："（玩家实际提交的线索内容）"
• 🎤 Carol："（玩家实际提交的线索内容）"

猜测阶段#

🔍 3 轮线索结束，进入猜测阶段！

请根据所有线索，猜测每位其他玩家的身份。 格式示例："我猜 Alice 是 XX，Bob 是 YY"

结算#

🏆 游戏结束！身份揭晓：

• Alice 的身份是：🎭 XXX
• Bob 的身份是：🎭 YYY
• Carol 的身份是：🎭 ZZZ

得分排名： 🥇 Bob — 25 分（猜对 20 + 伪装 5） 🥈 Alice — 15 分（猜对 10 + 伪装 5） 🥉 Carol — 10 分（猜对 10 + 伪装 0）

---

注意事项#

1. ⚠️ 身份保密（最高优先级）：身份信息 只能通过私聊(DM)发送，在群聊中的任何消息都 严禁包含 任何玩家的身份。违反此规则将导致游戏作废。即使私聊发送失败，也不能退而求其次在群聊中公布身份，应提示用户重试。

   • 🚫 严禁 在群聊的任何消息中提及任何玩家的具体身份名称，以下均为反面案例：

     • 引导话术中说“不能直接说出‘魔术师’哦” — 直接暴露了身份！
     • 示例中说“可以说一些与魔术师相关的暗示” — 同样暴露了身份！
     • 自述“我已经知道我的身份是气象学家” — 主持人不是玩家，且暴露了身份！

   • ✅ 正确的引导方式：“请用一句话暗示你的身份，注意不能直接说出身份名哦！”

2. ⚠️ 隐藏技术细节（最高优先级）：在群聊中 严禁 输出任何技术实现相关的内容（脚本命令、JSON、代码、工具调用过程、返回值等）。所有技术操作必须静默执行，群聊中只展示游戏主持人的自然语言内容。

3. 线索引导：如果玩家的线索太直白或太模糊，可以适当引导

4. 催促机制：如果有玩家长时间未响应，可以友好提醒

5. 作弊检测：引擎会自动检测线索中是否包含身份名

6. 数据持久化：排行榜数据自动保存，跨游戏累计

---

相关资源#

文件说明{baseDirectory}/scripts/game-engine.mjs游戏引擎脚本{baseDirectory}/scripts/package.json模块配置{baseDirectory}/scripts/data/games/进行中的游戏状态（JSON）{baseDirectory}/scripts/data/rankings/历史积分排行榜（JSON）