@taptap/instant-games-open-mcp 1.24.12 → 1.24.14

package/README.md

@@ -10,7 +10,8 @@
 - **📖 完整 API 文档** - 6 个排行榜 API + 详细代码示例
 - **⚙️ 服务端管理** - 创建/管理排行榜，自动处理 ID
 - **🎮 H5 游戏支持** - 上传、发布、状态查询
-- **📺 广告接入闭环** - 仅用于 TapTap 小游戏/H5，自动查询广告状态和广告位 ID，不与 Maker MCP 混用
+- **📺 广告接入闭环** - 仅用于 TapTap 小游戏/H5，自动查询广告状态和广告位 ID；方向缺失时先刷新
+  服务端应用信息，确认仍未设置后引导用户选择方向，不与 Maker MCP 混用
 - **🧭 当前游戏 DC 能力** - 商店/评价/社区统计概览、商店快照、论坛内容、评价列表、评价点赞、官方回复
 - **🦞 OpenClaw Plugin** - 提供一个原生 OpenClaw plugin 子包，内部复用 TapTap MCP 运行时并暴露 raw JSON 工具 + bundled skill
 - **🚀 三种传输模式** - stdio（本地）、SSE（远程/实时）、HTTP（兼容）
@@ -87,6 +88,11 @@ Node.js（包括 Windows 上未加入 PATH 的 `node.exe`），必要时才回
 /reload-plugins
 ```
 
+上述 marketplace 只用于从仓库源码验证。正式 WorkBuddy 市场发布 ZIP 直接以插件内容为根，
+不包含额外的 `taptap-maker/` 或 `plugins/workbuddy/taptap-maker/` 目录；根目录包含
+`.codebuddy-plugin/plugin.json`、`.mcp.json`、`README.md` 和 `SKILL.md`，所有文件的父目录深度
+最多为两层。普通用户通过 WorkBuddy 官方插件市场安装，不把发布 ZIP 当成本地 marketplace。
+
 WorkBuddy 旧独立 MCP 的迁移使用 `--client workbuddy`，只把旧注册的 `disabled` 设为 `true`，
 同时支持幂等检查和确认式恢复。插件更新通过 WorkBuddy `/plugin` 完成。
 
@@ -142,6 +148,7 @@ taptap-maker upgrade
 taptap-maker mcp verify
 npx -y --package @taptap/maker@<exact-version> taptap-maker mcp report --ide <client> --target-dir <project> --context-stdin --consent --json
 taptap-maker dev-kit update
+taptap-maker user-skills pull --target-dir <project>
 ```
 
 普通初始化、clone、下载或拉取远端项目的标准命令是 `taptap-maker init`，CLI 会展示 app 列表，
@@ -216,6 +223,11 @@ MCP 进程自身的 cwd 只作为最后兜底和诊断信息，不应通过重
 和 `taptap-maker doctor` 会检查老项目 `AGENTS.md` 是否缺失或过期，并提示运行
 `taptap-maker agents update` 或 `taptap-maker upgrade`。
 `taptap-maker dev-kit update` 会检查当前环境可用的最新 AI dev kit 并更新当前目录。
+`taptap-maker user-skills pull` 是可选的边缘命令，仅在用户明确要求时从 Maker Server 下载个人
+Skill，并覆盖项目 `.installer/skills/` 中 ZIP 包含的同名目录，再以原始 Skill 名称安装到项目内
+`.codex/skills/`、`.cursor/skills/` 和 `.workbuddy/skills/`；其它本地 Skill 保持不变。
+归档下载限制为 64 MiB，最多 1000 个条目、解压后最多 128 MiB。
+该命令不属于正常开发或初始化流程，也不会增加 MCP tool。
 
 如果 Maker MCP tools 缺失或出现 `-32000` / `Connection closed`，先按
 [TapTap Maker MCP 本地连接自检与修复指引](docs/MAKER_MCP_CONNECTION_TROUBLESHOOTING.md)
@@ -253,9 +265,10 @@ Maker MCP 初始化时会通过标准 `initialize.instructions` 向 AI 客户端
 检查实现”不应自动触发 Maker 远端构建，除非用户明确要求构建、运行或预览 Maker 游戏。
 普通构建会先 push 到 Maker 远端再触发远端 build：本地有改动时提交改动，已有未推送 commit 时
 直接 push，本地干净且没有未推送 commit 时创建 `chore: wake maker build server` 空提交来唤醒远端
