aipic-mcp-stdio 1.1.2 → 1.1.4

package/index.js

@@ -25,7 +25,9 @@ const policy = require('./tool-policy');
 
 const PROTOCOL_VERSION = '2025-06-18';
 const SERVER_NAME = 'aipic-mcp-stdio';
-const SERVER_VERSION = '1.1.2';
+const SERVER_VERSION = '1.1.4';
+/** 要求的最低修图客户端版本：低于此（或 endpoint 文件没有 version 字段的旧客户端）都提示更新 */
+const MIN_CLIENT_VERSION = '3.18.11-alpha.1';
 const ENDPOINT_FILENAME = 'aipic-mcp-endpoint.json';
 /** 客户端 productName（electron-builder.yml），userData 目录名即此值 */
 const PRODUCT_NAME = 'NetdiskAIPhoto';
@@ -39,6 +41,7 @@ const ERR = {
     UPSTREAM_FAILED: -32005,
     BATCH_TOO_LARGE: -32006,
     CLIENT_CRASHED: -32007,
+    CLIENT_VERSION_LOW: -32008,
 };
 
 /**
@@ -49,8 +52,8 @@ const STATUS_TOOL_NAME = 'aipic_client_status';
 const STATUS_TOOL = {
     name: STATUS_TOOL_NAME,
     description:
-        '探测百度网盘AI修图客户端是否在运行。' +
-        '当其他工具报「客户端未在运行 / 可能已崩溃」时，可调用本工具获取诊断与操作建议。',
+        '探测百度网盘AI修图客户端状态（是否运行、版本是否过低）。' +
+        '当其他工具报「客户端未在运行 / 连接异常 / 版本过低」时，可调用本工具获取诊断与操作建议。',
     inputSchema: { type: 'object', properties: {}, additionalProperties: false },
 };
 
@@ -58,6 +61,50 @@ function log(...args) {
     process.stderr.write(`[aipic-stdio] ${args.join(' ')}\n`);
 }
 
+/**
+ * 极简 semver 比较，兼容 app.getVersion() 的 "major.minor.patch[-prerelease]" 形态。
+ * 只比前三位数字，数字相同时「有 prerelease 的版本 < 同版本无 prerelease」。足够支撑
+ * 「是否低于最低版本」的判断；不引入外部依赖（npm 包 files 只发 index.js + tool-policy.js）。
+ */
+function compareSemver(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    for (let i = 0; i < 3; i += 1) {
+        if (pa.nums[i] !== pb.nums[i]) {
+            return pa.nums[i] < pb.nums[i] ? -1 : 1;
+        }
+    }
+    if (pa.pre && !pb.pre) {
+        return -1;
+    }
+    if (!pa.pre && pb.pre) {
+        return 1;
+    }
+    return 0;
+}
+
+function parseSemver(v) {
+    const s = String(v || '').trim();
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(s);
+    if (!m) {
+        return { nums: [0, 0, 0], pre: null };
+    }
+    return { nums: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] || null };
+}
+
+/** 版本是否过低：endpoint 没有 version 字段（旧客户端）或低于 MIN_CLIENT_VERSION，都按过低处理 */
+function isVersionTooLow(version) {
+    if (typeof version !== 'string' || !version) {
+        return true;
+    }
+    return compareSemver(version, MIN_CLIENT_VERSION) < 0;
+}
+
+function clientVersionLowHint(version) {
+    const current = typeof version === 'string' && version ? version : '未知';
+    return `百度网盘AI修图客户端版本 ${current} 过低，需要 ${MIN_CLIENT_VERSION} 及以上版本，请更新客户端后重试`;
+}
+
 /**
  * endpoint 文件路径。客户端写在 app.getPath('userData')，各平台展开如下；
  * 允许用 AIPIC_MCP_ENDPOINT_FILE 覆盖（调试 / 多实例）。
@@ -95,7 +142,7 @@ function tryReadEndpoint() {
         err.rpcCode = ERR.ENDPOINT_MALFORMED;
         throw err;
     }
-    const { host, port, path: rpcPath, token } = json || {};
+    const { host, port, path: rpcPath, token, version } = json || {};
     if (
         typeof host !== 'string' ||
         typeof port !== 'number' ||
@@ -106,7 +153,7 @@ function tryReadEndpoint() {
         err.rpcCode = ERR.ENDPOINT_MALFORMED;
         throw err;
     }
-    return { host, port, path: rpcPath, token };
+    return { host, port, path: rpcPath, token, version };
 }
 
 /** 读 endpoint；文件不存在时抛 CLIENT_NOT_RUNNING（给 forward 用） */
