writedock-mcp 0.4.15 → 0.4.16

package/README.md

@@ -14,7 +14,8 @@ npx -y writedock-mcp@latest setup
 
 它会做两件事，并在最后告诉用户下一步：
 
-- 给本机已有的 Codex、Claude Code、Cursor、Claude Desktop 添加 MCP 配置，原文件留一份 `.writedock-backup`。已有的 WriteDock 配置不会改动。
+- 给本机已有的 Codex、Claude Code、WorkBuddy、Cursor、Claude Desktop 添加 MCP 配置，原文件留一份 `.writedock-backup`。之前 `setup` 写的配置会更新，带自定义端口等设置的配置不会改动。
+- 生成启动脚本 `~/WriteDock/start-mcp`（Windows 是 `.cmd`）。电脑上有多个 Node 时，它依次找：`setup` 用的 Node、系统的 Node、常见安装位置，用第一个 22 或以上的版本。
 - 把内置的扩展放到本机固定目录。
 
 然后重启 agent，在扩展管理页打开开发者模式，加载提示中的文件夹，打开扩展点「连接」。
@@ -32,7 +33,7 @@ npx -y writedock-mcp@latest setup
 }
 ```
 
-Windows 上要写成 `"command": "cmd"`、`"args": ["/c", "npx", "-y", "--prefer-online", "writedock-mcp@latest"]`，`setup` 会自动处理。如果 PowerShell 提示禁止运行脚本，把安装命令换成 `cmd /c npx -y writedock-mcp@latest setup`。
+Windows 上要写成 `"command": "cmd"`、`"args": ["/c", "npx", "-y", "--prefer-online", "writedock-mcp@latest"]`。手动配置依赖系统默认的 Node，版本要够新，能用 `setup` 就用 `setup`。如果 PowerShell 提示禁止运行脚本，把安装命令换成 `cmd /c npx -y writedock-mcp@latest setup`。
 
 首次下载较慢，请把启动超时设为 120 秒。启动后调用 `get_connection_status`；未连接时，让用户打开扩展点「连接」。
 

package/extension/manifest.json

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

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.15
+WriteDock 安装与更新 v0.4.16
 
 首次使用
 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.15",
+  version: "0.4.16",
   private: true,
   type: "module",
   description: "WriteDock local MCP server for the browser extension",
@@ -50411,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_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",
+    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\u8FD9\u6761 MCP \u914D\u7F6E\uFF08\u5305\u62EC start-mcp \u542F\u52A8\u811A\u672C\uFF09\u662F\u6709\u610F\u7684\uFF0C\u7528\u6237\u9760\u5B83\u6536\u5230\u66F4\u65B0\u5E76\u4F7F\u7528\u6B63\u786E\u7684 Node\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()));
@@ -50588,48 +50588,133 @@ async function loadIdentity(port, legacyToken) {
 
 // src/setup.ts
 var import_node_child_process = require("child_process");
-var import_promises5 = require("fs/promises");
+var import_promises6 = require("fs/promises");
 var import_node_os3 = require("os");
+var import_node_path6 = require("path");
+
+// src/launcher.ts
+var import_promises5 = require("fs/promises");
 var import_node_path5 = require("path");
-var NPX_ARGS = ["-y", "--prefer-online", "writedock-mcp@latest"];
-var serverCommand = (platform) => platform === "win32" ? { command: "cmd", args: ["/c", "npx", ...NPX_ARGS] } : { command: "npx", args: NPX_ARGS };
+var NPX_ARGS = "-y --prefer-online writedock-mcp@latest";
+var VERSION_CHECK = `process.exit(Number(process.versions.node.split('.')[0])>=22?0:1)`;
+var NO_NODE = "WriteDock \u9700\u8981 Node.js 22 \u6216\u66F4\u9AD8\u7248\u672C\uFF0C\u8FD9\u53F0\u7535\u8111\u4E0A\u6CA1\u6709\u627E\u5230\u3002\u8BF7\u5B89\u88C5 https://nodejs.org \u7684 LTS \u7248\uFF0C\u7136\u540E\u91CD\u542F agent\u3002";
+function posixLauncher(nodePath) {
+  const recorded = `'${nodePath.replace(/'/g, `'\\''`)}'`;
+  return `#!/bin/sh
+# Written by writedock-mcp setup. Running setup again replaces this file.
+found=""
+check() {
+  [ -n "$found" ] && return 0
+  [ -x "$1" ] || return 0
+  "$1" -e "${VERSION_CHECK}" >/dev/null 2>&1 && found="$1"
+  return 0
+}
+check ${recorded}
+check "$(command -v node 2>/dev/null)"
+check /opt/homebrew/bin/node
+check /usr/local/bin/node
+for candidate in "$HOME"/.workbuddy/binaries/node/versions/*/bin/node "$HOME"/.workbuddy/binaries/node/versions/*/node "$HOME"/.nvm/versions/node/*/bin/node; do
+  check "$candidate"
+done
+if [ -z "$found" ]; then
+  echo "${NO_NODE}" >&2
+  exit 1
+fi
+PATH="$(dirname "$found"):$PATH"
+export PATH
+exec npx ${NPX_ARGS} "$@"
+`;
+}
+function windowsLauncher(nodePath) {
+  const script = `@echo off
+chcp 65001 >nul
+rem Written by writedock-mcp setup. Running setup again replaces this file.
+set "WRITEDOCK_NODE="
+call :check "${nodePath.replace(/%/g, "%%")}"
+if defined WRITEDOCK_NODE goto run
+for /f "delims=" %%n in ('where node 2^>nul') do if not defined WRITEDOCK_NODE call :check "%%n"
+if defined WRITEDOCK_NODE goto run
+for /d %%d in ("%USERPROFILE%\\.workbuddy\\binaries\\node\\versions\\*") do if not defined WRITEDOCK_NODE call :check "%%d\\node.exe"
+if defined WRITEDOCK_NODE goto run
+for /d %%d in ("%NVM_HOME%\\v*") do if not defined WRITEDOCK_NODE call :check "%%d\\node.exe"
+if defined WRITEDOCK_NODE goto run
+echo ${NO_NODE} 1>&2
+exit /b 1
+:run
+for %%d in ("%WRITEDOCK_NODE%") do set "PATH=%%~dpd;%PATH%"
+call npx ${NPX_ARGS} %*
+exit /b %errorlevel%
+:check
+if not exist "%~1" exit /b 0
+"%~1" -e "${VERSION_CHECK}" >nul 2>nul
+if not errorlevel 1 set "WRITEDOCK_NODE=%~1"
+exit /b 0
+`;
+  return script.replace(/\n/g, "\r\n");
+}
+async function writeLauncher(home, platform, nodePath) {
+  const directory = (0, import_node_path5.join)(home, "WriteDock");
+  await (0, import_promises5.mkdir)(directory, { recursive: true });
+  if (platform === "win32") {
+    const path2 = (0, import_node_path5.join)(directory, "start-mcp.cmd");
+    await (0, import_promises5.writeFile)(path2, windowsLauncher(nodePath));
+    return { path: path2, command: "cmd", args: ["/c", path2] };
+  }
+  const path = (0, import_node_path5.join)(directory, "start-mcp.sh");
+  await (0, import_promises5.writeFile)(path, posixLauncher(nodePath));
+  await (0, import_promises5.chmod)(path, 493);
+  return { path, command: path, args: [] };
+}
+
+// src/setup.ts
+var isOurs = (text) => text.includes("writedock-mcp@latest") || text.includes("start-mcp");
 async function readIfPresent(path) {
   try {
-    return (await (0, import_promises5.readFile)(path, "utf8")).replace(/^\uFEFF/, "");
+    return (await (0, import_promises6.readFile)(path, "utf8")).replace(/^\uFEFF/, "");
   } catch (error2) {
     if (error2.code === "ENOENT") return void 0;
     throw error2;
   }
 }
 async function save(path, content, previous) {
-  await (0, import_promises5.mkdir)((0, import_node_path5.dirname)(path), { recursive: true });
-  if (previous !== void 0) await (0, import_promises5.copyFile)(path, `${path}.writedock-backup`);
-  await (0, import_promises5.writeFile)(path, content);
+  await (0, import_promises6.mkdir)((0, import_node_path6.dirname)(path), { recursive: true });
+  if (previous !== void 0) await (0, import_promises6.copyFile)(path, `${path}.writedock-backup`);
+  await (0, import_promises6.writeFile)(path, content);
 }