-服务。push 失败时不会继续 build，会返回本地 commit、ahead 状态、stderr/stdout 和下一步建议，
-交给本地 Agent/skill 处理 pull、rebase 或冲突；push 成功但 build 失败时，会明确说明代码已到
-Maker 远端但构建失败。只有用户明确说“不提交，只构建云端版本”时，才传
+服务。提交前如果本地仅落后于 Maker 远端，会自动执行 fast-forward 后继续提交；如果远端更新会
+覆盖本地未提交修改，则会在创建 commit 前停止并保留本地文件。分叉、非 `main`、鉴权或网络失败仍
+按原有提示处理。push 成功但 build 失败时，会明确说明代码已到 Maker 远端但构建失败。只有用户明确
+说“不提交，只构建云端版本”时，才传
 `confirm_remote_build_without_submit=true`；该模式只构建 Maker 远端已提交版本，不会自动打开
 Maker 页面。
 
@@ -468,7 +481,7 @@ curl http://localhost:5002/health  # RND
 #### H5 游戏管理 (3)
 
 - `prepare_h5_upload` - 收集 H5 游戏信息（上传前）
-- `upload_h5_game` - 上传 H5 游戏包
+- `upload_h5_game` - 上传 H5 游戏包；首次上传未设置横竖屏时暂停并要求用户选择，提交后校验服务端方向
 - `get_debug_feedbacks` - 拉取用户调试反馈并下载日志/截图
 
 #### 振动 API 文档 (1)
@@ -567,6 +580,10 @@ maker_build_current_directory
 远端 proxy tools 使用版本化的本地完整定义在首次 `tools/list` 时立即注册，不等待 cwd、Maker 项目绑定、
 PAT/TapTap token 或远端 proxy 连接。项目定位和鉴权只在实际调用 tool 时校验；远端 schema 不会在运行时
 替换本地定义。schema 变更通过本地 MCP 版本更新发布，远端不可用不会让 proxy tools 从当前会话消失。
+唯一例外是 Maker Server 明确返回 `BLACKLISTED` 的账号：MCP 每个进程启动时只检查一次账号状态，
+`tools/list` 只保留 `maker_status_lite`，任何 tool call 和 `maker://status` 都直接返回限制提示，不进入
+本地构建或远端 proxy。PAT 缺失、过期、网络超时和其它非黑名单错误不会隐藏工具；账号状态变化需要
+重连或重启 MCP 后生效。
 Maker 内嵌代理不打开可选的 standalone SSE GET，远端 RPC 响应和构建进度统一通过 POST SSE 返回；
 这避免 Node.js 26 中长连接占用后续 `tools/list` 请求而触发固定 60 秒超时。普通 MCP Proxy 默认仍保留
 standalone SSE，只有显式设置 `disable_standalone_sse` 才会关闭。
@@ -739,7 +756,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/PROXY.md](docs/PROXY.md)** - MCP Proxy 开发指南（面向 TapCode 等平台）。
+  通用 Proxy 默认不添加 `local` 来源标记；本地 Maker 嵌入入口显式启用，服务端无需修改配置。
 - **[docs/PATH_RESOLUTION.md](docs/PATH_RESOLUTION.md)** - 路径解析系统
 
 ## Maker 持久化 Proxy 与多项目

package/dist/proxy.js

