@scorehub/mcp-server 0.3.3 → 0.4.1

package/README.en.md

@@ -62,13 +62,23 @@ Common configuration locations are:
 | Other MCP clients | The MCP configuration file used by that client |
 | WorkBuddy | `mcp.json` |
 
-On the first launch, `npx` downloads `@scorehub/mcp-server` and connects it to the remote endpoint. When you first call a remote tool, invoke `authorize` when prompted by your client. A browser opens the ScoreHub login page; after authorization it returns to a random `127.0.0.1` port and stores the token locally. Later calls reuse the cached token and do not require another login.
+On the first launch, `npx` downloads `@scorehub/mcp-server` and connects it to the remote endpoint. When you first call a remote tool, invoke `authorize` when prompted by your client. A browser opens the ScoreHub login page; after authorization it returns to a random `127.0.0.1` port and stores the token locally. In WorkBuddy, the successful callback page can launch Tiky through “Return to WorkBuddy.” Later calls reuse the cached token and do not require another login.
 
-> After you install Tiky through the WorkBuddy share link, Tiky can run `npx -y @scorehub/creator-outreach@latest` when needed to complete the local bootstrap and write or repair this MCP configuration automatically. Manual editing is not required.
+> After you install Tiky through the WorkBuddy share link, Tiky's first-turn bootstrap gate writes or repairs this MCP configuration after the user's one-time confirmation. Manual editing is not required.
+
+### Startup self-check
+
+Before writing the WorkBuddy configuration, creator-outreach prefetches npm latest and runs:
+
+```bash
+npx -y @scorehub/mcp-server@latest --self-check --json
+```
+
+The command reports the package version, Node.js version, and executable entrypoint status, then exits immediately. It does not start stdio, contact the remote MCP endpoint, enter OAuth, or write tokens.
 
 ## Windows
 
-Windows uses the same MCP JSON configuration as macOS and Linux. You do not need `npx.cmd` or a separate global installation.
+For manually configured MCP clients, Windows uses the same `"command": "npx"` configuration shown above as macOS and Linux; you do not need to switch it to `npx.cmd` or install the package globally. Tiky's public WorkBuddy installation path generates a managed configuration instead: it uses WorkBuddy's bundled `node.exe` to load the matching npm `npx-cli.js` directly, avoiding host process-launch compatibility problems with `.cmd` / `.bat` files.
 
 1. After installing Node.js 18+, reopen PowerShell or Windows Terminal and run the three version commands from the prerequisites section.
 2. If `node`, `npm`, or `npx` cannot be found, Node.js is not available on the current process PATH. Close and reopen the client and terminal; if the problem remains, verify the Node.js installation.
@@ -76,7 +86,7 @@ Windows uses the same MCP JSON configuration as macOS and Linux. You do not need
 4. Authorization uses PowerShell `Start-Process` to open your default browser, so OAuth URL parameters such as `redirect_uri` are preserved. If system policy blocks it, copy the authorization URL printed in the terminal and open it on the **same Windows computer that runs mcp-server**.
 5. The callback always uses a random `127.0.0.1` port. Do not open the authorization URL on another computer. If local security software blocks the loopback callback, allow local loopback connections and try again.
 
-If WorkBuddy uses its bundled Node.js, install Tiky through the share link first, then let Tiky run `npx -y @scorehub/creator-outreach@latest` to complete the local bootstrap. That flow handles `npx` / `npx.cmd` and PATH differences for each platform.
+If WorkBuddy uses its bundled Node.js, install Tiky through the share link first, then let Tiky run `npx -y @scorehub/creator-outreach@latest` to complete the local bootstrap. That flow resolves the managed `node.exe`, `npx-cli.js`, and PATH automatically; no wrapper script or manual `mcp.json` edit is required.
 
 ## Optional: Global Installation
 
@@ -173,7 +183,7 @@ Local mcp-server                         ScoreHub Remote MCP
 | `rate_limited` / `quota_exhausted` | Wait, split the operation into batches, or narrow the request. Do not reauthorize for rate limits. |
 | `invalid_input` | Correct the tool parameters; do not start authorization. |
 | Browser does not open automatically | Use the authorization URL printed in the terminal and complete the callback on the same machine that runs mcp-server. |
