@taptap/instant-games-open-mcp 1.22.0-beta.6 → 1.22.0-beta.7

package/README.md

@@ -66,6 +66,7 @@ maker_push_current_directory
 说明：
 
 - Maker MCP 依赖用户本机已有 Git。工具只检测并给出安装引导，不会代替用户安装 Git。
+- 用户说“更新 mcp / 更新 taptap mcp / 刷新 mcp 缓存 / tap mcp 有新版本”时，应调用 `maker_get_mcp_update_guide`。该工具只返回 Windows 或 macOS/Linux 的更新引导、安装检查、配置位置提醒和重启提示，不直接执行更新命令；由用户本地 AI 客户端按返回命令操作。
 - 用户说“我要开发maker游戏 / 本地maker开发 / 拉取maker游戏到本地 / 把maker游戏代码拉到本地 / clone maker项目 / 下载maker游戏代码 / 初始化maker开发目录 / 配置maker本地开发 / 继续开发maker项目”时，应触发 Maker 本地开发初始化流程。
 - 如果 `maker_status` 或 `maker_check_environment` 显示 Git 缺失，必须持续提示用户自行安装 Git；在 `git --version` 可用前，不执行 clone、fetch、commit 或 push。
 - Maker API、git 和 TapTap token 默认走 PAT-first：如果用户还没有 PAT，引导用户打开临时 PAT 页面 `https://fuping.agnt.xd.com/pat-tokens` 新建 PAT；用户提供 PAT 后调用 `maker_exchange_pat(manual_pat)` 保存。
@@ -79,10 +80,17 @@ maker_push_current_directory
 - JWT 仅作为 legacy fallback 保留：`maker_exchange_jwt(manual_jwt)`、`JWT` / `MAKER_JWT` 仍可用于旧后端或创建新 PAT。
 - Maker app 必须先通过 `maker_list_apps` 展示给用户选择，再调用 clone。
 - Maker 后端地址按 `TAPTAP_MCP_ENV` 从 `src/maker/config.ts` 的环境配置表读取，本地 MCP 配置只需要切 `rnd` / `production`。
-- 如果用户直接说“构建 / build / 重新构建游戏”，本地 Maker MCP 应调用 `maker_build_current_directory` 转发到远端 `build` tool。
+- 如果用户直接说“构建 / build / 重新构建游戏”，本地 Maker MCP 应调用 `maker_build_current_directory`。该工具会强制检查本地 Maker 项目是否有未提交改动。
+- 如果构建前发现本地有改动且尚未保存自动提交偏好，工具会停止并提示用户选择：`提交本地改动并触发构建（以后都是如此）`，或明确不提交、只构建云端已有版本。
+- 用户选择 `提交本地改动并触发构建（以后都是如此）` 后，应调用 `maker_submit_current_directory` 并传入 `remember_build_submit_preference=true`；提交成功后会在当前项目 `.maker-mcp/config.json` 记住偏好。
+- 保存偏好后，后续用户说“构建”且本地有改动时，`maker_build_current_directory` 会默认自动提交并依赖 Maker 自动构建，不再重复询问。
+- 只有当用户明确说“不提交 / 直接构建云端版本”时，才可再次调用 `maker_build_current_directory` 并传入 `confirm_remote_build_without_submit=true`。
+- 用户说“查看结果 / 预览 / 跑一下 / 验证一下 / 看看效果”时，也按构建流程处理；如果本地有改动，先提醒提交后自动构建。
 - 构建转发会从 MCP 包自身定位 `dist/proxy.js`；`cwd` / `target_dir` 只用于识别 Maker 游戏项目，不要求游戏目录存在 MCP 的 `dist/proxy.js`。
+- 用户未指定构建入口且本地存在 `scripts/main.lua` 时，Maker MCP 默认向远端 build 传 `scriptsPath="scripts"` 和 `entry="main.lua"`，避免第一次构建多一轮“入口配置缺失”的提示；用户显式传入口或多人入口时优先生效。
 - 如需在当前游戏项目里直接暴露远端全量 `taptap-proxy` tools，再使用 `maker_configure_remote_proxy` 写入 `.mcp.json` 并重启 MCP 会话。
-- 用户说“帮我提交/提交代码”时使用 `maker_submit_current_directory`，会对当前 Maker 项目执行 commit + push。
+- `maker_get_mcp_update_guide` 默认生成 `@taptap/instant-games-open-mcp@beta` 和 `taptap-maker` 的 npx 缓存更新步骤；更新后当前 MCP 会话通常不会热加载，必须重启 MCP 客户端或新开 Claude Code / Codex / Cursor 窗口，再调用 `maker_status` 验证。
+- 用户说“帮我提交/提交代码”时使用 `maker_submit_current_directory`，会对当前 Maker 项目执行 commit + push；Maker 提交成功后会自动触发构建，不需要再手动调用构建工具。
 - “帮我提交代码到maker / taptap制造 / tap制造 / tap”也应触发 `maker_submit_current_directory`。
 - Maker 项目提交不走通用 Git skill 的任务号、新分支规则；冲突时先和用户确认 pull/rebase 流程。
 - 如果 commit 已完成但 push 失败，Maker MCP 会返回 commit hash、ahead 状态、exit code、stderr/stdout 和下一步建议，便于开发期排查。

