writedock-mcp 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +72 -50
  2. package/index.cjs +44 -1
  3. package/package.json +1 -1
  4. package/source/package.json +1 -1
  5. package/source/src/server.ts +42 -0
package/README.md CHANGED
@@ -1,10 +1,12 @@
1
1
  # WriteDock MCP
2
2
 
3
- 连接用户自己的 agent 与 WriteDock 浏览器扩展。agent 写稿并准备图片或视频，本服务负责素材读取、任务转发与结果查询。平台 Cookie 留在浏览器中。
3
+ 连接你自己的 agent 与 WriteDock 浏览器扩展：agent 写稿并准备图片或视频，一次调用发布到多个平台，并按平台查询结果。
4
4
 
5
- ## 通过 npx 连接
5
+ MCP 运行在你自己的电脑上，只监听 `127.0.0.1`。平台 Cookie 留在浏览器里，稿件和媒体不经过 npm。
6
6
 
7
- 电脑需要 Node.js 22+（包含 npm/npx），首次获取及更新需要能访问 npm。无需手动下载解压安装包，无需全局安装。本包运行的是本机 stdio MCP，不是远程托管服务。
7
+ ## 安装
8
+
9
+ 需要 Node.js 22+，以及已加载 WriteDock 扩展的 Chrome 或 Edge。
8
10
 
9
11
  ```json
10
12
  {
@@ -18,7 +20,7 @@
18
20
  }
19
21
  ```
20
22
 
