GUIDE / PREPARE, SAVE, VERIFY

把首篇文章，保存为多平台草稿。

借助具备浏览器能力的 Agent，将符合要求的 Markdown 保存为知乎、CSDN、头条未发布草稿，保存后重新打开核对。

1. 检查版本与执行条件

多平台草稿从 v3.6.0 起提供。安装或更新后，查询当前程序实际具备的能力；不要仅凭官网版本判断本机已可用。

Terminal

npm install -g @geekjourneyx/md2wechat
md2wechat version --json
md2wechat capabilities --json

需要具备浏览器能力的 Agent，以及用户已登录的目标平台账号。本机准备不需要微信凭证或排版 Key。缺少浏览器能力时只能准备正文，不能把准备结果当作远程草稿。

完整安装与 Agent 入口

2. 先使用一份容易核对的样稿

把下面内容保存为 article.md。样稿使用同一级别的正文标题，便于同时验证三个平台。

article.md

---
title: 一篇文章的草稿核对清单
---

写完文章后，先检查内容，再安排发布。

## 核对正文

确认段落完整，标点和数字与原稿一致。

## 核对图片

如果加入图片，请使用有效的本地图片，并核对插入位置。

支持普通 Markdown 与有效本地图片；远程图片、Obsidian 专用语法、原始 HTML 和高级排版块需先处理。本地图片支持 PNG、JPEG、GIF、WebP，可使用 ![图片说明](./images/example.png)，但对应文件必须真实存在。不要把示例路径当作现成图片。

标题优先读取 frontmatter 的 title，否则读取首个 Markdown 标题。缺失标题、空正文、无效 frontmatter 或图片会导致准备失败。

3. 准备正文，读取本机操作说明

Terminal

md2wechat sync prepare article.md --output ./article-prepared --json
md2wechat skills read md2wechat references/sync/workflow.md --json
md2wechat skills read md2wechat references/sync/zhihu.md --json
md2wechat skills read md2wechat references/sync/csdn.md --json
md2wechat skills read md2wechat references/sync/toutiao.md --json

--output 必须指向尚不存在的新目录，且父目录已经存在。命令只生成 body.html，不修改原稿，不复制或上传图片。再次尝试时复用成功结果，或者为修改后的原稿指定一个新的输出目录。

成功返回 SYNC_PREPARED 与 status: action_required，包含标题、正文文件路径、本地图片路径和标题级别。它表示还需要 Agent 执行。返回 SYNC_PREPARE_FAILED 时，先解决原稿或图片问题，不开始远程写入。

4. 明确账号与目标，让 Agent 逐平台保存

给 Agent 的任务

请把 article.md 保存到我已登录的知乎、CSDN、头条账号草稿箱，不公开发布。先读取 md2wechat 内置多平台流程和对应平台说明，检查原稿与浏览器条件；保存后逐个平台重新打开，核对标题、全文、图片位置与主要结构。遇到平台限制先报告，不擅自改稿。

Agent 使用本次准备结果，通过正常编辑器逐图上传、填写正文和标题，再保存并取得草稿地址。账号、文章或授权范围不明确时先补齐。平台布局与说明不符时应停止，不猜测操作。

知乎

已有结构样本保留内容与标题层级，保存后仍须重开核对全文与图片。

先读取 references/sync/zhihu.md，按当前内置说明检查账号、编辑区、图片和保存结果。

CSDN

已有结构样本保留内容与标题层级，通过正常编辑器保存并重开核对。

先读取 references/sync/csdn.md，按当前内置说明检查账号、编辑区、图片和保存结果。

头条

单一标题级别会归一化；混合标题级别停止，特殊字符需逐字符核对。

先读取 references/sync/toutiao.md，按当前内置说明检查账号、编辑区、图片和保存结果。

5. 重开核对，并保留可恢复的进度

逐平台报告目标账号、草稿地址、重开全文核对结果和未完成原因。
检查标题、全文、图片位置与主要结构，不能只看首尾或保存提示。
中断时先重新打开已有地址，或检查草稿列表，继续同一篇草稿，避免重复创建。
本地进度笔记可记录最后完成的步骤；私人账号、草稿地址和临时图片地址不提交到公开仓库。

某个平台未完成，不抹去其他平台已经保存并核对的结果。当前没有统一任务后台，不会自动更新用户此前发表的文章。

遇到问题，按停止的位置处理

输出目录已经存在

未修改的原稿直接复用成功准备结果。原稿修改后，指定另一个尚不存在的输出目录，不覆盖已有结果。

图片或语法检查失败

检查图片是否有效且位于本地；先处理远程图片、Obsidian 语法、原始 HTML 和高级排版块。修复后重新准备，再开始平台操作。

浏览器未登录或宿主无法操作

先由用户完成目标账号登录并核对会话。缺少必要浏览器能力时停止，不将本地准备报告为同步成功。

已经点击保存，但重开内容不完整

继续检查同一草稿，修复后再次重开并核对全文。无法修复时报告该目标未完成，不重复创建，也不把点击保存作为完成依据。

验证范围、费用与后续服务

发布记录包含 macOS、Chrome 已登录会话的短图文、结构与长文验证；其他系统与 Agent 宿主尚未逐一验收。

本地准备不需要微信凭证或排版 API Key；准备成功不等于草稿完成。公众号排版服务沿用 ¥199 / ¥998，外部 Agent、模型和独立服务费用分别确认。企业自用、代运营及客户交付请先确认授权范围。商业授权单独沟通，购买服务不自动包含商业授权。