md2wechatSUPPORT / FIND THE NEXT STEP
遇到问题，从这里排查。
按现象找到对应步骤。先检查配置和输入，再缩小问题范围。
办公 Agent 如何使用 md2wechat
千问办公、DuMate、WorkBuddy、豆包工作（豆包办公）使用同一条路径：在 Agent 当前执行环境安装 md2wechat CLI，再把文章和操作手册交给它。
帮我安装 md2wechat，执行安装：
npm install -g @geekjourneyx/md2wechat
如果没有初始化配置，请执行初始化配置：
md2wechat config init
已有配置请保留。如果缺少 Node.js 或 npm，请先检查并完成安装。
安装后读取操作手册：https://www.md2wechat.cn/docs/md2wechat/skill
CLI 使用手册：https://www.md2wechat.cn/docs/md2wechat
请检查 md2wechat version --json，告诉我安装结果和下一步需要补充的配置。Agent 需要能执行终端命令并读写文章。已有配置应保留；初始化后，调用排版服务还需填写有效的 API Key。
同一篇文章，继续准备多平台草稿。
借助具备浏览器能力的 Agent，将符合要求的 Markdown 保存为知乎、CSDN、头条、腾讯云开发者社区未发布草稿，保存后重新打开核对。
本地准备不需要微信凭证或排版 API Key；准备成功不等于草稿完成。
常见问题
为什么提示认证失败？
检查请求是否携带有效 API Key，并确认密钥尚未过期。将认证失败与网络失败分别排查，不要公开完整密钥。
为什么在不同主题下看起来不同？
主题决定文章的视觉形式。先检查使用的主题 ID，再核对 Markdown 和字号设置。可以在主题详情查看同一份示例的真实输出。
草稿创建失败，转换却成功了？
转换与草稿是不同操作。草稿还需要公众号账号、凭证、封面和相关访问条件。先运行文章检查，再查看手册中的具体原因。
如何让维护者复现问题？
提供使用方式、错误信息、主题名称和删除敏感内容后的最小示例。不要发送完整 API Key、公众号密码或未授权的文章。
可以在 Obsidian 中使用吗？
可以通过 MD2WeChat Publisher 插件预览排版并确认创建公众号草稿。需要桌面 Obsidian 和已配置的 md2wechat CLI；API 模式需要有效排版服务 Key。详见 Obsidian 插件产品页与安装教程。
API 与在线编辑器有什么区别？
编辑器适合手动写稿、预览和复制。API 把同类排版能力接入你的程序或 Agent 工作流，适合重复使用和批量处理。
转换后会直接发布到公众号吗？
不会。排版 API 返回公众号可用 HTML。创建草稿需要另行配置公众号，并通过明确的草稿操作完成。
必须安装 CLI 才能使用吗？
不必。你可以直接请求 API；CLI 为本地文件、检查和 Agent 工作流提供更方便的入口。
如何获取 API Key？
当前采用人工开通。通过申请接入页面准备使用需求，再联系维护者确认购买范围并获取密钥。