writedock-mcp 0.4.13 → 0.4.15

package/extension/manifest.json

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

package/extension/service-worker-loader.js

@@ -1 +1 @@
-import './assets/index.ts-BeiBzFaR.js';
+import './assets/index.ts-Ch2Bzedq.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.13
+WriteDock 安装与更新 v0.4.15
 
 首次使用
 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.13",
+  version: "0.4.15",
   private: true,
   type: "module",
   description: "WriteDock local MCP server for the browser extension",
@@ -30029,7 +30029,8 @@ var LocalBridge = class {
   }
   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() };
+    const { extension_bundle_version: _bundled, ...release } = mcpReleaseInfo();
+    return { connected, extensionId: this.extensionId, ...this.extensionVersion ? { extension_version: this.extensionVersion } : {}, ...notice ? { update_notice: notice } : {}, protocol: "writedock/1", ...release };
   }
   /** How long nothing has needed this service. An open extension connection counts as needed. */
   idleFor() {
@@ -30235,12 +30236,28 @@ var LocalBridge = class {
       if (!(error2 instanceof TypeError)) throw error2;
       this.starting = void 0;
       await this.start();
-      if (this.primary) return { connected: false, protocol: "writedock/1", ...mcpReleaseInfo() };
+      if (this.primary) return this.connectionFields();
       return this.httpCall("/status");
     }
   }
+  /**
+   * The service may have only just started, for example on the first publication after a reboot, and the extension
+   * then needs a moment to connect. Nothing has been sent yet, so waiting here cannot submit anything twice.
+   */
+  async waitForExtension() {
+    const end = Date.now() + (this.options.extensionWaitMs ?? 45e3);
+    while (Date.now() < end) {
+      try {
+        if (this.primary ? this.client?.readyState === import_websocket.default.OPEN : (await this.httpCall("/status")).connected === true) return;
+      } catch {
+        return;
+      }
+      await new Promise((resolve4) => setTimeout(resolve4, 500));
+    }
+  }
   async request(method, params = {}) {
     await this.start();
+    await this.waitForExtension();
     if (this.primary) return this.requestConnected(method, params);
     try {
       return (await this.httpCall("/request", { method, params })).result;
@@ -50394,7 +50411,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\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",
+    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_version \u662F\u7528\u6237\u6B63\u5728\u7528\u7684\u6269\u5C55\u7248\u672C\uFF1B\u6CA1\u6709\u8FD9\u4E2A\u5B57\u6BB5\u8868\u793A\u7248\u672C\u672A\u77E5\uFF0C\u4E0D\u5F97\u58F0\u79F0\u6269\u5C55\u4E0E MCP \u7248\u672C\u4E00\u81F4\u3002\u914D\u7F6E\u91CC\u7684 writedock-mcp@latest \u662F\u6709\u610F\u7684\uFF0C\u7528\u6237\u9760\u5B83\u6536\u5230\u66F4\u65B0\uFF0C\u4E0D\u8981\u5EFA\u8BAE\u56FA\u5B9A\u7248\u672C\uFF0C\u4E5F\u4E0D\u8981\u4FEE\u6539\u8FD9\u6761\u914D\u7F6E\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()));
@@ -50749,7 +50766,7 @@ async function main() {
   const port = Number(process.env.WRITEDOCK_PORT || 9647);
   const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN);
   const background = !process.env.WRITEDOCK_NO_SERVICE;
-  const bridge = new LocalBridge({ token: identity.token, port, credentials: identity, ...background ? { ensureService: () => ensureService(bridge, port) } : {} });
+  const bridge = new LocalBridge({ token: identity.token, port, credentials: identity, ...background ? { ensureService: () => ensureService(bridge, port) } : {}, ...process.env.WRITEDOCK_EXTENSION_WAIT_MS ? { extensionWaitMs: Number(process.env.WRITEDOCK_EXTENSION_WAIT_MS) } : {} });
   await bridge.start();
   if (background) watchService(bridge, port);
   const server = createMcpServer(bridge);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "writedock-mcp",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "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.13",