21
- Codex 的配置示例（格式依据 [OpenAI 官方 MCP 文档](https://developers.openai.com/codex/mcp/)）：
23
+ Codex：
22
24
 
23
25
  ```toml
24
26
  [mcp_servers.writedock]
@@ -31,72 +33,92 @@ tool_timeout_sec = 60
31
33
  WRITEDOCK_PORT = "9647"
32
34
  ```
33
35
 
34
- 不同客户端按各自支持的配置格式添加。首次下载需预留启动时间；Windows 的 npx 启动命令按客户端要求处理。
35
-
36
- 启动 MCP 后调用 `get_connection_status`；尚未配对时调用 `begin_pairing`，将一次性配对码粘贴到扩展的「MCP 连接」。配对码 3 分钟有效、使用一次失效。连接配置和配对阶段不提交文章；连通后按用户指定的平台和内容调用发布工具。
37
-
38
- ## 更新与旧版迁移
36
+ 首次下载较慢，请把启动超时设为 120 秒。启动后调用 `get_connection_status`；未配对时调用 `begin_pairing`，把一次性配对码粘贴到扩展的「MCP 连接」页。配对码 3 分钟有效，只能用一次。
39
37
 
40
- `--prefer-online` 在每次新启动时检查 npm 包的更新，相同版本可复用缓存；`latest` 指向维护者发布的版本。正在运行的进程不会自动替换，发布新版后重新加载 MCP 连接或重启相关 agent。新建聊天、刷新扩展不一定重启 MCP。
38
+ ## 发布
41
39
 
42
- 从旧的 `node /安装目录/index.cjs` 迁移时，修改已有 writedock 服务的 command/args，保留原端口、`WRITEDOCK_DATA_DIR`、已有 `WRITEDOCK_TOKEN` 和其他客户端配置，停掉仍运行旧程序的 WriteDock MCP，再重新加载连接。无需删除旧程序目录或配对资料。
40
+ 优先使用 `publish`，一次调用即可：
43
41
 
44
- 身份与配对保存在用户数据目录的 `identity-端口.json`，不在程序目录或 npm 缓存里：
45
-
46
- - macOS：`~/Library/Application Support/WriteDock/mcp/`
47
- - Windows：`%LOCALAPPDATA%/WriteDock/mcp/`
48
- - Linux：`${XDG_DATA_HOME:-~/.local/share}/writedock/mcp/`
49
-
50
- 保留同一系统用户、端口和数据目录时，npx 更新继续复用身份。旧 `WRITEDOCK_TOKEN` 仅在首次建立持久身份时迁移，资料已存在时不会覆盖。扩展更新保留浏览器配对；卸载重装扩展后用 `begin_pairing` 恢复，不需要重装 MCP。配对资料不备份浏览器稿件或 Cookie。
51
-
52
- 服务默认只监听 `127.0.0.1:9647`，可通过 `WRITEDOCK_PORT` 调整。Cookie、稿件与媒体不经过 npm 注册表。MCP 桥接主进程重启后，未完成的本机素材授权需要重新准备，已提交的任务先查询原 request_id，不自动重发。
53
-
54
- `npx -y --prefer-online writedock-mcp@latest --version` 只显示版本，不启动服务或读取配对资料。
42
+ ```json
43
+ {
44
+ "platforms": ["zhihu", "baijiahao", "weibo", "xiaohongshu", "douyin"],
45
+ "article": { "file_path": "/absolute/path/article.md" },
46
+ "post": { "kind": "image", "title": "标题", "content": "正文", "image_paths": ["/absolute/path/1.png"] },
47
+ "request_id": "my_post_20261105_01"
48
+ }
49
+ ```
55
50
 
56
- ## 版本提示
51
+ 扩展按平台选择内容：
57
52
 
58
- 自 v0.4.2 起，MCP 在启动后异步检查 npm latest，随后每 6 小时检查，失败后至少等待 10 分钟再试。查询只访问公开版本信息，不传送配对凭据或稿件，也不会阻塞配对、工具调用或发布任务。
53
+ | 平台 ID | 默认发送 | 说明 |
54
+ |---|---|---|
55
+ | `zhihu` | 文章 | 标题最多 100 字，可内嵌本地 MP4 |
56
+ | `baijiahao` | 文章 | 标题最多 64 字；没有 `cover` 时使用正文第一张图 |
57
+ | `bilibili` | 文章 | 不接独立封面；LV1–3 账号每天只能发 1 篇，删除不退额度 |
58
+ | `weibo` | 有 `post` 发图文或视频，否则发长文章 | 长文章标题最多 32 字；视频必须明确 `weibo_video_creation` |
59
+ | `xiaohongshu` | 有 `post` 发图文或视频，否则发长文 | 长文标题最多 64 字、正文最多 10000 字 |
60
+ | `douyin` | 图文或视频 | 不接文章 |
61
+ | `weixin`、`sohu` | 只保存文章草稿 | 不公开发布 |
59
62
 
60
- `get_connection_status` 返回 `mcp_version`、可用时的 `latest_version`、`update_available`、`update_checked_at`、`update_checking` 及可选 `update_check_error`。运行版本指与扩展实际连接的本机桥接进程；多个 agent 共用端口时，不把新启动客户端的版本误当成仍占用端口的旧服务版本。
63
+ - 用 `modes` 可为微博、小红书指定内容类型，如 `{"weibo": "article"}`。
64
+ - 某个平台未登录、不能接收这份内容或失败时，只跳过该平台，其他平台继续。
65
+ - 不支持的 `cover` 会被忽略，并写入该平台的 `warnings`。标题超长不会被截断，该平台直接失败。
66
+ - 平台依次执行，全部完成通常需要几分钟。同一时间只运行一个任务。
67
+ - 只有用户明确要求发布并指定平台时，才调用发布工具。
61
68
 
62
- 现有 ready/ping 消息附带相同信息，扩展显示版本和更新提示。只有确定 npm 版本更新时才提醒用户重新启动 WriteDock MCP。发布任务进行中只提示，不自动重启、改配置或重新提交。旧扩展忽略新增字段；旧 MCP 未提供版本字段时显示未知。npm 查询失败不影响当前连接。
69
+ `rehearse_publish` 参数相同，但会在点击发布之前停下，也不需要 `request_id`。可能上传图片并留下草稿，结果 `rehearsed` 不代表已发布。
63
70
 
64
- 工具包括：`get_connection_status`、`begin_pairing`、`list_platforms`、`check_auth`、`prepare_article`、`publish_article`、`sync_article`、`prepare_post`、`publish_post`、`get_sync_task`、`list_sync_history`。
71
+ ## 查询结果
65
72
 
66
- 小红书的三种发布方式共用 `platforms: ["xiaohongshu"]`：
73
+ `publish` 立即返回 `task_id`，随后用 `get_sync_task` 查询，直到 `finished: true`。任务结束后，按 `summary` 逐平台告诉用户结果：
67
74
 
68
- | 模式 | 调用 | 说明 |
75
+ | `summary` 分类 | 含义 | agent 应该怎么做 |
69
76
  |---|---|---|
70
- | 写长文 | `publish_article` | Markdown/HTML/稿件文件，支持正文图片，原生自动排版后发布；标题最多 64 字、正文最多 10000 字，不接独立 `cover`、内嵌视频或长文话题 |
71
- | 普通图文 | `publish_post`，`kind: "image"` | `image_paths`、标题和正文；首图作封面 |
72
- | 独立视频 | `publish_post`，`kind: "video"` | `video_path`、标题和简介；不传 `cover_path` 时使用平台自动生成的第一帧封面 |
73
-
74
- Agent 先看 `list_platforms` 返回的 `publishModes`、`tools`、`modeOptions` 再选入口；直接传内容即可，不要求先准备本机预览。沿用已有工具名称、参数及桥接协议，已有通用 `publish_article` / `publish_post` 的 MCP 无需因小红书增加长文而重装。工具说明源码同步更新，未改用户安装。普通图文/视频的标题、数量、格式和正文长度还受原生控件限制，不能截断或丢图后继续提交。
77
+ | `submitted` | 平台已接受提交，可能还在审核 | 汇报结果和链接 |
78
+ | `draft_saved` | 已保存草稿 | 汇报，说明未公开发布 |
79
+ | `rehearsed` | 演练结束，未发布 | 不得说已发布 |
80
+ | `not_logged_in` | 未登录，未执行 | 请用户登录后，用新 `request_id` 只重发这些平台 |
81
+ | `login_unconfirmed` | 无法确认登录状态，未执行 | 请用户检查后再提交 |
82
+ | `waiting_verification` | 正在等用户完成验证码 | 立即转告 `user_actions` 的提示和链接，继续查询 |
83
+ | `needs_user_action` | 需要用户在页面上处理 | 转告原因和链接，不重发 |
84
+ | `unknown` | 结果未确认，可能已经发布 | 让用户核对，**不要重发** |
85
+ | `failed` | 未能完成 | 汇报 `error`，必要时提供 `diagnostics` |
75
86
 
76
- 小红书仅在匹配本任务的 `POST /web_api/sns/v2/note` 返回 HTTP 成功、`success: true`、`result: 0` 和有效笔记 ID 时确认 `submitted`。长文需先核对排版前的完整正文与插图，再核对生成图片的上传及最终长文标记。验证码、协议、封面或设置需人工处理时，Agent 把 `user_actions` 的原因和原稿件链接交给用户，在已打开的同一页处理并手动发布；不重发、不换请求 ID。本次仅完成源码接入，未运行测试、构建、打包或实际投稿。
87
+ 验证码由用户手动完成，agent 和扩展都不代做。用户完成后任务会自动更新，不需要重新提交。
77
88
 
78
- 知乎用 `publish_article` 直接发布 Agent 写好的 Markdown/HTML，参数为 file_path/markdown/html 三选一（或已准备的 draft_id）、platforms: ["zhihu"] 和稳定 request_id。可直接提交，无需在扩展编写，也无需先调用 prepare_article。支持本地 PNG/JPEG/GIF/WebP 正文图片；稿件中的 `<video src="./demo.mp4"></video>` 可插入本地 MP4，路径按稿件目录或 base_directory 解析。每篇最多 5 个视频、总量 512 MB；标题最多 100 字，独立封面和话题暂未接入。视频是文章内嵌，不是独立视频投稿。
89
+ 相同 `request_id` 和相同内容不会重复提交；内容变化必须换新 ID。部分平台失败时，只针对失败的平台用新 ID 重发，`unknown` 的平台不要重发。
79
90
 
80
- 扩展自动完成知乎内部草稿准备，再触发页面原生发布，让平台生成动态签名；仅在发布接口返回 code=0 且文章 ID 匹配时确认 submitted。未知结果返回 unknown，不自动重发。返回 task_id 后调用 get_sync_task 查询。源码接入尚未运行测试或真实投稿。
91
+ ## 工具
81
92
 
82
- 百家号同样使用 `publish_article`，必须提供 cover 封面（本地图片、HTTP(S) 地址或 data URI），当前接收 64 字以内标题，暂不接文章内视频。平台要求旋转验证码、其他验证码或调整封面时，任务返回 needs_user_action，顶层 requires_user_action 和 user_actions 给出原因、原稿件链接。Agent 必须把它们告诉用户，优先让用户在扩展已打开的页面完成验证并手动发布，不解验证码、不重发、不换 ID。人工接管不会被标记为提交成功，原任务也不会自动确认用户之后的操作。
93
+ | 工具 | 用途 |
94
+ |---|---|
95
+ | `get_connection_status` | 连接状态、运行版本和更新提示 |
96
+ | `begin_pairing` | 生成一次性配对码 |
97
+ | `list_platforms`、`check_auth` | 平台能力和登录状态 |
98
+ | `publish`、`rehearse_publish` | 一次调用发多平台，以及演练 |
99
+ | `get_sync_task`、`list_sync_history` | 任务结果和最近 25 次记录 |
100
+ | `prepare_article`、`prepare_post` | 可选：把稿件存到扩展里预览 |
101
+ | `publish_article`、`publish_post`、`sync_article` | 旧版按类型发布，继续可用 |
102
+ | `rehearse_article`、`rehearse_post` | 旧版按类型演练 |
83
103
 
84
- 微博长文章同样用 `publish_article`，platforms: ["weibo"]；当前接收 32 字以内标题，正文支持图片、封面可选。无独立封面时使用本篇第一张正文图片，没有正文图片则需显式提供 cover。视频 URL 尚未接入。验证码、原创协议或发布设置无法核对时转人工处理；不自动关注官方账号、声明原创或同步新浪新闻。
104
+ 文章来源支持 `file_path`、`markdown`、`html` 三选一，图片支持 PNG/JPEG/GIF/WebP，单张 8 MB，整篇 24 MB。图文图片单张 20 MB、总量 100 MB；视频支持 MP4/MOV/WebM，最大 512 MB。实际限制还以平台页面为准。
85
105
 
86
- 微信公众号、搜狐号暂用 `sync_article` 保存草稿。B站专栏改用 `publish_article`，平台 ID 为 `bilibili`，`platforms: ["bilibili"]` 接收 Agent 的 Markdown/HTML/文件，支持正文图片。扩展使用新版原生编辑器生成实时签名、上传图片并直接提交；不经过旧版专栏草稿接口。B站暂不接视频、视频卡片、音频或独立 cover，标题按页面实际限制校验。`code=-352` 或验证码请求返回 needs_user_action 和当前原稿件页链接，让用户在已打开的标签页验证并手动发布，Agent 不重新提交。只有匹配的 create/opus 返回 code=0 及有效字符串 dyn_id_str 才报告 submitted。B站接入沿用现有工具和平台字符串参数，不增加 MCP 工具、参数或协议，无需因此重装 MCP。微博长文章保留并接入直发。知乎、百家号、微博长文章、B站专栏旧草稿请求不会自动公开发布，需显式使用 publish_article。实际能力以 list_platforms 的 action、publishModes、capabilities、coverRequired 为准，publish_article 的平台入参不固定枚举。
106
+ ## 已知限制
87
107
 
88
- 小红书、抖音、微博普通图文/独立视频用 `prepare_post` / `publish_post`。字段包括 kind（image/video）、title、content、image_paths、video_path、cover_path、tags、base_directory。路径由 agent 自动准备。图片单张 20 MB、总量 100 MB；视频最大 512 MB，支持 MP4/MOV/WebM，具体格式和数量以平台上传控件为准。视频封面可选，图文封面使用第一张图片。普通微博标题放在正文首行，最多 18 张图片；微博视频封面最多 5 MB、标题最多 30 个汉字或 60 个半角字符。
108
+ - 发布依赖平台页面，平台改版可能导致失败。失败结果的 `diagnostics` 含阶段、页面结构和请求路径，不含 Cookie、输入内容和 URL 查询参数。
109
+ - 抖音只能通过页面提示确认结果，没有接口回执，遇到验证码时直接交给用户。
110
+ - 除 B站外，其他平台的验证码流程尚未在真实验证码上验证过。
111
+ - 视频发布已走到发布前，但尚未真实发布验证。
112
+ - `submitted` 不跟踪之后的审核结果。
89
113
 
90
- 抖音 `platforms: ["douyin"]` 直接复用 MultiPost-Extension 的公开页面流程，用户不需要先操作发布或抓 HAR。图文用 `kind: "image"`，独立视频用 `kind: "video"`，可选 `cover_path`。当前图文话题最多 4 个、视频最多 5 个；标题、全文和话题写入后会完整核对。仅接即时投稿，工具未提供定时发布或横竖两套封面参数。抖音以本次操作新增的原生成功提示确认 `submitted`，`list_platforms.confirmation` 为 `native_page_message`；未核对最终 HTTP 业务回执，跳转本身不算成功，没有明确提示则返回 `unknown`。验证码、声明、协议和封面问题返回 `needs_user_action`，Agent 交出原投稿页和原因，让用户在同一页处理并手动发布，不重发。本次沿用现有 `publish_post` 及桥接协议，已有此工具的 MCP 无需因此重装；仅改源码，未运行测试、构建、打包或修改用户安装。
114
+ ## 更新
91
115
 
92
- 微博视频必须明确 `weibo_video_creation: original | secondary | repost`（原创/二创/转载），不得默认声明原创。此参数会保存到本机稿件并参与请求去重。若需补充来源、原视频关联、内容声明、分类、封面或验证码，返回 needs_user_action 及原投稿页链接，Agent 告诉用户在已打开的页面手动处理并发布，不重新提交。只有匹配本任务的 statuses/update 成功回执才确认微博 submitted；视频回执可能不带帖子 ID，不因此编造 ID。微博长文章继续用 publish_article，三种格式共用 weibo 这个平台 ID。
116
+ `--prefer-online` 在每次启动时检查新版，运行中的进程不会自动替换，重启 MCP 即可。配置和配对都会保留，发布任务进行中不要重启。配对资料保存在用户数据目录的 `identity-端口.json`：
93
117
 
94
- 先用 `prepare_post` 存本机预览，返回 draft_id；再向 `publish_post` 传 draft_id、request_id 和 platforms（xiaohongshu/douyin/weibo）。也可直接向 publish_post 提供全部内容与素材。该工具会打开平台原生页面并点击发布，必须以用户明确的发布要求和目标平台为依据。publish_post 的平台参数改为由扩展实际能力校验，不在 MCP 中固定枚举。
95
-
96
- 所有提交都需要稳定的 `request_id`，返回 `task_id` 后用 `get_sync_task` 跟进。同 ID 的相同请求复用原任务，不能用同 ID 发布不同内容。Agent 只使用 WriteDock MCP，不依赖浏览器或 Playwright 工具。打开平台原生投稿页及操作由扩展完成。任务返回 finished、next_action、results、agent_instructions；poll_task 按原 ID 继续查询，report_result 汇报逐平台结果和链接。submitted/published 后不再打开网站验证；验证码、图形验证、unknown 或 interrupted 时，把 user_actions 中的原因和链接交给用户自行点击处理，不自动换 ID 重试。submitted 表示平台接受提交，是否公开展示以平台审核为准。
97
-
98
- 本地视频不嵌入 MCP 消息，而是通过随机授权、绑定具体文件的本机 HTTP 范围请求分块传输。授权两小时有效，MCP 桥接主进程重启后重新准备素材；文件变更会拒绝读取。从旧版使用新增 publish_article 或 prepare_post/publish_post 工具时，原位升级本 MCP 一次并重启，保留 agent 配置和已有配对资料。
118
+ - macOS：`~/Library/Application Support/WriteDock/mcp/`
119
+ - Windows：`%LOCALAPPDATA%/WriteDock/mcp/`
120
+ - Linux：`${XDG_DATA_HOME:-~/.local/share}/writedock/mcp/`
99
121
 
100
- 本次微博接入新增创作类型参数，并放开 publish_post 的固定平台枚举，启用新版时需原位更新 MCP 程序一次。后续同类平台增删由扩展校验，避免每次改平台枚举；保留安装位置、启动配置和配对资料，无需卸载重装。本版本提供可通过 npx 启动的构建包，未进行真实平台投稿验证。
122
+ 卸载重装扩展后，调用 `begin_pairing` 重新配对即可，不需要重装 MCP。`npx -y writedock-mcp@latest --version` 只显示版本。
101
123
 
102
- 对应源码位于 npm 包内 `source/`，可在该目录安装开发依赖并运行构建命令。第三方依赖许可见 `THIRD_PARTY_NOTICES.txt`，本服务遵循 GPL-3.0-only，见 `LICENSE` 与 `NOTICE.md`。
124
+ 对应源码位于包内 `source/`。本服务遵循 GPL-3.0-only，见 `LICENSE`、`NOTICE.md` 和 `THIRD_PARTY_NOTICES.txt`。
package/index.cjs CHANGED
@@ -29739,7 +29739,7 @@ var MediaStore = class {
29739
29739
  // package.json
29740
29740
  var package_default = {
29741
29741
  name: "@writedock/mcp-server",
29742
- version: "0.4.2",
29742
+ version: "0.4.4",
29743
29743
  private: true,
29744
29744
  type: "module",
29745
29745
  description: "WriteDock local MCP server for the browser extension",
@@ -50328,6 +50328,49 @@ function createMcpServer(bridge) {
50328
50328
  if (!args.draft_id && (!args.kind || !args.title)) throw new Error("\u8BF7\u63D0\u4F9B draft_id\uFF0C\u6216\u5B8C\u6574\u7684 kind\u3001title \u548C\u7D20\u6750\u8DEF\u5F84");
50329
50329
  return bridge.request("publishPost", { requestId: args.request_id, platforms: args.platforms, ...args.draft_id ? { draftId: args.draft_id } : { post: await preparePost({ ...args, kind: args.kind, title: args.title }, (path, kind) => bridge.registerMedia(path, kind)) } });
50330
50330
  }));
50331
+ const unifiedInput = {
50332
+ platforms: external_exports.array(external_exports.string().min(1)).min(1).max(30).describe("\u7528\u6237\u6307\u5B9A\u7684\u5168\u90E8\u5E73\u53F0 ID\u3002\u6269\u5C55\u6309\u5E73\u53F0\u5206\u6D41\uFF1A\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001B\u7AD9\u53D1\u6587\u7AE0\uFF1B\u6296\u97F3\u53D1\u56FE\u6587/\u89C6\u9891\uFF1B\u5FAE\u535A\u3001\u5C0F\u7EA2\u4E66\u6709 post \u65F6\u53D1\u56FE\u6587/\u89C6\u9891\uFF0C\u5426\u5219\u53D1\u957F\u6587\uFF1B\u516C\u4F17\u53F7\u3001\u641C\u72D0\u53F7\u53EA\u5B58\u8349\u7A3F\u3002"),
50333
+ article: external_exports.object(source).optional().describe("\u6587\u7AE0\u5185\u5BB9\uFF0Cfile_path/markdown/html \u4E09\u9009\u4E00\u3002cover \u4EC5\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u4F7F\u7528\uFF0C\u5176\u4ED6\u5E73\u53F0\u81EA\u52A8\u5FFD\u7565\u5E76\u5728 warnings \u4E2D\u63D0\u793A\uFF1B\u767E\u5BB6\u53F7\u7F3A cover \u65F6\u7528\u6B63\u6587\u7B2C\u4E00\u5F20\u56FE\u3002"),
50334
+ post: external_exports.object(postSource).optional().describe("\u56FE\u6587\u6216\u89C6\u9891\u5185\u5BB9\uFF0C\u7528\u4E8E\u5C0F\u7EA2\u4E66\u3001\u6296\u97F3\u3001\u5FAE\u535A\u3002"),
50335
+ modes: external_exports.record(external_exports.enum(["article", "post"])).optional().describe('\u53EF\u9009\uFF1A\u4E3A\u5FAE\u535A\u3001\u5C0F\u7EA2\u4E66\u6307\u5B9A\u53D1\u6587\u7AE0\u8FD8\u662F\u56FE\u6587/\u89C6\u9891\uFF0C\u5982 {"weibo":"article"}\u3002')
50336
+ };
50337
+ const unifiedParams = async (args) => {
50338
+ if (!args.article && !args.post) throw new Error("\u8BF7\u63D0\u4F9B article\uFF08\u6587\u7AE0\uFF09\u6216 post\uFF08\u56FE\u6587/\u89C6\u9891\uFF09\u5185\u5BB9");
50339
+ return {
50340
+ platforms: args.platforms,
50341
+ ...args.modes ? { modes: args.modes } : {},
50342
+ ...args.article ? { article: await prepareSource(args.article, (path) => bridge.registerMedia(path, "video")) } : {},
50343
+ ...args.post ? { post: await preparePost(args.post, (path, kind) => bridge.registerMedia(path, kind)) } : {}
50344
+ };
50345
+ };
50346
+ server.registerTool("publish", {
50347
+ description: agentWorkflow + "\u9996\u9009\u7684\u53D1\u5E03\u5DE5\u5177\uFF1A\u4E00\u6B21\u8C03\u7528\u53D1\u5E03\u5230\u7528\u6237\u6307\u5B9A\u7684\u591A\u4E2A\u5E73\u53F0\u3002\u53EA\u6709\u7528\u6237\u660E\u786E\u8981\u6C42\u53D1\u5E03\u5E76\u6307\u5B9A\u5E73\u53F0\u65F6\u624D\u8C03\u7528\u3002\u6309\u5E73\u53F0\u4F9D\u6B21\u6267\u884C\uFF0C\u67D0\u4E2A\u5E73\u53F0\u672A\u767B\u5F55\u3001\u4E0D\u80FD\u63A5\u6536\u5185\u5BB9\u6216\u5931\u8D25\uFF0C\u53EA\u8DF3\u8FC7\u8BE5\u5E73\u53F0\uFF0C\u5176\u4ED6\u5E73\u53F0\u7EE7\u7EED\u3002\u9047\u5230\u9A8C\u8BC1\u7801\u65F6\u5E73\u53F0\u8FDB\u5165 waiting_verification\uFF0C\u7ACB\u5373\u628A\u539F\u56E0\u548C\u94FE\u63A5\u544A\u8BC9\u7528\u6237\uFF0C\u7531\u7528\u6237\u624B\u52A8\u5B8C\u6210\uFF0C\u7EE7\u7EED\u67E5\u8BE2\u5373\u53EF\uFF0C\u4E0D\u8981\u91CD\u53D1\u3002\u4EFB\u52A1\u7ED3\u675F\u540E\u6309 get_sync_task \u7684 summary \u9010\u5E73\u53F0\u544A\u8BC9\u7528\u6237\uFF1A\u54EA\u4E9B\u6210\u529F\uFF0C\u54EA\u4E9B\u672A\u767B\u5F55\uFF08not_logged_in\uFF09\u7B49\u3002\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u518D\u7528 get_sync_task \u67E5\u8BE2\uFF1Bresults \u662F\u9010\u5E73\u53F0\u7ED3\u679C\uFF0Cwarnings \u8BF4\u660E\u4E3A\u5E73\u53F0\u505A\u7684\u8C03\u6574\u3002\u5FC5\u987B\u4F7F\u7528\u7A33\u5B9A request_id\uFF0C\u76F8\u540C ID \u4E0D\u4F1A\u91CD\u590D\u63D0\u4EA4\u3002\u90E8\u5206\u5E73\u53F0\u5931\u8D25\u65F6\uFF0C\u53EA\u9488\u5BF9\u5931\u8D25\u5E73\u53F0\u7528\u65B0 request_id \u91CD\u65B0\u63D0\u4EA4\uFF0Cunknown \u7684\u5E73\u53F0\u4E0D\u8981\u91CD\u53D1\u3002\u65E7\u7248\u6269\u5C55\u4E0D\u652F\u6301\u65F6\u4F1A\u62A5\u9519\uFF0C\u4E0D\u4F1A\u53D1\u5E03\u3002",
50348
+ inputSchema: { ...unifiedInput, request_id: requestId },
50349
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
50350
+ }, (args) => wrap(async () => bridge.request("publish", { requestId: args.request_id, ...await unifiedParams(args) })));
50351
+ server.registerTool("rehearse_publish", {
50352
+ description: "\u4E0E publish \u53C2\u6570\u76F8\u540C\u7684\u6F14\u7EC3\uFF1A\u9010\u5E73\u53F0\u6253\u5F00\u539F\u751F\u9875\u9762\uFF0C\u586B\u597D\u5185\u5BB9\u3001\u4E0A\u4F20\u7D20\u6750\uFF0C\u8D70\u5230\u70B9\u51FB\u53D1\u5E03\u4E4B\u524D\u505C\u4E0B\uFF0C\u4E0D\u63D0\u4EA4\u53D1\u5E03\u3002\u65E0\u9700 request_id\uFF0C\u4E0D\u5F71\u54CD\u4E4B\u540E\u7684\u771F\u5B9E\u53D1\u5E03\u3002\u56FE\u7247\u53EF\u80FD\u5DF2\u4E0A\u4F20\u5230\u5E73\u53F0\uFF0C\u90E8\u5206\u5E73\u53F0\u4F1A\u7559\u4E0B\u4E2D\u95F4\u8349\u7A3F\uFF0C\u516C\u4F17\u53F7\u3001\u641C\u72D0\u53F7\u4E0D\u53C2\u4E0E\u3002\u7ED3\u679C publicationState=rehearsed \u4E0D\u4EE3\u8868\u5DF2\u53D1\u5E03\uFF0C\u4E0D\u5F97\u544A\u8BC9\u7528\u6237\u5185\u5BB9\u5DF2\u53D1\u51FA\uFF0C\u4E5F\u4E0D\u8981\u81EA\u884C\u63A5\u7740\u53D1\u5E03\u3002",
50353
+ inputSchema: unifiedInput,
50354
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
50355
+ }, (args) => wrap(async () => bridge.request("rehearsePublish", await unifiedParams(args))));
50356
+ const rehearsalNote = "\u6F14\u7EC3\uFF1A\u6253\u5F00\u539F\u751F\u9875\u9762\uFF0C\u586B\u597D\u5185\u5BB9\u3001\u4E0A\u4F20\u7D20\u6750\uFF0C\u8D70\u5230\u70B9\u51FB\u53D1\u5E03\u4E4B\u524D\u505C\u4E0B\uFF0C\u4E0D\u63D0\u4EA4\u53D1\u5E03\u3002\u7528\u4E8E\u68C0\u67E5\u5E73\u53F0\u6539\u7248\u3001\u8D26\u53F7\u6743\u9650\u548C\u9009\u62E9\u5668\uFF0C\u7A3F\u4EF6\u7559\u5728\u5DF2\u6253\u5F00\u7684\u6807\u7B7E\u9875\u7531\u7528\u6237\u5173\u95ED\u3002\u56FE\u7247\u53EF\u80FD\u5DF2\u4E0A\u4F20\u5230\u5E73\u53F0\uFF0C\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u4F1A\u7559\u4E0B\u4E2D\u95F4\u8349\u7A3F\uFF1B\u6700\u7EC8\u53D1\u5E03\u8BF7\u6C42\u548C\u5E73\u53F0\u56DE\u6267\u53EA\u6709\u771F\u5B9E\u53D1\u5E03\u624D\u80FD\u6838\u5BF9\u3002\u65E0\u9700 request_id\uFF0C\u4E5F\u4E0D\u5F71\u54CD\u4E4B\u540E\u7684\u771F\u5B9E\u53D1\u5E03\u3002\u7ED3\u679C publicationState=rehearsed \u4E0D\u4EE3\u8868\u5DF2\u53D1\u5E03\uFF0C\u4E0D\u5F97\u544A\u8BC9\u7528\u6237\u5185\u5BB9\u5DF2\u53D1\u51FA\uFF0C\u4E5F\u4E0D\u8981\u81EA\u884C\u63A5\u7740\u53D1\u5E03\u3002\u5931\u8D25\u65F6\u7ED3\u679C\u5E26 diagnostics\uFF08\u9636\u6BB5\u3001\u9875\u9762\u7ED3\u6784\u3001\u8BF7\u6C42\u8BB0\u5F55\uFF09\u3002";
50357
+ server.registerTool("rehearse_article", {
50358
+ description: rehearsalNote + "\u672C\u5DE5\u5177\u7528\u4E8E publish_article \u7684\u5E73\u53F0\uFF1A\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u3001B\u7AD9\u4E13\u680F\u3001\u5C0F\u7EA2\u4E66\u957F\u6587\uFF0C\u53C2\u6570\u89C4\u5219\u76F8\u540C\u3002\u8FD4\u56DE task_id \u540E\u67E5\u8BE2 get_sync_task\u3002",
50359
+ inputSchema: { ...source, platforms: external_exports.array(external_exports.string().min(1)).min(1).max(30), draft_id: external_exports.string().optional() },
50360
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
50361
+ }, (args) => wrap(async () => {
50362
+ if (args.draft_id && Object.entries(args).some(([key2, value]) => key2 in source && value !== void 0)) throw new Error("draft_id \u4E0E\u7A3F\u4EF6\u5185\u5BB9\u4E0D\u80FD\u540C\u65F6\u63D0\u4F9B");
50363
+ return bridge.request("rehearseArticle", { platforms: args.platforms, ...args.draft_id ? { draftId: args.draft_id } : { article: await prepareSource(args, (path) => bridge.registerMedia(path, "video")) } });
50364
+ }));
50365
+ server.registerTool("rehearse_post", {
50366
+ description: rehearsalNote + "\u672C\u5DE5\u5177\u7528\u4E8E publish_post \u7684\u5E73\u53F0\uFF1A\u5C0F\u7EA2\u4E66\u3001\u6296\u97F3\u3001\u5FAE\u535A\u666E\u901A\u56FE\u6587\u548C\u89C6\u9891\uFF0C\u53C2\u6570\u89C4\u5219\u76F8\u540C\u3002\u8FD4\u56DE task_id \u540E\u67E5\u8BE2 get_sync_task\u3002",
50367
+ inputSchema: { ...postSource, kind: postSource.kind.optional(), title: postSource.title.optional(), draft_id: external_exports.string().optional(), platforms: external_exports.array(external_exports.string().min(1)).min(1).max(30) },
50368
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true }
50369
+ }, (args) => wrap(async () => {
50370
+ if (args.draft_id && Object.entries(args).some(([key2, value]) => key2 in postSource && value !== void 0)) throw new Error("draft_id \u4E0E\u6295\u7A3F\u5185\u5BB9\u4E0D\u80FD\u540C\u65F6\u63D0\u4F9B");
50371
+ if (!args.draft_id && (!args.kind || !args.title)) throw new Error("\u8BF7\u63D0\u4F9B draft_id\uFF0C\u6216\u5B8C\u6574\u7684 kind\u3001title \u548C\u7D20\u6750\u8DEF\u5F84");
50372
+ return bridge.request("rehearsePost", { platforms: args.platforms, ...args.draft_id ? { draftId: args.draft_id } : { post: await preparePost({ ...args, kind: args.kind, title: args.title }, (path, kind) => bridge.registerMedia(path, kind)) } });
50373
+ }));
50331
50374
  server.registerTool("sync_article", {
50332
50375
  description: "\u5411 list_platforms \u8FD4\u56DE action=draft \u7684\u7528\u6237\u6307\u5B9A\u5E73\u53F0\u4FDD\u5B58\u6587\u7AE0\u8349\u7A3F\uFF0C\u5F53\u524D\u5305\u62EC\u5FAE\u4FE1\u516C\u4F17\u53F7\u3001\u641C\u72D0\u53F7\u3002\u77E5\u4E4E\u3001\u767E\u5BB6\u53F7\u3001\u5FAE\u535A\u957F\u6587\u7AE0\u3001B\u7AD9\u4E13\u680F\u3001\u5C0F\u7EA2\u4E66\u957F\u6587\u5DF2\u6539\u7528 publish_article\uFF1B\u672C\u5DE5\u5177\u4E0D\u4F1A\u628A\u65E7\u8349\u7A3F\u8C03\u7528\u81EA\u52A8\u5347\u7EA7\u6210\u516C\u5F00\u53D1\u5E03\u3002\u53EF\u7528 prepare_article \u8FD4\u56DE\u7684 draft_id\uFF0C\u6216\u76F4\u63A5\u4F20 file_path/markdown/html\u3002\u5FC5\u987B\u7ED9\u540C\u4E00\u64CD\u4F5C\u4F7F\u7528\u7A33\u5B9A request_id\uFF1B\u76F8\u540C ID \u91CD\u653E\u4E0D\u4F1A\u91CD\u590D\u63D0\u4EA4\u3002\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u518D\u7528 get_sync_task \u67E5\u8BE2\u8FDB\u5EA6\u3002",
50333
50376
  inputSchema: { ...source, request_id: requestId, platforms: external_exports.array(external_exports.string().min(1)).min(1).max(30), draft_id: external_exports.string().optional() },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "writedock-mcp",
3
- "version": "0.4.2",
3
+ "version": "0.4.4",
4
4
  "description": "WriteDock local MCP server for the browser extension",
5
5
  "type": "commonjs",
6
6
  "license": "GPL-3.0-only",
package/source/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@writedock/mcp-server",
3
- "version": "0.4.2",
3
+ "version": "0.4.4",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "description": "WriteDock local MCP server for the browser extension",
package/source/src/server.ts CHANGED
@@ -80,6 +80,48 @@ export function createMcpServer(bridge: LocalBridge) {
80
80
  if (!args.draft_id && (!args.kind || !args.title)) throw new Error('请提供 draft_id，或完整的 kind、title 和素材路径')
81
81
  return bridge.request('publishPost', { requestId: args.request_id, platforms: args.platforms, ...(args.draft_id ? { draftId: args.draft_id } : { post: await preparePost({ ...args, kind: args.kind!, title: args.title! }, (path, kind) => bridge.registerMedia(path, kind)) }) })
82
82
  }))
