@taptap/instant-games-open-mcp 1.24.7-beta.1 → 1.24.7

package/README.md

@@ -18,10 +18,11 @@
 - **🤖 智能引导** - AI Agent 自动验证前置条件，主动询问用户选择
 
 **NPM**: [@taptap/instant-games-open-mcp](https://www.npmjs.com/package/@taptap/instant-games-open-mcp)
+**Maker NPM**: [@taptap/maker](https://www.npmjs.com/package/@taptap/maker)
 
 ## 🦞 OpenClaw Plugin（实验中）
 
-仓库内提供了一个可独立发布的 OpenClaw plugin 子包：
+仓库内提供了一个可独立使用的 OpenClaw plugin 子包：
 
 - [`packages/openclaw-dc-plugin`](packages/openclaw-dc-plugin)
 
@@ -41,18 +42,17 @@
 详见：
 
 - [OpenClaw Plugin 说明](docs/OPENCLAW_PLUGIN.md)
-- 维护者发布方式：`npm run openclaw:pack` / `npm run openclaw:publish`
 
 ## 🛠️ TapTap Maker 本地开发（CLI-first）
 
-Maker 本地开发按“初始化用 CLI，开发循环用 MCP”拆分。首次配置推荐直接运行：
+Maker 本地开发独立发布为 `@taptap/maker`。首次配置推荐直接运行：
 
 ```bash
-npx -y -p @taptap/instant-games-open-mcp taptap-maker init
+npx -y @taptap/maker init
 ```
 
-CLI 负责一次性流程：Git 检查、PAT 保存、TapTap token 换取、app 列表选择、AI dev kit
-准备、Maker Git clone、MCP 配置写入与基础验证。安装或修改 MCP 配置后，Claude Code /
+CLI 负责一次性流程：Git 检查、CLI 登录、TapTap token 换取、app 列表选择、Maker Git
+clone、AI dev kit 准备、MCP 配置写入与基础验证。安装或修改 MCP 配置后，Claude Code /
 Codex / Cursor 通常需要重启会话、刷新 MCP 或新开窗口才会出现新的 MCP tools；但当前终端
 里的 CLI 初始化流程可以继续完成到 PAT 鉴权和项目绑定。
 
@@ -60,30 +60,26 @@ Codex / Cursor 通常需要重启会话、刷新 MCP 或新开窗口才会出现
 
 ```bash
 taptap-maker init
+taptap-maker login
 taptap-maker doctor
 taptap-maker apps --json
-taptap-maker pat set
-taptap-maker mcp install --ide codex,cursor,claude
+taptap-maker install --ide codex,cursor,claude
 taptap-maker mcp verify
 taptap-maker dev-kit update
 ```
 
-`taptap-maker pat set` 默认通过交互式 prompt 接收 PAT，避免把 PAT 写进
-`ps` 进程列表或 shell history；自动化场景可用 `--pat-stdin` 从标准输入读取。
-`taptap-maker mcp verify` 默认验证 `mcp install` 写入 AI 客户端配置的 npx 启动命令；
-本地开发只想验证当前 CLI 时可加 `--mode self`。如果验证输出 `status: null` 或
-`failure_type`，说明本地 Node/npm/npx 启动命令还没正常跑通，Maker MCP server
-尚未启动；这不是 PAT、app 选择或 Maker 业务接口报错。先按输出里的 command
-在终端直接执行，再检查 `where.exe npx/node/npm`、`node -v` 和 `npm -v`。
+`taptap-maker login` 是 CLI 登录入口；它会按需打开 Maker 授权页，CLI 轮询授权结果并完成本地鉴权配置。
+`taptap-maker init` 缺 PAT 时会自动进入该流程。`taptap-maker pat set` 保留为兼容入口；
+自动化场景可用 `--pat-stdin` 从标准输入读取。`taptap-maker install` 是
+`taptap-maker mcp install` 的快捷别名，二者都会写入 AI 客户端 MCP 配置。
+`taptap-maker dev-kit update` 会检查当前环境可用的最新 AI dev kit 并更新当前目录。
 
-MCP 精简为开发循环里的高频能力：
+Maker MCP 精简为开发循环里的高频能力：
 
 ```text
 maker://status                  # Resource，读取本地 Maker 状态
 maker_status_lite               # Resource 不可用时的兼容 tool
 maker_build_current_directory   # commit/push/build 合并入口
-maker_pull_runtime_logs         # 单次拉取运行日志并落到本地固定路径
-taptap-maker logs watch         # CLI，构建成功后持续轮询运行日志
 ```
 
 `maker_build_current_directory` 同时覆盖“构建 / 预览 / 跑一下 / 验证一下 / 提交 / 推送”。
@@ -93,57 +89,18 @@ build。push 失败时不会继续 build，会返回本地 commit、ahead 状态
 Maker 远端但构建失败。只有用户明确说“不提交，只构建云端版本”时，才传
 `confirm_remote_build_without_submit=true`。
 
-构建成功并收到远端 build 返回后，Maker MCP 会主动调用当前环境的 Maker Web
-`/api/v1/apps/<APP_ID>/preview-refresh`，让 Web 端预览页刷新到最新构建。
-构建成功输出会同时给出本地 watcher 状态；MCP 在收到远端 build 返回后会启动本地
-`taptap-maker logs watch --target-dir <PROJECT_ROOT> --reset --interval 5s` detached 进程，
-由 CLI 清理历史日志并持续轮询。后续如果用户询问游戏运行结果、Lua 报错或调试问题，
-本地 AI Agent 应优先读取返回中的 `runtime_logs.local_file`；如需判断 watcher 是否正常，
-读取 `runtime_logs.state_file`。
-
-`maker_pull_runtime_logs` 只做固定的一次性业务流：调用远端 `query_runtime_logs`，默认只拉
-`engine`、`user_script`（客户端 Lua 脚本）和 `server_user_script`（服务端 Lua 脚本）。
-本地只追加写入一份
-`.maker/logs/runtime/runtime.log`，保持 server 日志行格式（`t/topic/level/msg/userId` 等），
-但去掉无用的 `id` 字段，也不再补 `time/message` 重复字段；`.maker/logs/runtime/state.json`
-保存下一次查询游标和 watcher 心跳状态，包括最近轮询时间、最近成功时间、最近写入条数、
-连续失败次数和最后错误。
-持续轮询和清理旧日志由 `taptap-maker logs watch --reset --interval 5s` 承担，不放进 MCP
-tool 长调用；远端返回 `hasMore=true` 时会立即继续拉取，否则每 5 秒轮询一次。
-
-`maker://status` 和 `maker_status_lite` 会在已绑定项目里检查 Maker 远端同步状态。
-如果远端有新提交，状态输出会区分本地工作区是否干净：干净时提示可先
-`git pull --ff-only origin main`，有本地改动时提示不要直接 pull，应让本地 Agent 先处理
-提交、stash 或取消同步。
-频繁轮询状态或只需要快速本地状态时，调用 `maker_status_lite` 应传
-`skip_remote_sync=true`，避免每次状态查询都触发 `git fetch origin` 网络往返。
-
-首次 clone/fetch 和 push 遇到 503、HTTP 5xx、超时、连接重置、RPC/HTTP2 中断等临时网络错误时会自动重试；认证、权限、仓库不存在、远端拒绝和本地目录冲突不会重试，会把错误分类交给 Agent 处理。首次 clone/fetch 前 CLI 会提示 Maker server 可能正在准备仓库，首次拉代码 20 秒以上是正常现象，建议保持命令运行等待自动重试。
+构建成功后，Maker MCP 会刷新 Maker Web 预览，并启动本地 runtime log watcher。后续如果用户询问
+游戏运行结果、Lua 报错或调试问题，本地 AI Agent 应优先读取构建返回中的
+`runtime_logs.local_file`；如需判断 watcher 是否正常，读取 `runtime_logs.state_file`。
+
+Maker MCP 也提供部分生成类能力，当前包括 `generate_image`、`batch_generate_images`、
+`edit_image`、`create_video_task` 和 `text_to_music`；具体参数以 MCP 客户端展示的 tool
+schema 为准。代理转发和白名单细节见 [TapTap Maker 本地开发](docs/MAKER.md)。
 
 Windows 是默认优先级：CLI 写 MCP 配置时会在 Windows 使用 `npx.cmd`，Git 引导优先提示
 Git for Windows，并要求安装选项允许命令行和第三方工具通过 PATH 找到 Git。macOS 用户可通过
 `git --version` 触发 Xcode Command Line Tools，或安装官方 Git。
 
-### Maker 本地 Workflow Skills（实验中）
-
-Maker 现在同时内置三个工作流 skill：
-
-- `taptap-maker-local`：把 Maker 初始化转交 CLI，并让本地 AI/Agent 按 push 失败分类处理 pull/rebase、切回 main、移除禁止路径、鉴权刷新、冲突和构建失败恢复。
-- `taptap-maker-dev-kit-guide`：介绍 clone 时安装到项目目录的 AI dev kit，明确 `CLAUDE.md`、`examples/`、`templates/`、`urhox-libs/` 的用途。
-- `update-taptap-mcp`：引导用户更新本地 npx 缓存里的 `@taptap/instant-games-open-mcp`，并提醒 Maker MCP 推荐安装到 user/global scope。
-
-初始化流程里，PAT 验证通过、用户选择 app 后，`taptap-maker init` 会自动准备本地 AI dev kit。
-
-CLI 会根据 `TAPTAP_MCP_ENV` 自动选择下载源：`production`（默认）使用 `https://urhox-demo-platform.spark.xd.com/ai-dev-kit/pd/stable/ai-dev-kit.zip`，`rnd` 使用 `https://urhox-demo-platform.spark.xd.com/ai-dev-kit/rnd/latest/ai-dev-kit.zip`，解压开发环境文档、引擎 API、demo、Lua 工具和本地 AI skills 到当前目录；解压复制完成后会自动运行 `tools/install-skills.sh all`（Linux/macOS）或 `tools/install-skills.ps1 all`（Windows），把 dev kit skills 安装到各 Agent 的发现目录。CLI 会先输出 `AI skills install started: <script>`，完成后输出 `AI skills install result: claude=N, codex=N, cursor=N, gemini=N`；脚本缺失、跳过或失败时也会输出原因，失败会带上平台、脚本、命令、stdout 和 stderr，方便 AI 与用户直接判断安装情况。流程会跳过 ZIP 里的顶层 `scripts` 目录并删除下载 ZIP，避免和 Maker 项目代码冲突。dev kit 准备成功后会刷新项目根 `.gitignore`，防止这些本地开发环境文件、Agent skill 目录和 `.maker/` 本地运行状态被提交到 Maker Git；`.gitignore` 本身是 Maker 项目必要文件，首次 init 生成后应随游戏代码提交。
-
-`maker://status` 和 `maker_status_lite` 会输出已随包内置的 skill 名称和文档路径：`taptap-maker-local`、`taptap-maker-dev-kit-guide` 与 `update-taptap-mcp`。Maker 操作目标是用户当前项目目录；若 MCP 进程 cwd 是临时对话目录，Agent 应把用户当前项目目录作为 `target_dir` 传入，不扫描其他项目。已绑定项目会检查 `CLAUDE.md`、`examples/`、`templates/`、`urhox-libs/`，并输出 `skill_install_status` 和 `skill_install_summary` 说明 `.claude/.codex/.cursor/.gemini` 下的 skill 安装状态；缺失时用 `taptap-maker dev-kit update` 恢复本地 AI dev kit 并刷新 `.gitignore` 管理块。
-
-Git 引导：
-
-- macOS：用户自行执行 `git --version`，按系统提示安装 Xcode Command Line Tools，或访问 `https://git-scm.com/download/mac` 下载安装器。
-- Windows：用户自行访问 `https://git-scm.com/download/win` 安装 Git for Windows，并确保安装选项允许命令行和第三方工具通过 PATH 找到 Git。
-- 安装后需要重启 MCP 客户端或终端，再用 `git --version` 验证。
-
 详见：[TapTap Maker 本地开发](docs/MAKER.md)。面向团队介绍的功能总览见
 [Maker CLI + MCP + Skill Rework Overview](docs/MAKER_CLI_MCP_SKILL_REWORK_OVERVIEW.md)。
 
@@ -391,12 +348,10 @@ maker_status_lite
 maker_build_current_directory
 ```
 
-`taptap-maker doctor` 会检查 Git、PAT、TapTap token、项目绑定和 MCP 配置。若 Git 不可用，clone/push 会直接停止，直到用户自行安装 Git 并通过 `git --version` 验证。
+`taptap-maker doctor` 会检查 Git、PAT、TapTap token、项目绑定、AI dev kit 版本和 MCP 配置。若 Git 不可用，clone/push 会直接停止，直到用户自行安装 Git 并通过 `git --version` 验证。
 `taptap-maker mcp verify` 默认跑一次实际 MCP 配置使用的 npx 包命令；本地 dist 自测可用 `--mode self`。如果失败结果显示 `failure_type` 或 `status: null`，优先按本地 Node/npm/npx 启动问题处理，Maker MCP server 此时尚未启动，不要误判为 PAT 或 Maker 服务报错。
 
-测试时引导用户访问当前环境的 PAT 页面新建 Maker PAT，
-production 使用 `https://maker.taptap.cn/pat-tokens`，RND 使用 `https://fuping.agnt.xd.com/pat-tokens`，
-再运行 `taptap-maker pat set` 并在 prompt 中粘贴 PAT，CLI 会同步获取 TapTap token。
+测试时优先运行 `taptap-maker login`；CLI 会按需打开 Maker 授权页，授权完成后自动完成本地鉴权配置。
 当前目录未绑定时，APP_ID 应通过 `taptap-maker init` 或 `taptap-maker apps` 返回的 app 列表让用户选择；当前目录已绑定时不要再次引导 clone。
 
 ```bash
@@ -535,36 +490,8 @@ graph LR
 - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - 架构文档
 - **[docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)** - 部署指南（本地、Docker、开发者测试）
 - **[docs/PROXY.md](docs/PROXY.md)** - MCP Proxy 开发指南（面向 TapCode 等平台）
-- **[docs/CI_CD.md](docs/CI_CD.md)** - CI/CD 和自动化发布流程
 - **[docs/PATH_RESOLUTION.md](docs/PATH_RESOLUTION.md)** - 路径解析系统
 
-## 🔄 CI/CD
-
-基于 Conventional Commits 的完全自动化发布：
-
-```bash
-# 创建功能分支
-git checkout -b feat/awesome-feature
-
-# 提交代码
-git commit -m "feat: add awesome feature"
-
-# 创建 PR 并合并
-gh pr create && gh pr merge
-
-# 自动发布到 npm（版本：1.4.13 → 1.5.0）
-```
-
-**发布流程**：
-
-1. PR 合并 → 触发 Actions
-2. 分析 commits 确定版本号
-3. 发布到 npm
-4. 自动创建版本 PR 并合并
-5. 创建 GitHub Release
-
-详见: [docs/CI_CD.md](docs/CI_CD.md)
-
 ## 🤝 贡献
 
 欢迎贡献！请遵循：

package/dist/proxy.js

@@ -29137,7 +29137,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.24.7-beta.1" : "dev";
+var VERSION = true ? "1.24.7" : "dev";
 var LOCAL_PROXY_TAG = "local";
 var TapTapMCPProxy = class {
   constructor(config2) {
@@ -29213,6 +29213,9 @@ var TapTapMCPProxy = class {
     if (this.config.tenant.user_id) {
       this.log("info", `User ID: ${this.config.tenant.user_id}`);
     }
+    if (this.config.tenant.client_session_id) {
+      this.log("info", `Client Session ID: ${this.config.tenant.client_session_id}`);
+    }
     if (this.config.tenant.project_id) {
       this.log("info", `Project ID: ${this.config.tenant.project_id}`);
     }
@@ -29240,6 +29243,7 @@ var TapTapMCPProxy = class {
    *
    * Headers:
    * - X-TapTap-User-Id: 用户标识
+   * - X-TapTap-Client-Session-Id: 业务/编辑器会话标识
    * - X-TapTap-Project-Id: 项目标识
    * - X-TapTap-Project-Path: 项目路径
    * - X-TapTap-Mac-Token: MAC 认证令牌（JSON）
@@ -29252,6 +29256,9 @@ var TapTapMCPProxy = class {
     if (this.config.tenant.user_id) {
       headers["X-TapTap-User-Id"] = this.config.tenant.user_id;
     }
+    if (this.config.tenant.client_session_id) {
+      headers["X-TapTap-Client-Session-Id"] = this.config.tenant.client_session_id;
+    }
     if (this.config.tenant.project_id) {
       headers["X-TapTap-Project-Id"] = this.config.tenant.project_id;
     }
@@ -29273,6 +29280,7 @@ var TapTapMCPProxy = class {
    * 注入的参数（以下划线开头，表示私有）：
    * - _mac_token: MAC 认证令牌
    * - _user_id: 用户标识（可选）
+   * - _client_session_id: 业务/编辑器会话标识（可选）
    * - _project_id: 项目标识（可选）
    * - _project_path: 项目路径（可选）
    * - _custom_fields: 业务自定义字段（可选）
@@ -29285,6 +29293,9 @@ var TapTapMCPProxy = class {
     if (this.config.tenant.user_id) {
       injected._user_id = this.config.tenant.user_id;
     }
+    if (this.config.tenant.client_session_id) {
+      injected._client_session_id = this.config.tenant.client_session_id;
+    }
     if (this.config.tenant.project_id) {
       injected._project_id = this.config.tenant.project_id;
     }
@@ -29296,6 +29307,37 @@ var TapTapMCPProxy = class {
     }
     return injected;
   }
+  /**
+   * Restrict the proxied tool list to the configured public surface.
+   *
+   * The proxy does not wrap or rewrite upstream tool definitions. It only hides tools that are not
+   * included in options.exposed_tools. Omitting the option keeps the historical full passthrough.
+   */
+  filterListedTools(result) {
+    var _a3;
+    const exposedTools = (_a3 = this.config.options) == null ? void 0 : _a3.exposed_tools;
+    if (!exposedTools) {
+      return result;
+    }
+    const exposedToolNames = new Set(exposedTools);
+    return {
+      ...result,
+      tools: result.tools.filter((tool) => exposedToolNames.has(tool.name))
+    };
+  }
+  /**
+   * Prevent callers from invoking tools hidden from tools/list.
+   */
+  assertToolExposed(name) {
+    var _a3;
+    const exposedTools = (_a3 = this.config.options) == null ? void 0 : _a3.exposed_tools;
+    if (!exposedTools) {
+      return;
+    }
+    if (!exposedTools.includes(name)) {
+      throw new McpError(ErrorCode.MethodNotFound, `Tool is not exposed by this proxy: ${name}`);
+    }
+  }
   /**
    * 连接到 TapTap MCP Server
    */
@@ -29628,7 +29670,7 @@ var TapTapMCPProxy = class {
         );
       }
       const result = await this.client.listTools();
-      return result;
+      return this.filterListedTools(result);
     });
     this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
       if (!this.connected) {
@@ -29653,6 +29695,7 @@ var TapTapMCPProxy = class {
     this.server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
       var _a3, _b, _c, _d, _e, _f, _g;
       const { name, arguments: args } = request.params;
+      this.assertToolExposed(name);
       const shouldInjectParams = ((_a3 = this.config.options) == null ? void 0 : _a3.inject_params_per_call) ?? true;
       const finalArgs = shouldInjectParams ? this.injectPrivateParams(args) : args;
       if ((_b = this.config.options) == null ? void 0 : _b.verbose) {
@@ -29790,6 +29833,7 @@ Received: ${configJson.substring(0, 100)}...`
   return applyDefaults(config2);
 }
 function validateConfig(config2) {
+  var _a3;
   const errors = [];
   if (!config2.server) {
     errors.push("- Missing required field: server");
@@ -29804,6 +29848,9 @@ function validateConfig(config2) {
   if (!config2.tenant) {
     errors.push("- Missing required field: tenant");
   } else {
+    if (config2.tenant.client_session_id !== void 0 && typeof config2.tenant.client_session_id !== "string") {
+      errors.push("- tenant.client_session_id must be a string");
+    }
     if (config2.tenant.custom_fields !== void 0) {
       const cf = config2.tenant.custom_fields;
       if (typeof cf !== "object" || cf === null || Array.isArray(cf) || Object.getPrototypeOf(cf) !== Object.prototype) {
@@ -29829,13 +29876,21 @@ function validateConfig(config2) {
       errors.push('- Invalid auth.mac_algorithm: must be "hmac-sha-1"');
     }
   }
+  if (((_a3 = config2.options) == null ? void 0 : _a3.exposed_tools) !== void 0) {
+    const exposedTools = config2.options.exposed_tools;
+    if (!Array.isArray(exposedTools)) {
+      errors.push("- options.exposed_tools must be an array of tool names");
+    } else if (!exposedTools.every((toolName) => typeof toolName === "string" && toolName.trim().length > 0)) {
+      errors.push("- options.exposed_tools values must be non-empty strings");
+    }
+  }
   if (errors.length > 0) {
     throw new Error("Invalid configuration:\n" + errors.join("\n"));
   }
 }
 var DEFAULT_LOG_ROOT = "/tmp/taptap-mcp/logs";
 function applyDefaults(config2) {
-  var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
+  var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r;
   const verbose = ((_a3 = config2.options) == null ? void 0 : _a3.verbose) ?? false;
   return {
     server: {
@@ -29846,6 +29901,7 @@ function applyDefaults(config2) {
       project_path: config2.tenant.project_path || ".",
       user_id: config2.tenant.user_id,
       project_id: config2.tenant.project_id,
+      client_session_id: config2.tenant.client_session_id,
       custom_fields: config2.tenant.custom_fields
     },
     auth: config2.auth,
@@ -29860,12 +29916,13 @@ function applyDefaults(config2) {
       enable_cookie_sticky: ((_g = config2.options) == null ? void 0 : _g.enable_cookie_sticky) ?? true,
       inject_params_per_call: ((_h = config2.options) == null ? void 0 : _h.inject_params_per_call) ?? true,
       force_inject_progress_token: ((_i = config2.options) == null ? void 0 : _i.force_inject_progress_token) ?? false,
+      exposed_tools: (_j = config2.options) == null ? void 0 : _j.exposed_tools,
       log: {
-        root: ((_k = (_j = config2.options) == null ? void 0 : _j.log) == null ? void 0 : _k.root) ?? DEFAULT_LOG_ROOT,
-        enabled: ((_m = (_l = config2.options) == null ? void 0 : _l.log) == null ? void 0 : _m.enabled) ?? false,
+        root: ((_l = (_k = config2.options) == null ? void 0 : _k.log) == null ? void 0 : _l.root) ?? DEFAULT_LOG_ROOT,
+        enabled: ((_n = (_m = config2.options) == null ? void 0 : _m.log) == null ? void 0 : _n.enabled) ?? false,
         // verbose=true 时自动使用 debug 级别
-        level: verbose ? "debug" : ((_o = (_n = config2.options) == null ? void 0 : _n.log) == null ? void 0 : _o.level) ?? "info",
-        max_days: ((_q = (_p = config2.options) == null ? void 0 : _p.log) == null ? void 0 : _q.max_days) ?? 7
+        level: verbose ? "debug" : ((_p = (_o = config2.options) == null ? void 0 : _o.log) == null ? void 0 : _p.level) ?? "info",
+        max_days: ((_r = (_q = config2.options) == null ? void 0 : _q.log) == null ? void 0 : _r.max_days) ?? 7
       }
     }
   };