+  "version": "0.4.15",
   "private": true,
   "type": "module",
   "description": "WriteDock local MCP server for the browser extension",

package/source/src/__tests__/bridge.test.ts

@@ -18,7 +18,7 @@ async function unusedPort() {
   return port
 }
 async function broker() {
-  const bridge = new LocalBridge({ token, port: await unusedPort(), timeoutMs: 1000 })
+  const bridge = new LocalBridge({ token, port: await unusedPort(), timeoutMs: 1000, extensionWaitMs: 0 })
   brokers.push(bridge); await bridge.start(); return bridge
 }
 async function pair(bridge: LocalBridge, key = token) {
@@ -79,6 +79,29 @@ describe('authenticated local bridge', () => {
     expect(await bridge.request('getSyncHistory')).toEqual({ method: 'getSyncHistory' })
   })
 
+  it('waits for an extension that connects shortly after, and sends the request only once', async () => {
+    const bridge = new LocalBridge({ token, port: await unusedPort(), timeoutMs: 1000, extensionWaitMs: 5000 })
+    brokers.push(bridge); await bridge.start()
+    const asked: string[] = []
+    const answer = bridge.request('getSyncHistory')
+    await new Promise(resolve => setTimeout(resolve, 600))
+    const ws = await pair(bridge)
+    ws.on('message', raw => {
+      const message = JSON.parse(raw.toString())
+      if (message.method) { asked.push(message.method); ws.send(JSON.stringify({ id: message.id, result: { ok: true } })) }
+    })
+    expect(await answer).toEqual({ ok: true })
+    expect(asked).toEqual(['getSyncHistory'])
+  })
+
+  it('still reports a missing extension after the wait, without sending anything', async () => {
+    const bridge = new LocalBridge({ token, port: await unusedPort(), timeoutMs: 1000, extensionWaitMs: 300 })
+    brokers.push(bridge); await bridge.start()
+    const started = Date.now()
+    await expect(bridge.request('publish')).rejects.toThrow('这次没有发布')
+    expect(Date.now() - started).toBeGreaterThanOrEqual(250)
+  })
+
   it('allows two MCP clients to share a port without replacing the extension or re-sending requests', async () => {
     const first = await broker()
     const ws = await pair(first)
@@ -88,7 +111,7 @@ describe('authenticated local bridge', () => {
       const message = JSON.parse(raw.toString())
       if (message.method) { requests++; ws.send(JSON.stringify({ id: message.id, result: 'ok' })) }
     })
-    const second = new LocalBridge({ token, port: first.port, timeoutMs: 1000 })
+    const second = new LocalBridge({ token, port: first.port, timeoutMs: 1000, extensionWaitMs: 0 })
     brokers.push(second)
     await second.start()
     expect(await second.request('listPlatforms')).toBe('ok')
@@ -100,7 +123,7 @@ describe('authenticated local bridge', () => {
 
   it('lets a remaining MCP client acquire the bridge when the first process exits', async () => {
     const first = await broker()
-    const second = new LocalBridge({ token, port: first.port, timeoutMs: 1000 })
+    const second = new LocalBridge({ token, port: first.port, timeoutMs: 1000, extensionWaitMs: 0 })
     brokers.push(second)
     await second.start()
     await first.close()

package/source/src/bridge.ts

@@ -35,7 +35,7 @@ export class LocalBridge {
   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> }; ensureService?: () => Promise<void>; onStopRequested?: () => void }) {
+  constructor(private options: { token: string; port?: number; timeoutMs?: number; credentials?: { getExtensionToken: () => Promise<string>; setExtensionToken: (token: string) => Promise<void> }; ensureService?: () => Promise<void>; onStopRequested?: () => void; extensionWaitMs?: number }) {
     this.port = options.port ?? 9647
     this.extensionToken = options.token
     this.media = new MediaStore(this.port)
@@ -91,7 +91,9 @@ export class LocalBridge {
 
   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() }
+    // Seen live: agents read the bundled version as the version the user runs, so it stays out of what they see.
+    const { extension_bundle_version: _bundled, ...release } = mcpReleaseInfo()
+    return { connected, extensionId: this.extensionId, ...(this.extensionVersion ? { extension_version: this.extensionVersion } : {}), ...(notice ? { update_notice: notice } : {}), protocol: 'writedock/1', ...release }
   }
 
   /** How long nothing has needed this service. An open extension connection counts as needed. */
@@ -267,13 +269,28 @@ export class LocalBridge {
       // 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', ...mcpReleaseInfo() }
+      if (this.primary) return this.connectionFields()
       return this.httpCall('/status') // A background service took the port in the meantime.
     }
   }
 
+  /**
+   * The service may have only just started, for example on the first publication after a reboot, and the extension
+   * then needs a moment to connect. Nothing has been sent yet, so waiting here cannot submit anything twice.
+   */
+  private async waitForExtension() {
+    const end = Date.now() + (this.options.extensionWaitMs ?? 45_000)
+    while (Date.now() < end) {
+      try {
+        if (this.primary ? this.client?.readyState === WebSocket.OPEN : (await this.httpCall('/status')).connected === true) return
+      } catch { return } // The request below reports what is wrong.
+      await new Promise(resolve => setTimeout(resolve, 500))
+    }
+  }
+
   async request<T = unknown>(method: string, params: Record<string, unknown> = {}): Promise<T> {
     await this.start()
+    await this.waitForExtension()
     if (this.primary) return this.requestConnected(method, params) as Promise<T>
     try { return (await this.httpCall('/request', { method, params })).result as T }
     catch (error) {

package/source/src/index.ts

@@ -12,7 +12,7 @@ async function main() {
   const identity = await loadIdentity(port, process.env.WRITEDOCK_TOKEN)
   // 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) } : {}) })
+  const bridge: LocalBridge = new LocalBridge({ token: identity.token, port, credentials: identity, ...(background ? { ensureService: () => ensureService(bridge, port) } : {}), ...(process.env.WRITEDOCK_EXTENSION_WAIT_MS ? { extensionWaitMs: Number(process.env.WRITEDOCK_EXTENSION_WAIT_MS) } : {}) })
   await bridge.start()
   if (background) watchService(bridge, port)
   const server = createMcpServer(bridge)

package/source/src/server.ts

@@ -38,7 +38,7 @@ export function createMcpServer(bridge: LocalBridge) {
   const readOnly = { readOnlyHint: true, destructiveHint: false, openWorldHint: false }
 
   server.registerTool('get_connection_status', {
-    description: '检查本机 MCP 与扩展的连接、运行版本和 npm 更新提示。update_available=true 时告知用户重新启动 WriteDock MCP，保留配置；发布任务进行中不要自动重启。有 update_notice 时转告用户。extension_bundle_version 只是 npm 包内置的扩展版本，extension_version 才是用户正在用的。旧版服务可能不返回版本字段；latest_version 缺失或 update_checking=true 时，不得声称已是最新版。', inputSchema: {}, annotations: { ...readOnly, openWorldHint: true },
+    description: '检查本机 MCP 与扩展的连接、运行版本和 npm 更新提示。update_available=true 时告知用户重新启动 WriteDock MCP，保留配置；发布任务进行中不要自动重启。有 update_notice 时转告用户。extension_version 是用户正在用的扩展版本；没有这个字段表示版本未知，不得声称扩展与 MCP 版本一致。配置里的 writedock-mcp@latest 是有意的，用户靠它收到更新，不要建议固定版本，也不要修改这条配置。旧版服务可能不返回版本字段；latest_version 缺失或 update_checking=true 时，不得声称已是最新版。', inputSchema: {}, annotations: { ...readOnly, openWorldHint: true },
   }, () => wrap(() => bridge.status()))
   server.registerTool('list_platforms', {
     description: '列出扩展实际支持的平台、登录状态、publishModes、对应 tools 及 modeOptions 限制；小红书 article 对应 publish_article，image/video 对应 publish_post。不会返回 Cookie。',