@sdd330dev/jy-skill 0.3.1 → 0.7.0

package/AGENTS.md

@@ -15,6 +15,8 @@ API 与完整规则见 [SKILL.md](SKILL.md)、[references/agent-handbook.md](ref
 - **数值准确**：所有计算必须遵循 `scripts/game-logic.ts`；禁止编造伤害、经验、价格
 - **单一入口**：只通过 `scripts/game-engine.ts` 调用游戏逻辑
 - **新人友好**：首登与求帮助时给出可执行建议，勿堆砌函数名或 API 术语
+- **选项契约优先**：每轮调用 `buildChoicePrompt(state)`，由 Host 渲染点选 UI（见 [host-adapters.md](references/host-adapters.md)）
+- **NPC 叙事**：`talkTo` 返回的 `npc.persona` / `knowledge` 用于扩写台词，但物品/武功/flag 以引擎为准
 
 ## 新玩家首登
 
@@ -26,21 +28,39 @@ API 与完整规则见 [SKILL.md](SKILL.md)、[references/agent-handbook.md](ref
    - 与村长或商人搭话，打听江湖消息；
    - 攒够脚程后前往平安镇，购置兵刃防具；
    - 说「查看背包」或「我现在什么状态」，熟悉自身家当。
-4. 末尾附带标准**状态栏**（见下文输出格式）。
+4. 末尾附带标准**状态栏**与**编号选项**（见下文输出格式）。
 
 若玩家是**续玩**（`isNewGame: false`），简短交代「你回到了江湖之中」并概括当前位置与近况即可，不必重复完整新人引导。
 
+## 行动选项（PlayerChoicePrompt）
+
+**每轮行动结束后 MUST 提供可点选选项**（在状态栏之前），禁止让玩家打字或输入数字选行动（除非 Host 无 UI 能力）。
+
+1. 调用 `buildChoicePrompt(state)` 得到标准契约（`type: 'player_choice'`）
+2. **Cursor**：若 AskQuestion 可用，用 `choices[].value` / `choices[].label` 映射为点选选项
+3. **MCP Host**：用 `toMcpElicitationParams(prompt)` 触发 Elicitation 单选 UI
+4. **飞书/OpenClaw**：用 `toFeishuInteractiveCard(prompt)` 或 `build-feishu-card.ts` 发交互卡片
+5. 用户点选 → `resolveOption(state, optionId)`；Elicitation 回传 → `fromElicitationResponse` → `resolveOption`
+
+**Fallback**（仅无 UI 时）：`getOptions` + 编号 1/2/3 文本列表。
+
+**对话分支**：`talkTo` 含 `choices` 时用 `buildChoicePromptFromTalk`；选中 `dialog:*` value 后 `resolveOption` 自动 `chooseDialog`。
+
+**事件**：`moveTo` / `talkTo` 返回 `events` 时须优先叙述，再展示新选项。
+
+详见 [host-adapters.md](references/host-adapters.md)。
+
 ## 帮助指令
 
 玩家说「帮助 / 怎么玩 / jy 帮助 / 指令 / 指令说明」时，按以下结构用武侠口吻回复（**不要用框线、不要罗列 API 函数名**）：
 
 1. **一句话**：江湖行事，只需用中文告诉我想做什么，不必记固定命令。
 2. **常用说法**（各举一例）：移动（如「去平安镇」）、对话（如「和村长聊聊」）、购物（如「买铁剑」）、战斗（如「攻击山贼」）、查看（如「看背包」）、休息（如「休息」）。
-3. **当下可为之事**：调用 `getLocationInfo(state)`，用一两段话说明可前往方向、在场人物、可购物品；若在地险要处（如山洞），提醒可能有埋伏。
+3. **当下可为之事**：调用 `getLocationDetail(state)` 与 `getOptions(state)`，用一两段话说明环境、可前往方向、在场人物；若在地险要处提醒可能有埋伏。
 4. 提示更完整说明见玩家手册；若玩家需要，可简要概括地图与战斗要点（相邻移动、战前备药、进洞可能遇敌）。
-5. 末尾附带**状态栏**。
+5. 末尾附带**编号选项**与**状态栏**。
 
-帮助场景下可调用 `getStatus` / `getInventory` / `getLocationInfo` 辅助叙述，但不要向玩家展示代码或函数调用过程。
+帮助场景下可调用 `getStatus` / `getInventory` / `getLocationDetail` / `getOptions` 辅助叙述，但不要向玩家展示代码或函数调用过程。
 
 ## 游戏流程
 
@@ -69,8 +89,9 @@ saveGameState(state)  // 可选
 
 | 意图 | 注意 |
 |------|------|
-| 移动 | `encounter` 不可忽略；「随便走走」用 `moveTo(state, 'random')` |
-| 对话 | NPC 名须与当前地点一致（如平安镇：守卫、商店老板、客栈老板） |
+| 移动 | `encounter` 不可忽略；「随便走走」用 `moveTo(state, 'random')`；返回 `events` 须叙述 |
+| 对话 | NPC 名须与当前地点一致；基于 `npc.persona` 扩写，数值以引擎为准 |
+| 数字输入（fallback） | 无 UI 时 `1`–`9` → `resolveOption` |
 | 使用物品 | 满状态时引擎拒绝消耗，须如实告知玩家 |
 | 战斗 | 多敌人时按 `enemies[i].hp > 0` 选目标 |
 
@@ -88,7 +109,9 @@ saveGameState(state)  // 可选
 - `getStatus(state)` — 状态栏
 - `getInventory(state)` — 背包
 - `getSkills(state)` — 武功
-- `getLocationInfo(state)` — 帮助/首登时说明附近选项
+- `getLocationInfo(state)` / `getLocationDetail(state)` — 地点信息
+- `buildChoicePrompt(state)` — 标准选项契约（**首选**）
+- `getOptions(state)` — 原始选项列表（适配器内部使用）
 
 ### 5. 死亡与重开
 
@@ -119,9 +142,16 @@ saveGameState(state)  // 可选
 - 每回合简洁有力；多敌人时点名（山贼1、山贼2…）。
 - 升级时可描写任督二脉通畅、功力精进一类意象，等级与属性以引擎为准。
 
+### NPC 对话与 LLM-NPC 模式
+
+- `talkTo` 返回 `npc` 角色卡时，用 `persona`、`knowledge` 丰富描写，但**不可编造**引擎未确认的结果。
+- 调用 `getNpcContext(state, npc)` 获取 `constraints` 硬约束列表，**必须遵守**。
+- NPC 传授武功：仅当 `availableActions` 含 `teach` 且条件满足时，调用 `learnSkill`；否则口头拒绝。
+- NPC 给予物品：须由事件引擎或 `chooseDialog` actions 触发，不可口头编造「送你 XXX」。
+
 ## 输出格式
 
-每次回复末尾附带状态栏（与 `getStatus` 一致）：
+每次回复末尾：**点选选项**（PlayerChoicePrompt / AskQuestion）→ **状态栏**（与 `getStatus` 一致）：
 
 ```
 👤 角色名 | Lv.等级 | 经验: …
@@ -147,4 +177,5 @@ saveGameState(state)  // 可选
 | [agent-handbook.md](references/agent-handbook.md) | 完整规则、API、地图、错误清单 |
 | [SKILL.md](SKILL.md) | Skill 入口与工作流 |
 | [player-guide.md](references/player-guide.md) | 可转述给玩家的 FAQ |
+| [host-adapters.md](references/host-adapters.md) | MCP / Cursor / 飞书选项适配 |
 | [game-design.md](references/game-design.md) | 公式细节 |

package/SKILL.md

@@ -5,7 +5,7 @@ description: >-
   Agent 须读 references/agent-handbook.md 掌握完整玩法与 API；玩家说 jy/开始游戏/帮助/金庸群侠传时使用。
 license: MIT
 metadata:
-  version: "0.3.1"
+  version: "0.7.0"
 disable-model-invocation: false
 ---
 
@@ -29,6 +29,7 @@ npm install @sdd330dev/jy-skill --save-dev && npx jy-skill install
 |------|------|------|
 | [agent-handbook.md](references/agent-handbook.md) | Agent | 规则、API、战斗、地图速查、错误清单 |
 | [AGENTS.md](AGENTS.md) | Agent | 武侠叙事、首登/帮助模板、输出格式 |
+| [host-adapters.md](references/host-adapters.md) | Agent | MCP / Cursor / 飞书选项适配 |
 | [player-guide.md](references/player-guide.md) | 玩家 | FAQ、地图、生存技巧 |
 | [game-design.md](references/game-design.md) | 开发 | 公式与设计细节 |
 
@@ -38,6 +39,7 @@ npm install @sdd330dev/jy-skill --save-dev && npx jy-skill install
 - 禁止手改存档、禁止编造伤害/价格/地图连接
 - `moveTo` 返回 `encounter` 时**必须** `startBattle` 并打完
 - 每轮回复末尾附 `getStatus(state)` 状态栏
+- **每轮 MUST** 调用 `buildChoicePrompt(state)`，由 Host 渲染点选 UI（见 [host-adapters.md](references/host-adapters.md)）；无 UI 时 fallback 数字导航
 
 ## 何时使用
 
@@ -46,7 +48,7 @@ npm install @sdd330dev/jy-skill --save-dev && npx jy-skill install
 | 玩家说法 | Agent 动作 |
 |----------|------------|
 | jy / 开始游戏 | `loadOrCreateGame`；`isNewGame` 则首登引导（见 AGENTS.md） |
-| 帮助 / 怎么玩 | `getLocationInfo` + 帮助模板，勿堆砌 API 名 |
+| 帮助 / 怎么玩 | `getLocationDetail` + `getOptions` + 帮助模板，勿堆砌 API 名 |
 | 重新开始 / 新游戏 | `restartGame()` |
 | 其他 | 解析意图 → 对应 API → 武侠叙述 + 状态栏 |
 
@@ -63,7 +65,10 @@ import {
   enemyAttack,
   isDead,
   getStatus,
-  getLocationInfo,
+  buildChoicePrompt,
+  toMcpElicitationParams,
+  resolveOption,
+  getLocationDetail,
   restartGame,
 } from './scripts/game-engine'
 
@@ -75,31 +80,37 @@ if (move.encounter) {
   // 战斗循环见下文
 }
 
-saveGameState(state) // 可选，引擎已自动存档
+// 每轮末尾：buildChoicePrompt → Host 点选 UI → resolveOption(optionId)
+const prompt = buildChoicePrompt(state)
 ```
 
 ## 每轮工作流
 
 1. **加载**：无 `state` 时 `loadOrCreateGame(createNewGame, '主角')`
-2. **执行**：按玩家意图调用 API（复合指令分步执行）
+2. **执行**：按玩家意图调用 API；点选回传 `optionId` → `resolveOption`
 3. **遇敌**：`moveTo` → `encounter?` → `startBattle` → 战斗循环
-4. **死亡**：`isDead` → 叙述结算 → `restartGame()`
-5. **输出**：武侠叙述 + `getStatus(state)` 状态栏
+4. **事件**：`moveTo`/`talkTo` 返回 `events` 时须优先叙述；对话分支用 `chooseDialog`
+5. **死亡**：`isDead` → 叙述结算 → `restartGame()`
+6. **输出**：武侠叙述 + `buildChoicePrompt` 选项 + `getStatus(state)` 状态栏
 
 ## 玩家意图 → API
 
 | 意图 | API | 要点 |
 |------|-----|------|
-| 移动 / 随便走走 | `moveTo(state, dest)` | `dest='random'` 随机相邻；返回 `encounter?` |
-| 对话 | `talkTo(state, npc)` | NPC 名须精确；`'random'` 随机 |
+| 移动 / 随便走走 | `moveTo(state, dest)` | `dest='random'` 随机相邻；返回 `encounter?`、`events?`、`locationDetail?` |
+| 对话 | `talkTo(state, npc)` | 返回 `npc` 角色卡、`choices?`、`context?`；基于 persona 扩写叙事 |
+| 对话选项 | `chooseDialog(state, dialogId, index)` | 处理分支与 setFlag/addItem/battle |
+| 点选选项 | `buildChoicePrompt` → Host UI → `resolveOption(state, optionId)` | 标准契约；见 host-adapters.md |
+| 数字 fallback | `resolveOption(state, getOptions()[n-1].id)` | 仅无 UI 时 |
 | 购买 | `buyItem(state, item)` | 仅当前地点商店 |
 | 使用 | `useItem(state, item)` | 无收益不消耗 |
 | 装备 | `equipItem(state, item)` | 武器/防具 |
-| 学武功 | `learnSkill(state, skill)` | 须存在于 assets |
+| 学武功 | `learnSkill(state, skill)` | 须存在于 assets；NPC 传授须引擎确认 |
 | 休息 | `rest(state)` | 满状态并解毒解伤 |
 | 战斗 | `startBattle` + 循环 | 见下节 |
 | 查看 | `getStatus` / `getInventory` / `getSkills` | |
-| 帮助 | `getLocationInfo` | 当前可为之事 |
+| 帮助 / 选项 | `getLocationDetail` / `buildChoicePrompt` | 当前可为之事与选项契约 |
+| NPC 约束 | `getNpcContext(state, npc)` | LLM-NPC 模式硬约束，禁止编造 teach/give |
 | 重开 | `restartGame(name?)` | 删档+新建+落盘 |
 
 ## 战斗循环（必遵）
@@ -174,10 +185,11 @@ if (isDead(state)) {
 
 | 类别 | 函数 |
 |------|------|
-| 存档 | `loadOrCreateGame`, `loadGameState`, `saveGameState`, `deleteSave`, `restartGame` |
+| 存档 | `loadOrCreateGame`, `loadOrCreateGameForUser`, `loadGameState`, `saveGameState`, `deleteSave`, `restartGame` |
 | 初始化 | `createNewGame` |
-| 查询 | `getStatus`, `getInventory`, `getSkills`, `getLocationInfo` |
-| 探索 | `moveTo`, `talkTo`, `rest` |
+| 查询 | `getStatus`, `getInventory`, `getSkills`, `getLocationInfo`, `getLocationDetail`, `getOptions`, `getNpcContext` |
+| 选项契约 | `buildChoicePrompt`, `buildChoicePromptFromTalk`, `toMcpElicitationParams`, `fromElicitationResponse`, `toFeishuInteractiveCard` |
+| 探索 | `moveTo`, `talkTo`, `chooseDialog`, `resolveOption`, `rest` |
 | 物品 | `buyItem`, `useItem`, `equipItem`, `learnSkill` |
 | 战斗 | `startBattle`, `attackEnemy`, `useSkillInBattle`, `enemyAttack`, `isDead` |
 
@@ -187,7 +199,7 @@ if (isDead(state)) {
 
 - 地图/NPC/商店/敌人：`assets/templates.json`（**勿编造**）
 - 武功/物品数值：`assets/skills.json`、`assets/items.json`
-- 存档：`save/game-state.json`（引擎原子写入，自动迁移旧档）
+- 存档：`save/game-state.json` 或 `save/users/{userId}.json`（多用户/MCP）
 
 ## 目录
 
@@ -197,12 +209,17 @@ jy/
 ├── AGENTS.md
 ├── references/
 │   ├── agent-handbook.md   # Agent 操作手册（必读）
+│   ├── host-adapters.md
 │   ├── player-guide.md
 │   └── game-design.md
 ├── scripts/
 │   ├── game-engine.ts      # 唯一 API
+│   ├── choice-prompt.ts    # PlayerChoicePrompt 契约
+│   ├── mcp-server.ts       # MCP Server（可选）
+│   ├── build-feishu-card.ts
 │   ├── game-logic.ts
 │   ├── config-loader.ts
+│   ├── event-engine.ts
 │   └── persistence.ts
 └── assets/
 ```

package/assets/game-config.json

@@ -98,6 +98,20 @@
             { "type": "setFlag", "params": { "flag": "village_visited", "value": true } },
             { "type": "dialog", "params": { "dialogId": "village_intro" } }
           ]
+        },
+        {
+          "id": "village_cave_return",
+          "triggerType": "talk",
+          "npcName": "村长",
+          "conditions": [
+            { "type": "flag", "params": { "flag": "cave_master_met", "value": true } },
+            { "type": "flag", "params": { "flag": "village_cave_reward", "value": false } }
+          ],
+          "actions": [
+            { "type": "dialog", "params": { "dialogId": "village_cave_reward" } },
+            { "type": "addItem", "params": { "itemId": 30, "count": 3 } },
+            { "type": "setFlag", "params": { "flag": "village_cave_reward", "value": true } }
+          ]
         }
       ]
     },
@@ -149,6 +163,29 @@
             { "type": "setFlag", "params": { "flag": "cave_treasure", "value": true } },
             { "type": "addItem", "params": { "itemId": 13, "count": 1 } }
           ]
+        },
+        {
+          "id": "cave_start",
+          "triggerType": "auto",
+          "conditions": [{ "type": "flag", "params": { "flag": "cave_entered", "value": false } }],
+          "actions": [
+            { "type": "setFlag", "params": { "flag": "cave_entered", "value": true } },
+            { "type": "dialog", "params": { "dialogId": "cave_intro" } }
+          ]
+        },
+        {
+          "id": "cave_master_quest",
+          "triggerType": "talk",
+          "npcName": "神秘人",
+          "conditions": [
+            { "type": "level", "params": { "min": 5 } },
+            { "type": "flag", "params": { "flag": "cave_master_met", "value": false } }
+          ],
+          "actions": [
+            { "type": "dialog", "params": { "dialogId": "cave_master_notice" } },
+            { "type": "addItem", "params": { "itemId": 36, "count": 1 } },
+            { "type": "setFlag", "params": { "flag": "cave_master_met", "value": true } }
+          ]
         }
       ]
     },
@@ -329,7 +366,7 @@
     },
     {
       "id": 6,
-      "name": "终南山全真教",
+      "name": "全真教",
       "desc": "道教圣地，全真教总坛。",
       "width": 14,
       "height": 12,
@@ -687,10 +724,34 @@
         {
           "text": "来吧！",
           "nextId": "",
-          "actions": [{ "type": "battle", "params": { "battleId": 3 } }]
+          "actions": [{ "type": "battle", "params": { "enemyName": "武林高手" } }]
         }
       ]
     },
+    "cave_intro": {
+      "id": "cave_intro",
+      "speaker": "旁白",
+      "text": "入此洞者，机缘与凶险并存。洞壁上刻着几行潦草的字迹。",
+      "choices": [
+        { "text": "（继续）", "nextId": "" }
+      ]
+    },
+    "cave_master_notice": {
+      "id": "cave_master_notice",
+      "speaker": "神秘人",
+      "text": "你已有几分功力。这瓶解毒丸收好，江湖路远，备不时之需。",
+      "choices": [
+        { "text": "多谢前辈", "nextId": "" }
+      ]
+    },
+    "village_cave_reward": {
+      "id": "village_cave_reward",
+      "speaker": "村长",
+      "text": "听说你在山洞有所收获？这是村里备的金创药，带上吧。",
+      "choices": [
+        { "text": "多谢村长", "nextId": "" }
+      ]
+    },
     "town_guard": {
       "id": "town_guard",
       "speaker": "守卫",

package/assets/templates.json

@@ -66,38 +66,197 @@
     "小村": {
       "npcs": ["村长", "商人"],
       "shops": ["金创药", "小还丹", "干粮"],
-      "connections": ["平安镇", "山洞"]
+      "connections": ["平安镇", "山洞"],
+      "description": "炊烟袅袅的宁静村落，茅屋错落，鸡犬相闻。村口水井旁有几个孩童在嬉戏。",
+      "atmosphere": "安全，适合新手落脚",
+      "dangerLevel": "safe",
+      "npcCards": {
+        "村长": {
+          "name": "村长",
+          "title": "小村村长",
+          "persona": "年过六旬的乡村长者，见多识广但话不多。年轻时在华山见过真正的剑客，从此对江湖心存敬畏。",
+          "knowledge": ["山洞传说：里面住着神秘人，据说藏着武林秘籍", "平安镇势力：镇上各派眼线不少，言行当心"],
+          "canHelp": ["告诉你山洞的位置和危险", "提醒平安镇物价"]
+        },
+        "商人": {
+          "name": "商人",
+          "title": "行脚商人",
+          "persona": "走南闯北的行脚商，消息灵通但唯利是图。脸上总挂着商人特有的精明笑容。",
+          "knowledge": ["知道哪里能买到好东西", "华山最近不太平"],
+          "isShop": true
+        }
+      }
     },
     "平安镇": {
       "npcs": ["守卫", "商店老板", "客栈老板"],
       "shops": ["铁剑", "钢刀", "布衣", "皮甲", "金创药", "小还丹"],
-      "connections": ["小村", "华山", "桃花岛", "全真教", "光明顶"]
+      "connections": ["小村", "华山", "桃花岛", "全真教", "光明顶"],
+      "description": "青石板铺就的市镇，酒旗招展，行人往来。这里是方圆百里最繁华的集散地。",
+      "atmosphere": "热闹但需留心，各路人物混杂",
+      "dangerLevel": "safe",
+      "npcCards": {
+        "守卫": {
+          "name": "守卫",
+          "title": "镇口守卫",
+          "persona": "魁梧的汉子，佩刀而立，对陌生人盘查仔细但不无礼。",
+          "knowledge": ["镇上最近有江湖人士出没", "华山、桃花岛、全真教、光明顶均可从此出发"],
+          "canHelp": ["指路各方向", "提醒宵禁"]
+        },
+        "商店老板": {
+          "name": "商店老板",
+          "title": "兵器铺掌柜",
+          "persona": "精明干练的中年人，一眼便能看出客人有没有银两。",
+          "knowledge": ["铁剑钢刀是入门首选", "皮甲比布衣实用得多"],
+          "isShop": true
+        },
+        "客栈老板": {
+          "name": "客栈老板",
+          "title": "悦来客栈掌柜",
+          "persona": "胖乎乎的笑脸掌柜，招呼客人热情周到，消息也灵通。",
+          "knowledge": ["休息可恢复全部状态", "江湖传闻常在他这里流传"],
+          "canHelp": ["提供休息", "打听江湖消息"]
+        }
+      }
     },
     "山洞": {
       "npcs": ["神秘人"],
       "shops": [],
       "connections": ["小村"],
-      "encounters": { "rate": 20, "enemies": ["山贼", "强盗", "老虎"] }
+      "encounters": { "rate": 20, "enemies": ["山贼", "强盗", "老虎"] },
+      "description": "崎岖山道尽头，一处隐蔽岩洞在藤蔓间若隐若现。洞口寒气森森，幽暗中隐约有火光闪烁。",
+      "atmosphere": "阴森危险，可能有埋伏",
+      "dangerLevel": "dangerous",
+      "npcCards": {
+        "神秘人": {
+          "name": "神秘人",
+          "title": "洞中隐士",
+          "persona": "面容被阴影遮住，声音低沉。似乎在此隐居多年，对闯入者半是考验半是好奇。",
+          "knowledge": ["洞壁上有前人刻下的武功心得", "深处似乎藏有宝物"],
+          "canHelp": ["指点武功", "给予任务"],
+          "canTeach": ["基本刀法"],
+          "conditions": {
+            "teach": { "minLevel": 3 },
+            "quest": { "minLevel": 5, "flag": "cave_master_met" }
+          }
+        }
+      }
     },
     "华山": {
       "npcs": ["王重阳"],
       "shops": [],
-      "connections": ["平安镇"]
+      "connections": ["平安镇"],
+      "description": "天下五绝论剑之地，山势险峻，云雾缭绕。峰顶有论剑台，江湖人梦寐以求的圣地。",
+      "atmosphere": "肃穆高远，暗藏剑意",
+      "dangerLevel": "cautious",
+      "npcCards": {
+        "王重阳": {
+          "name": "王重阳",
+          "title": "全真教主",
+          "persona": {
+            "archetype": "一代宗师",
+            "tone": "平和淡然，偶露锋芒",
+            "likes": ["修道之人", "悟性高者"],
+            "dislikes": ["奸邪小人", "好勇斗狠"]
+          },
+          "knowledge": ["华山论剑往事", "九阴真经下落", "全真内功精髓"],
+          "canTeach": ["全真剑法"],
+          "conditions": {
+            "teach": { "minLevel": 10, "minIQ": 60 }
+          }
+        }
+      }
     },
     "桃花岛": {
       "npcs": ["黄药师", "黄蓉"],
       "shops": [],
-      "connections": ["平安镇"]
+      "connections": ["平安镇"],
+      "description": "东海桃花岛，落英缤纷，奇门阵法隐于花丛。海风携着药香与箫声，令人心旷神怡又心生敬畏。",
+      "atmosphere": "瑰丽神秘，岛主性情难测",
+      "dangerLevel": "cautious",
+      "npcCards": {
+        "黄药师": {
+          "name": "黄药师",
+          "title": "桃花岛主",
+          "persona": {
+            "archetype": "傲世天才",
+            "tone": "冷淡疏离，偶尔露出一丝赞许",
+            "likes": ["聪明人", "奇门遁甲", "弹指神通"],
+            "dislikes": ["蠢人", "世俗礼法"]
+          },
+          "knowledge": ["九阴真经的秘密", "全真教的历史", "华山论剑往事"],
+          "canTeach": ["弹指神通"],
+          "conditions": {
+            "teach": { "minLevel": 5, "minIQ": 60 }
+          }
+        },
+        "黄蓉": {
+          "name": "黄蓉",
+          "title": "桃花岛千金",
+          "persona": "机灵聪慧的少女，笑语盈盈，却一眼能看穿人心。",
+          "knowledge": ["父亲黄药师的脾气", "江湖各派趣闻", "烹饪与奇门之术"],
+          "canHelp": ["在父亲面前美言", "分享江湖情报"]
+        }
+      }
     },
     "全真教": {
       "npcs": ["王重阳", "周伯通"],
       "shops": [],
-      "connections": ["平安镇"]
+      "connections": ["平安镇"],
+      "description": "终南山全真教总坛，道教圣地。殿宇庄严，钟磬悠扬，弟子们练功的呼喝声回荡在山谷。",
+      "atmosphere": "清修之地，规矩森严",
+      "dangerLevel": "safe",
+      "npcCards": {
+        "王重阳": {
+          "name": "王重阳",
+          "title": "全真教主",
+          "persona": {
+            "archetype": "一代宗师",
+            "tone": "平和淡然，偶露锋芒",
+            "likes": ["修道之人", "悟性高者"],
+            "dislikes": ["奸邪小人", "好勇斗狠"]
+          },
+          "knowledge": ["全真教历史", "九阴真经", "华山论剑"],
+          "canTeach": ["全真剑法"],
+          "conditions": {
+            "teach": { "minLevel": 10, "minIQ": 60 }
+          }
+        },
+        "周伯通": {
+          "name": "周伯通",
+          "title": "老顽童",
+          "persona": "童心未泯的前辈高人，爱开玩笑，武功却深不可测。",
+          "knowledge": ["左右互搏之术", "王重阳的往事", "江湖趣闻"],
+          "canTeach": ["空明拳"],
+          "conditions": {
+            "teach": { "minLevel": 8 }
+          }
+        }
+      }
     },
     "光明顶": {
       "npcs": ["张无忌"],
       "shops": [],
-      "connections": ["平安镇"]
+      "connections": ["平安镇"],
+      "description": "西域光明顶，明教总坛所在。烈日当空，教众练武之声震天。此地汇聚天下豪杰。",
+      "atmosphere": "豪迈壮阔，正邪之争的焦点",
+      "dangerLevel": "cautious",
+      "npcCards": {
+        "张无忌": {
+          "name": "张无忌",
+          "title": "明教教主",
+          "persona": {
+            "archetype": "仁厚领袖",
+            "tone": "温和谦逊，胸怀天下",
+            "likes": ["正义之士", "侠义心肠"],
+            "dislikes": ["欺压百姓", "门派偏见"]
+          },
+          "knowledge": ["九阳神功", "明教历史", "六大派围攻光明顶往事"],
+          "canTeach": ["九阳神功"],
+          "conditions": {
+            "teach": { "minLevel": 15, "minIQ": 70 }
+          }
+        }
+      }
     }
   },
   "skills": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdd330dev/jy-skill",
-  "version": "0.3.1",
+  "version": "0.7.0",
   "description": "金庸群侠传 Cursor Agent Skill — 对话式武侠 RPG，自然语言驱动移动、战斗与存档",
   "type": "module",
   "license": "MIT",
@@ -40,12 +40,18 @@
     "scripts/game-engine.ts",
     "scripts/game-logic.ts",
     "scripts/config-loader.ts",
+    "scripts/choice-prompt.ts",
+    "scripts/mcp-server.ts",
+    "scripts/build-feishu-card.ts",
+    "scripts/event-engine.ts",
     "scripts/persistence.ts",
     "scripts/game-types.ts",
     "scripts/install-skill.mjs"
   ],
   "scripts": {
     "test": "vitest run",
+    "mcp": "tsx scripts/mcp-server.ts",
+    "feishu-card": "tsx scripts/build-feishu-card.ts --demo",
     "test:skill": "vitest run",
     "test:logic": "vitest run scripts/game-logic.test.ts",
     "test:engine": "vitest run scripts/game-engine.test.ts",
@@ -76,5 +82,9 @@
     "typescript": "~6.0.3",
     "vite": "^8.0.16",
     "vitest": "^4.1.9"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
   }
 }