-| The authorization page says the link is invalid, or the browser URL has no `redirect_uri` | Fully quit and restart WorkBuddy, and confirm `~/.workbuddy/mcp.json` still uses `npx -y @scorehub/mcp-server@latest`. Newer versions open the OAuth URL through PowerShell to avoid truncating query parameters. |
+| The authorization page says the link is invalid, or the browser URL has no `redirect_uri` | Fully quit and restart WorkBuddy, then confirm the `scorehub` entry in `~/.workbuddy/mcp.json` still includes `@scorehub/mcp-server@latest` and is managed by `@scorehub/creator-outreach`. If not, rerun Tiky's bootstrap repair. Newer versions open the OAuth URL through PowerShell to avoid truncating query parameters. |
 
 Key `status` fields:
 
@@ -203,6 +213,8 @@ With `npx -y ...@latest`, every launch resolves npm's current `latest` tag. For
 npm update -g @scorehub/mcp-server
 ```
 
+Because the public WorkBuddy configuration always follows `@latest`, releases under this package name must preserve backward compatibility for tool names, parameters, OAuth, and the `status` contract. An incompatible protocol must use a new package name.
+
 ## Related Packages
 
 | Package | Description |

package/README.md

@@ -62,13 +62,23 @@ npx --version
 | 其他 MCP 客户端 | 该客户端使用的 MCP 配置文件 |
 | WorkBuddy | `mcp.json` |
 
-首次启动时，`npx` 会下载 `@scorehub/mcp-server` 并连接远程端点。首次调用远程工具时，按客户端提示调用 `authorize`：浏览器会打开 ScoreHub 登录页，授权完成后回调到 `127.0.0.1` 的随机端口并写入本地 Token。之后会复用缓存，不需要每次登录。
+首次启动时，`npx` 会下载 `@scorehub/mcp-server` 并连接远程端点。首次调用远程工具时，按客户端提示调用 `authorize`：浏览器会打开 ScoreHub 登录页，授权完成后回调到 `127.0.0.1` 的随机端口并写入本地 Token。在 WorkBuddy 中，成功回调页可通过“切换到终端继续”唤起 Tiky；之后会复用缓存，不需要每次登录。
 
-> 通过 WorkBuddy 分享链接安装 Tiky 后，Tiky 会在需要时执行 `npx -y @scorehub/creator-outreach@latest` 完成本地引导，并自动写入或修复这份 MCP 配置；无需手动编辑。
+> 通过 WorkBuddy 分享链接安装 Tiky 后，Tiky 会在首轮 bootstrap 门禁中经用户首次确认后自动写入或修复这份 MCP 配置；无需手动编辑。
+
+### 启动前自检
+
+在写入 WorkBuddy 配置前，creator-outreach 会预拉取 npm latest 并执行：
+
+```bash
+npx -y @scorehub/mcp-server@latest --self-check --json
+```
+
+该命令返回包版本、Node.js 版本和可执行入口状态，然后立即退出。它不启动 stdio 服务、不访问远端 MCP、不进入 OAuth，也不写入 Token。
 
 ## Windows 使用说明
 
-Windows 与 macOS、Linux 使用同一份 MCP JSON 配置，不需要改成 `npx.cmd` 或另行全局安装。
+手工配置普通 MCP 客户端时，Windows 与 macOS、Linux 一样使用前文的 `"command": "npx"`，不需要手工改成 `npx.cmd` 或另行全局安装。WorkBuddy 的公开安装路径由 Tiky 自动生成配置：它会使用 WorkBuddy 托管的 `node.exe` 直接加载同版本 npm 的 `npx-cli.js`，避免宿主原生进程 API 直接启动 `.cmd` / `.bat` 的兼容问题。
 
 1. 安装 Node.js 18+ 后，重新打开 PowerShell 或 Windows Terminal，运行前置条件中的三个版本命令。
 2. 如果提示找不到 `node`、`npm` 或 `npx`，说明 Node.js 尚未加入当前进程的 PATH：关闭并重新打开客户端和终端；仍无法识别时，检查 Node.js 安装是否完成。
@@ -76,7 +86,7 @@ Windows 与 macOS、Linux 使用同一份 MCP JSON 配置，不需要改成 `npx
 4. 授权时会优先使用 `cmd.exe /c start` 打开默认浏览器。被系统策略拦截时，复制终端输出的授权 URL，在**运行 mcp-server 的同一台 Windows 电脑**上打开并完成授权。
 5. 回调固定使用 `127.0.0.1` 随机端口。不要在另一台电脑打开授权 URL；本机安全软件若拦截回环回调，应允许本地回环连接后重试。
 
