writedock-mcp 0.4.11 → 0.4.13

package/extension/manifest.json

@@ -4,7 +4,7 @@
   "name": "写作台 WriteDock",
   "short_name": "写作台",
   "description": "连接自己的 AI agent，通过 MCP 发布小红书长文、图文和视频，微博图文、视频及长文章，知乎、百家号、B站专栏文章与抖音图文视频。",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "minimum_chrome_version": "116",
   "icons": {
     "16": "assets/icon-16.png",

package/extension/service-worker-loader.js

@@ -1 +1 @@
-import './assets/index.ts-CSY6FJ6h.js';
+import './assets/index.ts-BeiBzFaR.js';

package/extension/src/editor/index.html

@@ -6,7 +6,7 @@
     <meta name="color-scheme" content="light" />
     <title>写作台 · WriteDock</title>
     <link rel="icon" type="image/png" href="/assets/icon-48.png" />
-    <script type="module" crossorigin src="/assets/editor-DSj8NlXD.js"></script>
+    <script type="module" crossorigin src="/assets/editor-CMMMIxFa.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/purify.es-1yEQDPgc.js">
     <link rel="modulepreload" crossorigin href="/assets/react-vendor-BrXlnJmF.js">
     <link rel="modulepreload" crossorigin href="/assets/task-utils-DwzGcJkm.js">

package/extension//345/256/211/350/243/205/344/270/216/346/233/264/346/226/260.txt

@@ -1,4 +1,4 @@
-WriteDock 安装与更新 v0.4.11
+WriteDock 安装与更新 v0.4.13
 
 首次使用
 1. 把这句话发给你的 agent：帮我安装 WriteDock：先检查电脑上有没有 Node.js 22 或更高版本，没有就帮我安装，需要我操作时告诉我；然后运行 npx -y writedock-mcp@latest setup，最后告诉我怎么重启你。

package/index.cjs

@@ -29740,7 +29740,7 @@ var MediaStore = class {
 // package.json
 var package_default = {
   name: "@writedock/mcp-server",
-  version: "0.4.11",
+  version: "0.4.13",
   private: true,
   type: "module",
   description: "WriteDock local MCP server for the browser extension",
@@ -29924,6 +29924,14 @@ function mcpReleaseInfo() {
     update_checking: !!pending
   };
 }
+function updateNotice(input) {
+  const notices = [];
+  if (input.bundle && (!input.extension || newerVersion(input.bundle, input.extension))) {
+    notices.push(`WriteDock \u6269\u5C55\u6709\u65B0\u7248\u672C v${input.bundle}${input.extension ? `\uFF08\u5F53\u524D v${input.extension}\uFF09` : ""}\uFF0C\u9700\u8981\u7528\u6237\u81EA\u5DF1\u70B9\u4E00\u4E0B\u624D\u4F1A\u66F4\u65B0\uFF1A\u70B9\u6D4F\u89C8\u5668\u53F3\u4E0A\u89D2\u7684\u62FC\u56FE\u56FE\u6807\uFF0C\u70B9 WriteDock\uFF0C\u8FDB\u5165\u201C\u8FDE\u63A5 agent\u201D\uFF0C\u70B9\u201C\u66F4\u65B0\u6269\u5C55\u201D\u3002\u8FDE\u63A5\u548C\u7A3F\u4EF6\u90FD\u4F1A\u4FDD\u7559\u3002`);
+  }
+  if (input.mcpLatest && input.mcp && newerVersion(input.mcpLatest, input.mcp)) notices.push(`WriteDock \u670D\u52A1\u6709\u65B0\u7248\u672C v${input.mcpLatest}\uFF1A\u91CD\u542F agent \u5C31\u4F1A\u66F4\u65B0\u3002`);
+  return notices.length ? `${notices.join("")}\u8BF7\u5728\u6C47\u62A5\u7ED3\u679C\u65F6\u628A\u8FD9\u4E9B\u6B65\u9AA4\u539F\u6837\u544A\u8BC9\u7528\u6237\u4E00\u6B21\u3002\u8FD9\u4E0D\u5F71\u54CD\u672C\u6B21\u7ED3\u679C\uFF0C\u4E0D\u8981\u7B49\u7528\u6237\u66F4\u65B0\uFF0C\u4E5F\u4E0D\u8981\u56E0\u6B64\u91CD\u53D1\u3002` : void 0;
+}
 
 // src/bridge.ts
 var LIMIT = 32 * 1024 * 1024;
@@ -29953,14 +29961,18 @@ var LocalBridge = class {
   starting;
   primary = false;
   extensionId;
+  extensionVersion;
   seenNonces = /* @__PURE__ */ new Map();
   extensionToken;
+  lastWork = 0;
+  lastSeen = Date.now();
   media;
   pending = /* @__PURE__ */ new Map();
   port;
   async start() {
     if (this.starting) return this.starting;
-    this.starting = this.listen().catch(async (error2) => {
+    this.starting = Promise.resolve(this.options.ensureService?.()).catch(() => {
+    }).then(() => this.listen()).catch(async (error2) => {
       if (error2.code !== "EADDRINUSE") throw error2;
       this.server = void 0;
       this.sockets = void 0;
@@ -30007,6 +30019,31 @@ var LocalBridge = class {
     }, 2e4);
     this.heartbeat.unref();
   }
+  get isPrimary() {
+    return this.primary;
+  }
+  notice() {
+    if (this.client?.readyState !== import_websocket.default.OPEN) return void 0;
+    const release = mcpReleaseInfo();
+    return updateNotice({ bundle: release.extension_bundle_version, extension: this.extensionVersion, mcpLatest: release.latest_version, mcp: release.mcp_version });
+  }
+  connectionFields() {
+    const connected = this.client?.readyState === import_websocket.default.OPEN, notice = this.notice();
+    return { connected, extensionId: this.extensionId, ...this.extensionVersion ? { extension_version: this.extensionVersion } : {}, ...notice ? { update_notice: notice } : {}, protocol: "writedock/1", ...mcpReleaseInfo() };
+  }
+  /** How long nothing has needed this service. An open extension connection counts as needed. */
+  idleFor() {
+    if (this.client?.readyState === import_websocket.default.OPEN) this.lastSeen = Date.now();
+    return Date.now() - this.lastSeen;
+  }
+  /** Asks the running service to step aside for a newer one. It says no while it has work. */
+  async askServiceToStop() {
+    try {
+      return (await this.httpCall("/stop", {})).accepted === true;
+    } catch {
+      return false;
+    }
+  }
   validHost(host) {
     return host === `127.0.0.1:${this.port}` || host === `localhost:${this.port}`;
   }
@@ -30018,6 +30055,7 @@ var LocalBridge = class {
     const previousClient = this.client;
     this.client = void 0;
     this.extensionId = void 0;
+    this.extensionVersion = void 0;
     for (const value of this.pending.values()) {
       clearTimeout(value.timer);
       value.reject(new Error(reason));
@@ -30058,6 +30096,7 @@ var LocalBridge = class {
           clearTimeout(timer);
           this.client = ws;
           this.extensionId = String(message.extensionId || "");
+          this.extensionVersion = typeof message.extensionVersion === "string" && message.extensionVersion.length <= 40 ? message.extensionVersion : void 0;
           ws.send(JSON.stringify({ type: "ready", ...mcpReleaseInfo() }));
           return;
         }
@@ -30084,6 +30123,7 @@ var LocalBridge = class {
       if (this.client !== ws) return;
       this.client = void 0;
       this.extensionId = void 0;
+      this.extensionVersion = void 0;
       for (const value of this.pending.values()) {
         clearTimeout(value.timer);
         value.reject(new Error("\u6269\u5C55\u8FDE\u63A5\u5DF2\u65AD\u5F00\u3002\u82E5\u5DF2\u63D0\u4EA4\u540C\u6B65\uFF0C\u8BF7\u6309\u4EFB\u52A1 ID \u67E5\u8BE2\u7ED3\u679C\uFF0C\u4E0D\u8981\u66F4\u6362 request_id \u81EA\u52A8\u91CD\u53D1\u3002"));
@@ -30109,6 +30149,7 @@ var LocalBridge = class {
     }
     const assetPath = /^\/assets\/([a-f0-9-]{36})$/.exec(req.url || "");
     if (assetPath && this.validHost(req.headers.host) && (!req.headers.origin || /^chrome-extension:\/\/[a-p]{32}$/.test(req.headers.origin))) {
+      this.lastWork = this.lastSeen = Date.now();
       await this.media.serve(req, res, assetPath[1]);
       return;
     }
@@ -30139,10 +30180,18 @@ var LocalBridge = class {
       for (const [key2, expires] of this.seenNonces) if (expires < now) this.seenNonces.delete(key2);
       this.seenNonces.set(nonce, now + 3e4);
       responseNonce = nonce;
+      if (req.method === "POST" && req.url === "/stop") {
+        const accepted = this.pending.size === 0 && Date.now() - this.lastWork > 12e4;
+        send(200, { accepted });
+        if (accepted) setImmediate(() => this.options.onStopRequested?.());
+        return;
+      }
+      this.lastSeen = Date.now();
       if (req.method === "GET" && req.url === "/status") {
-        send(200, { connected: this.client?.readyState === import_websocket.default.OPEN, extensionId: this.extensionId, protocol: "writedock/1", ...mcpReleaseInfo() });
+        send(200, this.connectionFields());
         return;
       }
+      this.lastWork = Date.now();
       if (req.method === "POST" && req.url === "/assets/register") {
         const input2 = JSON.parse(body);
         if (typeof input2.path !== "string" || !["image", "video"].includes(input2.kind)) throw new Error("\u7D20\u6750\u53C2\u6570\u4E0D\u6B63\u786E");
@@ -30179,7 +30228,7 @@ 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", ...mcpReleaseInfo() };
+    if (this.primary) return this.connectionFields();
     try {
       return await this.httpCall("/status");
     } catch (error2) {
@@ -30187,7 +30236,7 @@ var LocalBridge = class {
       this.starting = void 0;
       await this.start();
       if (this.primary) return { connected: false, protocol: "writedock/1", ...mcpReleaseInfo() };
-      throw error2;
+      return this.httpCall("/status");
     }
   }
   async request(method, params = {}) {
@@ -30202,7 +30251,10 @@ var LocalBridge = class {
   }
   async registerMedia(path, kind) {
     await this.status();
-    if (this.primary) return this.media.register(path, kind);
+    if (this.primary) {
+      this.lastWork = this.lastSeen = Date.now();
+      return this.media.register(path, kind);
+    }
     return await this.httpCall("/assets/register", { path, kind });
   }
   async requestConnected(method, params) {
@@ -30220,6 +30272,9 @@ var LocalBridge = class {
         this.pending.delete(id);
         reject(error2);
       });
+    }).then((result) => {
+      const notice = result && typeof result === "object" && result.finished === true ? this.notice() : void 0;
+      return notice ? { ...result, update_notice: notice } : result;
     });
   }
   async close() {
@@ -50329,7 +50384,7 @@ 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\u552F\u4E00\u4F8B\u5916\u662F user_actions \u7684 type=old_draft\uFF1A\u5E73\u53F0\u6709\u4E00\u4EFD\u7528\u6237\u4E0A\u6B21\u6CA1\u53D1\u5B8C\u7684\u5185\u5BB9\uFF0C\u8FD9\u7BC7\u5C1A\u672A\u63D0\u4EA4\u3002\u5FC5\u987B\u5148\u95EE\u7528\u6237\u662F\u5426\u653E\u5F03\u90A3\u4EFD\u65E7\u5185\u5BB9\uFF0C\u4E0D\u5F97\u66FF\u7528\u6237\u51B3\u5B9A\uFF1B\u7528\u6237\u660E\u786E\u540C\u610F\u540E\uFF0C\u624D\u7528\u65B0\u7684 request_id \u53EA\u5BF9\u8BE5\u5E73\u53F0\u518D\u8C03\u7528 publish\uFF0C\u5E76\u4F20 discard_old_drafts\uFF1B\u7528\u6237\u4E0D\u540C\u610F\u5C31\u4FDD\u7559\u65E7\u5185\u5BB9\uFF0C\u544A\u8BC9\u7528\u6237\u8FD9\u4E2A\u5E73\u53F0\u6CA1\u6709\u53D1\u3002";
+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\u7ED3\u679C\u91CC\u6709 update_notice \u65F6\uFF0C\u5728\u6C47\u62A5\u7ED3\u679C\u672B\u5C3E\u987A\u5E26\u544A\u8BC9\u7528\u6237\u4E00\u6B21\u3002\u552F\u4E00\u4F8B\u5916\u662F user_actions \u7684 type=old_draft\uFF1A\u5E73\u53F0\u6709\u4E00\u4EFD\u7528\u6237\u4E0A\u6B21\u6CA1\u53D1\u5B8C\u7684\u5185\u5BB9\uFF0C\u8FD9\u7BC7\u5C1A\u672A\u63D0\u4EA4\u3002\u5FC5\u987B\u5148\u95EE\u7528\u6237\u662F\u5426\u653E\u5F03\u90A3\u4EFD\u65E7\u5185\u5BB9\uFF0C\u4E0D\u5F97\u66FF\u7528\u6237\u51B3\u5B9A\uFF1B\u7528\u6237\u660E\u786E\u540C\u610F\u540E\uFF0C\u624D\u7528\u65B0\u7684 request_id \u53EA\u5BF9\u8BE5\u5E73\u53F0\u518D\u8C03\u7528 publish\uFF0C\u5E76\u4F20 discard_old_drafts\uFF1B\u7528\u6237\u4E0D\u540C\u610F\u5C31\u4FDD\u7559\u65E7\u5185\u5BB9\uFF0C\u544A\u8BC9\u7528\u6237\u8FD9\u4E2A\u5E73\u53F0\u6CA1\u6709\u53D1\u3002";
 function createMcpServer(bridge) {
   const server = new McpServer({ name: "writedock", version: package_default.version }, {
     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\u672A\u8FDE\u63A5\u65F6\uFF0C\u8BA9\u7528\u6237\u6253\u5F00 WriteDock \u6269\u5C55\u7684\u300C\u8FDE\u63A5\u300D\u9875\u70B9\u201C\u8FDE\u63A5\u201D\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'
@@ -50339,7 +50394,7 @@ function createMcpServer(bridge) {
   })).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 \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\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",
+    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\uFF1B\u53D1\u5E03\u4EFB\u52A1\u8FDB\u884C\u4E2D\u4E0D\u8981\u81EA\u52A8\u91CD\u542F\u3002\u6709 update_notice \u65F6\u8F6C\u544A\u7528\u6237\u3002extension_bundle_version \u53EA\u662F npm \u5305\u5185\u7F6E\u7684\u6269\u5C55\u7248\u672C\uFF0Cextension_version \u624D\u662F\u7528\u6237\u6B63\u5728\u7528\u7684\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, openWorldHint: true }
   }, () => wrap(() => bridge.status()));
@@ -50615,12 +50670,88 @@ async function runSetup(home = (0, import_node_os3.homedir)(), log = console.log
   return found;
 }
 
+// src/service.ts
+var import_node_child_process2 = require("child_process");
+var import_node_fs2 = require("fs");
+var import_node_os4 = require("os");
+var import_node_path6 = require("path");
+var sleep = (ms) => new Promise((resolve4) => setTimeout(resolve4, ms));
+async function probe(port) {
+  try {
+    const response = await fetch(`http://127.0.0.1:${port}/hello`, { signal: AbortSignal.timeout(1500), cache: "no-store" });
+    const value = await response.json();
+    return value.service === "writedock-mcp" && typeof value.version === "string" ? { version: value.version } : "other";
+  } catch (error2) {
+    return error2 instanceof Error && error2.name === "TimeoutError" ? "other" : "none";
+  }
+}
+async function until(check2, timeoutMs) {
+  const end = Date.now() + timeoutMs;
+  while (Date.now() < end) {
+    if (await check2()) return true;
+    await sleep(200);
+  }
+  return false;
+}
+function startDetached() {
+  const directory = dataDirectory();
+  (0, import_node_fs2.mkdirSync)(directory, { recursive: true, mode: 448 });
+  const log = (0, import_node_fs2.openSync)((0, import_node_path6.join)(directory, "service.log"), "w");
+  try {
+    const child = (0, import_node_child_process2.spawn)(process.execPath, [__filename, "--service"], { detached: true, stdio: ["ignore", "ignore", log], windowsHide: true, cwd: (0, import_node_os4.homedir)() });
+    child.on("error", () => {
+    });
+    child.unref();
+  } finally {
+    (0, import_node_fs2.closeSync)(log);
+  }
+}
+async function ensureService(bridge, port) {
+  let found = await probe(port);
+  if (typeof found === "object" && newerVersion(package_default.version, found.version)) {
+    if (!await bridge.askServiceToStop()) return;
+    if (!await until(async () => await probe(port) === "none", 5e3)) return;
+    found = "none";
+  }
+  if (found !== "none") return;
+  startDetached();
+  await until(async () => typeof await probe(port) === "object", 1e4);
+}
+function watchService(bridge, port) {
+  let running = false;
+  const timer = setInterval(() => {
+    if (running) return;
+    running = true;
+    void ensureService(bridge, port).catch(() => {
+    }).finally(() => {
+      running = false;
+    });
+  }, 6e4);
+  timer.unref();
+}
+var IDLE_CHECK_MS = 5e3;
+async function runService(bridge) {
+  await bridge.start();
+  if (!bridge.isPrimary) process.exit(0);
+  const idleLimit = Number(process.env.WRITEDOCK_SERVICE_IDLE_MS) || 2 * 60 * 6e4;
+  setInterval(() => {
+    if (bridge.idleFor() >= idleLimit) void bridge.close().finally(() => process.exit(0));
+  }, IDLE_CHECK_MS);
+  const stop = () => {
+    void bridge.close().finally(() => process.exit(0));
+  };
+  process.on("SIGINT", stop);
+  process.on("SIGTERM", stop);
+}
+
 // src/index.ts
 async function main() {
   const port = Number(process.env.WRITEDOCK_PORT || 9647);
   const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN);
-  const bridge = new LocalBridge({ token: identity.token, port, credentials: identity });
+  const background = !process.env.WRITEDOCK_NO_SERVICE;
+  const bridge = new LocalBridge({ token: identity.token, port, credentials: identity, ...background ? { ensureService: () => ensureService(bridge, port) } : {} });
   await bridge.start();
+  if (background) watchService(bridge, port);
   const server = createMcpServer(bridge);
   let closing = false;
   const close = async () => {
@@ -50643,10 +50774,31 @@ async function main() {
   };
   await server.connect(new StdioServerTransport());
 }
+async function service() {
+  const port = Number(process.env.WRITEDOCK_PORT || 9647);
+  const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN);
+  const bridge = new LocalBridge({ token: identity.token, port, credentials: identity, onStopRequested: () => {
+    void bridge.close().finally(() => process.exit(0));
+  } });
+  await runService(bridge);
+}
+async function setup() {
+  await runSetup();
+  const port = Number(process.env.WRITEDOCK_PORT || 9647);
+  const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN);
+  await ensureService(new LocalBridge({ token: identity.token, port, credentials: identity }), port).catch(() => {
+  });
+  process.exit(0);
+}
 if (process.argv.slice(2).some((argument) => argument === "--version" || argument === "-v")) {
   console.log(package_default.version);
 } else if (process.argv[2] === "setup") {
-  runSetup().catch((error2) => {
+  setup().catch((error2) => {
+    console.error("[WriteDock MCP]", error2 instanceof Error ? error2.message : String(error2));
+    process.exit(1);
+  });
+} else if (process.argv[2] === "--service") {
+  service().catch((error2) => {
     console.error("[WriteDock MCP]", error2 instanceof Error ? error2.message : String(error2));
     process.exit(1);
   });

package/package.json

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

package/source/package.json

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

package/source/src/__tests__/update-notice.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest'
+import { updateNotice } from '../release-info'
+
+describe('updateNotice', () => {
+  it('offers a newer extension and says what to click', () => {
+    const text = updateNotice({ bundle: '0.4.13', extension: '0.4.12' })
+    expect(text).toContain('v0.4.13')
+    expect(text).toContain('拼图图标')
+    expect(text).toContain('连接 agent')
+    expect(text).toContain('更新扩展')
+    expect(text).toContain('不要因此重发')
+  })
+  it('treats an extension that reports no version as older', () => {
+    expect(updateNotice({ bundle: '0.4.13' })).toContain('v0.4.13')
+  })
+  it('compares versions as numbers', () => {
+    expect(updateNotice({ bundle: '0.4.10', extension: '0.4.9' })).toContain('v0.4.10')
+    expect(updateNotice({ bundle: '0.4.9', extension: '0.4.10' })).toBeUndefined()
+  })
+  it('stays quiet when everything is current or nothing can be offered', () => {
+    expect(updateNotice({ bundle: '0.4.13', extension: '0.4.13', mcp: '0.4.13', mcpLatest: '0.4.13' })).toBeUndefined()
+    expect(updateNotice({ extension: '0.4.1' })).toBeUndefined()
+  })
+  it('offers a newer service with a restart', () => {
+    expect(updateNotice({ mcp: '0.4.12', mcpLatest: '0.4.13' })).toContain('重启 agent')
+  })
+})

package/source/src/bridge.ts

@@ -5,7 +5,7 @@ import http from 'node:http'
 import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from 'node:crypto'
 import { WebSocket, WebSocketServer } from 'ws'
 import { MediaStore, type MediaAsset } from './media'
-import { mcpReleaseInfo } from './release-info'
+import { mcpReleaseInfo, updateNotice } from './release-info'
 import { EXTENSION_ORIGIN } from './extension-id'
 import { updateInstalledExtension } from './extension-update'
 
@@ -27,12 +27,15 @@ export class LocalBridge {
   private starting?: Promise<void>
   private primary = false
   private extensionId?: string
+  private extensionVersion?: string
   private seenNonces = new Map<string, number>()
   private extensionToken: string
+  private lastWork = 0
+  private lastSeen = Date.now()
   private media: MediaStore
   private pending = new Map<string, { resolve: (value: unknown) => void; reject: (error: Error) => void; timer: ReturnType<typeof setTimeout> }>()
   readonly port: number
-  constructor(private options: { token: string; port?: number; timeoutMs?: number; credentials?: { getExtensionToken: () => Promise<string>; setExtensionToken: (token: string) => Promise<void> } }) {
+  constructor(private options: { token: string; port?: number; timeoutMs?: number; credentials?: { getExtensionToken: () => Promise<string>; setExtensionToken: (token: string) => Promise<void> }; ensureService?: () => Promise<void>; onStopRequested?: () => void }) {
     this.port = options.port ?? 9647
     this.extensionToken = options.token
     this.media = new MediaStore(this.port)
@@ -42,7 +45,7 @@ export class LocalBridge {
 
   async start(): Promise<void> {
     if (this.starting) return this.starting
-    this.starting = this.listen().catch(async error => {
+    this.starting = Promise.resolve(this.options.ensureService?.()).catch(() => {}).then(() => this.listen()).catch(async error => {
       if ((error as NodeJS.ErrnoException).code !== 'EADDRINUSE') throw error
       this.server = undefined
       this.sockets = undefined
@@ -78,6 +81,31 @@ export class LocalBridge {
     this.heartbeat.unref()
   }
 
+  get isPrimary() { return this.primary }
+
+  private notice() {
+    if (this.client?.readyState !== WebSocket.OPEN) return undefined
+    const release = mcpReleaseInfo()
+    return updateNotice({ bundle: release.extension_bundle_version, extension: this.extensionVersion, mcpLatest: release.latest_version, mcp: release.mcp_version })
+  }
+
+  private connectionFields() {
+    const connected = this.client?.readyState === WebSocket.OPEN, notice = this.notice()
+    return { connected, extensionId: this.extensionId, ...(this.extensionVersion ? { extension_version: this.extensionVersion } : {}), ...(notice ? { update_notice: notice } : {}), protocol: 'writedock/1', ...mcpReleaseInfo() }
+  }
+
+  /** How long nothing has needed this service. An open extension connection counts as needed. */
+  idleFor() {
+    if (this.client?.readyState === WebSocket.OPEN) this.lastSeen = Date.now()
+    return Date.now() - this.lastSeen
+  }
+
+  /** Asks the running service to step aside for a newer one. It says no while it has work. */
+  async askServiceToStop() {
+    try { return (await this.httpCall('/stop', {})).accepted === true }
+    catch { return false } // Versions before this one have no such route, and leave with their agent.
+  }
+
   private validHost(host?: string) { return host === `127.0.0.1:${this.port}` || host === `localhost:${this.port}` }
 
   /** Replaces the extension credential and drops whatever was using the old one. */
@@ -86,7 +114,7 @@ export class LocalBridge {
     await this.options.credentials?.setExtensionToken(token)
     this.extensionToken = token
     const previousClient = this.client
-    this.client = undefined; this.extensionId = undefined
+    this.client = undefined; this.extensionId = undefined; this.extensionVersion = undefined
     for (const value of this.pending.values()) { clearTimeout(value.timer); value.reject(new Error(reason)) }
     this.pending.clear()
     previousClient?.close(1000, 'Extension connection replaced')
@@ -117,7 +145,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 || '')
+          this.client = ws; this.extensionId = String(message.extensionId || ''); this.extensionVersion = typeof message.extensionVersion === 'string' && message.extensionVersion.length <= 40 ? message.extensionVersion : undefined
           ws.send(JSON.stringify({ type: 'ready', ...mcpReleaseInfo() }))
           return
         }
@@ -139,7 +167,7 @@ export class LocalBridge {
     ws.on('close', () => {
       clearTimeout(timer)
       if (this.client !== ws) return
-      this.client = undefined; this.extensionId = undefined
+      this.client = undefined; this.extensionId = undefined; this.extensionVersion = undefined
       for (const value of this.pending.values()) {
         clearTimeout(value.timer)
         value.reject(new Error('扩展连接已断开。若已提交同步，请按任务 ID 查询结果，不要更换 request_id 自动重发。'))
@@ -165,6 +193,7 @@ export class LocalBridge {
     }
     const assetPath = /^\/assets\/([a-f0-9-]{36})$/.exec(req.url || '')
     if (assetPath && this.validHost(req.headers.host) && (!req.headers.origin || /^chrome-extension:\/\/[a-p]{32}$/.test(req.headers.origin))) {
+      this.lastWork = this.lastSeen = Date.now()
       await this.media.serve(req, res, assetPath[1]); return
     }
     if (!this.validHost(req.headers.host) || req.headers.origin !== undefined) {
@@ -188,9 +217,17 @@ export class LocalBridge {
       for (const [key, expires] of this.seenNonces) if (expires < now) this.seenNonces.delete(key)
       this.seenNonces.set(nonce, now + 30_000)
       responseNonce = nonce
+      if (req.method === 'POST' && req.url === '/stop') {
+        const accepted = this.pending.size === 0 && Date.now() - this.lastWork > 120_000
+        send(200, { accepted })
+        if (accepted) setImmediate(() => this.options.onStopRequested?.())
+        return
+      }
+      this.lastSeen = Date.now() // Status checks keep the service around, but only real work stops it being replaced.
       if (req.method === 'GET' && req.url === '/status') {
-        send(200, { connected: this.client?.readyState === WebSocket.OPEN, extensionId: this.extensionId, protocol: 'writedock/1', ...mcpReleaseInfo() }); return
+        send(200, this.connectionFields()); return
       }
+      this.lastWork = Date.now()
       if (req.method === 'POST' && req.url === '/assets/register') {
         const input = JSON.parse(body)
         if (typeof input.path !== 'string' || !['image', 'video'].includes(input.kind)) throw new Error('素材参数不正确')
@@ -223,7 +260,7 @@ export class LocalBridge {
 
   async status() {
     await this.start()
-    if (this.primary) return { connected: this.client?.readyState === WebSocket.OPEN, extensionId: this.extensionId, protocol: 'writedock/1', ...mcpReleaseInfo() }
+    if (this.primary) return this.connectionFields()
     try { return await this.httpCall('/status') }
     catch (error) {
       if (!(error instanceof TypeError)) throw error
@@ -231,7 +268,7 @@ export class LocalBridge {
       this.starting = undefined
       await this.start()
       if (this.primary) return { connected: false, protocol: 'writedock/1', ...mcpReleaseInfo() }
-      throw error
+      return this.httpCall('/status') // A background service took the port in the meantime.
     }
   }
 
@@ -248,14 +285,14 @@ export class LocalBridge {
 
   async registerMedia(path: string, kind: 'image' | 'video'): Promise<MediaAsset> {
     await this.status()
-    if (this.primary) return this.media.register(path, kind)
+    if (this.primary) { this.lastWork = this.lastSeen = Date.now(); return this.media.register(path, kind) }
     return await this.httpCall('/assets/register', { path, kind }) as unknown as MediaAsset
   }
 
   private async requestConnected(method: string, params: Record<string, unknown>): Promise<unknown> {
     if (this.client?.readyState !== WebSocket.OPEN) throw new Error('扩展未连接，这次没有发布。请让用户打开 Chrome 或 Edge，连接过的扩展通常会自动连上，然后再试；如果还是不行，打开 WriteDock 扩展点“连接”。无需重装 MCP。')
     const id = randomUUID()
-    return new Promise((resolve, reject) => {
+    return new Promise<unknown>((resolve, reject) => {
       const timer = setTimeout(() => {
         this.pending.delete(id)
         reject(new Error('扩展响应超时；同步任务可能仍在运行，请查询任务状态。'))
@@ -265,6 +302,10 @@ export class LocalBridge {
         if (!error) return
         clearTimeout(timer); this.pending.delete(id); reject(error)
       })
+    }).then(result => {
+      // Only on a finished task, so the agent says it once at the end and never in the middle of a publication.
+      const notice = result && typeof result === 'object' && (result as { finished?: unknown }).finished === true ? this.notice() : undefined
+      return notice ? { ...result as object, update_notice: notice } : result
     })
   }
 

package/source/src/index.ts

@@ -5,12 +5,16 @@ import { createMcpServer } from './server'
 import { loadIdentity } from './identity'
 import mcpPackage from '../package.json'
 import { runSetup } from './setup'
+import { ensureService, runService, watchService } from './service'
 
 async function main() {
   const port = Number(process.env.WRITEDOCK_PORT || 9647)
   const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN)
-  const bridge = new LocalBridge({ token: identity.token, port, credentials: identity })
+  // Set only for tests that need one process owning the port by itself.
+  const background = !process.env.WRITEDOCK_NO_SERVICE
+  const bridge: LocalBridge = new LocalBridge({ token: identity.token, port, credentials: identity, ...(background ? { ensureService: () => ensureService(bridge, port) } : {}) })
   await bridge.start()
+  if (background) watchService(bridge, port)
   const server = createMcpServer(bridge)
   let closing = false
   const close = async () => { if (closing) return; closing = true; await bridge.close(); await server.close() }
@@ -20,11 +24,29 @@ async function main() {
   server.server.onclose = () => { void bridge.close() }
   await server.connect(new StdioServerTransport())
 }
+async function service() {
+  const port = Number(process.env.WRITEDOCK_PORT || 9647)
+  const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN)
+  const bridge: LocalBridge = new LocalBridge({ token: identity.token, port, credentials: identity, onStopRequested: () => { void bridge.close().finally(() => process.exit(0)) } })
+  await runService(bridge)
+}
+
+/** Setup starts the service too, so 连接 appears even with an agent that only runs tools when it needs them. */
+async function setup() {
+  await runSetup()
+  const port = Number(process.env.WRITEDOCK_PORT || 9647)
+  const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN)
+  await ensureService(new LocalBridge({ token: identity.token, port, credentials: identity }), port).catch(() => {})
+  process.exit(0)
+}
+
 if (process.argv.slice(2).some(argument => argument === '--version' || argument === '-v')) {
   // Allow inspecting an npm archive without starting a bridge or reading pairing credentials.
   console.log(mcpPackage.version)
 } else if (process.argv[2] === 'setup') {
-  runSetup().catch(error => { console.error('[WriteDock MCP]', error instanceof Error ? error.message : String(error)); process.exit(1) })
+  setup().catch(error => { console.error('[WriteDock MCP]', error instanceof Error ? error.message : String(error)); process.exit(1) })
+} else if (process.argv[2] === '--service') {
+  service().catch(error => { console.error('[WriteDock MCP]', error instanceof Error ? error.message : String(error)); process.exit(1) })
 } else {
   main().catch(error => { console.error('[WriteDock MCP]', error instanceof Error ? error.message : String(error)); process.exit(1) })
 }

package/source/src/release-info.ts

@@ -68,3 +68,16 @@ export function mcpReleaseInfo() {
     update_checking: !!pending,
   }
 }
+
+/**
+ * What the agent should pass on to the user once a task has finished. An extension that reports no version
+ * predates reporting it, so it is older than any bundle that can compare. Without a bundle nothing can be offered.
+ */
+export function updateNotice(input: { bundle?: string; extension?: string; mcpLatest?: string; mcp?: string }) {
+  const notices: string[] = []
+  if (input.bundle && (!input.extension || newerVersion(input.bundle, input.extension))) {
+    notices.push(`WriteDock 扩展有新版本 v${input.bundle}${input.extension ? `（当前 v${input.extension}）` : ''}，需要用户自己点一下才会更新：点浏览器右上角的拼图图标，点 WriteDock，进入“连接 agent”，点“更新扩展”。连接和稿件都会保留。`)
+  }
+  if (input.mcpLatest && input.mcp && newerVersion(input.mcpLatest, input.mcp)) notices.push(`WriteDock 服务有新版本 v${input.mcpLatest}：重启 agent 就会更新。`)
+  return notices.length ? `${notices.join('')}请在汇报结果时把这些步骤原样告诉用户一次。这不影响本次结果，不要等用户更新，也不要因此重发。` : undefined
+}