@sdd330dev/jy-skill 0.3.1 → 0.7.0

package/scripts/mcp-server.ts

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * 金庸群侠传 MCP Server — 暴露游戏工具与 PlayerChoicePrompt 标准契约
+ *
+ * 用法: npx tsx scripts/mcp-server.ts
+ * Cursor / Claude Desktop 配置 stdio 启动此脚本即可。
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import {
+  loadOrCreateGameForUser,
+  getStatus,
+  getLocationDetail,
+  resolveOption,
+  buildChoicePrompt,
+  toMcpElicitationParams,
+  fromElicitationResponse,
+  setSaveUserId,
+} from './game-engine.js';
+import type { GameState } from './game-types.js';
+
+const sessions = new Map<string, GameState>();
+
+function getSession(playerId: string): GameState {
+  let state = sessions.get(playerId);
+  if (!state) {
+    setSaveUserId(playerId);
+    const { state: loaded } = loadOrCreateGameForUser(playerId, '主角');
+    state = loaded;
+    sessions.set(playerId, state);
+  }
+  return state;
+}
+
+function attachChoiceMeta(result: unknown, state: GameState) {
+  const prompt = buildChoicePrompt(state);
+  return {
+    result,
+    playerChoice: prompt,
+    mcpElicitation: toMcpElicitationParams(prompt),
+    status: getStatus(state),
+  };
+}
+
+const server = new McpServer({
+  name: 'jy-skill',
+  version: '0.6.0',
+});
+
+server.tool(
+  'jy_load_game',
+  '加载或新建金庸群侠传存档',
+  {
+    playerId: z.string().describe('玩家唯一 ID，如飞书 open_id'),
+    name: z.string().optional().describe('新角色名，默认「主角」'),
+  },
+  async ({ playerId, name }) => {
+    setSaveUserId(playerId);
+    const { state, isNewGame } = loadOrCreateGameForUser(playerId, name ?? '主角');
+    sessions.set(playerId, state);
+    const prompt = buildChoicePrompt(state);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              isNewGame,
+              location: state.location,
+              status: getStatus(state),
+              locationDetail: getLocationDetail(state),
+              playerChoice: prompt,
+              mcpElicitation: toMcpElicitationParams(prompt),
+            },
+            null,
+            2,
+          ),
+        },
+      ],
+    };
+  },
+);
+
+server.tool(
+  'jy_resolve_action',
+  '执行玩家选中的行动（optionId 来自 playerChoice.choices[].value）',
+  {
+    playerId: z.string(),
+    optionId: z.string().describe('PlayerChoicePrompt choices 中的 value'),
+  },
+  async ({ playerId, optionId }) => {
+    const state = getSession(playerId);
+    const resolved = resolveOption(state, optionId);
+    const payload = attachChoiceMeta(resolved, state);
+    return {
+      content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+  },
+);
+
+server.tool(
+  'jy_get_status',
+  '获取当前状态栏与可选行动',
+  { playerId: z.string() },
+  async ({ playerId }) => {
+    const state = getSession(playerId);
+    const prompt = buildChoicePrompt(state);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              status: getStatus(state),
+              playerChoice: prompt,
+              mcpElicitation: toMcpElicitationParams(prompt),
+            },
+            null,
+            2,
+          ),
+        },
+      ],
+    };
+  },
+);
+
+server.tool(
+  'jy_from_elicitation',
+  '将 MCP Elicitation 用户响应解析为 optionId 并执行',
+  {
+    playerId: z.string(),
+    elicitationContent: z.record(z.string(), z.unknown()).describe('elicitation 表单回传 JSON'),
+  },
+  async ({ playerId, elicitationContent }) => {
+    const optionId = fromElicitationResponse(elicitationContent);
+    if (!optionId) {
+      return {
+        content: [{ type: 'text', text: JSON.stringify({ error: '无效的 elicitation 响应' }) }],
+        isError: true,
+      };
+    }
+    const state = getSession(playerId);
+    const resolved = resolveOption(state, optionId);
+    const payload = attachChoiceMeta(resolved, state);
+    return {
+      content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+  },
+);
+
+async function main(): Promise<void> {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/scripts/persistence.ts

@@ -1,5 +1,5 @@
 /**
- * 游戏存档持久化 — save/game-state.json
+ * 游戏存档持久化 — save/game-state.json 或 save/users/{userId}.json
  */
 
 import {
@@ -23,11 +23,32 @@ export interface LoadGameResult {
 
 const ROOT_DIR = join(dirname(fileURLToPath(import.meta.url)), '..');
 const SAVE_DIR = join(ROOT_DIR, 'save');
+const USERS_DIR = join(SAVE_DIR, 'users');
 const SAVE_FILE = join(SAVE_DIR, 'game-state.json');
-const SAVE_TMP = join(SAVE_DIR, 'game-state.json.tmp');
 
-export function getSavePath(): string {
-  return SAVE_FILE;
+let currentSaveUserId: string | null = null;
+
+/** 设置当前会话使用的存档用户 ID（null = 默认单用户档） */
+export function setSaveUserId(userId: string | null): void {
+  currentSaveUserId = userId;
+}
+
+export function getSaveUserId(): string | null {
+  return currentSaveUserId;
+}
+
+function sanitizeUserId(userId: string): string {
+  return userId.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+
+export function getSavePath(userId?: string | null): string {
+  const id = userId === undefined ? currentSaveUserId : userId;
+  if (!id) return SAVE_FILE;
+  return join(USERS_DIR, `${sanitizeUserId(id)}.json`);
+}
+
+function getSaveTmpPath(savePath: string): string {
+  return `${savePath}.tmp`;
 }
 
 function isFiniteNumber(n: unknown): n is number {
@@ -122,49 +143,62 @@ function migrateGameState(state: GameState): GameState {
   return state;
 }
 
-/** 读取存档；不存在或损坏时返回 null */
-export function loadGameState(): GameState | null {
-  if (!existsSync(SAVE_FILE)) return null;
-
+function loadGameStateFromPath(path: string): GameState | null {
+  if (!existsSync(path)) return null;
   try {
-    const raw = readFileSync(SAVE_FILE, 'utf-8');
+    const raw = readFileSync(path, 'utf-8');
     const parsed: unknown = JSON.parse(raw);
-    if (!isValidGameState(parsed)) {
-      return null;
-    }
+    if (!isValidGameState(parsed)) return null;
     return migrateGameState(parsed);
   } catch {
     return null;
   }
 }
 
+/** 读取存档；不存在或损坏时返回 null */
+export function loadGameState(userId?: string | null): GameState | null {
+  return loadGameStateFromPath(getSavePath(userId));
+}
+
 /** 写入存档（原子替换，避免写入中断损坏） */
-export function saveGameState(state: GameState): void {
-  if (!existsSync(SAVE_DIR)) {
-    mkdirSync(SAVE_DIR, { recursive: true });
-  }
-  writeFileSync(SAVE_TMP, JSON.stringify(state, null, 2), 'utf-8');
-  renameSync(SAVE_TMP, SAVE_FILE);
+export function saveGameState(state: GameState, userId?: string | null): void {
+  const path = getSavePath(userId);
+  const dir = dirname(path);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  const tmp = getSaveTmpPath(path);
+  writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf-8');
+  renameSync(tmp, path);
 }
 
 /** 删除存档 */
-export function deleteSave(): void {
-  if (existsSync(SAVE_FILE)) {
-    unlinkSync(SAVE_FILE);
-  }
-  if (existsSync(SAVE_TMP)) {
-    unlinkSync(SAVE_TMP);
-  }
+export function deleteSave(userId?: string | null): void {
+  const path = getSavePath(userId);
+  const tmp = getSaveTmpPath(path);
+  if (existsSync(path)) unlinkSync(path);
+  if (existsSync(tmp)) unlinkSync(tmp);
 }
 
 /** 开始或继续：有存档则加载，否则新建并落盘 */
 export function loadOrCreateGame(
   createNewGame: (name: string) => GameState,
   name = '主角',
+  userId?: string | null,
 ): LoadGameResult {
-  const existing = loadGameState();
+  const existing = loadGameState(userId);
   if (existing) return { state: existing, isNewGame: false };
   const state = createNewGame(name);
-  saveGameState(state);
+  saveGameState(state, userId);
   return { state, isNewGame: true };
 }
+
+/** 多用户场景：按 userId 加载或新建 */
+export function loadOrCreateGameForUser(
+  userId: string,
+  createNewGame: (name: string) => GameState,
+  name = '主角',
+): LoadGameResult {
+  setSaveUserId(userId);
+  return loadOrCreateGame(createNewGame, name, userId);
+}