用浏览器自动化把 Markdown…

当需要把本地 Markdown 文件发布到知识星球文章编辑器并保存为草稿供人工审核时使用。

适用场景

解决思路

1. 准备内容：读取 Markdown 文件，提取标题（优先 YAML frontmatter 的 title 字段，其次 H1 标题，最后文件名），正文需剥离 YAML frontmatter、H1 标题行、HTML 注释（<!-- ... -->）以及所有水平分割线（---），因为 Milkdown 的粘贴处理会误解析 --- 导致后续标题和格式错乱。
2. 解析 group ID：按顺序从技能参数、环境变量 ZSXQ_GROUP_ID、或直接询问用户（星球 URL 中 groupId= 后的数字）获取，绝不硬编码默认值；未解析出 group ID 前不要进入导航步骤。
3. 导航到文章编辑器：访问 https://wx.zsxq.com/article?groupId={groupId}；若被重定向到登录页，提示用户手动登录 https://wx.zsxq.com/login 并等待其确认。
4. 切换到 Markdown 模式：页面加载后检查是否已显示「切换到富文本模式」；若显示「切换到 Markdown 模式 (内测)」则点击它，并在确认弹窗中点击「确定」。
5. 填写标题：定位占位符为「请在这里输入标题」的标题输入框，点击聚焦后用 fill 工具填入文章标题（最多 60 字符）。
6. 插入正文（必须用粘贴事件）：不要用 fill 工具（会被当作纯文本、Markdown 不渲染）；改用 evaluate_script 在 .ProseMirror 元素上聚焦并派发一个携带 text/plain 数据的 ClipboardEvent('paste')，让 Milkdown 解析并渲染 Markdown。
7. 可选添加标签：点击「添加标签」，输入标签文本并确认。
8. 保存为草稿：点击「保存」按钮保存草稿，绝不点击「发布」。
9. 验证并汇报：检查成功提示或草稿状态，告知用户「草稿已保存，请在知识星球中预览并手动发布」。
10. 上传图片（可选）：先用 ls -la 检查图片大小，超过 500KB 先用 sips 或 ImageMagick 压缩；用 take_snapshot(verbose=true) 找到图片按钮（富文本模式为 button "image"，Markdown 模式为 generic description="Add image"），用 upload_file（Chrome DevTools MCP）或 browser_file_upload（Playwright MCP）上传，再截图确认图片已出现。
11. 工具选择：默认优先使用 Playwright MCP（如 mcp__playwright__browser_navigate），仅当 Playwright 不可用时回退到 Chrome DevTools MCP（如 mcp__chrome-devtools__navigate_page）。
12. 故障排查：若 Markdown 未渲染（显示 **bold** 等原始语法），说明用了 fill 而非粘贴事件，改用 evaluate_script 模拟粘贴；若标题变成 ** 加粗文本，说明内容含 --- 水平线，需先剥离；若编辑器元素不可见，等待页面加载、重新快照或刷新页面；若内容超过 100000 字符，提示用户拆分文章。
13. 关键规则：绝不点击「发布」，只保存草稿；始终使用 Markdown 模式；检查登录状态；不修改源 Markdown 文件；完成后明确告知用户草稿已保存需人工审核。

适用边界 · 注意事项

• 没有浏览器自动化 MCP（Chrome DevTools MCP 或 Playwright MCP）时无法执行。
• 用户未登录知识星球账号时无法完成保存。
• 文章内容超过 100000 字符限制时需先拆分。