writedock-mcp 0.4.1 → 0.4.2

package/README.md

@@ -51,7 +51,15 @@ WRITEDOCK_PORT = "9647"
 
 服务默认只监听 `127.0.0.1:9647`，可通过 `WRITEDOCK_PORT` 调整。Cookie、稿件与媒体不经过 npm 注册表。MCP 桥接主进程重启后，未完成的本机素材授权需要重新准备，已提交的任务先查询原 request_id，不自动重发。
 
-无法访问 npm 时，可使用扩展的「离线安装（备用）」ZIP，运行包内 `node install.mjs`，按输出的本地 command/args 配置。离线安装路径与 npx 共用同一身份目录。`npx -y --prefer-online writedock-mcp@latest --version` 只显示版本，不启动服务或读取配对资料。
+`npx -y --prefer-online writedock-mcp@latest --version` 只显示版本，不启动服务或读取配对资料。
+
+## 版本提示
+
+自 v0.4.2 起，MCP 在启动后异步检查 npm latest，随后每 6 小时检查，失败后至少等待 10 分钟再试。查询只访问公开版本信息，不传送配对凭据或稿件，也不会阻塞配对、工具调用或发布任务。
+
+`get_connection_status` 返回 `mcp_version`、可用时的 `latest_version`、`update_available`、`update_checked_at`、`update_checking` 及可选 `update_check_error`。运行版本指与扩展实际连接的本机桥接进程；多个 agent 共用端口时，不把新启动客户端的版本误当成仍占用端口的旧服务版本。
+
+现有 ready/ping 消息附带相同信息，扩展显示版本和更新提示。只有确定 npm 版本更新时才提醒用户重新启动 WriteDock MCP。发布任务进行中只提示，不自动重启、改配置或重新提交。旧扩展忽略新增字段；旧 MCP 未提供版本字段时显示未知。npm 查询失败不影响当前连接。
 
 工具包括：`get_connection_status`、`begin_pairing`、`list_platforms`、`check_auth`、`prepare_article`、`publish_article`、`sync_article`、`prepare_post`、`publish_post`、`get_sync_task`、`list_sync_history`。
 
@@ -85,10 +93,10 @@ Agent 先看 `list_platforms` 返回的 `publishModes`、`tools`、`modeOptions`
 
 先用 `prepare_post` 存本机预览，返回 draft_id；再向 `publish_post` 传 draft_id、request_id 和 platforms（xiaohongshu/douyin/weibo）。也可直接向 publish_post 提供全部内容与素材。该工具会打开平台原生页面并点击发布，必须以用户明确的发布要求和目标平台为依据。publish_post 的平台参数改为由扩展实际能力校验，不在 MCP 中固定枚举。
 
-所有提交都需要稳定的 `request_id`，返回 `task_id` 后用 `get_sync_task` 跟进。同 ID 的相同请求复用原任务，不能用同 ID 发布不同内容。直接发布结果 `publicationState=unknown` 时先检查作品管理，不自动换 ID 重试。submitted 表示平台接受提交，是否公开展示以平台审核为准。
+所有提交都需要稳定的 `request_id`，返回 `task_id` 后用 `get_sync_task` 跟进。同 ID 的相同请求复用原任务，不能用同 ID 发布不同内容。Agent 只使用 WriteDock MCP，不依赖浏览器或 Playwright 工具。打开平台原生投稿页及操作由扩展完成。任务返回 finished、next_action、results、agent_instructions；poll_task 按原 ID 继续查询，report_result 汇报逐平台结果和链接。submitted/published 后不再打开网站验证；验证码、图形验证、unknown 或 interrupted 时，把 user_actions 中的原因和链接交给用户自行点击处理，不自动换 ID 重试。submitted 表示平台接受提交，是否公开展示以平台审核为准。
 
 本地视频不嵌入 MCP 消息，而是通过随机授权、绑定具体文件的本机 HTTP 范围请求分块传输。授权两小时有效，MCP 桥接主进程重启后重新准备素材；文件变更会拒绝读取。从旧版使用新增 publish_article 或 prepare_post/publish_post 工具时，原位升级本 MCP 一次并重启，保留 agent 配置和已有配对资料。
 
 本次微博接入新增创作类型参数，并放开 publish_post 的固定平台枚举，启用新版时需原位更新 MCP 程序一次。后续同类平台增删由扩展校验，避免每次改平台枚举；保留安装位置、启动配置和配对资料，无需卸载重装。本版本提供可通过 npx 启动的构建包，未进行真实平台投稿验证。
 
-对应源码位于 npm 包及离线包内 `source/`，可在该目录安装开发依赖并运行构建命令。第三方依赖许可见 `THIRD_PARTY_NOTICES.txt`，本服务遵循 GPL-3.0-only，见 `LICENSE` 与 `NOTICE.md`。
+对应源码位于 npm 包内 `source/`，可在该目录安装开发依赖并运行构建命令。第三方依赖许可见 `THIRD_PARTY_NOTICES.txt`，本服务遵循 GPL-3.0-only，见 `LICENSE` 与 `NOTICE.md`。

package/index.cjs

@@ -29736,6 +29736,107 @@ var MediaStore = class {
   }
 };
 
+// package.json
+var package_default = {
+  name: "@writedock/mcp-server",
+  version: "0.4.2",
+  private: true,
+  type: "module",
+  description: "WriteDock local MCP server for the browser extension",
+  license: "GPL-3.0-only",
+  bin: { "writedock-mcp": "dist/index.cjs" },
+  scripts: {
+    build: "tsc --noEmit && tsup",
+    typecheck: "tsc --noEmit",
+    test: "vitest run"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    ws: "^8.18.0",
+    zod: "^3.25.76",
+    marked: "^17.0.1",
+    linkedom: "^0.18.12",
+    yaml: "^2.3.4"
+  },
+  devDependencies: {
+    "@types/ws": "^8.5.13",
+    tsup: "^8.0.1",
+    vitest: "^2.1.9"
+  }
+};
+
+// distribution.json
+var distribution_default = {
+  name: "writedock-mcp",
+  tag: "latest",
+  registry: "https://registry.npmjs.org/"
+};
+
+// src/release-info.ts
+var CHECK_INTERVAL = 6 * 60 * 6e4;
+var RETRY_INTERVAL = 10 * 6e4;
+var latestVersion;
+var checkedAt;
+var lastAttempt = 0;
+var checkError;
+var pending;
+function parseVersion(value) {
+  if (value.length > 120) return void 0;
+  const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(value);
+  if (!match) return void 0;
+  const core = match.slice(1, 4).map(Number);
+  if (core.some((number3) => !Number.isSafeInteger(number3))) return void 0;
+  const pre = match[4]?.split(".");
+  if (pre?.some((part) => !part || /^\d+$/.test(part) && part.length > 1 && part.startsWith("0"))) return void 0;
+  return { core, pre };
+}
+function newerVersion(candidate, current) {
+  const left = parseVersion(candidate), right = parseVersion(current);
+  if (!left || !right) return false;
+  for (let index = 0; index < 3; index++) if (left.core[index] !== right.core[index]) return left.core[index] > right.core[index];
+  if (!left.pre || !right.pre) return !left.pre && !!right.pre;
+  for (let index = 0; index < Math.max(left.pre.length, right.pre.length); index++) {
+    const a = left.pre[index], b2 = right.pre[index];
+    if (a === b2) continue;
+    if (a === void 0 || b2 === void 0) return a !== void 0;
+    const numericA = /^\d+$/.test(a), numericB = /^\d+$/.test(b2);
+    if (numericA && numericB) return a.length !== b2.length ? a.length > b2.length : a > b2;
+    if (numericA !== numericB) return !numericA;
+    return a > b2;
+  }
+  return false;
+}
+function refresh() {
+  if (pending || Date.now() - lastAttempt < (checkError ? RETRY_INTERVAL : CHECK_INTERVAL)) return;
+  lastAttempt = Date.now();
+  pending = (async () => {
+    const url = `${distribution_default.registry.replace(/\/$/, "")}/${encodeURIComponent(distribution_default.name)}/${encodeURIComponent(distribution_default.tag)}`;
+    const response = await fetch(url, { credentials: "omit", cache: "no-store", signal: AbortSignal.timeout(8e3) });
+    if (!response.ok) throw new Error(`npm \u7248\u672C\u67E5\u8BE2\u6682\u4E0D\u53EF\u7528\uFF08HTTP ${response.status}\uFF09`);
+    const data = await response.json();
+    if (data.name !== distribution_default.name || typeof data.version !== "string" || !parseVersion(data.version)) throw new Error("npm \u8FD4\u56DE\u7684\u7248\u672C\u4FE1\u606F\u65E0\u6CD5\u786E\u8BA4");
+    latestVersion = data.version;
+    checkError = void 0;
+  })().catch((error2) => {
+    latestVersion = void 0;
+    checkError = error2 instanceof Error && error2.message.startsWith("npm ") ? error2.message : "\u6682\u65F6\u65E0\u6CD5\u68C0\u67E5 npm \u65B0\u7248\u672C\uFF0C\u4E0D\u5F71\u54CD\u5F53\u524D\u8FDE\u63A5";
+  }).finally(() => {
+    checkedAt = Date.now();
+    pending = void 0;
+  });
+}
+function mcpReleaseInfo() {
+  refresh();
+  return {
+    mcp_version: package_default.version,
+    ...latestVersion ? { latest_version: latestVersion } : {},
+    update_available: !!latestVersion && newerVersion(latestVersion, package_default.version),
+    ...checkedAt ? { update_checked_at: checkedAt } : {},
+    ...checkError ? { update_check_error: checkError } : {},
+    update_checking: !!pending
+  };
+}
+
 // src/bridge.ts
 var LIMIT = 32 * 1024 * 1024;
 var messageOf = (error2) => error2 instanceof Error ? error2.message : String(error2);
@@ -29812,8 +29913,10 @@ var LocalBridge = class {
       });
     });
     this.primary = true;
+    mcpReleaseInfo();
     this.heartbeat = setInterval(() => {
-      if (this.client?.readyState === import_websocket.default.OPEN) this.client.send(JSON.stringify({ type: "ping" }));
+      const release = mcpReleaseInfo();
+      if (this.client?.readyState === import_websocket.default.OPEN) this.client.send(JSON.stringify({ type: "ping", ...release }));
     }, 2e4);
     this.heartbeat.unref();
   }
@@ -29900,16 +30003,16 @@ var LocalBridge = class {
           clearTimeout(timer);
           this.client = ws;
           this.extensionId = String(message.extensionId || "");
-          ws.send(JSON.stringify({ type: "ready" }));
+          ws.send(JSON.stringify({ type: "ready", ...mcpReleaseInfo() }));
           return;
         }
         if (message.type === "pong") return;
-        const pending = this.pending.get(message.id);
-        if (!pending) return;
+        const pending2 = this.pending.get(message.id);
+        if (!pending2) return;
         this.pending.delete(message.id);
-        clearTimeout(pending.timer);
-        if (message.error) pending.reject(new Error(message.error.message || "\u6269\u5C55\u64CD\u4F5C\u5931\u8D25"));
-        else pending.resolve(message.result);
+        clearTimeout(pending2.timer);
+        if (message.error) pending2.reject(new Error(message.error.message || "\u6269\u5C55\u64CD\u4F5C\u5931\u8D25"));
+        else pending2.resolve(message.result);
       } catch {
         ws.close(1008, "Invalid message");
       }
