@taptap/instant-games-open-mcp 1.23.0 → 1.23.1

package/dist/maker.js

@@ -28711,6 +28711,14 @@ var DEV_KIT_IGNORE_BEGIN = "# >>> TapTap Maker AI dev kit (local only) >>>";
 var DEV_KIT_IGNORE_END = "# <<< TapTap Maker AI dev kit (local only) <<<";
 var DEV_KIT_GITIGNORE_STAGING_FILE = ".gitignore.dev-kit-before-clone";
 var DEV_KIT_REQUIRED_ENTRIES = ["CLAUDE.md", "examples", "templates", "urhox-libs"];
+var DEV_KIT_MANAGED_ENTRY_CANDIDATES = [
+  ".emmylua",
+  "CLAUDE.md",
+  "engine-docs",
+  "examples",
+  "templates",
+  "urhox-libs"
+];
 var SKIPPED_TOP_LEVEL_ENTRIES = /* @__PURE__ */ new Set(["scripts", ".DS_Store", "ai-dev-kit.zip"]);
 function inspectAiDevKit(targetDir) {
   const resolvedTargetDir = path4.resolve(targetDir);
@@ -28728,6 +28736,12 @@ function inspectAiDevKit(targetDir) {
     ready: missingEntries.length === 0
   };
 }
