aipic-mcp-stdio 1.1.1 → 1.1.3

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.1';
+const SERVER_VERSION = '1.1.3';
+/** 要求的最低修图客户端版本：低于此（或 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修图客户端连接异常或已退出，请重启客户端后重试',
         };
     }
 }

package/package.json

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

package/tool-policy.js

@@ -34,14 +34,13 @@ const DESTRUCTIVE_TOOLS = new Set([
  * 已知会让客户端崩溃的工具：曾稳定触发 SIGABRT 并留下孤儿进程，
  * 崩溃后 MCP 服务不恢复而 endpoint 文件仍在。
  *
- * - aipic_mark_filter_best：aipic_modify_filelist_item 对筛图(type=1)写 select_status 会触发
- *   aipic-host 延迟 40~90s 抛未捕获 C++ 异常 → SIGABRT（三次实测复现，栈一致，offset 0x104e00
- *   附近）。native 未修前一律拦下。
- * - 原 aipic_control_export_tasks 的「第二个崩溃入口」经真机复现未触发（完成/失败/暂停任务
- *   × type 0/1/2 全不崩，retry 还能正常恢复 PAUSED），已移出 unsafe、归入 write（控制导出
- *   任务状态属写操作）。若后续出现崩溃，再回填此名单。
+ * 当前名单为空。历史：
+ * - aipic_mark_filter_best 曾因 ffiCall「回调触发即 unregister」导致 native 二次回调（40~90s 后）
+ *   打到已释放 trampoline 而崩客户端；已改用常驻回调（见 ai-pick/mark.ts）并移出 unsafe、归入 write。
+ * - aipic_control_export_tasks 经真机复现未触发崩溃，已移出 unsafe、归入 write。
+ * 若后续出现崩溃，再回填此名单。
  */
-const UNSAFE_TOOLS = new Set(['aipic_mark_filter_best']);
+const UNSAFE_TOOLS = new Set([]);
 
 /** 会写入数据的工具：需要串行执行，避免并发写 workspace / filecache 互相踩 */
 const WRITE_TOOLS = new Set([
@@ -73,6 +72,7 @@ const WRITE_TOOLS = new Set([
     'aipic_stop_filter',
     'aipic_pause_filter',
     'aipic_resume_filter',
+    'aipic_mark_filter_best',
     // 在线选片
     'aipic_select_switch_state',
     'aipic_match_source',