-async function configureCodex(path, platform = process.platform) {
+async function configureCodex(path, server) {
   const previous = await readIfPresent(path);
-  if (previous !== void 0 && /^\s*\[mcp_servers\.writedock\]/m.test(previous)) return "present";
-  const { command, args } = serverCommand(platform);
-  const entry = `[mcp_servers.writedock]
-command = "${command}"
-args = ${JSON.stringify(args)}
+  const lines = `command = ${JSON.stringify(server.command)}
+args = ${JSON.stringify(server.args)}
 startup_timeout_sec = 120
 `;
+  const section = previous === void 0 ? null : /^[ \t]*\[mcp_servers\.writedock\][^\n]*\n([\s\S]*?)(?=^[ \t]*\[|(?![\s\S]))/m.exec(previous);
+  if (section && previous !== void 0) {
+    const customised = /^[ \t]*\[mcp_servers\.writedock\./m.test(previous) || !isOurs(section[1]);
+    const current = section[1].includes(JSON.stringify(server.args).slice(1, -1)) && section[1].includes(JSON.stringify(server.command));
+    if (customised || current) return "present";
+    const start = section.index + section[0].length - section[1].length;
+    await save(path, `${previous.slice(0, start)}${lines}
+${previous.slice(start + section[1].length)}`, previous);
+    return "updated";
+  }
+  const entry = `[mcp_servers.writedock]
+${lines}`;
   await save(path, previous ? `${previous.replace(/\s*$/, "")}
 
 ${entry}` : entry, previous);
   return "added";
 }
-async function configureJsonClient(path, platform = process.platform) {
+async function configureJsonClient(path, server) {
   const previous = await readIfPresent(path);
   const config2 = previous?.trim() ? JSON.parse(previous) : {};
-  if (config2.mcpServers?.writedock) return "present";
-  config2.mcpServers = { ...config2.mcpServers, writedock: serverCommand(platform) };
+  const existing = config2.mcpServers?.writedock;
+  if (existing && (existing.env || !isOurs(JSON.stringify(existing.args ?? [])) || JSON.stringify([existing.command, existing.args]) === JSON.stringify([server.command, server.args]))) return "present";
+  config2.mcpServers = { ...config2.mcpServers, writedock: server };
   await save(path, `${JSON.stringify(config2, null, 2)}
 `, previous);
-  return "added";
+  return existing ? "updated" : "added";
 }
-var exists = async (path) => await readIfPresent(path) !== void 0;
+var exists = (path) => (0, import_promises6.access)(path).then(() => true, () => false);
 function revealFolder(path) {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer" : "xdg-open";
   try {
@@ -50640,12 +50725,15 @@ function revealFolder(path) {
   } catch {
   }
 }
-async function runSetup(home = (0, import_node_os3.homedir)(), log = console.log, platform = process.platform) {
-  const claudeDesktop = platform === "win32" ? (0, import_node_path5.join)(process.env.APPDATA || (0, import_node_path5.join)(home, "AppData/Roaming"), "Claude/claude_desktop_config.json") : platform === "darwin" ? (0, import_node_path5.join)(home, "Library/Application Support/Claude/claude_desktop_config.json") : (0, import_node_path5.join)(home, ".config/Claude/claude_desktop_config.json");
+async function runSetup(home = (0, import_node_os3.homedir)(), log = console.log, platform = process.platform, nodePath = process.execPath) {
+  const server = await writeLauncher(home, platform, nodePath);
+  const entry = { command: server.command, args: server.args };
+  const claudeDesktop = platform === "win32" ? (0, import_node_path6.join)(process.env.APPDATA || (0, import_node_path6.join)(home, "AppData/Roaming"), "Claude/claude_desktop_config.json") : platform === "darwin" ? (0, import_node_path6.join)(home, "Library/Application Support/Claude/claude_desktop_config.json") : (0, import_node_path6.join)(home, ".config/Claude/claude_desktop_config.json");
   const clients = [
-    { name: "Codex", path: (0, import_node_path5.join)(home, ".codex/config.toml"), detect: (0, import_node_path5.join)(home, ".codex/config.toml"), configure: configureCodex },
-    { name: "Claude Code", path: (0, import_node_path5.join)(home, ".claude.json"), detect: (0, import_node_path5.join)(home, ".claude.json"), configure: configureJsonClient },
-    { name: "Cursor", path: (0, import_node_path5.join)(home, ".cursor/mcp.json"), detect: (0, import_node_path5.join)(home, ".cursor/mcp.json"), configure: configureJsonClient },
+    { name: "Codex", path: (0, import_node_path6.join)(home, ".codex/config.toml"), detect: (0, import_node_path6.join)(home, ".codex/config.toml"), configure: configureCodex },
+    { name: "Claude Code", path: (0, import_node_path6.join)(home, ".claude.json"), detect: (0, import_node_path6.join)(home, ".claude.json"), configure: configureJsonClient },
+    { name: "WorkBuddy", path: (0, import_node_path6.join)(home, ".workbuddy/mcp.json"), detect: (0, import_node_path6.join)(home, ".workbuddy"), configure: configureJsonClient },
+    { name: "Cursor", path: (0, import_node_path6.join)(home, ".cursor/mcp.json"), detect: (0, import_node_path6.join)(home, ".cursor/mcp.json"), configure: configureJsonClient },
     { name: "Claude Desktop", path: claudeDesktop, detect: claudeDesktop, configure: configureJsonClient }
   ];
   let found = 0;
@@ -50653,15 +50741,15 @@ async function runSetup(home = (0, import_node_os3.homedir)(), log = console.log
     if (!await exists(client.detect)) continue;
     found++;
     try {
-      const state = await client.configure(client.path, platform);
-      log(state === "added" ? `\u2713 ${client.name}\uFF1A\u5DF2\u6DFB\u52A0 WriteDock\uFF08\u539F\u914D\u7F6E\u5907\u4EFD\u4E3A .writedock-backup\uFF09` : `\u2713 ${client.name}\uFF1A\u5DF2\u6709 WriteDock \u914D\u7F6E\uFF0C\u672A\u6539\u52A8`);
+      const state = await client.configure(client.path, entry);
+      log(state === "present" ? `\u2713 ${client.name}\uFF1A\u5DF2\u6709 WriteDock \u914D\u7F6E\uFF0C\u672A\u6539\u52A8` : `\u2713 ${client.name}\uFF1A\u5DF2${state === "added" ? "\u6DFB\u52A0" : "\u66F4\u65B0"} WriteDock\uFF08\u539F\u914D\u7F6E\u5907\u4EFD\u4E3A .writedock-backup\uFF09`);
     } catch (error2) {
       log(`\u2717 ${client.name}\uFF1A\u914D\u7F6E\u5931\u8D25\uFF08${error2 instanceof Error ? error2.message : String(error2)}\uFF09\uFF0C\u539F\u6587\u4EF6\u672A\u6539\u52A8`);
     }
   }
   if (!found) {
     log("\u6CA1\u6709\u627E\u5230\u5DF2\u77E5\u7684 agent \u5BA2\u6237\u7AEF\u3002\u8BF7\u5728\u4F60\u7684\u5BA2\u6237\u7AEF\u91CC\u6DFB\u52A0\u8FD9\u4E2A MCP \u670D\u52A1\uFF1A");
-    log(JSON.stringify({ mcpServers: { writedock: serverCommand(platform) } }, null, 2));
+    log(JSON.stringify({ mcpServers: { writedock: entry } }, null, 2));
   }
   const bundle = bundledExtension();
   const loaded = bundle ? await findInstalledExtension().catch(() => void 0) : void 0;
@@ -50691,7 +50779,7 @@ async function runSetup(home = (0, import_node_os3.homedir)(), log = console.log
 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 import_node_path7 = require("path");
 var sleep = (ms) => new Promise((resolve4) => setTimeout(resolve4, ms));
 async function probe(port) {
   try {
@@ -50713,7 +50801,7 @@ async function until(check2, timeoutMs) {
 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");
+  const log = (0, import_node_fs2.openSync)((0, import_node_path7.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", () => {

package/package.json

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

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

@@ -0,0 +1,100 @@
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { chmod, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { windowsLauncher, writeLauncher } from '../launcher'
+
+const systemNodeElsewhere = ['/opt/homebrew/bin/node', '/usr/local/bin/node'].some(existsSync)
+
+describe.skipIf(process.platform === 'win32')('Mac and Linux launcher, actually run', () => {
+  let home: string, fakeBin: string
+  const tool = async (path: string, body: string) => { await mkdir(dirname(path), { recursive: true }); await writeFile(path, `#!/bin/sh\n${body}\n`); await chmod(path, 0o755) }
+  const oldNode = (path: string) => tool(path, 'exit 1')
+  const goodNode = async (path: string) => { await tool(path, 'exit 0'); return path }
+  beforeEach(async () => {
+    home = await mkdtemp(join(tmpdir(), 'writedock-launcher-'))
+    fakeBin = join(home, 'fake-bin')
+    // Stands in for npx, so nothing is downloaded: it reports what it was started with.
+    await tool(join(fakeBin, 'npx'), 'echo "first-path=${PATH%%:*}"; echo "args=$*"')
+  })
+  afterEach(() => rm(home, { recursive: true, force: true }))
+  const run = async (recorded: string, pathDirs: string[] = []) => {
+    const { path } = await writeLauncher(home, 'darwin', recorded)
+    return spawnSync(path, ['--extra'], { encoding: 'utf8', env: { HOME: home, PATH: [fakeBin, ...pathDirs, '/usr/bin', '/bin'].join(':') } })
+  }
+
+  it('uses the Node setup ran with, ahead of an old system Node, and puts it first on PATH', async () => {
+    const system = join(home, 'system')
+    await oldNode(join(system, 'node'))
+    const recorded = await goodNode(join(home, 'agent/node'))
+    const result = await run(recorded, [system])
+    expect(result.status).toBe(0)
+    expect(result.stdout).toContain(`first-path=${dirname(recorded)}`)
+    expect(result.stdout).toContain('args=-y --prefer-online writedock-mcp@latest --extra')
+  })
+
+  it('falls back to the system Node when the recorded one is gone', async () => {
+    const system = await goodNode(join(home, 'system/node'))
+    const result = await run(join(home, 'removed-by-agent-update/node'), [dirname(system)])
+    expect(result.status).toBe(0)
+    expect(result.stdout).toContain(`first-path=${dirname(system)}`)
+  })
+
+  it('finds a newer WorkBuddy Node when its version folder changed, past an old system Node', async () => {
+    const system = join(home, 'system')
+    await oldNode(join(system, 'node'))
+    const moved = join(home, '.workbuddy/binaries/node/versions/23.0.0-1/bin')
+    await goodNode(join(moved, 'node'))
+    const result = await run(join(home, '.workbuddy/binaries/node/versions/22.22.2-6/bin/node'), [system])
+    expect(result.status).toBe(0)
+    if (!systemNodeElsewhere) expect(result.stdout).toContain(`first-path=${moved}`)
+  })
+
+  it.skipIf(systemNodeElsewhere)('says what to do when no usable Node exists, and starts nothing', async () => {
+    const system = join(home, 'system')
+    await oldNode(join(system, 'node'))
+    const result = await run(join(home, 'gone/node'), [system])
+    expect(result.status).toBe(1)
+    expect(result.stderr).toContain('nodejs.org')
+    expect(result.stdout).not.toContain('args=')
+  })
+
+  it('copes with spaces and quotes in the recorded path', async () => {
+    const odd = join(home, "it's a folder")
+    await goodNode(join(odd, 'node'))
+    const result = await run(join(odd, 'node'))
+    expect(result.status).toBe(0)
+    expect(result.stdout).toContain(`first-path=${odd}`)
+  })
+})
+
+describe('Windows launcher text (cannot run on this machine)', () => {
+  const script = windowsLauncher('C:\\Users\\张三\\.workbuddy\\binaries\\node\\versions\\22.22.2-6\\node.exe')
+  it('handles non-English user names and uses Windows line endings', () => {
+    expect(script.startsWith('@echo off\r\nchcp 65001 >nul\r\n')).toBe(true)
+    expect(script).toContain('张三')
+    expect(script.replace(/\r\n/g, '')).not.toContain('\n')
+  })
+  it('checks the recorded Node, then the system, then known folders, in that order', () => {
+    const order = ['call :check "C:\\Users', 'where node', '%USERPROFILE%', 'NVM_HOME', 'nodejs.org'].map(text => script.indexOf(text))
+    expect(order.every(index => index >= 0)).toBe(true)
+    expect([...order].sort((a, b) => a - b)).toEqual(order)
+  })
+  it('puts the chosen Node first on PATH and starts npx with call, or the script would stop there', () => {
+    expect(script).toContain('set "PATH=%%~dpd;%PATH%"')
+    expect(script).toContain('call npx -y --prefer-online writedock-mcp@latest %*')
+  })
+  it('escapes percent signs in the path', () => {
+    expect(windowsLauncher('C:\\50%\\node.exe')).toContain('C:\\50%%\\node.exe')
+  })
+  it('is what setup writes for Windows, started through cmd', async () => {
+    const home = await mkdtemp(join(tmpdir(), 'writedock-launcher-'))
+    const written = await writeLauncher(home, 'win32', 'C:\\node.exe')
+    expect(written.command).toBe('cmd')
+    expect(written.args).toEqual(['/c', written.path])
+    expect(await readFile(written.path, 'utf8')).toContain('C:\\node.exe')
+    await rm(home, { recursive: true, force: true })
+  })
+})

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