+function listPresentDevKitManagedEntries(targetDir) {
+  const resolvedTargetDir = path4.resolve(targetDir);
+  return DEV_KIT_MANAGED_ENTRY_CANDIDATES.filter(
+    (entry) => fs3.existsSync(path4.join(resolvedTargetDir, entry))
+  );
+}
 async function installAiDevKit(options = {}) {
   const targetDir = path4.resolve(options.targetDir || ".");
   fs3.mkdirSync(targetDir, { recursive: true });
@@ -28824,7 +28838,7 @@ async function downloadAndExtractDevKit(url2) {
 }
 function extractZip(zipPath, targetDir) {
   if (process.platform === "win32") {
-    const result2 = spawnSync2(
+    const result = spawnSync2(
       "powershell.exe",
       [
         "-NoProfile",
@@ -28838,15 +28852,52 @@ function extractZip(zipPath, targetDir) {
       ],
       { encoding: "utf8" }
     );
-    if (result2.status !== 0) {
-      throw new Error(`Failed to extract AI dev kit zip: ${result2.stderr || result2.stdout}`);
+    if (result.status !== 0) {
+      throw new Error(`Failed to extract AI dev kit zip: ${formatSpawnFailure(result)}`);
     }
     return;
   }
-  const result = spawnSync2("unzip", ["-q", zipPath, "-d", targetDir], { encoding: "utf8" });
-  if (result.status !== 0) {
-    throw new Error(`Failed to extract AI dev kit zip: ${result.stderr || result.stdout}`);
+  const unzipResult = spawnSync2("unzip", ["-q", zipPath, "-d", targetDir], { encoding: "utf8" });
+  if (unzipResult.status === 0) {
+    return;
+  }
+  const pythonFailures = [];
+  for (const pythonCommand of ["python3", "python"]) {
+    const pythonResult = spawnSync2(
+      pythonCommand,
+      ["-c", PYTHON_ZIP_EXTRACT_SCRIPT, zipPath, targetDir],
+      { encoding: "utf8" }
+    );
+    if (pythonResult.status === 0) {
+      return;
+    }
+    pythonFailures.push(`${pythonCommand}: ${formatSpawnFailure(pythonResult)}`);
   }
+  throw new Error(
+    [
+      `Failed to extract AI dev kit zip: unzip: ${formatSpawnFailure(unzipResult)}`,
+      ...pythonFailures
+    ].join("; ")
+  );
+}
+var PYTHON_ZIP_EXTRACT_SCRIPT = String.raw`
+import os
+import sys
+import zipfile
+
+zip_path = sys.argv[1]
+target_dir = os.path.abspath(sys.argv[2])
+
+with zipfile.ZipFile(zip_path) as archive:
+    for member in archive.infolist():
+        destination = os.path.abspath(os.path.join(target_dir, member.filename))
+        if os.path.commonpath([target_dir, destination]) != target_dir:
+            raise RuntimeError("Blocked unsafe zip entry: " + member.filename)
+    archive.extractall(target_dir)
+`;
+function formatSpawnFailure(result) {
+  var _a2;
+  return ((_a2 = result.error) == null ? void 0 : _a2.message) || String(result.stderr || "").trim() || String(result.stdout || "").trim() || `exit status ${result.status ?? "unknown"}`;
 }
 function resolveDevKitRoot(sourceDir) {
   const directEntries = fs3.existsSync(sourceDir) ? fs3.readdirSync(sourceDir) : [];
@@ -30031,14 +30082,14 @@ function getBundledSkillSourceDir(skillName) {
 }
 
 // src/maker/server/mcp.ts
-var VERSION = true ? "1.23.0" : "dev";
+var VERSION = true ? "1.23.1" : "dev";
 var DEFAULT_PROXY_PACKAGE = "@taptap/instant-games-open-mcp@1.22.0";
 var DEFAULT_BUILD_TIMEOUT_MS = 10 * 60 * 1e3;
 var LONG_OPERATION_HEARTBEAT_MS = 3 * 60 * 1e3;
 var tools = [
   {
     name: "maker_exchange_pat",
-    description: "Save a Maker PAT for local Maker API, Git, and TapTap token operations. After saving PAT, this tool fetches TapTap token and lists available Maker apps.",
+    description: "Save a Maker PAT for local Maker API, Git, and TapTap token operations. After saving PAT, this tool fetches TapTap token and returns a user-facing Maker app list. If the current directory is unbound, show every returned app entry to the user and ask them to choose; do not summarize the list as a count only.",
     inputSchema: {
       type: "object",
       properties: {
@@ -30052,7 +30103,7 @@ var tools = [
   },
   {
     name: "maker_list_apps",
-    description: "List Maker apps available to the cached or provided Maker PAT. Use this for unbound Maker directory initialization or explicit app-list requests. If maker_status already reports the current directory is bound, treat this list as reference only and do not ask which app to clone unless the user explicitly wants to switch or re-clone.",
+    description: "List Maker apps available to the cached or provided Maker PAT. Use this for unbound Maker directory initialization or explicit app-list requests. If the current directory is unbound, show every returned app entry to the user and ask them to choose; do not summarize the list as a count only. If maker_status already reports the current directory is bound, treat this list as reference only and do not ask which app to clone unless the user explicitly wants to switch or re-clone.",
     inputSchema: {
       type: "object",
       properties: {
@@ -30065,7 +30116,7 @@ var tools = [
   },
   {
     name: "maker_status",
-    description: "Show local Maker MCP status for the user current working directory: Git availability, PAT/TapTap token status, project binding, AI dev kit status, bundled skill document paths, validation checklist, and available apps when the current directory is unbound and PAT exists. If the MCP process cwd differs from the user current working directory, pass target_dir with the user current working directory.",
+    description: "Show local Maker MCP status for the user current working directory: Git availability, PAT/TapTap token status, project binding, AI dev kit status, bundled skill document paths, validation checklist, and available apps when the current directory is unbound and PAT exists. If the current directory is unbound and apps are returned, show every app entry to the user; do not summarize the list as a count only. If the MCP process cwd differs from the user current working directory, pass target_dir with the user current working directory.",
     inputSchema: {
       type: "object",
       properties: {
@@ -30238,7 +30289,12 @@ async function startMakerMcpServer() {
         let nextText;
         try {
           const projects = await listMakerProjects({ pat: args.manual_pat });
-          nextText = ["已自动列出可用 Maker Apps：", "", formatProjectList(projects)].join("\n");
+          nextText = [
+            "已自动列出可用 Maker Apps。",
+            "当前目录未绑定时，请逐项展示下面完整列表，不要只总结数量；然后让用户选择编号或 app_id。",
+            "",
+            formatProjectList(projects)
+          ].join("\n");
         } catch (error2) {
           nextText = [
             "自动列出 Maker Apps 失败。",
@@ -30290,7 +30346,16 @@ async function startMakerMcpServer() {
           "Maker clone"
         );
         let result;
-        let devKitResult;
+        let devKitResult = {
+          targetDir,
+          sourceDir: targetDir,
+          installedEntries: [],
+          skippedEntries: [],
+          gitignorePath: path7.join(targetDir, ".gitignore"),
+          stagedGitignorePath: path7.join(targetDir, DEV_KIT_GITIGNORE_STAGING_FILE)
+        };
+        let devKitState = "prepared";
+        let devKitError = "";
         let progressSummary;
         try {
           progressReporter.report({
@@ -30299,14 +30364,45 @@ async function startMakerMcpServer() {
             phase: "dev_kit",
             message: "Preparing local AI dev kit before Maker clone"
           });
-          devKitResult = await installAiDevKit({
-            targetDir
-          });
+          const devKitStatus = inspectAiDevKit(targetDir);
+          if (devKitStatus.ready) {
+            const presentManagedEntries = listPresentDevKitManagedEntries(targetDir);
+            writeDevKitStagedGitignore(
+              path7.join(targetDir, DEV_KIT_GITIGNORE_STAGING_FILE),
+              presentManagedEntries
+            );
+            devKitState = "already_ready";
+            devKitResult = {
+              targetDir,
+              sourceDir: targetDir,
+              installedEntries: presentManagedEntries,
+              skippedEntries: [],
+              gitignorePath: path7.join(targetDir, ".gitignore"),
+              stagedGitignorePath: path7.join(targetDir, DEV_KIT_GITIGNORE_STAGING_FILE)
+            };
+          } else {
+            try {
+              devKitResult = await installAiDevKit({
+                targetDir
+              });
+            } catch (error2) {
+              const presentManagedEntries = listPresentDevKitManagedEntries(targetDir);
+              if (presentManagedEntries.length > 0) {
+                writeDevKitStagedGitignore(
+                  path7.join(targetDir, DEV_KIT_GITIGNORE_STAGING_FILE),
+                  presentManagedEntries
+                );
+              }
+              devKitState = "failed_non_blocking";
+              devKitError = error2 instanceof Error ? error2.message : String(error2);
+              devKitResult.installedEntries = presentManagedEntries;
+            }
+          }
           progressReporter.report({
             progress: 5,
             total: 100,
             phase: "dev_kit",
-            message: "Local AI dev kit prepared"
+            message: devKitState === "failed_non_blocking" ? "Local AI dev kit preparation failed; continuing Maker clone" : "Local AI dev kit prepared"
           });
           result = await cloneMakerProject({
             appId: args.app_id,
@@ -30333,7 +30429,11 @@ async function startMakerMcpServer() {
                 `- target_dir: ${result.targetDir}`,
                 `- status: ${result.status}`,
                 `- retried_with_new_pat: ${result.retriedWithNewPat ? "yes" : "no"}`,
-                "- ai_dev_kit: prepared",
+                `- ai_dev_kit: ${devKitState}`,
+                ...devKitError ? [
+                  `- ai_dev_kit_error: ${devKitError}`,
+                  "- ai_dev_kit_next_step: run maker_status after clone to retry dev kit restoration"
+                ] : [],
                 `- ai_dev_kit_installed_entries: ${devKitResult.installedEntries.join(", ") || "(none)"}`,
                 `- ai_dev_kit_skipped_entries: ${devKitResult.skippedEntries.join(", ") || "(none)"}`,
                 ...formatProgressSummary(progressSummary),
@@ -30546,7 +30646,7 @@ async function formatAutoProjectListFromPat() {
     const projects = await listMakerProjects();
     return [
       "本地已有 Maker PAT，当前目录尚未绑定 Maker 项目。",
-      "当前目录未绑定时，可从下面的 Maker Apps 中选择一个进行 clone；选择、解释和 clone 顺序请参考 taptap-maker-local skill。",
+      "当前目录未绑定时，必须逐项展示下面完整 Maker Apps 列表，不要只总结数量；选择、解释和 clone 顺序请参考 taptap-maker-local skill。",
       "",
       formatProjectList(projects)
     ].join("\n");
@@ -30575,6 +30675,8 @@ function formatProjectList(projects) {
   return [
     "Maker apps",
     "",
+    "请把下面每一个 app 条目展示给用户，不要只说共有多少个。",
+    "",
     ...projects.map(
       (project, index) => `${index + 1}. ${project.id}${project.name ? `  ${project.name}` : ""}${project.user_id ? `  user_id=${project.user_id}` : ""}${project.gameType ? `  gameType=${project.gameType}` : ""}${project.stage ? `  stage=${project.stage}` : ""}${project.createdAt ? `  createdAt=${project.createdAt}` : ""}${project.lastConversationAt ? `  lastConversationAt=${project.lastConversationAt}` : ""}`
     ),

package/dist/proxy.js

@@ -29137,7 +29137,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.23.0" : "dev";
+var VERSION = true ? "1.23.1" : "dev";
 var TapTapMCPProxy = class {
   constructor(config2) {
     this.connected = false;

package/dist/server.js

@@ -6078,7 +6078,7 @@ class MultiplayerManager {
 // 导出
 // export default MultiplayerManager;
 // module.exports = MultiplayerManager;
-// window.MultiplayerManager = MultiplayerManager;`}]}}};var ws;ws="1.23.0";async function MRe(){return Go(Rm,"api_event_relations")}async function NRe(){return Go(Rm,"protocol_template")}async function SD(){return Go(Rm,"complete_example")}async function jRe(){return`# TapTap 多人联机集成指南
+// window.MultiplayerManager = MultiplayerManager;`}]}}};var ws;ws="1.23.1";async function MRe(){return Go(Rm,"api_event_relations")}async function NRe(){return Go(Rm,"protocol_template")}async function SD(){return Go(Rm,"complete_example")}async function jRe(){return`# TapTap 多人联机集成指南
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taptap/instant-games-open-mcp",
-  "version": "1.23.0",
+  "version": "1.23.1",
   "type": "module",
   "description": "TapTap Open API MCP Server - Documentation and Management APIs for TapTap Minigame and H5 Games (Leaderboard, and more features coming)",
   "main": "dist/server.js",

package/skills/taptap-maker-local/SKILL.md

@@ -94,8 +94,9 @@ Workflow:
    Do not run editor-specific CLI install commands.
 5. If PAT is missing, ask the user to open the PAT page shown by `maker_status`, create a PAT, and send it back.
 6. When the user provides PAT, call `maker_exchange_pat(manual_pat)`.
-7. If the current directory is still unbound, show the returned Maker app list and ask the user to
-   choose. Do not auto-select, even if there is only one app.
+7. If the current directory is still unbound, show every returned Maker app entry to the user and
+   ask the user to choose. Do not summarize the list as only a count, category, or stage. Do not
+   auto-select, even if there is only one app.
 8. Run the working directory compliance check below.
 9. After the user chooses an app, call `maker_clone_to_current_directory(app_id)`. The clone
    tool prepares the AI dev kit automatically before project checkout.
@@ -170,8 +171,9 @@ If the current directory is already bound, app lists from `maker_exchange_pat`,
 `maker_status` are reference only. Do not ask which app to clone. Continue operating on the current
 bound project unless the user explicitly requests a different project.
 
-When app selection is needed, display the app list and ask the user to choose by index, app id, or
-name.
+When app selection is needed, display every app entry from the tool result and ask the user to
+choose by index, app id, or name. Do not replace the list with a summary such as "10 apps are
+available".
 
 Do not auto-select:
 

package/skills/update-taptap-mcp/SKILL.md

@@ -104,7 +104,7 @@ Get-ChildItem $NpxDir -Directory -ErrorAction SilentlyContinue | ForEach-Object
 $env:TAPTAP_MCP_ENV = 'rnd'
 $log = Join-Path $env:TEMP 'taptap-mcp-warmup.log'
 $proc = Start-Process -FilePath npx `
-  -ArgumentList '-y','--prefer-online','-p','@taptap/instant-games-open-mcp@beta','taptap-maker' `
+  -ArgumentList '-y','-p','@taptap/instant-games-open-mcp@beta','taptap-maker' `
   -RedirectStandardOutput $log -RedirectStandardError "$log.err" `
   -WindowStyle Hidden -PassThru
 Start-Sleep -Seconds 25
@@ -189,7 +189,7 @@ done
 根据用户 MCP 配置选默认 bin 或指定 bin（`taptap-maker`）。下例以 `taptap-maker` 为例，默认 bin 去掉 `-p ... taptap-maker`，直接写 `@taptap/instant-games-open-mcp@beta`。
 
 ```bash
-TAPTAP_MCP_ENV=rnd npx -y --prefer-online -p @taptap/instant-games-open-mcp@beta taptap-maker \
+TAPTAP_MCP_ENV=rnd npx -y -p @taptap/instant-games-open-mcp@beta taptap-maker \
   < /dev/null > /tmp/taptap-mcp-warmup.log 2>&1 &
 PID=$!; sleep 25; kill $PID 2>/dev/null; wait 2>/dev/null
 ```