-WorkBuddy 若使用其捆绑的 Node.js，建议先通过分享链接安装 Tiky，再由 Tiky 执行 `npx -y @scorehub/creator-outreach@latest` 完成本地引导；该流程会按平台处理 `npx` / `npx.cmd` 与 PATH。
+WorkBuddy 若使用其捆绑的 Node.js，建议先通过分享链接安装 Tiky，再由 Tiky 执行 `npx -y @scorehub/creator-outreach@latest` 完成本地引导；该流程会自动解析托管的 `node.exe`、`npx-cli.js` 与 PATH，不需要创建包装脚本或手工编辑 `mcp.json`。
 
 ## 可选：全局安装
 
@@ -173,7 +183,7 @@ Token 持久化在本机文件中；调用默认 ScoreHub 生产端点时，mcp-
 | `rate_limited` / `quota_exhausted` | 等待、分批执行或缩小请求范围；不要为了限流重新授权。 |
 | `invalid_input` | 修正工具参数，不走授权流程。 |
 | 浏览器无法自动打开 | 使用终端输出的授权 URL，并在运行 mcp-server 的同一台机器上完成回调。 |
-| Windows 授权页提示授权链接无效，或浏览器地址栏缺少 `redirect_uri` | 完全退出并重启 WorkBuddy，确认 `~/.workbuddy/mcp.json` 仍使用 `npx -y @scorehub/mcp-server@latest`；新版会通过 PowerShell 打开授权 URL，避免 `cmd.exe start` 截断带 `&` 的参数。 |
+| Windows 授权页提示授权链接无效，或浏览器地址栏缺少 `redirect_uri` | 完全退出并重启 WorkBuddy，确认 `~/.workbuddy/mcp.json` 的 `scorehub` 参数仍包含 `@scorehub/mcp-server@latest`，且配置由 `@scorehub/creator-outreach` 托管；若不符合，重新运行 Tiky bootstrap 修复。新版会通过 PowerShell 打开授权 URL，避免 `cmd.exe start` 截断带 `&` 的参数。 |
 
 `status` 的关键字段说明：
 
@@ -203,6 +213,8 @@ Token 持久化在本机文件中；调用默认 ScoreHub 生产端点时，mcp-
 npm update -g @scorehub/mcp-server
 ```
 
+由于 WorkBuddy 公开配置始终跟随 `@latest`，同一包名下的 latest 发布必须保持工具名、参数、OAuth 和 `status` 契约向后兼容。无法兼容的新协议必须使用新包名。
+
 ## 相关包
 
 | 包 | 说明 |

package/dist/index.js

@@ -18,11 +18,12 @@ const index_js_2 = require("@modelcontextprotocol/sdk/client/index.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-function readPackageVersion() {
-    const packageJson = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "../package.json"), "utf-8"));
-    return packageJson.version;
+const self_check_js_1 = require("./self-check.js");
+function readPackageMetadata() {
+    return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "../package.json"), "utf-8"));
 }
-const SERVER_VERSION = readPackageVersion();
+const PACKAGE_METADATA = readPackageMetadata();
+const SERVER_VERSION = PACKAGE_METADATA.version;
 const DEFAULT_SCOREHUB_BASE_URL = "https://app.scorehub.cn/mcp";
 const SCOREHUB_BASE_URL = normalizeBaseUrl(process.env.SCOREHUB_REMOTE_MCP_URL || DEFAULT_SCOREHUB_BASE_URL);
 // OAuth endpoints are at the root path
@@ -378,6 +379,23 @@ function startTokenKeepAlive() {
 }
 // ── Start ───────────────────────────────────────────────────
 async function main() {
+    if (process.argv.includes("--self-check")) {
+        const payload = (0, self_check_js_1.buildSelfCheckPayload)({
+            packageName: PACKAGE_METADATA.name,
+            serverVersion: SERVER_VERSION,
+        });
+        if (process.argv.includes("--json")) {
+            process.stdout.write(`${JSON.stringify(payload)}\n`);
+        }
+        else {
+            process.stdout.write(payload.ok
+                ? `ScoreHub MCP Server v${payload.server_version} is ready (Node.js ${payload.node_version}).\n`
+                : `Node.js ${payload.minimum_node_major}+ is required. Detected ${payload.node_version}.\n`);
+        }
+        if (!payload.ok)
+            process.exitCode = 1;
+        return;
+    }
     // Set process title for easy identification in ps/task manager
     process.title = 'scorehub-mcp';
     // Gracefully exit when parent AI agent closes stdin (normal shutdown or crash).

package/dist/pages/callback-pages.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCallbackPage = buildCallbackPage;
 const logo_data_js_1 = require("./logo-data.js");
+const WORKBUDDY_LAUNCH_URL = "workbuddy://launch?expertname=Tiky%20%C2%B7%20TikTok%E8%BE%BE%E4%BA%BA%E8%90%A5%E9%94%80%E4%B8%93%E5%AE%B6&buddy_type=workbuddy";
 const CALLBACK_BASE_STYLES = `
     * { margin:0; padding:0; box-sizing:border-box; }
     body {
@@ -191,6 +192,9 @@ const CALLBACK_BASE_STYLES = `
       margin-top:22px;
     }
     .btn {
+      display:flex;
+      align-items:center;
+      justify-content:center;
       min-height:44px;
       padding:10px 16px;
       border-radius:12px;
@@ -198,6 +202,7 @@ const CALLBACK_BASE_STYLES = `
       font-weight:800;
       cursor:pointer;
       border:1px solid transparent;
+      text-decoration:none;
       transition:background 0.15s, border-color 0.15s, box-shadow 0.15s, transform 0.15s;
     }
     .btn:hover { transform:translateY(-1px); }