83
+ const unifiedInput = {
84
+ platforms: z.array(z.string().min(1)).min(1).max(30).describe('用户指定的全部平台 ID。扩展按平台分流：知乎、百家号、B站发文章；抖音发图文/视频；微博、小红书有 post 时发图文/视频，否则发长文；公众号、搜狐号只存草稿。'),
85
+ article: z.object(source).optional().describe('文章内容，file_path/markdown/html 三选一。cover 仅百家号、微博长文使用，其他平台自动忽略并在 warnings 中提示；百家号缺 cover 时用正文第一张图。'),
86
+ post: z.object(postSource).optional().describe('图文或视频内容，用于小红书、抖音、微博。'),
87
+ modes: z.record(z.enum(['article', 'post'])).optional().describe('可选：为微博、小红书指定发文章还是图文/视频，如 {"weibo":"article"}。'),
88
+ }
89
+ const unifiedParams = async (args: { platforms: string[]; article?: Parameters<typeof prepareSource>[0]; post?: Parameters<typeof preparePost>[0]; modes?: Record<string, string> }) => {
90
+ if (!args.article && !args.post) throw new Error('请提供 article（文章）或 post（图文/视频）内容')
91
+ return {
92
+ platforms: args.platforms, ...(args.modes ? { modes: args.modes } : {}),
93
+ ...(args.article ? { article: await prepareSource(args.article, path => bridge.registerMedia(path, 'video')) } : {}),
94
+ ...(args.post ? { post: await preparePost(args.post, (path, kind) => bridge.registerMedia(path, kind)) } : {}),
95
+ }
96
+ }
97
+ server.registerTool('publish', {
98
+ description: agentWorkflow + '首选的发布工具：一次调用发布到用户指定的多个平台。只有用户明确要求发布并指定平台时才调用。按平台依次执行，某个平台未登录、不能接收内容或失败，只跳过该平台，其他平台继续。遇到验证码时平台进入 waiting_verification，立即把原因和链接告诉用户，由用户手动完成，继续查询即可，不要重发。任务结束后按 get_sync_task 的 summary 逐平台告诉用户：哪些成功，哪些未登录（not_logged_in）等。立即返回 task_id，再用 get_sync_task 查询；results 是逐平台结果，warnings 说明为平台做的调整。必须使用稳定 request_id，相同 ID 不会重复提交。部分平台失败时，只针对失败平台用新 request_id 重新提交，unknown 的平台不要重发。旧版扩展不支持时会报错，不会发布。',
99
+ inputSchema: { ...unifiedInput, request_id: requestId },
100
+ annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
101
+ }, args => wrap(async () => bridge.request('publish', { requestId: args.request_id, ...await unifiedParams(args) })))
102
+ server.registerTool('rehearse_publish', {
103
+ description: '与 publish 参数相同的演练：逐平台打开原生页面，填好内容、上传素材，走到点击发布之前停下，不提交发布。无需 request_id，不影响之后的真实发布。图片可能已上传到平台，部分平台会留下中间草稿，公众号、搜狐号不参与。结果 publicationState=rehearsed 不代表已发布，不得告诉用户内容已发出，也不要自行接着发布。',
104
+ inputSchema: unifiedInput,
105
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
106
+ }, args => wrap(async () => bridge.request('rehearsePublish', await unifiedParams(args))))
107
+ const rehearsalNote = '演练：打开原生页面，填好内容、上传素材，走到点击发布之前停下，不提交发布。用于检查平台改版、账号权限和选择器，稿件留在已打开的标签页由用户关闭。图片可能已上传到平台，知乎、百家号、微博长文章会留下中间草稿；最终发布请求和平台回执只有真实发布才能核对。无需 request_id，也不影响之后的真实发布。结果 publicationState=rehearsed 不代表已发布，不得告诉用户内容已发出，也不要自行接着发布。失败时结果带 diagnostics（阶段、页面结构、请求记录）。'
108
+ server.registerTool('rehearse_article', {
109
+ description: rehearsalNote + '本工具用于 publish_article 的平台：知乎、百家号、微博长文章、B站专栏、小红书长文，参数规则相同。返回 task_id 后查询 get_sync_task。',
110
+ inputSchema: { ...source, platforms: z.array(z.string().min(1)).min(1).max(30), draft_id: z.string().optional() },
111
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
112
+ }, args => wrap(async () => {
113
+ if (args.draft_id && Object.entries(args).some(([key, value]) => key in source && value !== undefined)) throw new Error('draft_id 与稿件内容不能同时提供')
114
+ return bridge.request('rehearseArticle', { platforms: args.platforms, ...(args.draft_id ? { draftId: args.draft_id } : { article: await prepareSource(args, path => bridge.registerMedia(path, 'video')) }) })
115
+ }))
116
+ server.registerTool('rehearse_post', {
117
+ description: rehearsalNote + '本工具用于 publish_post 的平台：小红书、抖音、微博普通图文和视频，参数规则相同。返回 task_id 后查询 get_sync_task。',
118
+ inputSchema: { ...postSource, kind: postSource.kind.optional(), title: postSource.title.optional(), draft_id: z.string().optional(), platforms: z.array(z.string().min(1)).min(1).max(30) },
119
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
120
+ }, args => wrap(async () => {
121
+ if (args.draft_id && Object.entries(args).some(([key, value]) => key in postSource && value !== undefined)) throw new Error('draft_id 与投稿内容不能同时提供')
122
+ if (!args.draft_id && (!args.kind || !args.title)) throw new Error('请提供 draft_id，或完整的 kind、title 和素材路径')
123
+ return bridge.request('rehearsePost', { platforms: args.platforms, ...(args.draft_id ? { draftId: args.draft_id } : { post: await preparePost({ ...args, kind: args.kind!, title: args.title! }, (path, kind) => bridge.registerMedia(path, kind)) }) })
124
+ }))
83
125
  server.registerTool('sync_article', {
84
126
  description: '向 list_platforms 返回 action=draft 的用户指定平台保存文章草稿，当前包括微信公众号、搜狐号。知乎、百家号、微博长文章、B站专栏、小红书长文已改用 publish_article；本工具不会把旧草稿调用自动升级成公开发布。可用 prepare_article 返回的 draft_id，或直接传 file_path/markdown/html。必须给同一操作使用稳定 request_id；相同 ID 重放不会重复提交。立即返回 task_id，再用 get_sync_task 查询进度。',
85
127
  inputSchema: { ...source, request_id: requestId, platforms: z.array(z.string().min(1)).min(1).max(30), draft_id: z.string().optional() },