@@ -18,11 +18,11 @@ describe('setup', () => {
     const result = await readFile(join(home, '.codex/config.toml'), 'utf8')
     expect(result.startsWith(original.trimEnd())).toBe(true)
     expect(result).toContain('[mcp_servers.writedock]')
-    expect(result).toContain('"writedock-mcp@latest"')
+    expect(result).toContain('start-mcp.sh')
     expect(await readFile(join(home, '.codex/config.toml.writedock-backup'), 'utf8')).toBe(original)
   })
 
-  it('starts npx through cmd on Windows, and finds Claude Desktop in its Windows folder', async () => {
+  it('points clients at the launcher on Windows, and finds Claude Desktop in its Windows folder', async () => {
     const appData = process.env.APPDATA
     delete process.env.APPDATA
     try {
@@ -31,16 +31,59 @@ describe('setup', () => {
       const desktop = join(home, 'AppData/Roaming/Claude')
       await mkdir(desktop, { recursive: true })
       await writeFile(join(desktop, 'claude_desktop_config.json'), '\uFEFF{"theme":"dark"}')
-      expect(await runSetup(home, line => log.push(line), 'win32')).toBe(2)
+      expect(await runSetup(home, line => log.push(line), 'win32', 'C:\\node.exe')).toBe(2)
+      const launcher = join(home, 'WriteDock/start-mcp.cmd')
       const codex = await readFile(join(home, '.codex/config.toml'), 'utf8')
       expect(codex).toContain('command = "cmd"')
-      expect(codex).toContain('args = ["/c","npx","-y","--prefer-online","writedock-mcp@latest"]')
+      expect(codex).toContain(JSON.stringify(['/c', launcher]))
       const config = JSON.parse(await readFile(join(desktop, 'claude_desktop_config.json'), 'utf8'))
       expect(config.theme).toBe('dark')
-      expect(config.mcpServers.writedock).toEqual({ command: 'cmd', args: ['/c', 'npx', '-y', '--prefer-online', 'writedock-mcp@latest'] })
+      expect(config.mcpServers.writedock).toEqual({ command: 'cmd', args: ['/c', launcher] })
+      expect(await readFile(launcher, 'utf8')).toContain('C:\\node.exe')
     } finally { if (appData !== undefined) process.env.APPDATA = appData }
   })
 
+  it('configures WorkBuddy when it is installed, even before it has an MCP file', async () => {
+    await mkdir(join(home, '.workbuddy'))
+    expect(await runSetup(home, line => log.push(line), 'win32', 'C:\\node.exe')).toBe(1)
+    const config = JSON.parse(await readFile(join(home, '.workbuddy/mcp.json'), 'utf8'))
+    expect(config.mcpServers.writedock.command).toBe('cmd')
+    expect(log.join()).toContain('WorkBuddy')
+  })
+
+  it('moves an entry from an earlier setup to the launcher, in JSON and in Codex, with a backup', async () => {
+    await mkdir(join(home, '.workbuddy'))
+    const old = { mcpServers: { writedock: { command: 'cmd', args: ['/c', 'npx', '-y', '--prefer-online', 'writedock-mcp@latest'] }, other: { command: 'x' } } }
+    await writeFile(join(home, '.workbuddy/mcp.json'), JSON.stringify(old))
+    await mkdir(join(home, '.codex'))
+    const toml = 'model = "x"\n\n[mcp_servers.writedock]\ncommand = "npx"\nargs = ["-y","--prefer-online","writedock-mcp@latest"]\nstartup_timeout_sec = 120\n\n[mcp_servers.other]\ncommand = "other"\n'
+    await writeFile(join(home, '.codex/config.toml'), toml)
+    await runSetup(home, line => log.push(line), 'win32', 'C:\\node.exe')
+    const config = JSON.parse(await readFile(join(home, '.workbuddy/mcp.json'), 'utf8'))
+    expect(config.mcpServers.writedock.args[1]).toContain('start-mcp')
+    expect(config.mcpServers.other).toEqual({ command: 'x' })
+    const codex = await readFile(join(home, '.codex/config.toml'), 'utf8')
+    expect(codex).toContain('start-mcp')
+    expect(codex).not.toContain('writedock-mcp@latest')
+    expect(codex).toContain('[mcp_servers.other]\ncommand = "other"')
+    expect(codex).toContain('model = "x"')
+    expect(await readFile(join(home, '.codex/config.toml.writedock-backup'), 'utf8')).toBe(toml)
+    expect(log.join()).toContain('已更新')
+    // A second run changes nothing.
+    log.length = 0
+    await runSetup(home, line => log.push(line), 'win32', 'C:\\node.exe')
+    expect(log.join()).not.toContain('已更新')
+    expect(await readFile(join(home, '.codex/config.toml'), 'utf8')).toBe(codex)
+  })
+
+  it('leaves a JSON entry with custom settings alone', async () => {
+    await mkdir(join(home, '.cursor'))
+    const original = JSON.stringify({ mcpServers: { writedock: { command: 'npx', args: ['writedock-mcp@latest'], env: { WRITEDOCK_PORT: '9700' } } } })
+    await writeFile(join(home, '.cursor/mcp.json'), original)
+    await runSetup(home, line => log.push(line))
+    expect(await readFile(join(home, '.cursor/mcp.json'), 'utf8')).toBe(original)
+  })
+
   it('leaves an existing entry alone, including its custom port and token', async () => {
     await mkdir(join(home, '.codex'))
     const original = '[mcp_servers.writedock]\ncommand = "node"\n\n[mcp_servers.writedock.env]\nWRITEDOCK_PORT = "9700"\n'
@@ -62,8 +105,8 @@ describe('setup', () => {
     expect(log.join()).toContain('配置失败')
   })
 
-  it('touches nothing when no client exists, and prints the configuration', async () => {
+  it('changes no client when none exists, and prints the configuration', async () => {
     expect(await runSetup(home, line => log.push(line))).toBe(0)
-    expect(log.join()).toContain('writedock-mcp@latest')
+    expect(log.join()).toContain('start-mcp')
   })
 })

package/source/src/launcher.ts

@@ -0,0 +1,82 @@
+import { chmod, mkdir, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+const NPX_ARGS = '-y --prefer-online writedock-mcp@latest'
+const VERSION_CHECK = `process.exit(Number(process.versions.node.split('.')[0])>=22?0:1)`
+const NO_NODE = 'WriteDock 需要 Node.js 22 或更高版本，这台电脑上没有找到。请安装 https://nodejs.org 的 LTS 版，然后重启 agent。'
+
+/**
+ * Seen live: an agent ran setup with its own Node 22, then started MCP with the system's Node 16, which cannot run it.
+ * So the agent's config points at this script. It looks for a usable Node in order: the one setup ran with (an agent
+ * update can remove that folder), the system's, then the places they are usually kept. It puts that Node first on
+ * PATH, because npx starts the package through whichever node comes first there.
+ */
+export function posixLauncher(nodePath: string) {
+  const recorded = `'${nodePath.replace(/'/g, `'\\''`)}'`
+  return `#!/bin/sh
+# Written by writedock-mcp setup. Running setup again replaces this file.
+found=""
+check() {
+  [ -n "$found" ] && return 0
+  [ -x "$1" ] || return 0
+  "$1" -e "${VERSION_CHECK}" >/dev/null 2>&1 && found="$1"
+  return 0
+}
+check ${recorded}
+check "$(command -v node 2>/dev/null)"
+check /opt/homebrew/bin/node
+check /usr/local/bin/node
+for candidate in "$HOME"/.workbuddy/binaries/node/versions/*/bin/node "$HOME"/.workbuddy/binaries/node/versions/*/node "$HOME"/.nvm/versions/node/*/bin/node; do
+  check "$candidate"
+done
+if [ -z "$found" ]; then
+  echo "${NO_NODE}" >&2
+  exit 1
+fi
+PATH="$(dirname "$found"):$PATH"
+export PATH
+exec npx ${NPX_ARGS} "$@"
+`
+}
+
+export function windowsLauncher(nodePath: string) {
+  const script = `@echo off
+chcp 65001 >nul
+rem Written by writedock-mcp setup. Running setup again replaces this file.
+set "WRITEDOCK_NODE="
+call :check "${nodePath.replace(/%/g, '%%')}"
+if defined WRITEDOCK_NODE goto run
+for /f "delims=" %%n in ('where node 2^>nul') do if not defined WRITEDOCK_NODE call :check "%%n"
+if defined WRITEDOCK_NODE goto run
+for /d %%d in ("%USERPROFILE%\\.workbuddy\\binaries\\node\\versions\\*") do if not defined WRITEDOCK_NODE call :check "%%d\\node.exe"
+if defined WRITEDOCK_NODE goto run
+for /d %%d in ("%NVM_HOME%\\v*") do if not defined WRITEDOCK_NODE call :check "%%d\\node.exe"
+if defined WRITEDOCK_NODE goto run
+echo ${NO_NODE} 1>&2
+exit /b 1
+:run
+for %%d in ("%WRITEDOCK_NODE%") do set "PATH=%%~dpd;%PATH%"
+call npx ${NPX_ARGS} %*
+exit /b %errorlevel%
+:check
+if not exist "%~1" exit /b 0
+"%~1" -e "${VERSION_CHECK}" >nul 2>nul
+if not errorlevel 1 set "WRITEDOCK_NODE=%~1"
+exit /b 0
+`
+  return script.replace(/\n/g, '\r\n')
+}
+
+export async function writeLauncher(home: string, platform: NodeJS.Platform, nodePath: string) {
+  const directory = join(home, 'WriteDock')
+  await mkdir(directory, { recursive: true })
+  if (platform === 'win32') {
+    const path = join(directory, 'start-mcp.cmd')
+    await writeFile(path, windowsLauncher(nodePath))
+    return { path, command: 'cmd', args: ['/c', path] }
+  }
+  const path = join(directory, 'start-mcp.sh')
+  await writeFile(path, posixLauncher(nodePath))
+  await chmod(path, 0o755)
+  return { path, command: path, args: [] as string[] }
+}

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_version 是用户正在用的扩展版本；没有这个字段表示版本未知，不得声称扩展与 MCP 版本一致。配置里的 writedock-mcp@latest 是有意的，用户靠它收到更新，不要建议固定版本，也不要修改这条配置。旧版服务可能不返回版本字段；latest_version 缺失或 update_checking=true 时，不得声称已是最新版。', inputSchema: {}, annotations: { ...readOnly, openWorldHint: true },
+    description: '检查本机 MCP 与扩展的连接、运行版本和 npm 更新提示。update_available=true 时告知用户重新启动 WriteDock MCP，保留配置；发布任务进行中不要自动重启。有 update_notice 时转告用户。extension_version 是用户正在用的扩展版本；没有这个字段表示版本未知，不得声称扩展与 MCP 版本一致。这条 MCP 配置（包括 start-mcp 启动脚本）是有意的，用户靠它收到更新并使用正确的 Node，不要建议固定版本，也不要修改这条配置。旧版服务可能不返回版本字段；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。',

package/source/src/setup.ts

@@ -1,14 +1,12 @@
 import { spawn } from 'node:child_process'
-import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises'
+import { access, copyFile, mkdir, readFile, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
+import { writeLauncher } from './launcher'
 import { bundledExtension, defaultExtensionDirectory, findInstalledExtension, installExtensionFiles } from './extension-update'
 
-const NPX_ARGS = ['-y', '--prefer-online', 'writedock-mcp@latest']
-/** On Windows npx is a .cmd script, which clients that start programs directly cannot run. */
-const serverCommand = (platform: NodeJS.Platform) => platform === 'win32'
-  ? { command: 'cmd', args: ['/c', 'npx', ...NPX_ARGS] }
-  : { command: 'npx', args: NPX_ARGS }
+type ServerCommand = { command: string; args: string[] }
+const isOurs = (text: string) => text.includes('writedock-mcp@latest') || text.includes('start-mcp')
 
 async function readIfPresent(path: string) {
   // Windows editors may save a BOM, which JSON.parse rejects.
@@ -22,26 +20,38 @@ async function save(path: string, content: string, previous: string | undefined)
   await writeFile(path, content)
 }
 
-/** Keeps the user's other settings; an existing WriteDock entry stays, because it may hold a custom port or data directory. */
-export async function configureCodex(path: string, platform: NodeJS.Platform = process.platform): Promise<'added' | 'present'> {
+/**
+ * Keeps the user's other settings. An entry from an earlier setup moves to the launcher. Anything else stays,
+ * because it may hold a custom command, port or data directory.
+ */
+export async function configureCodex(path: string, server: ServerCommand): Promise<'added' | 'updated' | 'present'> {
   const previous = await readIfPresent(path)
-  if (previous !== undefined && /^\s*\[mcp_servers\.writedock\]/m.test(previous)) return 'present'
-  const { command, args } = serverCommand(platform)
-  const entry = `[mcp_servers.writedock]\ncommand = "${command}"\nargs = ${JSON.stringify(args)}\nstartup_timeout_sec = 120\n`
+  const lines = `command = ${JSON.stringify(server.command)}\nargs = ${JSON.stringify(server.args)}\nstartup_timeout_sec = 120\n`
+  const section = previous === undefined ? null : /^[ \t]*\[mcp_servers\.writedock\][^\n]*\n([\s\S]*?)(?=^[ \t]*\[|(?![\s\S]))/m.exec(previous)
+  if (section && previous !== undefined) {
+    const customised = /^[ \t]*\[mcp_servers\.writedock\./m.test(previous) || !isOurs(section[1])
+    const current = section[1].includes(JSON.stringify(server.args).slice(1, -1)) && section[1].includes(JSON.stringify(server.command))
+    if (customised || current) return 'present'
+    const start = section.index + section[0].length - section[1].length
+    await save(path, `${previous.slice(0, start)}${lines}\n${previous.slice(start + section[1].length)}`, previous)
+    return 'updated'
+  }
+  const entry = `[mcp_servers.writedock]\n${lines}`
   await save(path, previous ? `${previous.replace(/\s*$/, '')}\n\n${entry}` : entry, previous)
   return 'added'
 }
 
-export async function configureJsonClient(path: string, platform: NodeJS.Platform = process.platform): Promise<'added' | 'present'> {
+export async function configureJsonClient(path: string, server: ServerCommand): Promise<'added' | 'updated' | 'present'> {
   const previous = await readIfPresent(path)
-  const config = previous?.trim() ? JSON.parse(previous) as { mcpServers?: Record<string, unknown> } : {}
-  if (config.mcpServers?.writedock) return 'present'
-  config.mcpServers = { ...config.mcpServers, writedock: serverCommand(platform) }
+  const config = previous?.trim() ? JSON.parse(previous) as { mcpServers?: Record<string, { command?: unknown; args?: unknown; env?: unknown }> } : {}
+  const existing = config.mcpServers?.writedock
+  if (existing && (existing.env || !isOurs(JSON.stringify(existing.args ?? [])) || JSON.stringify([existing.command, existing.args]) === JSON.stringify([server.command, server.args]))) return 'present'
+  config.mcpServers = { ...config.mcpServers, writedock: server }
   await save(path, `${JSON.stringify(config, null, 2)}\n`, previous)
-  return 'added'
+  return existing ? 'updated' : 'added'
 }
 
-const exists = async (path: string) => (await readIfPresent(path)) !== undefined
+const exists = (path: string) => access(path).then(() => true, () => false)
 
 /** Best effort: shows the folder so the user can pick it, or drag it onto the extensions page. */
 function revealFolder(path: string) {
@@ -50,15 +60,18 @@ function revealFolder(path: string) {
 }
 
 /** Only clients already on this computer are configured, so setup never creates settings for an app the user does not have. */
-export async function runSetup(home = homedir(), log: (line: string) => void = console.log, platform: NodeJS.Platform = process.platform) {
+export async function runSetup(home = homedir(), log: (line: string) => void = console.log, platform: NodeJS.Platform = process.platform, nodePath = process.execPath) {
+  const server = await writeLauncher(home, platform, nodePath)
+  const entry = { command: server.command, args: server.args }
   const claudeDesktop = platform === 'win32'
     ? join(process.env.APPDATA || join(home, 'AppData/Roaming'), 'Claude/claude_desktop_config.json')
     : platform === 'darwin'
       ? join(home, 'Library/Application Support/Claude/claude_desktop_config.json')
       : join(home, '.config/Claude/claude_desktop_config.json')
-  const clients: { name: string; path: string; detect: string; configure: (path: string, platform: NodeJS.Platform) => Promise<'added' | 'present'> }[] = [
+  const clients: { name: string; path: string; detect: string; configure: (path: string, server: ServerCommand) => Promise<'added' | 'updated' | 'present'> }[] = [
     { name: 'Codex', path: join(home, '.codex/config.toml'), detect: join(home, '.codex/config.toml'), configure: configureCodex },
     { name: 'Claude Code', path: join(home, '.claude.json'), detect: join(home, '.claude.json'), configure: configureJsonClient },
+    { name: 'WorkBuddy', path: join(home, '.workbuddy/mcp.json'), detect: join(home, '.workbuddy'), configure: configureJsonClient },
     { name: 'Cursor', path: join(home, '.cursor/mcp.json'), detect: join(home, '.cursor/mcp.json'), configure: configureJsonClient },
     { name: 'Claude Desktop', path: claudeDesktop, detect: claudeDesktop, configure: configureJsonClient },
   ]
@@ -67,13 +80,13 @@ export async function runSetup(home = homedir(), log: (line: string) => void = c
     if (!await exists(client.detect)) continue
     found++
     try {
-      const state = await client.configure(client.path, platform)
-      log(state === 'added' ? `✓ ${client.name}：已添加 WriteDock（原配置备份为 .writedock-backup）` : `✓ ${client.name}：已有 WriteDock 配置，未改动`)
+      const state = await client.configure(client.path, entry)
+      log(state === 'present' ? `✓ ${client.name}：已有 WriteDock 配置，未改动` : `✓ ${client.name}：已${state === 'added' ? '添加' : '更新'} WriteDock（原配置备份为 .writedock-backup）`)
     } catch (error) { log(`✗ ${client.name}：配置失败（${error instanceof Error ? error.message : String(error)}），原文件未改动`) }
   }
   if (!found) {
     log('没有找到已知的 agent 客户端。请在你的客户端里添加这个 MCP 服务：')
-    log(JSON.stringify({ mcpServers: { writedock: serverCommand(platform) } }, null, 2))
+    log(JSON.stringify({ mcpServers: { writedock: entry } }, null, 2))
   }
   // Keep whichever folder the browser already loads, so a repeat setup does not ask for another manual load.
   const bundle = bundledExtension()