@@ -29151,7 +29151,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/config.ts
-var DEFAULT_TOOL_CALL_TIMEOUT_MS = 60 * 60 * 1e3;
+var DEFAULT_TOOL_CALL_TIMEOUT_MS = 5 * 60 * 1e3;
 function readStdin() {
   return new Promise((resolve, reject) => {
     const chunks = [];
@@ -29306,8 +29306,7 @@ function applyDefaults(config2) {
 }
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.24.12" : "dev";
-var LOCAL_PROXY_TAG = "local";
+var VERSION = true ? "1.24.14" : "dev";
 var DEFAULT_RECONNECT_INTERVAL_MS = 5e3;
 var MAX_RECONNECT_INTERVAL_MS = 60 * 1e3;
 function createNonReplayableToolResult(name, executionState) {
@@ -29369,20 +29368,23 @@ function isHttpClientError(error2) {
   return numericCode !== void 0 && numericCode >= 400 && numericCode < 500 || /\bHTTP\s+4\d\d\b/i.test(error2.message);
 }
 var TapTapMCPProxy = class {
-  constructor(config2) {
+  constructor(config2, runtimeOptions = {}) {
     this.connected = false;
     this.reconnecting = false;
     this.reconnectTimer = null;
     this.healthCheckTimer = null;
     this.pendingRequests = [];
-    this.reconnectDelayMs = DEFAULT_RECONNECT_INTERVAL_MS;
     // 会话验证相关
     this.sessionValidated = false;
     this.lastValidationTime = 0;
     this.SESSION_VALIDATION_INTERVAL = 3e4;
-    var _a3;
+    var _a3, _b;
     this.config = config2;
-    this.cookieJar = new CookieJar(((_a3 = config2.options) == null ? void 0 : _a3.verbose) ?? false);
+    this.sourceTag = runtimeOptions.sourceTag;
+    this.remoteErrorMode = runtimeOptions.remoteErrorMode ?? "passthrough";
+    this.recoveryMode = runtimeOptions.recoveryMode ?? "compatible";
+    this.reconnectDelayMs = ((_a3 = config2.options) == null ? void 0 : _a3.reconnect_interval) ?? DEFAULT_RECONNECT_INTERVAL_MS;
+    this.cookieJar = new CookieJar(((_b = config2.options) == null ? void 0 : _b.verbose) ?? false);
     this.logWriter = this.createLogWriter();
     this.client = this.createClient();
     this.server = new Server(
@@ -29480,11 +29482,13 @@ var TapTapMCPProxy = class {
    * - X-TapTap-Project-Path: 项目路径
    * - X-TapTap-Mac-Token: MAC 认证令牌（JSON）
    * - X-TapTap-Custom-Fields: 业务自定义字段（JSON）
-   * - X-TapTap-Tag: 调用来源标记，固定为 "local"
+   * - X-TapTap-Tag: 调用来源标记，仅在嵌入入口显式启用时发送
    */
   buildSessionHeaders() {
     const headers = {};
-    headers["X-TapTap-Tag"] = LOCAL_PROXY_TAG;
+    if (this.sourceTag !== void 0) {
+      headers["X-TapTap-Tag"] = this.sourceTag;
+    }
     if (this.config.tenant.user_id) {
       headers["X-TapTap-User-Id"] = this.config.tenant.user_id;
     }
@@ -29512,12 +29516,14 @@ var TapTapMCPProxy = class {
    * - _project_id: 项目标识（可选）
    * - _project_path: 项目路径（可选）
    * - _custom_fields: 业务自定义字段（可选）
-   * - _tag: 调用来源标记，固定为 "local"
+   * - _tag: 调用来源标记，仅在嵌入入口显式启用时注入
    */
   injectPrivateParams(args) {
     const injected = { ...args || {} };
     injected._mac_token = this.config.auth;
-    injected._tag = LOCAL_PROXY_TAG;
+    if (this.sourceTag !== void 0) {
+      injected._tag = this.sourceTag;
+    }
     if (this.config.tenant.user_id) {
       injected._user_id = this.config.tenant.user_id;
     }
@@ -29568,6 +29574,18 @@ var TapTapMCPProxy = class {
     const replayableTools = (_a3 = this.config.options) == null ? void 0 : _a3.replayable_tools;
     return replayableTools === void 0 || replayableTools.includes(name);
   }
+  toolErrorResult(error2) {
+    return this.remoteErrorMode === "tool-result" ? convertMcpApplicationErrorToToolResult(error2) : void 0;
+  }
+  shouldReplayToolFailure(name, error2) {
+    if (!this.isToolReplayable(name) || !(error2 instanceof Error)) return false;
+    if (this.recoveryMode === "resilient") return true;
+    if (this.isSessionInvalidError(error2) || error2.message.toLowerCase().includes("not connected")) {
+      return true;
+    }
+    const code = error2.code;
+    return !isTransientHttpServerError(error2) && code !== ErrorCode.ConnectionClosed && code !== ErrorCode.RequestTimeout;
+  }
   /**
    * 连接到 TapTap MCP Server
    */
@@ -29604,8 +29622,13 @@ var TapTapMCPProxy = class {
       this.log("info", "✅ Connected and session validated");
       this.startHealthCheck();
       if (this.reconnecting) {
+        if (this.recoveryMode === "compatible") {
+          await this.notifyReconnected();
+        }
         await this.processPendingRequests();
-        await this.notifyReconnected();
+        if (this.recoveryMode === "resilient") {
+          await this.notifyReconnected();
+        }
         this.reconnecting = false;
       }
     } catch (error2) {
@@ -29760,15 +29783,17 @@ var TapTapMCPProxy = class {
     var _a3, _b, _c;
     this.clearReconnectTimer();
     const configuredInterval = ((_a3 = this.config.options) == null ? void 0 : _a3.reconnect_interval) ?? DEFAULT_RECONNECT_INTERVAL_MS;
-    const interval = this.reconnectDelayMs || configuredInterval;
+    const interval = this.recoveryMode === "resilient" ? this.reconnectDelayMs : configuredInterval;
     this.reconnectTimer = setTimeout(() => {
       this.reconnectToServer();
     }, interval);
     (_c = (_b = this.reconnectTimer).unref) == null ? void 0 : _c.call(_b);
-    this.reconnectDelayMs = Math.min(
-      Math.max(interval * 2, configuredInterval),
-      MAX_RECONNECT_INTERVAL_MS
-    );
+    if (this.recoveryMode === "resilient") {
+      this.reconnectDelayMs = Math.min(
+        Math.max(interval * 2, configuredInterval),
+        Math.max(MAX_RECONNECT_INTERVAL_MS, configuredInterval)
+      );
+    }
   }
   /**
    * 清除重连定时器
@@ -29809,15 +29834,18 @@ var TapTapMCPProxy = class {
    * 检测是否是需要重连的错误（网络错误或会话无效）
    */
   isNetworkError(error2) {
+    var _a3;
     if (!(error2 instanceof Error)) return false;
     if (convertMcpApplicationErrorToToolResult(error2)) {
       return false;
     }
     if (isHttpClientError(error2)) {
-      return false;
-    }
-    if (isTransientHttpServerError(error2)) {
-      return true;
+      if (this.isMcpApplicationError(error2)) {
+        return false;
+      }
+      const code = error2.code;
+      const status = typeof code === "number" && code >= 400 && code < 500 ? code : typeof code === "string" && /^4\d\d$/.test(code) ? Number(code) : Number((_a3 = error2.message.match(/\bHTTP\s+(4\d\d)\b/i)) == null ? void 0 : _a3[1]);
+      return (status === 400 || status === 404) && this.isSessionInvalidError(error2);
     }
     const errorMsg = error2.message.toLowerCase();
     const errorCode = error2.code;
@@ -29845,11 +29873,14 @@ var TapTapMCPProxy = class {
     if (errorCode === ErrorCode.ConnectionClosed || errorCode === ErrorCode.RequestTimeout) {
       return true;
     }
+    if (this.isMcpApplicationError(error2)) {
+      return false;
+    }
     if (errorMsg.includes("not connected") || this.isSessionInvalidError(error2)) {
       return true;
     }
-    if (this.isMcpApplicationError(error2)) {
-      return false;
+    if (isTransientHttpServerError(error2)) {
+      return true;
     }
     const networkErrorKeywords = [
       "fetch failed",
@@ -29876,7 +29907,6 @@ var TapTapMCPProxy = class {
   async processPendingRequests() {
     var _a3, _b, _c;
     const timeout = ((_a3 = this.config.options) == null ? void 0 : _a3.request_timeout) ?? 3e4;
-    const now = Date.now();
     this.log("info", `Processing ${this.pendingRequests.length} pending requests...`);
     while (this.pendingRequests.length > 0) {
       const req = this.pendingRequests.shift();
@@ -29884,7 +29914,7 @@ var TapTapMCPProxy = class {
         req.resolve(createNonReplayableToolResult(req.name, req.executionState ?? "unknown"));
         continue;
       }
-      if (now - req.timestamp > timeout) {
+      if (Date.now() - req.timestamp > timeout) {
         req.reject(new Error("Request timeout while waiting for reconnection"));
         continue;
       }
@@ -29904,7 +29934,7 @@ var TapTapMCPProxy = class {
         );
         req.resolve(result);
       } catch (error2) {
-        const toolErrorResult = convertMcpApplicationErrorToToolResult(error2);
+        const toolErrorResult = this.toolErrorResult(error2);
         if (toolErrorResult) {
           req.resolve(toolErrorResult);
           continue;
@@ -29912,7 +29942,11 @@ var TapTapMCPProxy = class {
         if (this.isNetworkError(error2)) {
           this.connected = false;
           this.sessionValidated = false;
-          this.pendingRequests.unshift(req);
+          if (this.recoveryMode === "resilient") {
+            this.pendingRequests.unshift(req);
+          } else {
+            req.reject(error2);
+          }
           throw error2;
         }
         req.reject(error2 instanceof Error ? error2 : new Error(String(error2)));
@@ -30051,19 +30085,23 @@ var TapTapMCPProxy = class {
         );
         return result;
       } catch (error2) {
-        const toolErrorResult = convertMcpApplicationErrorToToolResult(error2);
+        const toolErrorResult = this.toolErrorResult(error2);
         if (toolErrorResult) {
           return toolErrorResult;
         }
         if (this.isNetworkError(error2)) {
           this.log("error", "❌ Network error detected, marking connection as lost");
           this.connected = false;
+          this.sessionValidated = false;
           if (!this.reconnecting) {
             this.log("info", "Triggering immediate reconnection...");
             this.reconnectToServer();
             if (!this.isToolReplayable(name)) {
               return createNonReplayableToolResult(name, "unknown");
             }
+            if (!this.shouldReplayToolFailure(name, error2)) {
+              throw error2;
+            }
             this.log("info", `⏳ Queueing current request: ${name}`);
             return new Promise((resolve, reject) => {
               this.pendingRequests.push({