@@ -29971,7 +30074,7 @@ var LocalBridge = class {
       this.seenNonces.set(nonce, now + 3e4);
       responseNonce = nonce;
       if (req.method === "GET" && req.url === "/status") {
-        send(200, { connected: this.client?.readyState === import_websocket.default.OPEN, extensionId: this.extensionId, protocol: "writedock/1", pairing_available: true });
+        send(200, { connected: this.client?.readyState === import_websocket.default.OPEN, extensionId: this.extensionId, protocol: "writedock/1", pairing_available: true, ...mcpReleaseInfo() });
         return;
       }
       if (req.method === "POST" && req.url === "/pairing") {
@@ -30014,14 +30117,14 @@ var LocalBridge = class {
   }
   async status() {
     await this.start();
-    if (this.primary) return { connected: this.client?.readyState === import_websocket.default.OPEN, extensionId: this.extensionId, protocol: "writedock/1", pairing_available: true };
+    if (this.primary) return { connected: this.client?.readyState === import_websocket.default.OPEN, extensionId: this.extensionId, protocol: "writedock/1", pairing_available: true, ...mcpReleaseInfo() };
     try {
       return await this.httpCall("/status");
     } catch (error2) {
       if (!(error2 instanceof TypeError)) throw error2;
       this.starting = void 0;
       await this.start();
-      if (this.primary) return { connected: false, protocol: "writedock/1", pairing_available: true };
+      if (this.primary) return { connected: false, protocol: "writedock/1", pairing_available: true, ...mcpReleaseInfo() };
       throw error2;
     }
   }
@@ -50130,35 +50233,6 @@ async function prepareSource(source2, registerVideo) {
   return article;
 }
 
-// package.json
-var package_default = {
-  name: "@writedock/mcp-server",
-  version: "0.4.1",
-  private: true,
-  type: "module",
-  description: "WriteDock local MCP server for the browser extension",
-  license: "GPL-3.0-only",
-  bin: { "writedock-mcp": "dist/index.cjs" },
-  scripts: {
-    build: "tsc --noEmit && tsup",
-    typecheck: "tsc --noEmit",
-    test: "vitest run"
-  },
-  dependencies: {
-    "@modelcontextprotocol/sdk": "^1.25.2",
-    ws: "^8.18.0",
-    zod: "^3.25.76",
-    marked: "^17.0.1",
-    linkedom: "^0.18.12",
-    yaml: "^2.3.4"
-  },
-  devDependencies: {
-    "@types/ws": "^8.5.13",
-    tsup: "^8.0.1",
-    vitest: "^2.1.9"
-  }
-};
-
 // src/post.ts
 async function preparePost(source2, register) {
   if (!source2.title.trim() || source2.title.trim().length > 200) throw new Error("\u6807\u9898\u9700\u8981 1\u2013200 \u5B57");
@@ -50194,18 +50268,19 @@ var postSource = {
   weibo_video_creation: external_exports.enum(["original", "secondary", "repost"]).optional().describe("\u5FAE\u535A\u72EC\u7ACB\u89C6\u9891\u5FC5\u586B\uFF1Aoriginal \u539F\u521B\u3001secondary \u4E8C\u521B\u3001repost \u8F6C\u8F7D\u3002\u5FC5\u987B\u6839\u636E\u7528\u6237\u5B9E\u9645\u5185\u5BB9\u660E\u786E\u9009\u62E9\uFF0C\u4E0D\u5F97\u9ED8\u8BA4\u539F\u521B\u3002\u5176\u4ED6\u5E73\u53F0\u4E0D\u4F7F\u7528\u6B64\u5B57\u6BB5\uFF1B\u6765\u6E90\u3001\u5185\u5BB9\u58F0\u660E\u6216\u534F\u8BAE\u9700\u8865\u5145\u65F6\u8F6C\u4EBA\u5DE5\u5904\u7406"),
   base_directory: external_exports.string().optional().describe("\u4F7F\u7528\u76F8\u5BF9\u7D20\u6750\u8DEF\u5F84\u65F6\uFF0C\u660E\u786E\u6307\u5B9A\u7D20\u6750\u76EE\u5F55")
 };
+var agentWorkflow = "Agent \u53EA\u901A\u8FC7 WriteDock MCP \u6295\u7A3F\u548C\u67E5\u8BE2\u56DE\u6267\uFF0C\u4E0D\u4F9D\u8D56\u4E5F\u4E0D\u8981\u8C03\u7528\u6D4F\u89C8\u5668\u3001Playwright \u6216\u5176\u4ED6\u7F51\u9875\u5DE5\u5177\u3002\u6309\u7ED3\u679C\u7684 next_action \u64CD\u4F5C\uFF1Apoll_task \u7528\u539F task_id/request_id \u67E5\u8BE2 get_sync_task\uFF1Breport_result \u76F4\u63A5\u5411\u7528\u6237\u6C47\u62A5\u9010\u5E73\u53F0\u72B6\u6001\u548C\u94FE\u63A5\u3002submitted/published \u5DF2\u6709\u6269\u5C55\u786E\u8BA4\uFF0C\u4E0D\u518D\u6253\u5F00\u7F51\u9875\u9A8C\u8BC1\uFF1B\u9A8C\u8BC1\u7801\u3001\u56FE\u5F62\u9A8C\u8BC1\u3001\u534F\u8BAE\u3001\u53D1\u5E03\u8BBE\u7F6E\u6216 unknown/interrupted \u90FD\u5C06\u539F\u56E0\u548C\u94FE\u63A5\u4EA4\u7ED9\u7528\u6237\u81EA\u884C\u70B9\u51FB\u5904\u7406\uFF0C\u4E0D\u81EA\u52A8\u91CD\u53D1\u3001\u4E0D\u6362 request_id\u3002\u4EBA\u5DE5\u63A5\u7BA1\u4E0D\u4EE3\u8868\u5DF2\u7ECF\u53D1\u5E03\u3002";
 function createMcpServer(bridge) {
   const server = new McpServer({ name: "writedock", version: package_default.version }, {
-    instructions: 'WriteDock \u901A\u8FC7\u672C\u673A\u6269\u5C55\u6267\u884C\u6295\u7A3F\u3002\u5148\u68C0\u67E5\u8FDE\u63A5\u548C\u5E73\u53F0\u767B\u5F55\u3002\u5B9E\u9645\u5E73\u53F0\u80FD\u529B\u4EE5 list_platforms \u8FD4\u56DE\u7684 action\u3001publishModes\u3001tools\u3001modeOptions\u3001confirmation\u3001capabilities\u3001coverRequired \u4E3A\u51C6\uFF0C\u6269\u5C55\u66F4\u65B0\u540E\u4F18\u5148\u6309\u8BE5\u5143\u4FE1\u606F\u9009\u62E9\u5DE5\u5177\u3002\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u3001B\u7AD9\u4E13\u680F\u3001\u5C0F\u7EA2\u4E66\u957F\u6587\u4F7F\u7528 publish_article\uFF0CAgent \u76F4\u63A5\u63D0\u4F9B Markdown/HTML \u6216\u6587\u4EF6\u8DEF\u5F84\u5373\u53EF\u53D1\u5E03\uFF0C\u65E0\u9700\u7528\u6237\u5728\u6269\u5C55\u7F16\u8F91\u3002\u767E\u5BB6\u53F7\u5FC5\u987B\u63D0\u4F9B cover \u5C01\u9762\uFF1B\u77E5\u4E4E\u53E6\u652F\u6301 <video src="\u672C\u5730MP4\u8DEF\u5F84"></video> \u6587\u7AE0\u5185\u89C6\u9891\uFF0C\u72EC\u7ACB\u5C01\u9762\u6682\u672A\u63A5\u5165\u3002prepare_article \u4EC5\u4F9B\u53EF\u9009\u672C\u673A\u9884\u89C8\uFF0C\u4E0D\u662F\u53D1\u5E03\u7684\u524D\u7F6E\u8981\u6C42\u3002\u5C0F\u7EA2\u4E66 ID \u4E3A xiaohongshu\uFF0C\u4E09\u79CD\u6A21\u5F0F\u5171\u7528\u6B64\u5E73\u53F0\uFF1A\u5199\u957F\u6587\u7528 publish_article\uFF0C\u652F\u6301\u6B63\u6587\u56FE\u7247\u3001\u539F\u751F\u81EA\u52A8\u6392\u7248\u540E\u53D1\u5E03\uFF0C\u6807\u9898\u6700\u591A 64 \u5B57\u3001\u6B63\u6587\u6700\u591A 10000 \u5B57\uFF0C\u4E0D\u63A5\u72EC\u7ACB cover \u6216\u6587\u7AE0\u5185\u89C6\u9891\uFF1B\u666E\u901A\u56FE\u6587\u7528 publish_post(kind=image)\uFF0C\u72EC\u7ACB\u89C6\u9891\u7528 publish_post(kind=video)\uFF0C\u672A\u4F20 cover_path \u65F6\u4FDD\u7559\u5E73\u53F0\u81EA\u52A8\u751F\u6210\u7684\u7B2C\u4E00\u5E27\u5C01\u9762\u3002\u5C0F\u7EA2\u4E66\u6700\u7EC8\u5747\u987B\u5339\u914D POST /web_api/sns/v2/note \u7684 success=true\u3001result=0 \u548C\u7B14\u8BB0 ID \u56DE\u6267\u624D\u786E\u8BA4 submitted\u3002\u6296\u97F3\u5E73\u53F0 ID \u4E3A douyin\uFF0C\u56FE\u6587\u548C\u89C6\u9891\u540C\u6837\u7528 publish_post(kind=image|video)\uFF0C\u53EF\u9009 cover_path\uFF1B\u56FE\u6587\u8BDD\u9898\u6700\u591A 4 \u4E2A\u3001\u89C6\u9891\u6700\u591A 5 \u4E2A\uFF0C\u5F53\u524D\u53EA\u63A5\u5373\u65F6\u53D1\u5E03\u3002\u6296\u97F3 confirmation=native_page_message\uFF0C\u4EE5\u672C\u6B21\u64CD\u4F5C\u65B0\u589E\u7684\u539F\u751F\u6210\u529F\u63D0\u793A\u786E\u8BA4 submitted\uFF0C\u672A\u6838\u5BF9\u6700\u7EC8 HTTP \u4E1A\u52A1\u56DE\u6267\uFF1B\u4EC5\u8DF3\u8F6C\u4F5C\u54C1\u7BA1\u7406\u65F6\u4ECD\u4E3A unknown\uFF0CAgent \u4E0D\u81EA\u52A8\u91CD\u53D1\u3002\u5C0F\u7EA2\u4E66\u3001\u6296\u97F3\u3001\u5FAE\u535A\u666E\u901A\u56FE\u6587\u4E0E\u72EC\u7ACB\u89C6\u9891\u4F7F\u7528 prepare_post / publish_post\uFF0C\u5FAE\u535A\u5E73\u53F0 ID \u4ECD\u4E3A weibo\uFF0C\u4E0D\u53E6\u5EFA\u5E73\u53F0\u3002\u5FAE\u535A\u56FE\u6587\u6807\u9898\u653E\u5165\u6B63\u6587\u9996\u884C\uFF0C\u6700\u591A 18 \u5F20\u56FE\u7247\uFF1B\u72EC\u7ACB\u89C6\u9891\u6807\u9898\u6700\u591A 30 \u4E2A\u6C49\u5B57\uFF0860 \u4E2A\u534A\u89D2\u5B57\u7B26\uFF09\uFF0Cweibo_video_creation \u5FC5\u586B\uFF0C\u987B\u4F9D\u636E\u7528\u6237\u5B9E\u9645\u5185\u5BB9\u4F20 original\u3001secondary \u6216 repost\uFF0C\u4E0D\u80FD\u9ED8\u8BA4\u539F\u521B\u3002\u5FAE\u535A\u540C\u4E00\u6B21\u53EA\u80FD\u9009\u56FE\u6587\u6216\u89C6\u9891\uFF0C\u957F\u6587\u7AE0\u7EE7\u7EED\u7528 publish_article\u3002\u53EA\u6709\u7528\u6237\u660E\u786E\u8981\u6C42\u53D1\u5E03\u5E76\u6307\u5B9A\u5E73\u53F0\u65F6\u624D\u8C03\u7528\u53D1\u5E03\u5DE5\u5177\u3002\u5FAE\u4FE1\u516C\u4F17\u53F7\u3001\u641C\u72D0\u53F7\u76EE\u524D\u7528 sync_article \u4FDD\u5B58\u6587\u7AE0\u8349\u7A3F\u3002B\u7AD9\u4E13\u680F ID \u4E3A bilibili\uFF0C\u4F7F\u7528 publish_article \u76F4\u63A5\u53D1\u5E03\u6587\u5B57\u548C\u6B63\u6587\u56FE\u7247\uFF0C\u4E0D\u63A5\u89C6\u9891\u3001\u97F3\u9891\u3001\u9644\u52A0\u5185\u5BB9\u5361\u7247\u6216\u72EC\u7ACB\u5C01\u9762\uFF1B\u901A\u8FC7\u65B0\u7248\u539F\u751F\u7F16\u8F91\u5668\u4E0A\u4F20\u5E76\u53D1\u5E03\uFF0Ccode=-352 \u65F6\u505C\u6B62\u81EA\u52A8\u63D0\u4EA4\u5E76\u8F6C\u4EBA\u5DE5\u9A8C\u8BC1\u3002\u9047\u5230 needs_user_action \u6216 requires_user_action \u65F6\uFF0C\u628A user_actions \u4E2D\u7684\u539F\u56E0\u548C\u7A3F\u4EF6\u94FE\u63A5\u544A\u8BC9\u7528\u6237\uFF0C\u4F18\u5148\u8BA9\u7528\u6237\u5207\u6362\u5230\u6269\u5C55\u5DF2\u6253\u5F00\u7684\u9875\u9762\u5904\u7406\u9A8C\u8BC1\u7801\u3001\u5C01\u9762\u3001\u5185\u5BB9\u58F0\u660E\u3001\u6765\u6E90\u3001\u539F\u521B\u534F\u8BAE\u6216\u53D1\u5E03\u8BBE\u7F6E\uFF0C\u5E76\u624B\u52A8\u53D1\u5E03\uFF1B\u4E0D\u5F97\u81EA\u52A8\u89E3\u51B3\u9A8C\u8BC1\u7801\u3001\u91CD\u65B0\u63D0\u4EA4\u6216\u6362 request_id\u3002\u8BE5\u72B6\u6001\u53EA\u8BB0\u5F55\u4EBA\u5DE5\u63A5\u7BA1\uFF0C\u4E0D\u4EE3\u8868\u7528\u6237\u4E4B\u540E\u7684\u64CD\u4F5C\u7ED3\u679C\u5DF2\u88AB\u786E\u8BA4\u3002\u6269\u5C55\u66F4\u65B0\u590D\u7528\u5DF2\u6709 MCP\uFF1B\u9700\u8981\u6062\u590D\u8FDE\u63A5\u65F6\u8C03\u7528 begin_pairing\uFF0C\u8BA9\u7528\u6237\u5728\u6269\u5C55\u8F93\u5165\u914D\u5BF9\u7801\u3002\u63D0\u4EA4\u8FD4\u56DE\u4EFB\u52A1 ID\uFF0C\u968F\u540E\u7528 get_sync_task \u67E5\u8BE2\u7ED3\u679C\u3002\u4FDD\u6301\u540C\u4E00\u64CD\u4F5C\u7684 request_id \u4E0D\u53D8\u3002publicationState=unknown \u6216\u4EFB\u52A1\u4E2D\u65AD\u65F6\uFF0C\u5148\u8BA9\u7528\u6237\u68C0\u67E5\u5E73\u53F0\uFF0C\u4E0D\u8981\u81EA\u52A8\u751F\u6210\u65B0 request_id \u91CD\u53D1\u3002\u76F4\u63A5\u53D1\u5E03\u6210\u529F\u8868\u793A\u5E73\u53F0\u5DF2\u63A5\u53D7\u63D0\u4EA4\uFF0C\u662F\u5426\u516C\u5F00\u5C55\u793A\u4EE5\u5E73\u53F0\u4E3A\u51C6\u3002'
+    instructions: agentWorkflow + 'WriteDock \u901A\u8FC7\u672C\u673A\u6269\u5C55\u6267\u884C\u6295\u7A3F\u3002\u5148\u68C0\u67E5\u8FDE\u63A5\u548C\u5E73\u53F0\u767B\u5F55\u3002\u5B9E\u9645\u5E73\u53F0\u80FD\u529B\u4EE5 list_platforms \u8FD4\u56DE\u7684 action\u3001publishModes\u3001tools\u3001modeOptions\u3001confirmation\u3001capabilities\u3001coverRequired \u4E3A\u51C6\uFF0C\u6269\u5C55\u66F4\u65B0\u540E\u4F18\u5148\u6309\u8BE5\u5143\u4FE1\u606F\u9009\u62E9\u5DE5\u5177\u3002\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u3001B\u7AD9\u4E13\u680F\u3001\u5C0F\u7EA2\u4E66\u957F\u6587\u4F7F\u7528 publish_article\uFF0CAgent \u76F4\u63A5\u63D0\u4F9B Markdown/HTML \u6216\u6587\u4EF6\u8DEF\u5F84\u5373\u53EF\u53D1\u5E03\uFF0C\u65E0\u9700\u7528\u6237\u5728\u6269\u5C55\u7F16\u8F91\u3002\u767E\u5BB6\u53F7\u5FC5\u987B\u63D0\u4F9B cover \u5C01\u9762\uFF1B\u77E5\u4E4E\u53E6\u652F\u6301 <video src="\u672C\u5730MP4\u8DEF\u5F84"></video> \u6587\u7AE0\u5185\u89C6\u9891\uFF0C\u72EC\u7ACB\u5C01\u9762\u6682\u672A\u63A5\u5165\u3002prepare_article \u4EC5\u4F9B\u53EF\u9009\u672C\u673A\u9884\u89C8\uFF0C\u4E0D\u662F\u53D1\u5E03\u7684\u524D\u7F6E\u8981\u6C42\u3002\u5C0F\u7EA2\u4E66 ID \u4E3A xiaohongshu\uFF0C\u4E09\u79CD\u6A21\u5F0F\u5171\u7528\u6B64\u5E73\u53F0\uFF1A\u5199\u957F\u6587\u7528 publish_article\uFF0C\u652F\u6301\u6B63\u6587\u56FE\u7247\u3001\u539F\u751F\u81EA\u52A8\u6392\u7248\u540E\u53D1\u5E03\uFF0C\u6807\u9898\u6700\u591A 64 \u5B57\u3001\u6B63\u6587\u6700\u591A 10000 \u5B57\uFF0C\u4E0D\u63A5\u72EC\u7ACB cover \u6216\u6587\u7AE0\u5185\u89C6\u9891\uFF1B\u666E\u901A\u56FE\u6587\u7528 publish_post(kind=image)\uFF0C\u72EC\u7ACB\u89C6\u9891\u7528 publish_post(kind=video)\uFF0C\u672A\u4F20 cover_path \u65F6\u4FDD\u7559\u5E73\u53F0\u81EA\u52A8\u751F\u6210\u7684\u7B2C\u4E00\u5E27\u5C01\u9762\u3002\u5C0F\u7EA2\u4E66\u6700\u7EC8\u5747\u987B\u5339\u914D POST /web_api/sns/v2/note \u7684 success=true\u3001result=0 \u548C\u7B14\u8BB0 ID \u56DE\u6267\u624D\u786E\u8BA4 submitted\u3002\u6296\u97F3\u5E73\u53F0 ID \u4E3A douyin\uFF0C\u56FE\u6587\u548C\u89C6\u9891\u540C\u6837\u7528 publish_post(kind=image|video)\uFF0C\u53EF\u9009 cover_path\uFF1B\u56FE\u6587\u8BDD\u9898\u6700\u591A 4 \u4E2A\u3001\u89C6\u9891\u6700\u591A 5 \u4E2A\uFF0C\u5F53\u524D\u53EA\u63A5\u5373\u65F6\u53D1\u5E03\u3002\u6296\u97F3 confirmation=native_page_message\uFF0C\u4EE5\u672C\u6B21\u64CD\u4F5C\u65B0\u589E\u7684\u539F\u751F\u6210\u529F\u63D0\u793A\u786E\u8BA4 submitted\uFF0C\u672A\u6838\u5BF9\u6700\u7EC8 HTTP \u4E1A\u52A1\u56DE\u6267\uFF1B\u4EC5\u8DF3\u8F6C\u4F5C\u54C1\u7BA1\u7406\u65F6\u4ECD\u4E3A unknown\uFF0CAgent \u4E0D\u81EA\u52A8\u91CD\u53D1\u3002\u5C0F\u7EA2\u4E66\u3001\u6296\u97F3\u3001\u5FAE\u535A\u666E\u901A\u56FE\u6587\u4E0E\u72EC\u7ACB\u89C6\u9891\u4F7F\u7528 prepare_post / publish_post\uFF0C\u5FAE\u535A\u5E73\u53F0 ID \u4ECD\u4E3A weibo\uFF0C\u4E0D\u53E6\u5EFA\u5E73\u53F0\u3002\u5FAE\u535A\u56FE\u6587\u6807\u9898\u653E\u5165\u6B63\u6587\u9996\u884C\uFF0C\u6700\u591A 18 \u5F20\u56FE\u7247\uFF1B\u72EC\u7ACB\u89C6\u9891\u6807\u9898\u6700\u591A 30 \u4E2A\u6C49\u5B57\uFF0860 \u4E2A\u534A\u89D2\u5B57\u7B26\uFF09\uFF0Cweibo_video_creation \u5FC5\u586B\uFF0C\u987B\u4F9D\u636E\u7528\u6237\u5B9E\u9645\u5185\u5BB9\u4F20 original\u3001secondary \u6216 repost\uFF0C\u4E0D\u80FD\u9ED8\u8BA4\u539F\u521B\u3002\u5FAE\u535A\u540C\u4E00\u6B21\u53EA\u80FD\u9009\u56FE\u6587\u6216\u89C6\u9891\uFF0C\u957F\u6587\u7AE0\u7EE7\u7EED\u7528 publish_article\u3002\u53EA\u6709\u7528\u6237\u660E\u786E\u8981\u6C42\u53D1\u5E03\u5E76\u6307\u5B9A\u5E73\u53F0\u65F6\u624D\u8C03\u7528\u53D1\u5E03\u5DE5\u5177\u3002\u5FAE\u4FE1\u516C\u4F17\u53F7\u3001\u641C\u72D0\u53F7\u76EE\u524D\u7528 sync_article \u4FDD\u5B58\u6587\u7AE0\u8349\u7A3F\u3002B\u7AD9\u4E13\u680F ID \u4E3A bilibili\uFF0C\u4F7F\u7528 publish_article \u76F4\u63A5\u53D1\u5E03\u6587\u5B57\u548C\u6B63\u6587\u56FE\u7247\uFF0C\u4E0D\u63A5\u89C6\u9891\u3001\u97F3\u9891\u3001\u9644\u52A0\u5185\u5BB9\u5361\u7247\u6216\u72EC\u7ACB\u5C01\u9762\uFF1B\u901A\u8FC7\u65B0\u7248\u539F\u751F\u7F16\u8F91\u5668\u4E0A\u4F20\u5E76\u53D1\u5E03\uFF0Ccode=-352 \u65F6\u505C\u6B62\u81EA\u52A8\u63D0\u4EA4\u5E76\u8F6C\u4EBA\u5DE5\u9A8C\u8BC1\u3002\u9047\u5230 needs_user_action \u6216 requires_user_action \u65F6\uFF0C\u628A user_actions \u4E2D\u7684\u539F\u56E0\u548C\u7A3F\u4EF6\u94FE\u63A5\u544A\u8BC9\u7528\u6237\uFF0C\u4F18\u5148\u8BA9\u7528\u6237\u5207\u6362\u5230\u6269\u5C55\u5DF2\u6253\u5F00\u7684\u9875\u9762\u5904\u7406\u9A8C\u8BC1\u7801\u3001\u5C01\u9762\u3001\u5185\u5BB9\u58F0\u660E\u3001\u6765\u6E90\u3001\u539F\u521B\u534F\u8BAE\u6216\u53D1\u5E03\u8BBE\u7F6E\uFF0C\u5E76\u624B\u52A8\u53D1\u5E03\uFF1B\u4E0D\u5F97\u81EA\u52A8\u89E3\u51B3\u9A8C\u8BC1\u7801\u3001\u91CD\u65B0\u63D0\u4EA4\u6216\u6362 request_id\u3002\u8BE5\u72B6\u6001\u53EA\u8BB0\u5F55\u4EBA\u5DE5\u63A5\u7BA1\uFF0C\u4E0D\u4EE3\u8868\u7528\u6237\u4E4B\u540E\u7684\u64CD\u4F5C\u7ED3\u679C\u5DF2\u88AB\u786E\u8BA4\u3002\u6269\u5C55\u66F4\u65B0\u590D\u7528\u5DF2\u6709 MCP\uFF1B\u9700\u8981\u6062\u590D\u8FDE\u63A5\u65F6\u8C03\u7528 begin_pairing\uFF0C\u8BA9\u7528\u6237\u5728\u6269\u5C55\u8F93\u5165\u914D\u5BF9\u7801\u3002\u63D0\u4EA4\u8FD4\u56DE\u4EFB\u52A1 ID\uFF0C\u968F\u540E\u7528 get_sync_task \u67E5\u8BE2\u7ED3\u679C\u3002\u4FDD\u6301\u540C\u4E00\u64CD\u4F5C\u7684 request_id \u4E0D\u53D8\u3002publicationState=unknown \u6216\u4EFB\u52A1\u4E2D\u65AD\u65F6\uFF0C\u5411\u7528\u6237\u7ED9\u51FA\u94FE\u63A5\u8BA9\u5176\u81EA\u884C\u6838\u5BF9\u5E73\u53F0\uFF0CAgent \u4E0D\u6253\u5F00\u7F51\u9875\uFF0C\u4E0D\u8981\u81EA\u52A8\u751F\u6210\u65B0 request_id \u91CD\u53D1\u3002\u76F4\u63A5\u53D1\u5E03\u6210\u529F\u8868\u793A\u5E73\u53F0\u5DF2\u63A5\u53D7\u63D0\u4EA4\uFF0C\u662F\u5426\u516C\u5F00\u5C55\u793A\u4EE5\u5E73\u53F0\u4E3A\u51C6\u3002'
   });
   const wrap = (operation) => operation().then((result) => ({
     content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
   })).catch((error2) => ({ content: [{ type: "text", text: error2 instanceof Error ? error2.message : String(error2) }], isError: true }));
   const readOnly = { readOnlyHint: true, destructiveHint: false, openWorldHint: false };
   server.registerTool("get_connection_status", {
-    description: "\u68C0\u67E5\u672C\u673A MCP \u670D\u52A1\u548C\u6D4F\u89C8\u5668\u6269\u5C55\u662F\u5426\u5DF2\u7ECF\u914D\u5BF9\u8FDE\u63A5\u3002",
+    description: "\u68C0\u67E5\u672C\u673A MCP \u4E0E\u6269\u5C55\u7684\u8FDE\u63A5\u3001\u8FD0\u884C\u7248\u672C\u548C npm \u66F4\u65B0\u63D0\u793A\u3002update_available=true \u65F6\u544A\u77E5\u7528\u6237\u91CD\u65B0\u542F\u52A8 WriteDock MCP\uFF0C\u4FDD\u7559\u914D\u7F6E\u548C\u914D\u5BF9\uFF1B\u53D1\u5E03\u4EFB\u52A1\u8FDB\u884C\u4E2D\u4E0D\u8981\u81EA\u52A8\u91CD\u542F\u3002\u65E7\u7248\u670D\u52A1\u53EF\u80FD\u4E0D\u8FD4\u56DE\u7248\u672C\u5B57\u6BB5\uFF1Blatest_version \u7F3A\u5931\u6216 update_checking=true \u65F6\uFF0C\u4E0D\u5F97\u58F0\u79F0\u5DF2\u662F\u6700\u65B0\u7248\u3002",
     inputSchema: {},
-    annotations: readOnly
+    annotations: { ...readOnly, openWorldHint: true }
   }, () => wrap(() => bridge.status()));
   server.registerTool("begin_pairing", {
     description: "\u9996\u6B21\u8FDE\u63A5\u6216\u6269\u5C55\u5378\u8F7D\u91CD\u88C5\u540E\uFF0C\u751F\u6210 3 \u5206\u949F\u6709\u6548\u7684\u4E00\u6B21\u6027\u914D\u5BF9\u7801\u3002\u8BA9\u7528\u6237\u7C98\u8D34\u5230\u6269\u5C55\u7684 MCP \u8FDE\u63A5\u9875\u5373\u53EF\uFF0C\u590D\u7528\u5DF2\u6709 MCP \u548C agent \u914D\u7F6E\u3002\u65B0\u914D\u5BF9\u4F1A\u66FF\u6362\u6B64\u524D\u6D4F\u89C8\u5668\u7684\u8FDE\u63A5\u6388\u6743\uFF0C\u8BF7\u5728\u7528\u6237\u8981\u6C42\u8FDE\u63A5\u6269\u5C55\u65F6\u8C03\u7528\u3002",
@@ -50228,7 +50303,7 @@ function createMcpServer(bridge) {
     annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
   }, (args) => wrap(async () => bridge.request("prepareArticle", { article: await prepareSource(args, (path) => bridge.registerMedia(path, "video")) })));
   server.registerTool("publish_article", {
-    description: '\u76F4\u63A5\u53D1\u5E03 Agent \u5199\u597D\u7684\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u3001B\u7AD9\u4E13\u680F\u6216\u5C0F\u7EA2\u4E66\u957F\u6587\u3002\u5C0F\u7EA2\u4E66 platforms=["xiaohongshu"]\uFF0C\u63A5\u6536\u6807\u9898\u6700\u591A 64 \u5B57\u3001\u6B63\u6587\u6700\u591A 10000 \u5B57\u7684 Markdown/HTML \u53CA\u6B63\u6587\u56FE\u7247\uFF0C\u8D70\u5199\u957F\u6587\u2192\u539F\u751F\u81EA\u52A8\u6392\u7248\u2192\u4E0B\u4E00\u6B65\u2192\u53D1\u5E03\uFF1B\u4E0D\u63A5\u72EC\u7ACB cover\u3001\u6587\u7AE0\u5185\u89C6\u9891\u6216\u957F\u6587\u8BDD\u9898\u3002\u666E\u901A\u56FE\u6587\u548C\u72EC\u7ACB\u89C6\u9891\u6539\u7528 publish_post\u3002B\u7AD9\u4EC5\u63A5\u6587\u5B57\u548C\u6B63\u6587\u56FE\u7247\uFF0C\u6807\u9898\u957F\u5EA6\u6309\u539F\u751F\u9875\u9762\u6821\u9A8C\uFF1B\u4E0D\u63A5\u89C6\u9891\u3001\u97F3\u9891\u3001\u9644\u52A0\u5185\u5BB9\u5361\u7247\u6216\u72EC\u7ACB cover\u3002\u539F\u751F\u65B0\u7248\u7F16\u8F91\u5668\u751F\u6210 WBI \u7B7E\u540D\u548C\u98CE\u63A7\u53C2\u6570\uFF0C\u9A8C\u8BC1\u7801 code=-352 \u65F6\u8FD4\u56DE needs_user_action\uFF0CAgent \u8BA9\u7528\u6237\u5728\u5DF2\u6253\u5F00\u7684\u539F\u7A3F\u4EF6\u9875\u5B8C\u6210\u9A8C\u8BC1\u5E76\u624B\u52A8\u53D1\u5E03\uFF0C\u4E0D\u91CD\u53D1\u3002\u5FAE\u535A\u957F\u6587\u7AE0\u652F\u6301\u6B63\u6587\u56FE\u7247\u548C\u5C01\u9762\uFF0C\u65E0\u72EC\u7ACB\u5C01\u9762\u65F6\u4F7F\u7528\u672C\u7BC7\u9996\u56FE\uFF0C\u65E0\u6B63\u6587\u56FE\u7247\u65F6\u9700 cover\uFF0C\u5F53\u524D\u6807\u9898\u63A5\u6536 32 \u5B57\u4EE5\u5185\uFF1B\u4E0D\u63A5\u89C6\u9891 URL\uFF0C\u4E0D\u81EA\u52A8\u5173\u6CE8\u5B98\u65B9\u8D26\u53F7\u6216\u58F0\u660E\u539F\u521B\u3002\u9A8C\u8BC1\u7801\u53CA\u539F\u521B\u534F\u8BAE\u8F6C\u4EBA\u5DE5\u5904\u7406\uFF0C\u7528\u6237\u5B8C\u6210\u9A8C\u8BC1\u540E\u8FD8\u9700\u68C0\u67E5\u53D1\u5E03\u786E\u8BA4\u7A97\u53E3\u3002\u4F20 file_path/markdown/html \u4E09\u9009\u4E00\uFF0C\u6216 prepare_article \u7684 draft_id\uFF1B\u65E0\u9700\u7528\u6237\u5728\u6269\u5C55\u7F16\u5199\u3002\u767E\u5BB6\u53F7\u5FC5\u987B\u63D0\u4F9B cover\uFF08\u672C\u5730\u5C01\u9762\u56FE\u7247\u8DEF\u5F84\u6216\u56FE\u7247\u5730\u5740\uFF09\uFF0C\u5F53\u524D\u6807\u9898\u63A5\u6536 64 \u5B57\u4EE5\u5185\uFF1B\u9A8C\u8BC1\u7801\u6216\u5C01\u9762\u9700\u4EBA\u5DE5\u5904\u7406\u65F6\u8FD4\u56DE needs_user_action\uFF0CAgent \u5FC5\u987B\u628A\u539F\u56E0\u548C\u539F\u7A3F\u4EF6\u94FE\u63A5\u4EA4\u7ED9\u7528\u6237\uFF0C\u4E0D\u91CD\u8BD5\u3001\u4E0D\u6362 request_id\u3002\u77E5\u4E4E\u652F\u6301\u6B63\u6587\u56FE\u7247\u548C <video src="\u672C\u5730MP4\u8DEF\u5F84"></video> \u5185\u5D4C\u89C6\u9891\uFF0C\u6807\u9898\u6700\u591A 100 \u5B57\uFF0C\u4E0D\u652F\u6301\u5355\u72EC\u8BBE\u7F6E\u5C01\u9762\u548C\u8BDD\u9898\u3002cover \u53EF\u7528\u4E8E\u767E\u5BB6\u53F7\u548C\u5FAE\u535A\u957F\u6587\u7AE0\uFF1B\u5185\u5D4C\u89C6\u9891\u53EA\u5141\u8BB8\u5355\u72EC\u6295\u77E5\u4E4E\u3002\u6269\u5C55\u89E6\u53D1\u5E73\u53F0\u539F\u751F\u53D1\u5E03\uFF0C\u53EA\u6709\u5339\u914D\u672C\u4EFB\u52A1\u7684\u6700\u7EC8\u53D1\u5E03\u8BF7\u6C42\u53CA\u53EF\u6838\u5B9E\u7684\u6210\u529F\u56DE\u6267\u624D\u786E\u8BA4 submitted\u3002\u8FD4\u56DE task_id \u540E\u67E5\u8BE2 get_sync_task\u3002',
+    description: agentWorkflow + '\u76F4\u63A5\u53D1\u5E03 Agent \u5199\u597D\u7684\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u3001B\u7AD9\u4E13\u680F\u6216\u5C0F\u7EA2\u4E66\u957F\u6587\u3002\u5C0F\u7EA2\u4E66 platforms=["xiaohongshu"]\uFF0C\u63A5\u6536\u6807\u9898\u6700\u591A 64 \u5B57\u3001\u6B63\u6587\u6700\u591A 10000 \u5B57\u7684 Markdown/HTML \u53CA\u6B63\u6587\u56FE\u7247\uFF0C\u8D70\u5199\u957F\u6587\u2192\u539F\u751F\u81EA\u52A8\u6392\u7248\u2192\u4E0B\u4E00\u6B65\u2192\u53D1\u5E03\uFF1B\u4E0D\u63A5\u72EC\u7ACB cover\u3001\u6587\u7AE0\u5185\u89C6\u9891\u6216\u957F\u6587\u8BDD\u9898\u3002\u666E\u901A\u56FE\u6587\u548C\u72EC\u7ACB\u89C6\u9891\u6539\u7528 publish_post\u3002B\u7AD9\u4EC5\u63A5\u6587\u5B57\u548C\u6B63\u6587\u56FE\u7247\uFF0C\u6807\u9898\u957F\u5EA6\u6309\u539F\u751F\u9875\u9762\u6821\u9A8C\uFF1B\u4E0D\u63A5\u89C6\u9891\u3001\u97F3\u9891\u3001\u9644\u52A0\u5185\u5BB9\u5361\u7247\u6216\u72EC\u7ACB cover\u3002\u539F\u751F\u65B0\u7248\u7F16\u8F91\u5668\u751F\u6210 WBI \u7B7E\u540D\u548C\u98CE\u63A7\u53C2\u6570\uFF0C\u9A8C\u8BC1\u7801 code=-352 \u65F6\u8FD4\u56DE needs_user_action\uFF0CAgent \u8BA9\u7528\u6237\u5728\u5DF2\u6253\u5F00\u7684\u539F\u7A3F\u4EF6\u9875\u5B8C\u6210\u9A8C\u8BC1\u5E76\u624B\u52A8\u53D1\u5E03\uFF0C\u4E0D\u91CD\u53D1\u3002\u5FAE\u535A\u957F\u6587\u7AE0\u652F\u6301\u6B63\u6587\u56FE\u7247\u548C\u5C01\u9762\uFF0C\u65E0\u72EC\u7ACB\u5C01\u9762\u65F6\u4F7F\u7528\u672C\u7BC7\u9996\u56FE\uFF0C\u65E0\u6B63\u6587\u56FE\u7247\u65F6\u9700 cover\uFF0C\u5F53\u524D\u6807\u9898\u63A5\u6536 32 \u5B57\u4EE5\u5185\uFF1B\u4E0D\u63A5\u89C6\u9891 URL\uFF0C\u4E0D\u81EA\u52A8\u5173\u6CE8\u5B98\u65B9\u8D26\u53F7\u6216\u58F0\u660E\u539F\u521B\u3002\u9A8C\u8BC1\u7801\u53CA\u539F\u521B\u534F\u8BAE\u8F6C\u4EBA\u5DE5\u5904\u7406\uFF0C\u7528\u6237\u5B8C\u6210\u9A8C\u8BC1\u540E\u8FD8\u9700\u68C0\u67E5\u53D1\u5E03\u786E\u8BA4\u7A97\u53E3\u3002\u4F20 file_path/markdown/html \u4E09\u9009\u4E00\uFF0C\u6216 prepare_article \u7684 draft_id\uFF1B\u65E0\u9700\u7528\u6237\u5728\u6269\u5C55\u7F16\u5199\u3002\u767E\u5BB6\u53F7\u5FC5\u987B\u63D0\u4F9B cover\uFF08\u672C\u5730\u5C01\u9762\u56FE\u7247\u8DEF\u5F84\u6216\u56FE\u7247\u5730\u5740\uFF09\uFF0C\u5F53\u524D\u6807\u9898\u63A5\u6536 64 \u5B57\u4EE5\u5185\uFF1B\u9A8C\u8BC1\u7801\u6216\u5C01\u9762\u9700\u4EBA\u5DE5\u5904\u7406\u65F6\u8FD4\u56DE needs_user_action\uFF0CAgent \u5FC5\u987B\u628A\u539F\u56E0\u548C\u539F\u7A3F\u4EF6\u94FE\u63A5\u4EA4\u7ED9\u7528\u6237\uFF0C\u4E0D\u91CD\u8BD5\u3001\u4E0D\u6362 request_id\u3002\u77E5\u4E4E\u652F\u6301\u6B63\u6587\u56FE\u7247\u548C <video src="\u672C\u5730MP4\u8DEF\u5F84"></video> \u5185\u5D4C\u89C6\u9891\uFF0C\u6807\u9898\u6700\u591A 100 \u5B57\uFF0C\u4E0D\u652F\u6301\u5355\u72EC\u8BBE\u7F6E\u5C01\u9762\u548C\u8BDD\u9898\u3002cover \u53EF\u7528\u4E8E\u767E\u5BB6\u53F7\u548C\u5FAE\u535A\u957F\u6587\u7AE0\uFF1B\u5185\u5D4C\u89C6\u9891\u53EA\u5141\u8BB8\u5355\u72EC\u6295\u77E5\u4E4E\u3002\u6269\u5C55\u89E6\u53D1\u5E73\u53F0\u539F\u751F\u53D1\u5E03\u3002\u77E5\u4E4E\u4F18\u5148\u6838\u5BF9\u5339\u914D\u6587\u7AE0 ID \u7684 HTTP \u6210\u529F\u54CD\u5E94\uFF0C\u4E5F\u53EF\u7531\u6269\u5C55\u5728\u540C\u4E00\u4EFB\u52A1\u6807\u7B7E\u9875\u6838\u5BF9\u5339\u914D\u6587\u7AE0 ID\u3001\u6807\u9898\u7684\u539F\u751F\u53D1\u5E03\u6210\u529F\u5F39\u7A97\uFF0Cconfirmation \u533A\u5206 http_response/native_page_message\uFF1B\u4EC5\u8DF3\u8F6C\u4E0D\u7B97\u6210\u529F\u3002\u5176\u4ED6\u6587\u7AE0\u5E73\u53F0\u6309\u5404\u81EA\u5339\u914D\u7684\u6700\u7EC8 HTTP \u56DE\u6267\u786E\u8BA4 submitted\u3002\u8FD4\u56DE task_id \u540E\u67E5\u8BE2 get_sync_task\u3002',
     inputSchema: { ...source, cover: source.cover.describe("\u5E73\u53F0\u5C01\u9762\uFF1A\u672C\u5730\u56FE\u7247\u8DEF\u5F84\u3001HTTP(S) \u56FE\u7247\u5730\u5740\u6216 data URI\uFF1B\u6309 list_platforms \u7684 cover \u80FD\u529B\u548C coverRequired \u63D0\u4F9B\u3002\u5F53\u524D\u767E\u5BB6\u53F7\u5FC5\u586B\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u53EF\u9009\uFF0C\u77E5\u4E4E\u3001B\u7AD9\u4E13\u680F\u548C\u5C0F\u7EA2\u4E66\u957F\u6587\u4E0D\u652F\u6301\u72EC\u7ACB\u5C01\u9762"), request_id: requestId, platforms: external_exports.array(external_exports.string().min(1)).min(1).max(30).describe("\u5148\u6309 list_platforms \u7684 action=publish \u548C publishModes=article \u9009\u62E9\uFF1B\u5B9E\u9645\u652F\u6301\u8303\u56F4\u7531\u6269\u5C55\u6821\u9A8C"), draft_id: external_exports.string().optional() },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
   }, (args) => wrap(async () => {
@@ -50245,7 +50320,7 @@ function createMcpServer(bridge) {
     annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
   }, (args) => wrap(async () => bridge.request("preparePost", { post: await preparePost(args, (path, kind) => bridge.registerMedia(path, kind)) })));
   server.registerTool("publish_post", {
-    description: "\u76F4\u63A5\u5411\u7528\u6237\u660E\u786E\u6307\u5B9A\u7684\u5C0F\u7EA2\u4E66/\u6296\u97F3/\u5FAE\u535A\u516C\u5F00\u6295\u7A3F\uFF08\u5E73\u53F0\u53EF\u80FD\u5148\u5BA1\u6838\uFF09\uFF0C\u652F\u6301\u56FE\u6587\u548C\u72EC\u7ACB\u89C6\u9891\u3002\u5C0F\u7EA2\u4E66 ID \u4E3A xiaohongshu\uFF0Ckind=image \u4E0A\u4F20\u56FE\u7247\u540E\u586B\u5199\u6807\u9898/\u6B63\u6587\u5E76\u53D1\u5E03\uFF0Ckind=video \u4E0A\u4F20\u89C6\u9891\u540E\u53D1\u5E03\uFF0C\u7701\u7565 cover_path \u65F6\u6CBF\u7528\u5E73\u53F0\u89C6\u9891\u7B2C\u4E00\u5E27\u5C01\u9762\uFF1B\u5199\u957F\u6587\u5FC5\u987B\u7528 publish_article\u3002\u5C0F\u7EA2\u4E66\u4EC5\u5728\u672C\u4EFB\u52A1 POST /web_api/sns/v2/note \u8FD4\u56DE success=true\u3001result=0 \u53CA\u6709\u6548\u7B14\u8BB0 ID \u65F6\u786E\u8BA4 submitted\u3002\u6296\u97F3 ID \u4E3A douyin\uFF0Ckind=image/video \u590D\u7528\u539F\u751F\u4E0A\u4F20\u3001\u586B\u5199\u548C\u53D1\u5E03\u6D41\u7A0B\uFF0C\u53EF\u9009\u89C6\u9891 cover_path\uFF0C\u5F53\u524D\u4EC5\u63A5\u5373\u65F6\u53D1\u5E03\uFF1B\u56FE\u6587\u8BDD\u9898\u6700\u591A 4 \u4E2A\u3001\u89C6\u9891\u6700\u591A 5 \u4E2A\u3002\u6296\u97F3\u4EE5\u672C\u6B21\u64CD\u4F5C\u65B0\u589E\u7684\u539F\u751F\u6210\u529F\u63D0\u793A\u786E\u8BA4 submitted\uFF0Cconfirmation=native_page_message\uFF0C\u672A\u63A5\u6700\u7EC8 HTTP \u4E1A\u52A1\u56DE\u6267\u6838\u5BF9\uFF1B\u9875\u9762\u8DF3\u8F6C\u672C\u8EAB\u4E0D\u7B97\u6210\u529F\uFF0C\u7F3A\u5C11\u660E\u786E\u63D0\u793A\u5219\u8FD4\u56DE unknown\uFF0C\u4E0D\u80FD\u91CD\u53D1\u3002\u5FAE\u535A ID \u4E3A weibo\uFF0Ckind=image \u6700\u591A 18 \u5F20\uFF0C\u6807\u9898\u5E76\u5165\u6B63\u6587\u9996\u884C\uFF1Bkind=video \u5FC5\u987B\u660E\u786E weibo_video_creation\uFF08original/secondary/repost\uFF09\uFF0C\u6807\u9898\u6700\u591A 30 \u4E2A\u6C49\u5B57\u6216 60 \u4E2A\u534A\u89D2\u5B57\u7B26\u3002\u5FAE\u535A\u56FE\u6587/\u89C6\u9891\u4E92\u65A5\uFF0C\u957F\u6587\u7AE0\u4F7F\u7528 publish_article\u3002\u53EF\u4F20 prepare_post \u7684 draft_id\uFF0C\u6216\u76F4\u63A5\u4F20\u5B8C\u6574\u7D20\u6750\u53C2\u6570\u3002\u901A\u8FC7\u5E73\u53F0\u539F\u751F\u9875\u9762\u4E0A\u4F20\u5E76\u53D1\u9001\uFF0C\u5FAE\u535A\u53EA\u6709\u5339\u914D\u672C\u4EFB\u52A1\u7684 statuses/update \u6210\u529F\u56DE\u6267\u624D\u786E\u8BA4 submitted\u3002\u9A8C\u8BC1\u7801\u3001\u6765\u6E90\u3001\u5185\u5BB9\u58F0\u660E\u3001\u5C01\u9762\u6216\u534F\u8BAE\u9700\u4EBA\u5DE5\u5904\u7406\u65F6\u8FD4\u56DE needs_user_action\uFF0CAgent \u5E94\u628A\u539F\u56E0\u548C\u539F\u6295\u7A3F\u9875\u94FE\u63A5\u544A\u77E5\u7528\u6237\uFF0C\u4E0D\u91CD\u8BD5\u3002\u5FC5\u987B\u4F7F\u7528\u7A33\u5B9A request_id\uFF1B\u8FD4\u56DE task_id \u540E\u67E5\u8BE2 get_sync_task\uFF0Cunknown \u65F6\u5148\u68C0\u67E5\u5E73\u53F0\u3002",
+    description: agentWorkflow + "\u76F4\u63A5\u5411\u7528\u6237\u660E\u786E\u6307\u5B9A\u7684\u5C0F\u7EA2\u4E66/\u6296\u97F3/\u5FAE\u535A\u516C\u5F00\u6295\u7A3F\uFF08\u5E73\u53F0\u53EF\u80FD\u5148\u5BA1\u6838\uFF09\uFF0C\u652F\u6301\u56FE\u6587\u548C\u72EC\u7ACB\u89C6\u9891\u3002\u5C0F\u7EA2\u4E66 ID \u4E3A xiaohongshu\uFF0Ckind=image \u4E0A\u4F20\u56FE\u7247\u540E\u586B\u5199\u6807\u9898/\u6B63\u6587\u5E76\u53D1\u5E03\uFF0Ckind=video \u4E0A\u4F20\u89C6\u9891\u540E\u53D1\u5E03\uFF0C\u7701\u7565 cover_path \u65F6\u6CBF\u7528\u5E73\u53F0\u89C6\u9891\u7B2C\u4E00\u5E27\u5C01\u9762\uFF1B\u5199\u957F\u6587\u5FC5\u987B\u7528 publish_article\u3002\u5C0F\u7EA2\u4E66\u4EC5\u5728\u672C\u4EFB\u52A1 POST /web_api/sns/v2/note \u8FD4\u56DE success=true\u3001result=0 \u53CA\u6709\u6548\u7B14\u8BB0 ID \u65F6\u786E\u8BA4 submitted\u3002\u6296\u97F3 ID \u4E3A douyin\uFF0Ckind=image/video \u590D\u7528\u539F\u751F\u4E0A\u4F20\u3001\u586B\u5199\u548C\u53D1\u5E03\u6D41\u7A0B\uFF0C\u53EF\u9009\u89C6\u9891 cover_path\uFF0C\u5F53\u524D\u4EC5\u63A5\u5373\u65F6\u53D1\u5E03\uFF1B\u56FE\u6587\u8BDD\u9898\u6700\u591A 4 \u4E2A\u3001\u89C6\u9891\u6700\u591A 5 \u4E2A\u3002\u6296\u97F3\u4EE5\u672C\u6B21\u64CD\u4F5C\u65B0\u589E\u7684\u539F\u751F\u6210\u529F\u63D0\u793A\u786E\u8BA4 submitted\uFF0Cconfirmation=native_page_message\uFF0C\u672A\u63A5\u6700\u7EC8 HTTP \u4E1A\u52A1\u56DE\u6267\u6838\u5BF9\uFF1B\u9875\u9762\u8DF3\u8F6C\u672C\u8EAB\u4E0D\u7B97\u6210\u529F\uFF0C\u7F3A\u5C11\u660E\u786E\u63D0\u793A\u5219\u8FD4\u56DE unknown\uFF0C\u4E0D\u80FD\u91CD\u53D1\u3002\u5FAE\u535A ID \u4E3A weibo\uFF0Ckind=image \u6700\u591A 18 \u5F20\uFF0C\u6807\u9898\u5E76\u5165\u6B63\u6587\u9996\u884C\uFF1Bkind=video \u5FC5\u987B\u660E\u786E weibo_video_creation\uFF08original/secondary/repost\uFF09\uFF0C\u6807\u9898\u6700\u591A 30 \u4E2A\u6C49\u5B57\u6216 60 \u4E2A\u534A\u89D2\u5B57\u7B26\u3002\u5FAE\u535A\u56FE\u6587/\u89C6\u9891\u4E92\u65A5\uFF0C\u957F\u6587\u7AE0\u4F7F\u7528 publish_article\u3002\u53EF\u4F20 prepare_post \u7684 draft_id\uFF0C\u6216\u76F4\u63A5\u4F20\u5B8C\u6574\u7D20\u6750\u53C2\u6570\u3002\u901A\u8FC7\u5E73\u53F0\u539F\u751F\u9875\u9762\u4E0A\u4F20\u5E76\u53D1\u9001\uFF0C\u5FAE\u535A\u53EA\u6709\u5339\u914D\u672C\u4EFB\u52A1\u7684 statuses/update \u6210\u529F\u56DE\u6267\u624D\u786E\u8BA4 submitted\u3002\u9A8C\u8BC1\u7801\u3001\u6765\u6E90\u3001\u5185\u5BB9\u58F0\u660E\u3001\u5C01\u9762\u6216\u534F\u8BAE\u9700\u4EBA\u5DE5\u5904\u7406\u65F6\u8FD4\u56DE needs_user_action\uFF0CAgent \u5E94\u628A\u539F\u56E0\u548C\u539F\u6295\u7A3F\u9875\u94FE\u63A5\u544A\u77E5\u7528\u6237\uFF0C\u4E0D\u91CD\u8BD5\u3002\u5FC5\u987B\u4F7F\u7528\u7A33\u5B9A request_id\uFF1B\u8FD4\u56DE task_id \u540E\u67E5\u8BE2 get_sync_task\uFF0Cunknown \u65F6\u5C06\u94FE\u63A5\u4EA4\u7ED9\u7528\u6237\u81EA\u884C\u6838\u5BF9\uFF0CAgent \u4E0D\u8C03\u7528\u6D4F\u89C8\u5668\u3002",
     inputSchema: { ...postSource, kind: postSource.kind.optional(), title: postSource.title.optional(), draft_id: external_exports.string().optional(), request_id: requestId, platforms: external_exports.array(external_exports.string().min(1)).min(1).max(30).describe("\u6309 list_platforms \u8FD4\u56DE\u7684 publishModes=image/video \u53CA\u5DE5\u5177\u4FE1\u606F\u9009\u62E9\uFF0C\u5F53\u524D\u4E3A xiaohongshu\u3001douyin\u3001weibo\uFF1B\u7531\u6269\u5C55\u6821\u9A8C\uFF0C\u540E\u7EED\u5E73\u53F0\u53D8\u66F4\u4E0D\u8981\u6C42\u56FA\u5B9A\u679A\u4E3E\u5347\u7EA7") },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
   }, (args) => wrap(async () => {
@@ -50266,7 +50341,7 @@ function createMcpServer(bridge) {
     });
   }));
   server.registerTool("get_sync_task", {
-    description: "\u67E5\u8BE2\u53D1\u5E03\u6216\u8349\u7A3F\u4EFB\u52A1\u7684\u8FDB\u5EA6\u3001\u9010\u5E73\u53F0\u7ED3\u679C\u53CA\u5185\u5BB9\u94FE\u63A5\u3002publicationState=submitted \u8868\u793A\u63A5\u53E3\u5DF2\u786E\u8BA4\u63D0\u4EA4\uFF1Bneeds_user_action \u6216 requires_user_action \u8868\u793A\u9700\u8981\u7528\u6237\u63A5\u7BA1\uFF0C\u8BF7\u5C06 user_actions \u4E2D\u7684\u539F\u56E0\u4E0E\u94FE\u63A5\u544A\u8BC9\u7528\u6237\u624B\u52A8\u5904\u7406\uFF0C\u4E0D\u91CD\u65B0\u6295\u7A3F\uFF1Bunknown \u8868\u793A\u7ED3\u679C\u672A\u786E\u8BA4\uFF0C\u4E0D\u80FD\u81EA\u52A8\u91CD\u53D1\u3002\u53EF\u4F20 task_id \u6216\u539F request_id\u3002",
+    description: agentWorkflow + "\u67E5\u8BE2\u53D1\u5E03\u6216\u8349\u7A3F\u4EFB\u52A1\u7684\u8FDB\u5EA6\u3001\u9010\u5E73\u53F0\u7ED3\u679C\u53CA\u5185\u5BB9\u94FE\u63A5\u3002publicationState=submitted \u8868\u793A\u6269\u5C55\u5DF2\u6309\u5E73\u53F0 confirmation \u786E\u8BA4\u63D0\u4EA4\uFF1Bneeds_user_action \u6216 requires_user_action \u8868\u793A\u9700\u8981\u7528\u6237\u63A5\u7BA1\uFF0C\u8BF7\u5C06 user_actions \u4E2D\u7684\u539F\u56E0\u4E0E\u94FE\u63A5\u544A\u8BC9\u7528\u6237\u624B\u52A8\u5904\u7406\uFF0C\u4E0D\u91CD\u65B0\u6295\u7A3F\uFF1Bunknown \u8868\u793A\u7ED3\u679C\u672A\u786E\u8BA4\uFF0C\u4E0D\u80FD\u81EA\u52A8\u91CD\u53D1\u3002\u53EF\u4F20 task_id \u6216\u539F request_id\u3002",
     inputSchema: { task_id: external_exports.string().optional(), request_id: external_exports.string().optional() },
     annotations: readOnly
   }, (args) => wrap(() => bridge.request("getSyncTask", { taskId: args.task_id, requestId: args.request_id })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "writedock-mcp",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "WriteDock local MCP server for the browser extension",
   "type": "commonjs",
   "license": "GPL-3.0-only",

package/source/distribution.json

@@ -0,0 +1,5 @@
+{
+  "name": "writedock-mcp",
+  "tag": "latest",
+  "registry": "https://registry.npmjs.org/"
+}

package/source/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@writedock/mcp-server",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "private": true,
   "type": "module",
   "description": "WriteDock local MCP server for the browser extension",

package/source/src/bridge.ts

@@ -5,6 +5,7 @@ import http from 'node:http'
 import { createCipheriv, createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from 'node:crypto'
 import { WebSocket, WebSocketServer } from 'ws'
 import { MediaStore, type MediaAsset } from './media'
+import { mcpReleaseInfo } from './release-info'
 
 const LIMIT = 32 * 1024 * 1024
 const messageOf = (error: unknown) => error instanceof Error ? error.message : String(error)
@@ -68,8 +69,10 @@ export class LocalBridge {
       server.listen(this.port, '127.0.0.1', () => { server.off('error', reject); resolve() })
     })
     this.primary = true
+    mcpReleaseInfo()
     this.heartbeat = setInterval(() => {
-      if (this.client?.readyState === WebSocket.OPEN) this.client.send(JSON.stringify({ type: 'ping' }))
+      const release = mcpReleaseInfo()
+      if (this.client?.readyState === WebSocket.OPEN) this.client.send(JSON.stringify({ type: 'ping', ...release }))
     }, 20_000)
     this.heartbeat.unref()
   }
@@ -143,7 +146,7 @@ export class LocalBridge {
           if (this.client?.readyState === WebSocket.OPEN) { ws.close(1008, 'An extension is already connected'); return }
           authenticated = true; clearTimeout(timer)
           this.client = ws; this.extensionId = String(message.extensionId || '')
-          ws.send(JSON.stringify({ type: 'ready' }))
+          ws.send(JSON.stringify({ type: 'ready', ...mcpReleaseInfo() }))
           return
         }
         if (message.type === 'pong') return
@@ -202,7 +205,7 @@ export class LocalBridge {
       this.seenNonces.set(nonce, now + 30_000)
       responseNonce = nonce
       if (req.method === 'GET' && req.url === '/status') {
-        send(200, { connected: this.client?.readyState === WebSocket.OPEN, extensionId: this.extensionId, protocol: 'writedock/1', pairing_available: true }); return
+        send(200, { connected: this.client?.readyState === WebSocket.OPEN, extensionId: this.extensionId, protocol: 'writedock/1', pairing_available: true, ...mcpReleaseInfo() }); return
       }
       if (req.method === 'POST' && req.url === '/pairing') { send(200, await this.beginPairing()); return }
       if (req.method === 'POST' && req.url === '/assets/register') {
@@ -237,14 +240,14 @@ export class LocalBridge {
 
   async status() {
     await this.start()
-    if (this.primary) return { connected: this.client?.readyState === WebSocket.OPEN, extensionId: this.extensionId, protocol: 'writedock/1', pairing_available: true }
+    if (this.primary) return { connected: this.client?.readyState === WebSocket.OPEN, extensionId: this.extensionId, protocol: 'writedock/1', pairing_available: true, ...mcpReleaseInfo() }
     try { return await this.httpCall('/status') }
     catch (error) {
       if (!(error instanceof TypeError)) throw error
       // Read-only health checks can acquire the vacant port after another MCP client exits.
       this.starting = undefined
       await this.start()
-      if (this.primary) return { connected: false, protocol: 'writedock/1', pairing_available: true }
+      if (this.primary) return { connected: false, protocol: 'writedock/1', pairing_available: true, ...mcpReleaseInfo() }
       throw error
     }
   }

package/source/src/release-info.ts

@@ -0,0 +1,67 @@
+import mcpPackage from '../package.json'
+import distribution from '../distribution.json'
+
+const CHECK_INTERVAL = 6 * 60 * 60_000
+const RETRY_INTERVAL = 10 * 60_000
+let latestVersion: string | undefined
+let checkedAt: number | undefined
+let lastAttempt = 0
+let checkError: string | undefined
+let pending: Promise<void> | undefined
+
+function parseVersion(value: string) {
+  if (value.length > 120) return undefined
+  const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(value)
+  if (!match) return undefined
+  const core = match.slice(1, 4).map(Number)
+  if (core.some(number => !Number.isSafeInteger(number))) return undefined
+  const pre = match[4]?.split('.')
+  if (pre?.some(part => !part || /^\d+$/.test(part) && part.length > 1 && part.startsWith('0'))) return undefined
+  return { core, pre }
+}
+
+export function newerVersion(candidate: string, current: string) {
+  const left = parseVersion(candidate), right = parseVersion(current)
+  if (!left || !right) return false
+  for (let index = 0; index < 3; index++) if (left.core[index] !== right.core[index]) return left.core[index] > right.core[index]
+  if (!left.pre || !right.pre) return !left.pre && !!right.pre
+  for (let index = 0; index < Math.max(left.pre.length, right.pre.length); index++) {
+    const a = left.pre[index], b = right.pre[index]
+    if (a === b) continue
+    if (a === undefined || b === undefined) return a !== undefined
+    const numericA = /^\d+$/.test(a), numericB = /^\d+$/.test(b)
+    if (numericA && numericB) return a.length !== b.length ? a.length > b.length : a > b
+    if (numericA !== numericB) return !numericA
+    return a > b
+  }
+  return false
+}
+
+function refresh() {
+  if (pending || Date.now() - lastAttempt < (checkError ? RETRY_INTERVAL : CHECK_INTERVAL)) return
+  lastAttempt = Date.now()
+  pending = (async () => {
+    const url = `${distribution.registry.replace(/\/$/, '')}/${encodeURIComponent(distribution.name)}/${encodeURIComponent(distribution.tag)}`
+    const response = await fetch(url, { credentials: 'omit', cache: 'no-store', signal: AbortSignal.timeout(8000) })
+    if (!response.ok) throw new Error(`npm 版本查询暂不可用（HTTP ${response.status}）`)
+    const data = await response.json() as { name?: unknown; version?: unknown }
+    if (data.name !== distribution.name || typeof data.version !== 'string' || !parseVersion(data.version)) throw new Error('npm 返回的版本信息无法确认')
+    latestVersion = data.version; checkError = undefined
+  })().catch(error => {
+    latestVersion = undefined
+    checkError = error instanceof Error && error.message.startsWith('npm ') ? error.message : '暂时无法检查 npm 新版本，不影响当前连接'
+  }).finally(() => { checkedAt = Date.now(); pending = undefined })
+}
+
+/** Check asynchronously; version lookup must never delay pairing, tool calls or publication. */
+export function mcpReleaseInfo() {
+  refresh()
+  return {
+    mcp_version: mcpPackage.version,
+    ...(latestVersion ? { latest_version: latestVersion } : {}),
+    update_available: !!latestVersion && newerVersion(latestVersion, mcpPackage.version),
+    ...(checkedAt ? { update_checked_at: checkedAt } : {}),
+    ...(checkError ? { update_check_error: checkError } : {}),
+    update_checking: !!pending,
+  }
+}

package/source/src/server.ts

@@ -26,9 +26,11 @@ const postSource = {
   base_directory: z.string().optional().describe('使用相对素材路径时，明确指定素材目录'),
 }
 
+const agentWorkflow = 'Agent 只通过 WriteDock MCP 投稿和查询回执，不依赖也不要调用浏览器、Playwright 或其他网页工具。按结果的 next_action 操作：poll_task 用原 task_id/request_id 查询 get_sync_task；report_result 直接向用户汇报逐平台状态和链接。submitted/published 已有扩展确认，不再打开网页验证；验证码、图形验证、协议、发布设置或 unknown/interrupted 都将原因和链接交给用户自行点击处理，不自动重发、不换 request_id。人工接管不代表已经发布。'
+
 export function createMcpServer(bridge: LocalBridge) {
   const server = new McpServer({ name: 'writedock', version: mcpPackage.version }, {
-    instructions: 'WriteDock 通过本机扩展执行投稿。先检查连接和平台登录。实际平台能力以 list_platforms 返回的 action、publishModes、tools、modeOptions、confirmation、capabilities、coverRequired 为准，扩展更新后优先按该元信息选择工具。知乎、百家号、微博长文章、B站专栏、小红书长文使用 publish_article，Agent 直接提供 Markdown/HTML 或文件路径即可发布，无需用户在扩展编辑。百家号必须提供 cover 封面；知乎另支持 <video src="本地MP4路径"></video> 文章内视频，独立封面暂未接入。prepare_article 仅供可选本机预览，不是发布的前置要求。小红书 ID 为 xiaohongshu，三种模式共用此平台：写长文用 publish_article，支持正文图片、原生自动排版后发布，标题最多 64 字、正文最多 10000 字，不接独立 cover 或文章内视频；普通图文用 publish_post(kind=image)，独立视频用 publish_post(kind=video)，未传 cover_path 时保留平台自动生成的第一帧封面。小红书最终均须匹配 POST /web_api/sns/v2/note 的 success=true、result=0 和笔记 ID 回执才确认 submitted。抖音平台 ID 为 douyin，图文和视频同样用 publish_post(kind=image|video)，可选 cover_path；图文话题最多 4 个、视频最多 5 个，当前只接即时发布。抖音 confirmation=native_page_message，以本次操作新增的原生成功提示确认 submitted，未核对最终 HTTP 业务回执；仅跳转作品管理时仍为 unknown，Agent 不自动重发。小红书、抖音、微博普通图文与独立视频使用 prepare_post / publish_post，微博平台 ID 仍为 weibo，不另建平台。微博图文标题放入正文首行，最多 18 张图片；独立视频标题最多 30 个汉字（60 个半角字符），weibo_video_creation 必填，须依据用户实际内容传 original、secondary 或 repost，不能默认原创。微博同一次只能选图文或视频，长文章继续用 publish_article。只有用户明确要求发布并指定平台时才调用发布工具。微信公众号、搜狐号目前用 sync_article 保存文章草稿。B站专栏 ID 为 bilibili，使用 publish_article 直接发布文字和正文图片，不接视频、音频、附加内容卡片或独立封面；通过新版原生编辑器上传并发布，code=-352 时停止自动提交并转人工验证。遇到 needs_user_action 或 requires_user_action 时，把 user_actions 中的原因和稿件链接告诉用户，优先让用户切换到扩展已打开的页面处理验证码、封面、内容声明、来源、原创协议或发布设置，并手动发布；不得自动解决验证码、重新提交或换 request_id。该状态只记录人工接管，不代表用户之后的操作结果已被确认。扩展更新复用已有 MCP；需要恢复连接时调用 begin_pairing，让用户在扩展输入配对码。提交返回任务 ID，随后用 get_sync_task 查询结果。保持同一操作的 request_id 不变。publicationState=unknown 或任务中断时，先让用户检查平台，不要自动生成新 request_id 重发。直接发布成功表示平台已接受提交，是否公开展示以平台为准。',
+    instructions: agentWorkflow + 'WriteDock 通过本机扩展执行投稿。先检查连接和平台登录。实际平台能力以 list_platforms 返回的 action、publishModes、tools、modeOptions、confirmation、capabilities、coverRequired 为准，扩展更新后优先按该元信息选择工具。知乎、百家号、微博长文章、B站专栏、小红书长文使用 publish_article，Agent 直接提供 Markdown/HTML 或文件路径即可发布，无需用户在扩展编辑。百家号必须提供 cover 封面；知乎另支持 <video src="本地MP4路径"></video> 文章内视频，独立封面暂未接入。prepare_article 仅供可选本机预览，不是发布的前置要求。小红书 ID 为 xiaohongshu，三种模式共用此平台：写长文用 publish_article，支持正文图片、原生自动排版后发布，标题最多 64 字、正文最多 10000 字，不接独立 cover 或文章内视频；普通图文用 publish_post(kind=image)，独立视频用 publish_post(kind=video)，未传 cover_path 时保留平台自动生成的第一帧封面。小红书最终均须匹配 POST /web_api/sns/v2/note 的 success=true、result=0 和笔记 ID 回执才确认 submitted。抖音平台 ID 为 douyin，图文和视频同样用 publish_post(kind=image|video)，可选 cover_path；图文话题最多 4 个、视频最多 5 个，当前只接即时发布。抖音 confirmation=native_page_message，以本次操作新增的原生成功提示确认 submitted，未核对最终 HTTP 业务回执；仅跳转作品管理时仍为 unknown，Agent 不自动重发。小红书、抖音、微博普通图文与独立视频使用 prepare_post / publish_post，微博平台 ID 仍为 weibo，不另建平台。微博图文标题放入正文首行，最多 18 张图片；独立视频标题最多 30 个汉字（60 个半角字符），weibo_video_creation 必填，须依据用户实际内容传 original、secondary 或 repost，不能默认原创。微博同一次只能选图文或视频，长文章继续用 publish_article。只有用户明确要求发布并指定平台时才调用发布工具。微信公众号、搜狐号目前用 sync_article 保存文章草稿。B站专栏 ID 为 bilibili，使用 publish_article 直接发布文字和正文图片，不接视频、音频、附加内容卡片或独立封面；通过新版原生编辑器上传并发布，code=-352 时停止自动提交并转人工验证。遇到 needs_user_action 或 requires_user_action 时，把 user_actions 中的原因和稿件链接告诉用户，优先让用户切换到扩展已打开的页面处理验证码、封面、内容声明、来源、原创协议或发布设置，并手动发布；不得自动解决验证码、重新提交或换 request_id。该状态只记录人工接管，不代表用户之后的操作结果已被确认。扩展更新复用已有 MCP；需要恢复连接时调用 begin_pairing，让用户在扩展输入配对码。提交返回任务 ID，随后用 get_sync_task 查询结果。保持同一操作的 request_id 不变。publicationState=unknown 或任务中断时，向用户给出链接让其自行核对平台，Agent 不打开网页，不要自动生成新 request_id 重发。直接发布成功表示平台已接受提交，是否公开展示以平台为准。',
   })
   const wrap = (operation: () => Promise<unknown>) => operation().then(result => ({
     content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }],
@@ -36,7 +38,7 @@ export function createMcpServer(bridge: LocalBridge) {
   const readOnly = { readOnlyHint: true, destructiveHint: false, openWorldHint: false }
 
   server.registerTool('get_connection_status', {
-    description: '检查本机 MCP 服务和浏览器扩展是否已经配对连接。', inputSchema: {}, annotations: readOnly,
+    description: '检查本机 MCP 与扩展的连接、运行版本和 npm 更新提示。update_available=true 时告知用户重新启动 WriteDock MCP，保留配置和配对；发布任务进行中不要自动重启。旧版服务可能不返回版本字段；latest_version 缺失或 update_checking=true 时，不得声称已是最新版。', inputSchema: {}, annotations: { ...readOnly, openWorldHint: true },
   }, () => wrap(() => bridge.status()))
   server.registerTool('begin_pairing', {
     description: '首次连接或扩展卸载重装后，生成 3 分钟有效的一次性配对码。让用户粘贴到扩展的 MCP 连接页即可，复用已有 MCP 和 agent 配置。新配对会替换此前浏览器的连接授权，请在用户要求连接扩展时调用。',
@@ -55,7 +57,7 @@ export function createMcpServer(bridge: LocalBridge) {
     inputSchema: source, annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
   }, args => wrap(async () => bridge.request('prepareArticle', { article: await prepareSource(args, path => bridge.registerMedia(path, 'video')) })))
   server.registerTool('publish_article', {
-    description: '直接发布 Agent 写好的知乎、百家号、微博长文章、B站专栏或小红书长文。小红书 platforms=["xiaohongshu"]，接收标题最多 64 字、正文最多 10000 字的 Markdown/HTML 及正文图片，走写长文→原生自动排版→下一步→发布；不接独立 cover、文章内视频或长文话题。普通图文和独立视频改用 publish_post。B站仅接文字和正文图片，标题长度按原生页面校验；不接视频、音频、附加内容卡片或独立 cover。原生新版编辑器生成 WBI 签名和风控参数，验证码 code=-352 时返回 needs_user_action，Agent 让用户在已打开的原稿件页完成验证并手动发布，不重发。微博长文章支持正文图片和封面，无独立封面时使用本篇首图，无正文图片时需 cover，当前标题接收 32 字以内；不接视频 URL，不自动关注官方账号或声明原创。验证码及原创协议转人工处理，用户完成验证后还需检查发布确认窗口。传 file_path/markdown/html 三选一，或 prepare_article 的 draft_id；无需用户在扩展编写。百家号必须提供 cover（本地封面图片路径或图片地址），当前标题接收 64 字以内；验证码或封面需人工处理时返回 needs_user_action，Agent 必须把原因和原稿件链接交给用户，不重试、不换 request_id。知乎支持正文图片和 <video src="本地MP4路径"></video> 内嵌视频，标题最多 100 字，不支持单独设置封面和话题。cover 可用于百家号和微博长文章；内嵌视频只允许单独投知乎。扩展触发平台原生发布，只有匹配本任务的最终发布请求及可核实的成功回执才确认 submitted。返回 task_id 后查询 get_sync_task。',
+    description: agentWorkflow + '直接发布 Agent 写好的知乎、百家号、微博长文章、B站专栏或小红书长文。小红书 platforms=["xiaohongshu"]，接收标题最多 64 字、正文最多 10000 字的 Markdown/HTML 及正文图片，走写长文→原生自动排版→下一步→发布；不接独立 cover、文章内视频或长文话题。普通图文和独立视频改用 publish_post。B站仅接文字和正文图片，标题长度按原生页面校验；不接视频、音频、附加内容卡片或独立 cover。原生新版编辑器生成 WBI 签名和风控参数，验证码 code=-352 时返回 needs_user_action，Agent 让用户在已打开的原稿件页完成验证并手动发布，不重发。微博长文章支持正文图片和封面，无独立封面时使用本篇首图，无正文图片时需 cover，当前标题接收 32 字以内；不接视频 URL，不自动关注官方账号或声明原创。验证码及原创协议转人工处理，用户完成验证后还需检查发布确认窗口。传 file_path/markdown/html 三选一，或 prepare_article 的 draft_id；无需用户在扩展编写。百家号必须提供 cover（本地封面图片路径或图片地址），当前标题接收 64 字以内；验证码或封面需人工处理时返回 needs_user_action，Agent 必须把原因和原稿件链接交给用户，不重试、不换 request_id。知乎支持正文图片和 <video src="本地MP4路径"></video> 内嵌视频，标题最多 100 字，不支持单独设置封面和话题。cover 可用于百家号和微博长文章；内嵌视频只允许单独投知乎。扩展触发平台原生发布。知乎优先核对匹配文章 ID 的 HTTP 成功响应，也可由扩展在同一任务标签页核对匹配文章 ID、标题的原生发布成功弹窗，confirmation 区分 http_response/native_page_message；仅跳转不算成功。其他文章平台按各自匹配的最终 HTTP 回执确认 submitted。返回 task_id 后查询 get_sync_task。',
     inputSchema: { ...source, cover: source.cover.describe('平台封面：本地图片路径、HTTP(S) 图片地址或 data URI；按 list_platforms 的 cover 能力和 coverRequired 提供。当前百家号必填、微博长文章可选，知乎、B站专栏和小红书长文不支持独立封面'), request_id: requestId, platforms: z.array(z.string().min(1)).min(1).max(30).describe('先按 list_platforms 的 action=publish 和 publishModes=article 选择；实际支持范围由扩展校验'), draft_id: z.string().optional() },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
   }, args => wrap(async () => {
@@ -70,7 +72,7 @@ export function createMcpServer(bridge: LocalBridge) {
     inputSchema: postSource, annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
   }, args => wrap(async () => bridge.request('preparePost', { post: await preparePost(args, (path, kind) => bridge.registerMedia(path, kind)) })))
   server.registerTool('publish_post', {
-    description: '直接向用户明确指定的小红书/抖音/微博公开投稿（平台可能先审核），支持图文和独立视频。小红书 ID 为 xiaohongshu，kind=image 上传图片后填写标题/正文并发布，kind=video 上传视频后发布，省略 cover_path 时沿用平台视频第一帧封面；写长文必须用 publish_article。小红书仅在本任务 POST /web_api/sns/v2/note 返回 success=true、result=0 及有效笔记 ID 时确认 submitted。抖音 ID 为 douyin，kind=image/video 复用原生上传、填写和发布流程，可选视频 cover_path，当前仅接即时发布；图文话题最多 4 个、视频最多 5 个。抖音以本次操作新增的原生成功提示确认 submitted，confirmation=native_page_message，未接最终 HTTP 业务回执核对；页面跳转本身不算成功，缺少明确提示则返回 unknown，不能重发。微博 ID 为 weibo，kind=image 最多 18 张，标题并入正文首行；kind=video 必须明确 weibo_video_creation（original/secondary/repost），标题最多 30 个汉字或 60 个半角字符。微博图文/视频互斥，长文章使用 publish_article。可传 prepare_post 的 draft_id，或直接传完整素材参数。通过平台原生页面上传并发送，微博只有匹配本任务的 statuses/update 成功回执才确认 submitted。验证码、来源、内容声明、封面或协议需人工处理时返回 needs_user_action，Agent 应把原因和原投稿页链接告知用户，不重试。必须使用稳定 request_id；返回 task_id 后查询 get_sync_task，unknown 时先检查平台。',
+    description: agentWorkflow + '直接向用户明确指定的小红书/抖音/微博公开投稿（平台可能先审核），支持图文和独立视频。小红书 ID 为 xiaohongshu，kind=image 上传图片后填写标题/正文并发布，kind=video 上传视频后发布，省略 cover_path 时沿用平台视频第一帧封面；写长文必须用 publish_article。小红书仅在本任务 POST /web_api/sns/v2/note 返回 success=true、result=0 及有效笔记 ID 时确认 submitted。抖音 ID 为 douyin，kind=image/video 复用原生上传、填写和发布流程，可选视频 cover_path，当前仅接即时发布；图文话题最多 4 个、视频最多 5 个。抖音以本次操作新增的原生成功提示确认 submitted，confirmation=native_page_message，未接最终 HTTP 业务回执核对；页面跳转本身不算成功，缺少明确提示则返回 unknown，不能重发。微博 ID 为 weibo，kind=image 最多 18 张，标题并入正文首行；kind=video 必须明确 weibo_video_creation（original/secondary/repost），标题最多 30 个汉字或 60 个半角字符。微博图文/视频互斥，长文章使用 publish_article。可传 prepare_post 的 draft_id，或直接传完整素材参数。通过平台原生页面上传并发送，微博只有匹配本任务的 statuses/update 成功回执才确认 submitted。验证码、来源、内容声明、封面或协议需人工处理时返回 needs_user_action，Agent 应把原因和原投稿页链接告知用户，不重试。必须使用稳定 request_id；返回 task_id 后查询 get_sync_task，unknown 时将链接交给用户自行核对，Agent 不调用浏览器。',
     inputSchema: { ...postSource, kind: postSource.kind.optional(), title: postSource.title.optional(), draft_id: z.string().optional(), request_id: requestId, platforms: z.array(z.string().min(1)).min(1).max(30).describe('按 list_platforms 返回的 publishModes=image/video 及工具信息选择，当前为 xiaohongshu、douyin、weibo；由扩展校验，后续平台变更不要求固定枚举升级') },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
   }, args => wrap(async () => {
@@ -90,7 +92,7 @@ export function createMcpServer(bridge: LocalBridge) {
     })
   }))
   server.registerTool('get_sync_task', {
-    description: '查询发布或草稿任务的进度、逐平台结果及内容链接。publicationState=submitted 表示接口已确认提交；needs_user_action 或 requires_user_action 表示需要用户接管，请将 user_actions 中的原因与链接告诉用户手动处理，不重新投稿；unknown 表示结果未确认，不能自动重发。可传 task_id 或原 request_id。',
+    description: agentWorkflow + '查询发布或草稿任务的进度、逐平台结果及内容链接。publicationState=submitted 表示扩展已按平台 confirmation 确认提交；needs_user_action 或 requires_user_action 表示需要用户接管，请将 user_actions 中的原因与链接告诉用户手动处理，不重新投稿；unknown 表示结果未确认，不能自动重发。可传 task_id 或原 request_id。',
     inputSchema: { task_id: z.string().optional(), request_id: z.string().optional() }, annotations: readOnly,
   }, args => wrap(() => bridge.request('getSyncTask', { taskId: args.task_id, requestId: args.request_id })))
   server.registerTool('list_sync_history', {