md2wechatOBSIDIAN / WRITE AND REVIEW
在 Obsidian 写文章，
在笔记旁确认公众号排版。
在 Obsidian 写文章，在笔记旁预览排版，确认后创建微信公众号草稿。
桌面 Obsidian 1.12.7+ · 手动安装 · 需要安装并配置 md2wechat
写作、预览、确认，围绕同一篇笔记。
先检查排版结果，再选择公众号和封面。最后确认时才执行图片上传与草稿创建。
打开文章
在笔记库中打开 Markdown 文章，打开公众号排版面板。
预览与调整
预览正文、搜索主题，按需调整字号；修改原文后刷新排版。
确认创建
检查公众号、封面、标题和摘要，确认后创建草稿，再到后台审核。
直接使用插件，也可接入自己的 Agent。
交给自己的 Agent 排版
安装随插件提供的技能，并启用 Obsidian 官方命令行。让具备本地命令执行、文件读写与技能能力的 Agent 操作当前笔记。
提供通用接入约定，独立 Agent 宿主尚未逐个完成验收。
查看 Agent 接入条件插件、CLI 与服务，分别负责什么？
Obsidian 插件
提供笔记内预览、主题调整与草稿确认界面。
md2wechat CLI
管理配置，执行排版、图片上传与草稿创建。
排版 API
在 API 模式下生成公众号 HTML，需要有效服务 Key；转换本身不会创建草稿。
安装前，检查你的使用环境。
- 桌面 Obsidian 1.12.7+，不支持移动端
- 先安装 md2wechat 并校验配置；本版本以 CLI 3.5.0 验证
- 当前提供 ZIP 手动安装包，插件市场审核后续另行提交
- 仅桌面端；macOS 已实测，Windows / Linux 尚未实测。
- Agent 接入还需支持官方命令行的 Obsidian 安装程序
开始前的常见问题
一定需要 Agent 吗？
不需要。配置好 md2wechat 后，可直接在插件中预览和创建草稿。让 Agent 操作当前笔记时，才需要额外配置官方命令行和技能。
插件里要填写 API Key 吗？
不用在插件内填写。公众号账号和排版服务由 md2wechat CLI 配置管理；API 模式需要有效排版服务 Key。
会覆盖我的原文吗？
插件排版流程不会覆盖原文。修改笔记后可以刷新排版；若另行要求 Agent 润色，请自行核对 Agent 的编辑结果。
刷新排版会更新微信后台旧草稿吗？
不会。刷新只更新本地预览；创建新版草稿会新增一篇，并再次要求确认。插件不会自动正式发布文章。
草稿创建结果不确定，可以再点一次吗？
先核对公众号草稿箱，不要盲目重试。本地成功记录不代表后台草稿仍然存在，后台修改也不会反向同步。
已经购买排版服务，还要再买一次吗？
先校验现有 Key 和服务范围。插件不另设购买套餐；使用 API 模式需要相应排版权限，是否需要补充服务以开通时确认的信息为准。
YOUR FIRST NOTE
先预览一篇自己的文章。
按教程完成配置，检查正文与图片，再决定是否创建公众号草稿。