@@ -267,6 +272,19 @@ function escapeHtml(value) {
 }
 function buildCallbackPage(page) {
     const statusClass = page.tone === "success" ? "status-badge-success" : "status-badge-error";
+    const primaryAction = page.tone === "success"
+        ? `<a class="btn btn-primary" id="workbuddy-launch-link" href="${WORKBUDDY_LAUNCH_URL}">切换到终端继续</a>`
+        : `<button class="btn btn-primary" type="button" id="focus-button">切回终端继续</button>`;
+    const focusScript = page.tone === "success"
+        ? ""
+        : `
+    const focusButton = document.getElementById('focus-button');
+    focusButton?.addEventListener('click', function() {
+      window.close();
+      setTimeout(function() {
+        window.focus();
+      }, 60);
+    });`;
     const detailBlock = page.detail
         ? `<div class="detail-card">
         <span class="section-title">错误详情</span>
@@ -326,7 +344,7 @@ function buildCallbackPage(page) {
       </div>
 
       <div class="actions">
-        <button class="btn btn-primary" type="button" id="focus-button">切回终端继续</button>
+        ${primaryAction}
         <button class="btn btn-secondary" type="button" id="close-button">${escapeHtml(page.closeLabel ?? "关闭当前页面")}</button>
       </div>
       <div class="helper-note">${escapeHtml(page.helperText ?? "如果浏览器无法自动关闭，请手动切回终端继续。")}</div>
@@ -334,18 +352,11 @@ function buildCallbackPage(page) {
   </div>
   <script>
     const closeButton = document.getElementById('close-button');
-    const focusButton = document.getElementById('focus-button');
 
     closeButton?.addEventListener('click', function() {
       window.close();
     });
-
-    focusButton?.addEventListener('click', function() {
-      window.close();
-      setTimeout(function() {
-        window.focus();
-      }, 60);
-    });
+${focusScript}
   </script>
 </body>
 </html>`;

package/dist/self-check.d.ts

@@ -0,0 +1,18 @@
+export declare const MIN_NODE_MAJOR = 18;
+export interface SelfCheckPayload {
+    schema_version: 1;
+    ok: boolean;
+    package_name: string;
+    server_version: string;
+    node_version: string;
+    node_supported: boolean;
+    minimum_node_major: number;
+    entrypoint: "scorehub-mcp";
+}
+export interface SelfCheckInput {
+    packageName: string;
+    serverVersion: string;
+    nodeVersion?: string;
+}
+export declare function getNodeMajorVersion(nodeVersion: string): number;
+export declare function buildSelfCheckPayload(input: SelfCheckInput): SelfCheckPayload;

package/dist/self-check.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_NODE_MAJOR = void 0;
+exports.getNodeMajorVersion = getNodeMajorVersion;
+exports.buildSelfCheckPayload = buildSelfCheckPayload;
+exports.MIN_NODE_MAJOR = 18;
+function getNodeMajorVersion(nodeVersion) {
+    return Number.parseInt(nodeVersion.split(".")[0], 10);
+}
+function buildSelfCheckPayload(input) {
+    const nodeVersion = input.nodeVersion ?? process.versions.node;
+    const nodeSupported = getNodeMajorVersion(nodeVersion) >= exports.MIN_NODE_MAJOR;
+    return {
+        schema_version: 1,
+        ok: nodeSupported,
+        package_name: input.packageName,
+        server_version: input.serverVersion,
+        node_version: nodeVersion,
+        node_supported: nodeSupported,
+        minimum_node_major: exports.MIN_NODE_MAJOR,
+        entrypoint: "scorehub-mcp",
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorehub/mcp-server",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "ScoreHub local MCP proxy — OAuth login, token caching, and tool forwarding to remote MCP endpoint",
   "engines": {
     "node": ">=18"
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc && node -e \"const fs=require('fs');const f='dist/index.js';fs.writeFileSync(f,'#!/usr/bin/env node\\n'+fs.readFileSync(f,'utf8'));fs.chmodSync(f,0o755)\"",
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && node -e \"const fs=require('fs');const f='dist/index.js';fs.writeFileSync(f,'#!/usr/bin/env node\\n'+fs.readFileSync(f,'utf8'));fs.chmodSync(f,0o755)\"",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "tsx --test test/*.test.ts"

package/dist/startup-check.d.ts

@@ -1,39 +0,0 @@
-export declare const VERSION_CACHE_TTL_MS: number;
-export declare const VERSION_REQUEST_TIMEOUT_MS = 3000;
-export type StartupCheckStatus = "ready" | "restart_required" | "migration_required" | "verification_unavailable";
-export interface LatestVersions {
-    creatorOutreach?: string;
-    mcpServer?: string;
-    checkedAt: string;
-    error?: string;
-}
-export interface StartupCheckResult {
-    status: StartupCheckStatus;
-    creator_outreach: {
-        agent_version: string;
-        bootstrap_version: string | null;
-        latest_version: string | null;
-    };
-    mcp_server: {
-        running_version: string;
-        latest_version: string | null;
-    };
-    checked_at: string;
-    message: string;
-}
-interface GetLatestVersionsOptions {
-    registryUrl?: string;
-    fetchImpl?: typeof fetch;
-    now?: () => number;
-    timeoutMs?: number;
-}
-interface EvaluateStartupCheckOptions {
-    agentVersion: string;
-    bootstrapVersion?: string;
-    mcpServerVersion: string;
-    latestVersions: LatestVersions;
-}
-export declare function getLatestVersions({ registryUrl, fetchImpl, now, timeoutMs, }?: GetLatestVersionsOptions): Promise<LatestVersions>;
-export declare function evaluateStartupCheck({ agentVersion, bootstrapVersion, mcpServerVersion, latestVersions, }: EvaluateStartupCheckOptions): StartupCheckResult;
-export declare function resetVersionCacheForTests(): void;
-export {};

package/dist/startup-check.js

@@ -1,120 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION_REQUEST_TIMEOUT_MS = exports.VERSION_CACHE_TTL_MS = void 0;
-exports.getLatestVersions = getLatestVersions;
-exports.evaluateStartupCheck = evaluateStartupCheck;
-exports.resetVersionCacheForTests = resetVersionCacheForTests;
-const DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
-exports.VERSION_CACHE_TTL_MS = 15 * 60 * 1000;
-exports.VERSION_REQUEST_TIMEOUT_MS = 3000;
-const CREATOR_OUTREACH_PACKAGE = "@scorehub/creator-outreach";
-const MCP_SERVER_PACKAGE = "@scorehub/mcp-server";
-let versionCache = null;
-function normalizeRegistryUrl(value) {
-    const registry = (value || DEFAULT_NPM_REGISTRY).trim();
-    return registry.endsWith("/") ? registry : `${registry}/`;
-}
-async function fetchPackageVersion(packageName, registryUrl, fetchImpl, timeoutMs) {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), timeoutMs);
-    timeout.unref?.();
-    try {
-        const url = new URL(`${encodeURIComponent(packageName)}/latest`, registryUrl);
-        const response = await fetchImpl(url, {
-            headers: { accept: "application/json" },
-            signal: controller.signal,
-        });
-        if (!response.ok) {
-            throw new Error(`${packageName} returned HTTP ${response.status}`);
-        }
-        const payload = await response.json();
-        if (typeof payload.version !== "string" || payload.version.trim() === "") {
-            throw new Error(`${packageName} latest metadata did not include a version`);
-        }
-        return payload.version.trim();
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-async function getLatestVersions({ registryUrl = process.env.npm_config_registry, fetchImpl = fetch, now = Date.now, timeoutMs = exports.VERSION_REQUEST_TIMEOUT_MS, } = {}) {
-    const nowMs = now();
-    if (versionCache && versionCache.expiresAt > nowMs) {
-        return versionCache.value;
-    }
-    const checkedAt = new Date(nowMs).toISOString();
-    const normalizedRegistry = normalizeRegistryUrl(registryUrl);
-    const [creatorResult, mcpResult] = await Promise.allSettled([
-        fetchPackageVersion(CREATOR_OUTREACH_PACKAGE, normalizedRegistry, fetchImpl, timeoutMs),
-        fetchPackageVersion(MCP_SERVER_PACKAGE, normalizedRegistry, fetchImpl, timeoutMs),
-    ]);
-    const errors = [];
-    const value = { checkedAt };
-    if (creatorResult.status === "fulfilled") {
-        value.creatorOutreach = creatorResult.value;
-    }
-    else {
-        errors.push(`creator-outreach: ${String(creatorResult.reason)}`);
-    }
-    if (mcpResult.status === "fulfilled") {
-        value.mcpServer = mcpResult.value;
-    }
-    else {
-        errors.push(`mcp-server: ${String(mcpResult.reason)}`);
-    }
-    if (errors.length > 0) {
-        value.error = errors.join("; ");
-    }
-    versionCache = {
-        expiresAt: nowMs + exports.VERSION_CACHE_TTL_MS,
-        value,
-    };
-    return value;
-}
-function evaluateStartupCheck({ agentVersion, bootstrapVersion, mcpServerVersion, latestVersions, }) {
-    const result = {
-        creator_outreach: {
-            agent_version: agentVersion,
-            bootstrap_version: bootstrapVersion || null,
-            latest_version: latestVersions.creatorOutreach || null,
-        },
-        mcp_server: {
-            running_version: mcpServerVersion,
-            latest_version: latestVersions.mcpServer || null,
-        },
-        checked_at: latestVersions.checkedAt,
-    };
-    if (!bootstrapVersion) {
-        return {
-            status: "migration_required",
-            ...result,
-            message: "当前仍在使用旧版 MCP 启动配置。请执行一次 npx -y @scorehub/creator-outreach@latest，然后完全退出并重新打开客户端。",
-        };
-    }
-    if (agentVersion !== bootstrapVersion
-        || (latestVersions.creatorOutreach && bootstrapVersion !== latestVersions.creatorOutreach)
-        || (latestVersions.mcpServer && mcpServerVersion !== latestVersions.mcpServer)) {
-        return {
-            status: "restart_required",
-            ...result,
-            message: "检测到 Tiky 配置或 ScoreHub MCP 版本已变化。请完全退出并重新打开客户端，以加载已刷新的版本。",
-        };
-    }
-    if (latestVersions.error
-        || !latestVersions.creatorOutreach
-        || !latestVersions.mcpServer) {
-        return {
-            status: "verification_unavailable",
-            ...result,
-            message: "暂时无法连接 npm registry 确认是否为最新版；当前本地版本一致，可以继续使用。",
-        };
-    }
-    return {
-        status: "ready",
-        ...result,
-        message: "Tiky 配置与 ScoreHub MCP 均已就绪。",
-    };
-}
-function resetVersionCacheForTests() {
-    versionCache = null;
-}