@@ -179,6 +226,11 @@ function parseBody(text) {
  */
 async function forward(body, timeoutMs) {
     let ep = readEndpoint();
+    if (isVersionTooLow(ep.version)) {
+        const err = new Error(clientVersionLowHint(ep.version));
+        err.rpcCode = ERR.CLIENT_VERSION_LOW;
+        throw err;
+    }
     let res;
     try {
         res = await post(ep, body, timeoutMs);
@@ -222,7 +274,7 @@ async function forward(body, timeoutMs) {
 function wrapConnError(e) {
     const code = e && e.code;
     if (code === 'ECONNREFUSED' || code === 'ECONNRESET' || code === 'EPIPE') {
-        const err = new Error('百度网盘AI修图客户端可能已崩溃或异常退出，请重启客户端后重试');
+        const err = new Error('百度网盘AI修图客户端连接异常或已退出，请重启客户端后重试');
         err.rpcCode = ERR.CLIENT_CRASHED;
         return err;
     }
@@ -230,10 +282,11 @@ function wrapConnError(e) {
 }
 
 /**
- * 探测客户端状态，分三类：
+ * 探测客户端状态，分四类：
  *   - not_running：endpoint 文件不存在（没装 / 没启动 / 正常退出），统一提示安装并启动；
+ *   - version_too_low：endpoint 文件在但版本过低（或旧客户端没写 version 字段），提示更新客户端；
  *   - crashed：endpoint 文件在，但端口连不上（崩溃 / 异常退出残留），提示重启；
- *   - running：端口有 HTTP 应答。
+ *   - running：版本合格且端口有 HTTP 应答。
  * 只在本地做（读文件 + 短超时探端口），不触发任何业务。
  */
 const PROBE_TIMEOUT_MS = 2000;
@@ -254,14 +307,22 @@ async function probeClient() {
             hint: '百度网盘AI修图客户端未在运行，请安装并启动客户端后重试',
         };
     }
+    if (isVersionTooLow(ep.version)) {
+        return {
+            state: 'version_too_low',
+            version: ep.version || null,
+            min_version: MIN_CLIENT_VERSION,
+            hint: clientVersionLowHint(ep.version),
+        };
+    }
     try {
         // 用不存在的 method 探活：只要端口有 HTTP 应答就说明客户端在跑，body 忽略
         await post(ep, { jsonrpc: '2.0', id: 0, method: 'ping', params: {} }, PROBE_TIMEOUT_MS);
-        return { state: 'running', hint: '百度网盘AI修图客户端运行正常' };
+        return { state: 'running', version: ep.version, hint: '百度网盘AI修图客户端运行正常' };
     } catch (e) {
         return {
             state: 'crashed',
-            hint: '百度网盘AI修图客户端可能已崩溃或异常退出，请重启客户端后重试',
+            hint: '百度网盘AI修图客户端连接异常或已退出，请重启客户端后重试',
         };
     }
 }
@@ -426,7 +487,8 @@ async function handleToolsCall(msg) {
     if (policy.requiresConfirmation(name)) {
         return toolError(
             msg.id,
-            `CONFIRMATION_REQUIRED: ${name} 会丢数据，代理层禁止由模型直接调用。` + '请引导用户在修图客户端 UI 里操作。'
+            `CONFIRMATION_REQUIRED: ${name} 是不可逆操作，代理层禁止由模型直接调用。` +
+                '请直接转告用户「此操作请在修图客户端 UI 中完成」，不要生成确认选项、不要再次询问是否继续。'
         );
     }
     const tooBig = policy.batchLimit(name, args);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "aipic-mcp-stdio",
-    "version": "1.1.2",
+    "version": "1.1.4",
     "description": "stdio <-> HTTP proxy for the Baidu Netdisk AI Photo (NetdiskAIPhoto) local MCP server",
     "keywords": [
         "mcp",