package/dist/maker.js

@@ -25751,7 +25751,7 @@ function requireMakerJwt(manualJwt) {
 var BUILT_IN_MAKER_CLIENT_ID = "m2dnabebip3fpardnm";
 var MAKER_CLIENT_ID_ENV = "TAPTAP_MAKER_CLIENT_ID";
 var TAPTAP_CLIENT_ID_ENV = "TAPTAP_MCP_CLIENT_ID";
-var MAKER_VERSION = true ? "1.22.0-beta.6" : "dev";
+var MAKER_VERSION = true ? "1.22.0-beta.7" : "dev";
 async function startTapDeviceLogin() {
   ensureMakerClientId();
   const environment = EnvConfig.environment;
@@ -26595,6 +26595,30 @@ async function pushMakerProject(options) {
     status: "pushed"
   };
 }
+async function readMakerProjectLocalChanges(cwd) {
+  ensureGitAvailable();
+  const requestedDir = path6.resolve(cwd);
+  if (!isGitRepo(requestedDir)) {
+    throw new Error(`${requestedDir} is not a git repository.`);
+  }
+  const projectRoot = (await readGit(["rev-parse", "--show-toplevel"], requestedDir)).trim();
+  const configPath = path6.join(projectRoot, ".maker-mcp", "config.json");
+  if (!fs4.existsSync(configPath)) {
+    throw new Error(
+      `${projectRoot} is not bound to a Maker project. .maker-mcp/config.json is missing.`
+    );
+  }
+  const rawStatus = await readGit(["status", "--porcelain", "-z"], projectRoot);
+  const files = parseGitStatusFiles(rawStatus).filter(
+    (file2) => file2 !== ".maker-mcp" && !file2.startsWith(".maker-mcp/")
+  );
+  return {
+    hasChanges: files.length > 0,
+    projectRoot,
+    files,
+    rawStatus
+  };
+}
 function ensureTargetCanBindApp(target, appId) {
   const existingConfig = loadProjectConfig(target);
   if (!(existingConfig == null ? void 0 : existingConfig.project_id) || existingConfig.project_id === appId) {
@@ -26625,6 +26649,22 @@ function generateCommitMessage(status) {
   }
   return "chore: update maker project";
 }
+function parseGitStatusFiles(status) {
+  const entries = status.split("\0").filter(Boolean);
+  const files = [];
+  for (let index = 0; index < entries.length; index += 1) {
+    const entry = entries[index];
+    const statusCode = entry.slice(0, 2);
+    const file2 = entry.slice(3);
+    if (file2) {
+      files.push(file2);
+    }
+    if (statusCode.includes("R") || statusCode.includes("C")) {
+      index += 1;
+    }
+  }
+  return files;
+}
 async function readAheadState(cwd) {
   var _a2;
   try {
@@ -42380,8 +42420,257 @@ function isElectron() {
   return "type" in process6;
 }
 
+// src/maker/system/updateGuide.ts
+var DEFAULT_PACKAGE_SPEC = "@taptap/instant-games-open-mcp@beta";
+var DEFAULT_BIN = "taptap-maker";
+var UPDATE_BINS = [
+  "taptap-maker",
+  "instant-games-open-mcp",
+  "taptap-mcp-proxy"
+];
+function createMakerMcpUpdateGuide(options = {}) {
+  const platform = options.platform || process.platform;
+  const packageSpec = options.packageSpec || DEFAULT_PACKAGE_SPEC;
+  const bin = isMakerMcpUpdateBin(options.bin) ? options.bin : DEFAULT_BIN;
+  const client = options.client || "unknown";
+  const isWindows = platform === "win32";
+  return [
+    "TapTap Maker MCP update guide",
+    "",
+    `- platform: ${isWindows ? "Windows PowerShell" : "macOS / Linux"}`,
+    `- client: ${client}`,
+    `- package: ${packageSpec}`,
+    `- bin: ${bin}`,
+    "",
+    "Important",
+    "",
+    "- 本工具不会直接执行更新命令，只返回适合当前平台的更新引导。",
+    "- 请由当前本地 AI 客户端在用户机器的 shell 中执行下列命令。",
+    "- 推荐把 Maker MCP 安装到 user/global scope，不建议放在当前项目目录或仓库级配置。",
+    "- 如果现在是 project/local scope，也可以继续更新；后续可让 Claude Code / Codex / Cursor 迁移到 user/global scope。",
+    "- 更新 npx 缓存后，当前 MCP 会话通常不会热加载；请重启 MCP 客户端，或新开 Claude Code / Codex / Cursor 窗口。",
+    "- 重启后调用 maker_status，确认新 MCP 已生效。",
+    "",
+    isWindows ? createWindowsGuide(packageSpec, bin) : createPosixGuide(packageSpec, bin)
+  ].join("\n");
+}
+function createWindowsGuide(packageSpec, bin) {
+  return [
+    "Windows PowerShell",
+    "",
+    "Step 0: 安装检查和配置位置提醒",
+    "",
+    "```powershell",
+    "node --version",
+    "npm --version",
+    "npx --version",
+    "",
+    "# 1. 项目级 .mcp.json（Claude Code / Codex 都可能读取）",
+    "if (Test-Path .mcp.json) {",
+    "  if (Select-String -Path .mcp.json -Pattern 'taptap|instant-games-open-mcp|taptap-maker' -Quiet) {",
+    '    Write-Host "ℹ️  当前目录 .mcp.json 包含 TapTap MCP。更新可以继续；建议后续迁移到 user/global scope。"',
+    "  }",
+    "}",
+    "",
+    "# 2. Claude Code user/project scope",
+    '$cj = "$env:USERPROFILE\\.claude.json"',
+    "if (Test-Path $cj) {",
+    "  $json = Get-Content $cj -Raw | ConvertFrom-Json",
+    "  if ($json.mcpServers) {",
+    "    $json.mcpServers.PSObject.Properties | Where-Object { $_.Name -match 'taptap' } | ForEach-Object {",
+    '      Write-Host "✅ Claude Code user scope 已安装：$($_.Name)"',
+    "    }",
+    "  }",
+    "  if ($json.projects) {",
+    "    $json.projects.PSObject.Properties | ForEach-Object {",
+    "      $projectPath = $_.Name",
+    "      $servers = $_.Value.mcpServers",
+    "      if ($servers) {",
+    "        $servers.PSObject.Properties | Where-Object { $_.Name -match 'taptap' } | ForEach-Object {",
+    '          Write-Host "ℹ️  Claude Code project scope TapTap MCP：$($_.Name) under $projectPath。建议后续迁移到 user/global scope。"',
+    "        }",
+    "      }",
+    "    }",
+    "  }",
+    "}",
+    "",
+    "# 3. 常见项目级 MCP / AI 客户端配置。只查已知路径，避免扫到源码或游戏资源。",
+    "$projectConfigPaths = @('.codex\\config.toml', '.codex\\mcp.json', '.cursor\\mcp.json', '.vscode\\mcp.json', 'codex.toml')",
+    "foreach ($f in $projectConfigPaths) {",
+    "  if ((Test-Path $f) -and (Select-String -Path $f -Pattern 'taptap|instant-games-open-mcp|taptap-maker' -Quiet)) {",
+    '    Write-Host "ℹ️  $f 包含 TapTap MCP。更新可以继续；建议后续迁移到 user/global scope。"',
+    "  }",
+    "}",
+    "```",
+    "",
+    "Step 1: 对比远端和本地 npx 缓存版本",
+    "",
+    "```powershell",
+    `npm view ${quotePowerShell(packageSpec)} version`,
+    "$NpxDir = Join-Path (npm config get cache) '_npx'",
+    "$LocalVersions = @()",
+    "Get-ChildItem $NpxDir -Directory -ErrorAction SilentlyContinue | ForEach-Object {",
+    "  $p = Join-Path $_.FullName 'node_modules\\@taptap\\instant-games-open-mcp\\package.json'",
+    "  if (Test-Path $p) {",
+    "    $version = (Get-Content $p -Raw | ConvertFrom-Json).version",
+    '    $LocalVersions += "$($_.Name) -> $version"',
+    "  }",
+    "}",
+    "$LocalVersions",
+    "```",
+    "",
+    "如果远端和本地版本已经一致，可以结束更新缓存流程，但仍建议重启或新开窗口确认。",
+    "",
+    "Step 2: 清理 TapTap MCP 的 npx 缓存",
+    "",
+    "```powershell",
+    "$NpxDir = Join-Path (npm config get cache) '_npx'",
+    "Get-ChildItem $NpxDir -Directory -ErrorAction SilentlyContinue | ForEach-Object {",
+    "  if (Test-Path (Join-Path $_.FullName 'node_modules\\@taptap\\instant-games-open-mcp')) {",
+    "    Remove-Item -Recurse -Force $_.FullName",
+    "  }",
+    "}",
+    "```",
+    "",
+    "Step 3: 预热下载新版本",
+    "",
+    "```powershell",
+    "$env:TAPTAP_MCP_ENV = 'rnd'",
+    "$log = Join-Path $env:TEMP 'taptap-mcp-warmup.log'",
+    "$proc = Start-Process -FilePath npx `",
+    `  -ArgumentList ${formatPowerShellArgumentList(createNpxWarmupArgs(packageSpec, bin))} \``,
+    '  -RedirectStandardOutput $log -RedirectStandardError "$log.err" `',
+    "  -WindowStyle Hidden -PassThru",
+    "Start-Sleep -Seconds 25",
+    "Stop-Process -Id $proc.Id -Force -ErrorAction SilentlyContinue",
+    "```",
+    "",
+    "Step 4: 验证缓存版本",
+    "",
+    "```powershell",
+    "$NpxDir = Join-Path (npm config get cache) '_npx'",
+    "Get-ChildItem $NpxDir -Directory -ErrorAction SilentlyContinue | ForEach-Object {",
+    "  $p = Join-Path $_.FullName 'node_modules\\@taptap\\instant-games-open-mcp\\package.json'",
+    '  if (Test-Path $p) { "$($_.Name) -> $((Get-Content $p -Raw | ConvertFrom-Json).version)" }',
+    "}",
+    "```",
+    "",
+    "Step 5: 生效方式",
+    "",
+    "请重启 MCP 客户端，或新开 Claude Code / Codex / Cursor 窗口。当前会话通常不会热加载新 MCP；重启后调用 maker_status 验证。"
+  ].join("\n");
+}
+function createPosixGuide(packageSpec, bin) {
+  return [
+    "macOS / Linux",
+    "",
+    "Step 0: 安装检查和配置位置提醒",
+    "",
+    "```bash",
+    "node --version",
+    "npm --version",
+    "npx --version",
+    "",
+    "# 1. 项目级 .mcp.json",
+    '[ -f .mcp.json ] && grep -qiE "taptap|instant-games-open-mcp|taptap-maker" .mcp.json && \\',
+    '  echo "ℹ️  当前目录 .mcp.json 包含 TapTap MCP。更新可以继续；建议后续迁移到 user/global scope。"',
+    "",
+    "# 2. Claude Code user/project scope。没有 jq 时跳过，不阻塞更新。",
+    'CJ="$HOME/.claude.json"',
+    'if [ -f "$CJ" ] && command -v jq >/dev/null 2>&1; then',
+    "  jq -r '",
+    "    .mcpServers // {} | to_entries[]",
+    '    | select(.key | test("taptap"; "i"))',
+    '    | "✅ Claude Code user scope 已安装: \\(.key)"',
+    `  ' "$CJ"`,
+    "  jq -r '",
+    "    .projects // {} | to_entries[]",
+    "    | . as $p | $p.value.mcpServers // {} | to_entries[]",
+    '    | select(.key | test("taptap"; "i"))',
+    '    | "ℹ️  Claude Code project scope TapTap MCP: \\($p.key) -> \\(.key)。建议后续迁移到 user/global scope。"',
+    `  ' "$CJ"`,
+    "fi",
+    "",
+    "# 3. 常见项目级 MCP / AI 客户端配置。只查已知路径，避免扫到源码或游戏资源。",
+    "for f in .codex/config.toml .codex/mcp.json .cursor/mcp.json .vscode/mcp.json codex.toml; do",
+    '  [ -f "$f" ] && grep -qiE "taptap|instant-games-open-mcp|taptap-maker" "$f" && \\',
+    '    echo "ℹ️  $f 包含 TapTap MCP。更新可以继续；建议后续迁移到 user/global scope。"',
+    "done",
+    "```",
+    "",
+    "Step 1: 对比远端和本地 npx 缓存版本",
+    "",
+    "```bash",
+    `npm view ${quotePosix(packageSpec)} version`,
+    'NPX_DIR="$(npm config get cache)/_npx"',
+    'for d in "$NPX_DIR"/*/; do',
+    '  p="$d/node_modules/@taptap/instant-games-open-mcp/package.json"',
+    '  [ -f "$p" ] && echo "$(basename "$d") -> $(node -p "require(process.argv[1]).version" "$p")"',
+    "done",
+    "```",
+    "",
+    "如果远端和本地版本已经一致，可以结束更新缓存流程，但仍建议重启或新开窗口确认。",
+    "",
+    "Step 2: 清理 TapTap MCP 的 npx 缓存",
+    "",
+    "```bash",
+    'NPX_DIR="$(npm config get cache)/_npx"',
+    'for d in "$NPX_DIR"/*/; do',
+    '  [ -d "$d/node_modules/@taptap/instant-games-open-mcp" ] && rm -rf "$d"',
+    "done",
+    "```",
+    "",
+    "Step 3: 预热下载新版本",
+    "",
+    "```bash",
+    `TAPTAP_MCP_ENV=rnd ${formatPosixNpxWarmup(packageSpec, bin)} \\`,
+    "  < /dev/null > /tmp/taptap-mcp-warmup.log 2>&1 &",
+    'PID=$!; sleep 25; kill "$PID" 2>/dev/null; wait "$PID" 2>/dev/null',
+    "```",
+    "",
+    "Step 4: 验证缓存版本",
+    "",
+    "```bash",
+    'NPX_DIR="$(npm config get cache)/_npx"',
+    'for d in "$NPX_DIR"/*/; do',
+    '  p="$d/node_modules/@taptap/instant-games-open-mcp/package.json"',
+    '  [ -f "$p" ] && echo "$(basename "$d") -> $(node -p "require(process.argv[1]).version" "$p")"',
+    "done",
+    "```",
+    "",
+    "Step 5: 生效方式",
+    "",
+    "请重启 MCP 客户端，或新开 Claude Code / Codex / Cursor 窗口。当前会话通常不会热加载新 MCP；重启后调用 maker_status 验证。"
+  ].join("\n");
+}
+function createNpxWarmupArgs(packageSpec, bin) {
+  if (bin === "instant-games-open-mcp") {
+    return ["-y", "--prefer-online", packageSpec];
+  }
+  return ["-y", "--prefer-online", "-p", packageSpec, bin];
+}
+function isMakerMcpUpdateBin(value) {
+  return typeof value === "string" && UPDATE_BINS.includes(value);
+}
+function quotePowerShell(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function formatPowerShellArgumentList(args) {
+  return args.map(quotePowerShell).join(",");
+}
+function formatPosixNpxWarmup(packageSpec, bin) {
+  const args = createNpxWarmupArgs(packageSpec, bin);
+  return ["npx", ...args].map(quotePosix).join(" ");
+}
+function quotePosix(value) {
+  if (/^[A-Za-z0-9_./:=@+-]+$/.test(value)) {
+    return value;
+  }
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+
 // src/maker/server/mcp.ts
-var VERSION = true ? "1.22.0-beta.6" : "dev";
+var VERSION = true ? "1.22.0-beta.7" : "dev";
 var DEFAULT_PROXY_MCP_NAME = "taptap-proxy";
 var DEFAULT_PROXY_PACKAGE = "@taptap/instant-games-open-mcp@1.22.0";
 var DEFAULT_BUILD_TIMEOUT_MS = 10 * 60 * 1e3;
@@ -42473,6 +42762,29 @@ var tools = [
       properties: {}
     }
   },
+  {
+    name: "maker_get_mcp_update_guide",
+    description: 'Return platform-specific instructions for updating the local npx cache of @taptap/instant-games-open-mcp. Use when the user says "更新 mcp", "更新 taptap mcp", "刷新 mcp 缓存", or asks how to update Maker MCP. This tool only returns guidance and MUST NOT update npm cache by itself. After calling it, the AI client should run the returned commands in the user local shell, then tell the user to restart or open a new MCP client window for changes to take effect.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        package_spec: {
+          type: "string",
+          description: "Optional npm package spec to update. Defaults to @taptap/instant-games-open-mcp@beta."
+        },
+        bin: {
+          type: "string",
+          enum: ["taptap-maker", "instant-games-open-mcp", "taptap-mcp-proxy"],
+          description: "Optional bin to warm up after cache cleanup. Defaults to taptap-maker."
+        },
+        client: {
+          type: "string",
+          enum: ["codex", "claude", "cursor", "unknown"],
+          description: "Optional current AI client name for tailored restart wording. Defaults to unknown."
+        }
+      }
+    }
+  },
   {
     name: "maker_setup_guide",
     description: `Show setup guidance when the current directory is not bound to a Maker project yet. Use this for user intents like "我要开发maker游戏", "本地maker开发", "拉取maker游戏到本地", "把maker游戏代码拉到本地", "clone maker游戏", "下载maker项目代码", "初始化maker项目", or "配置maker本地开发". In Codex/MCP mode, first make sure Git is installed by checking maker_status or maker_check_environment. If Git is missing, keep showing the install guidance and do not clone. If PAT is missing, ask the user to open the temporary PAT page ${TEMP_MAKER_PAT_TOKENS_URL}, create a PAT, give it to the agent, then call maker_exchange_pat; maker_exchange_pat automatically lists apps after saving PAT. If PAT already exists, maker_status automatically lists apps. Ask the user to choose an app, then maker_clone_to_current_directory. Do not ask for app_id upfront and do not run shell commands.`,
@@ -42559,7 +42871,7 @@ var tools = [
   },
   {
     name: "maker_submit_current_directory",
-    description: 'Alias for maker_push_current_directory. Requires local Git. If Git is missing, stop and show install guidance; do not stage, commit, or push. Use this in Maker projects when the user says "帮我提交", "帮我提交代码", "提交", "提交代码", "帮我提交代码到maker", "帮我提交代码到taptap制造", "帮我提交代码到tap制造", or "帮我提交代码到tap". This bypasses local generic Git branch/task-id rules and pushes directly to the Maker remote configured for the current directory.',
+    description: 'Alias for maker_push_current_directory. Requires local Git. If Git is missing, stop and show install guidance; do not stage, commit, or push. Use this in Maker projects when the user says "帮我提交", "帮我提交代码", "提交", "提交代码", "帮我提交代码到maker", "帮我提交代码到taptap制造", "帮我提交代码到tap制造", or "帮我提交代码到tap". If the user chooses "提交本地改动并触发构建（以后都是如此）" from a build local-change prompt, call this tool with remember_build_submit_preference=true. This saves a project preference so future build requests with local changes submit automatically. This bypasses local generic Git branch/task-id rules and pushes directly to the Maker remote configured for the current directory.',
     inputSchema: {
       type: "object",
       properties: {
@@ -42575,6 +42887,10 @@ var tools = [
           type: "array",
           items: { type: "string" },
           description: "Optional files to stage. Defaults to all changes."
+        },
+        remember_build_submit_preference: {
+          type: "boolean",
+          description: 'Set true only when the user explicitly chooses "提交本地改动并触发构建（以后都是如此）". After a successful submit, future build requests with local changes will automatically submit instead of asking again.'
         }
       }
     }
@@ -42615,7 +42931,7 @@ var tools = [
   },
   {
     name: "maker_build_current_directory",
-    description: 'Build the current Maker game by forwarding to the remote TapTap Maker MCP build tool. MUST use this for user requests like "构建", "build", "重新构建游戏", "帮我构建maker游戏", "compile", or "run" in a Maker project. Do not write local build scripts. Uses saved Tap auth and current .maker-mcp/config.json project binding to call the remote build tool through taptap-proxy.',
+    description: 'Build the current Maker game by forwarding to the remote TapTap Maker MCP build tool. MUST use this for user requests like "构建", "build", "重新构建游戏", "帮我构建maker游戏", "compile", or "run" in a Maker project. The tool itself enforces a local-change guard before remote build: if local Maker project changes exist, it will stop unless confirm_remote_build_without_submit is true or the project has saved build_local_changes_policy=auto_submit. Explain to the user that direct build only uses the Maker remote committed version and may not include local edits. The primary option should be "提交本地改动并触发构建（以后都是如此）"; if the user chooses it, call maker_submit_current_directory with remember_build_submit_preference=true. Successful Maker submit is commit + push and automatically triggers build, so do not call manual build again unless the user explicitly asks. If auto_submit preference is already saved, this build tool will submit local changes automatically and rely on Maker auto build. If the user explicitly says not to submit and wants to build the remote version, call this tool with confirm_remote_build_without_submit=true. Do not write local build scripts. Uses saved Tap auth and current .maker-mcp/config.json project binding to call the remote build tool through taptap-proxy.',
     inputSchema: {
       type: "object",
       properties: {
@@ -42625,11 +42941,11 @@ var tools = [
         },
         entry: {
           type: "string",
-          description: 'Optional single-player Lua entry file relative to scriptsPath, e.g. "main.lua". Omit to let the remote build tool infer/default.'
+          description: 'Optional single-player Lua entry file relative to scriptsPath, e.g. "main.lua". If omitted and local scripts/main.lua exists with no explicit multiplayer entries, Maker MCP sends entry="main.lua" and scriptsPath="scripts" by default to avoid remote entry-missing prompts. Otherwise omit to let the remote build tool infer/default.'
         },
         scriptsPath: {
           type: "string",
-          description: 'Optional scripts directory relative to workspace. Remote build defaults to "scripts" when omitted.'
+          description: 'Optional scripts directory relative to workspace. If omitted and local scripts/main.lua exists with no explicit entry overrides, Maker MCP sends scriptsPath="scripts" by default.'
         },
         entry_client: {
           type: "string",
@@ -42655,6 +42971,10 @@ var tools = [
         timeout_ms: {
           type: "number",
           description: "Optional remote build timeout in milliseconds. Defaults to 10 minutes. If timed out, do not retry blindly; inspect remote build logs first."
+        },
+        confirm_remote_build_without_submit: {
+          type: "boolean",
+          description: "Set true only after the user explicitly confirms they do not want to submit local changes and want to build the current Maker remote committed version."
         }
       }
     }
@@ -42697,6 +43017,21 @@ async function startMakerMcpServer() {
           ]
         };
       }
+      if (name === "maker_get_mcp_update_guide") {
+        const args = request.params.arguments || {};
+        return {
+          content: [
+            {
+              type: "text",
+              text: createMakerMcpUpdateGuide({
+                packageSpec: args.package_spec,
+                bin: args.bin,
+                client: args.client
+              })
+            }
+          ]
+        };
+      }
       if (name === "maker_tap_login_start") {
         const session = await startTapDeviceLogin();
         return {
@@ -42927,6 +43262,9 @@ async function startMakerMcpServer() {
             forcePat: args.force_pat === true,
             onProgress: progressReporter.report
           });
+          if (args.remember_build_submit_preference && !result.failure) {
+            rememberBuildSubmitPreference(targetDir);
+          }
           progressSummary = progressReporter.finish();
         } catch (error2) {
           progressReporter.finish();
@@ -42980,6 +43318,7 @@ async function startMakerMcpServer() {
             serverUrl: args.server_url,
             env: args.env,
             timeoutMs: args.timeout_ms,
+            confirmRemoteBuildWithoutSubmit: args.confirm_remote_build_without_submit,
             onProgress: progressReporter.report
           });
           progressSummary = progressReporter.finish();
@@ -43040,6 +43379,10 @@ async function formatStatus() {
   const projectSection = identify.projectId ? [
     "当前目录已绑定 Maker 项目。",
     "如果用户要求“帮我提交代码 / 提交并推送 / push / 帮我提交代码到maker / 帮我提交代码到taptap制造 / 帮我提交代码到tap制造 / 帮我提交代码到tap”，必须调用 maker_submit_current_directory 或 maker_push_current_directory。",
+    "如果用户要求“构建 / build / 重新构建 / 查看结果 / 预览 / 跑一下 / 验证一下”，必须先经过 maker_build_current_directory 的本地改动强制检查；有本地改动时不要静默构建云端旧版本，应询问用户是否提交。",
+    "优先选项文案应是“提交本地改动并触发构建（以后都是如此）”；用户选择后调用 maker_submit_current_directory，并设置 remember_build_submit_preference=true。",
+    "Maker 提交等于 commit + push，提交成功后会自动触发构建，不要再额外调用 build；保存偏好后，后续构建遇到本地改动会自动提交。",
+    "用户明确说不提交、直接构建云端版本时，才允许调用 maker_build_current_directory 并设置 confirm_remote_build_without_submit=true。",
     "不要套用本地通用 Git skill 的任务号、默认分支保护、新建分支规则；Maker push 按远端 Maker 仓库当前分支直接提交并推送。"
   ].join("\n") : pat ? await formatAutoProjectListFromPat() : formatIdentifyHint();
   return [
@@ -43069,6 +43412,19 @@ async function formatStatus() {
     projectSection
   ].filter(Boolean).join("\n");
 }
+function rememberBuildSubmitPreference(targetDir) {
+  const identify = identifyMakerProject({ cwd: targetDir });
+  if (!identify.projectRoot || !identify.projectId) {
+    throw new Error(
+      `${targetDir} is not bound to a Maker project. Cannot save build submit preference.`
+    );
+  }
+  saveProjectConfig(identify.projectRoot, {
+    ...identify.config || { project_id: identify.projectId },
+    project_id: identify.projectId,
+    build_local_changes_policy: "auto_submit"
+  });
+}
 async function formatAutoProjectListFromPat() {
   try {
     const projects = await listMakerProjects();
@@ -43398,6 +43754,30 @@ function formatDuration(ms) {
   return `${minutes}m ${seconds}s`;
 }
 async function buildCurrentDirectory(options) {
+  var _a2;
+  const localChanges = await readMakerProjectLocalChanges(options.targetDir);
+  if (localChanges.hasChanges && !options.confirmRemoteBuildWithoutSubmit) {
+    const config2 = loadProjectConfig(localChanges.projectRoot);
+    if ((config2 == null ? void 0 : config2.build_local_changes_policy) === "auto_submit") {
+      (_a2 = options.onProgress) == null ? void 0 : _a2.call(options, {
+        progress: 0,
+        total: 100,
+        phase: "auto_submit",
+        message: "Auto-submitting local Maker changes before build"
+      });
+      const submitResult = await (options.submitLocalChanges || pushMakerProject)({
+        cwd: localChanges.projectRoot,
+        onProgress: options.onProgress
+      });
+      return {
+        mode: "submitted_for_auto_build",
+        projectRoot: localChanges.projectRoot,
+        projectId: config2.project_id,
+        submitResult
+      };
+    }
+    throw new Error(formatLocalChangesBeforeBuildMessage(localChanges.files));
+  }
   const proxy = createRemoteProxyContext({
     targetDir: options.targetDir,
     serverUrl: options.serverUrl,
@@ -43432,8 +43812,8 @@ async function buildCurrentDirectory(options) {
         timeout: timeoutMs,
         resetTimeoutOnProgress: true,
         onprogress: (progress) => {
-          var _a2;
-          (_a2 = options.onProgress) == null ? void 0 : _a2.call(options, {
+          var _a3;
+          (_a3 = options.onProgress) == null ? void 0 : _a3.call(options, {
             progress: progress.progress,
             total: progress.total,
             phase: "remote_build",
@@ -43443,6 +43823,7 @@ async function buildCurrentDirectory(options) {
       }
     );
     return {
+      mode: "remote_build",
       projectRoot: proxy.projectRoot,
       projectId: proxy.projectId,
       projectPath: proxy.projectPath,
@@ -43456,6 +43837,22 @@ async function buildCurrentDirectory(options) {
     await client.close();
   }
 }
+function formatLocalChangesBeforeBuildMessage(files) {
+  const visibleFiles = files.slice(0, 20);
+  const hiddenCount = Math.max(0, files.length - visibleFiles.length);
+  return [
+    "Current Maker project has local changes that are not submitted.",
+    "",
+    "当前有本地修改还没有提交。直接构建只会构建 Maker 云端已有版本，可能看不到这些新修改。",
+    "请先询问用户选择：",
+    "- 提交本地改动并触发构建（以后都是如此）：调用 maker_submit_current_directory，并设置 remember_build_submit_preference=true；提交会同时保存并推送到 Maker，提交成功后自动触发构建，不要再额外调用 build。后续构建遇到本地改动会默认自动提交。",
+    "- 如果用户明确说不提交、直接构建云端版本，再调用 maker_build_current_directory，并设置 confirm_remote_build_without_submit=true。",
+    "",
+    "local_changes:",
+    ...visibleFiles.map((file2) => `- ${file2}`),
+    ...hiddenCount > 0 ? [`- ... and ${hiddenCount} more`] : []
+  ].join("\n");
+}
 function createBuildArgs(projectRoot, options) {
   const buildArgs = {};
   if (options.entry) {
@@ -43464,6 +43861,10 @@ function createBuildArgs(projectRoot, options) {
   if (options.scriptsPath) {
     buildArgs.scriptsPath = options.scriptsPath;
   }
+  if (!options.entry && !options.scriptsPath && !options.entryClient && !options.entryServer && !options.multiplayer && fs6.existsSync(path9.join(projectRoot, "scripts", "main.lua"))) {
+    buildArgs.entry = "main.lua";
+    buildArgs.scriptsPath = "scripts";
+  }
   if (options.entryClient) {
     buildArgs.entry_client = options.entryClient;
   }
@@ -43507,6 +43908,25 @@ function formatRemoteToolResult(result) {
   }).join("\n");
 }
 function formatBuildResult(result, progressSummary) {
+  if (result.mode === "submitted_for_auto_build") {
+    return [
+      result.submitResult.pushed ? "✓ Maker project submitted; Maker auto build triggered" : result.submitResult.status === "clean" ? "Maker project has no changes to submit; Maker auto build was not triggered" : "✗ Maker project submit failed; Maker auto build was not triggered",
+      "",
+      `- project_root: ${result.projectRoot}`,
+      `- project_id: ${result.projectId}`,
+      "- build_local_changes_policy: auto_submit",
+      `- branch: ${result.submitResult.branch}`,
+      `- status: ${result.submitResult.status}`,
+      `- committed: ${result.submitResult.committed ? "yes" : "no"}`,
+      result.submitResult.commitHash ? `- commit_hash: ${result.submitResult.commitHash}` : "",
+      result.submitResult.message ? `- commit_message: ${result.submitResult.message}` : "",
+      result.submitResult.ahead ? `- git_state: ${result.submitResult.ahead}` : "",
+      ...formatProgressSummary(progressSummary),
+      "",
+      "note: Maker submit is commit + push; successful submit automatically triggers build.",
+      ...result.submitResult.failure ? ["", ...formatMakerFailureLines(result.submitResult.failure)] : []
+    ].filter(Boolean).join("\n");
+  }
   return [
     "✓ Remote Maker build finished",
     "",
@@ -43539,20 +43959,21 @@ function formatPushResult(targetDir, result, progressSummary) {
   if (!result.failure) {
     return lines.join("\n");
   }
+  return [...lines, "", ...formatMakerFailureLines(result.failure)].filter(Boolean).join("\n");
+}
+function formatMakerFailureLines(failure) {
   return [
-    ...lines,
-    "",
     "failure:",
-    `- stage: ${result.failure.stage}`,
-    `- classification: ${result.failure.classification}`,
-    `- exit_code: ${result.failure.exitCode ?? "(none)"}`,
-    result.failure.command ? `- command: ${result.failure.command}` : "",
-    result.failure.stderr ? `- stderr:
-${indent(result.failure.stderr)}` : "",
-    result.failure.stdout ? `- stdout:
-${indent(result.failure.stdout)}` : "",
-    `- next_action: ${result.failure.nextAction}`
-  ].filter(Boolean).join("\n");
+    `- stage: ${failure.stage}`,
+    `- classification: ${failure.classification}`,
+    `- exit_code: ${failure.exitCode ?? "(none)"}`,
+    failure.command ? `- command: ${failure.command}` : "",
+    failure.stderr ? `- stderr:
+${indent(failure.stderr)}` : "",
+    failure.stdout ? `- stdout:
+${indent(failure.stdout)}` : "",
+    `- next_action: ${failure.nextAction}`
+  ].filter(Boolean);
 }
 function formatToolException(toolName, error2) {
   const message = error2 instanceof Error ? error2.message : String(error2);

package/dist/proxy.js

@@ -29137,7 +29137,7 @@ var LogWriter = class {
 };
 
 // src/mcp-proxy/proxy.ts
-var VERSION = true ? "1.22.0-beta.6" : "dev";
+var VERSION = true ? "1.22.0-beta.7" : "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.22.0-beta.6";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.22.0-beta.7";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.22.0-beta.6",
+  "version": "1.22.0-beta.7",
   "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",