| name | wechat-publish |
| description | Markdown 转微信公众号排版并发布草稿。Use this whenever the user asks to convert Markdown to WeChat Official Account HTML, inspect publish readiness, preview local WeChat layout, or create a WeChat draft. 不用于：写文章内容、其他平台发布。 |
wechat-publish
将 Markdown 转成微信公众号兼容 HTML，可预览或创建草稿箱草稿。所有常规操作只走统一入口：
cd D:/mycode/agentclaw && python skills/wechat-publish/scripts/wechat_publish.py capabilities --json
cd D:/mycode/agentclaw && python skills/wechat-publish/scripts/wechat_publish.py inspect {INPUT_MD} --json
cd D:/mycode/agentclaw && python skills/wechat-publish/scripts/wechat_publish.py publish {INPUT_MD} --title "封面标题" --subtitle "封面副标题" --scheme dark --author "爬爬虾" --out-dir {WORKDIR} --json
离线验收或调试时使用 --dry-run，不会创建真实草稿：
cd D:/mycode/agentclaw && python skills/wechat-publish/scripts/wechat_publish.py publish {INPUT_MD} --title "封面标题" --subtitle "封面副标题" --out-dir {WORKDIR} --dry-run --json
执行规则
- 先用
capabilities --json 获取当前可用主题、封面配色和 JSON 契约，不要从文档猜。
- 发布前优先跑
inspect {INPUT_MD} --json。如果 readiness.convert_ready=false，按 checks[].code 处理，不要继续发布。
- 如果用户还没有提供 Markdown 文件，先用
file_write 写 .md 源文；不要用 bash/cat/Node/Python 临时脚本拼接或检查正文。
- 用户只要求查看效果、预览或明确说不要发布时才用
preview，它只写可直接打开的本地 HTML，不上传图片、不创建草稿。
- 用户说“发布到公众号 / 发送到公众号 / 发到公众号 / 草稿箱”时，
inspect 通过后必须直接用 publish 创建草稿；不要停在 preview，不要询问是否继续发布。
- 用户明确要求发布到公众号草稿箱时才用
publish。成功后只根据 JSON 中的 data.draft_media_id、data.artifacts.manifest_json 和 data.theme_selection.resolved 汇报结果；manifest_json 是本次执行的审计清单。
- stdout 是唯一机器契约：
success/code/message/data。不要解析旧脚本的行文本输出。
- 参数名必须写完整，尤其是
--out-dir；CLI 不接受 --out 这类缩写。
- 所有
wechat_publish.py 命令都必须从仓库根目录执行：先 cd D:/mycode/agentclaw && ...。不要在 C:/Users/voroj、Downloads 或临时目录里直接运行相对路径 skills/wechat-publish/...。
- 默认不要传
--theme。不传时 CLI 会使用 auto，根据正文把读书笔记、书摘、阅读心得、书评和书籍提炼选为 minimal，把 AgentClaw/产品/品牌/发布复盘选为 sage，把技术教程/API/CLI/部署类文章选为 tech-modern。只有用户明确指定某个主题时才传 --theme。
--draft 只属于 inspect 子命令的特殊草稿就绪检查，常规发布不需要；publish 子命令没有 --draft。发布时优先写 --out-dir {WORKDIR}；如果漏写，CLI 会默认输出到 Markdown 同目录的 wechat-output。- 发布或 dry-run 成功后，最终回复必须包含
code、data.draft_media_id、data.artifacts.manifest_json 和 data.theme_selection.resolved，不要只发送封面图。
禁止事项
- 禁止使用不存在的
upload.py、publish.py。
- 禁止手写访问令牌、上传封面或
curl 微信草稿接口。
- 禁止绕过
wechat_publish.py 直接访问微信接口。
- 禁止读取
data/tmp/**/skills/** 里的历史脚本。
- 禁止在发布成功后再读取
article.json 做无必要预览。
- 禁止在
publish 子命令里添加 --draft。
- 禁止在用户已经要求发布时只生成 preview 或发送 preview 文件后停止。
显式预览
只有用户要求“预览、查看效果、不要发布”时才运行：
cd D:/mycode/agentclaw && python skills/wechat-publish/scripts/wechat_publish.py preview {INPUT_MD} --out-dir {WORKDIR} --json
常用参数
--theme：文章主题，默认 auto；可用值以 capabilities --json 为准。用户明确指定时才使用指定主题，默认发布不要传。--scheme：封面配色，默认 dark；可用值以 capabilities --json 为准。--article-title：覆盖文章 metadata 标题；不传时取 Markdown 第一个 H1。--digest：覆盖摘要；不传时从正文生成，最长 120 字符。--thumb-media-id：使用已有微信永久封面素材 ID。--dry-run：只生成本地 article.json / draft.json，不创建真实草稿。
微信限制自动处理
脚本自动处理：
- 外链转脚注，避免微信外链限制。
- 列表改成
<section> flex 布局，避免原生列表在微信编辑器里失真。
- CJK 和 Latin 字符间插入空格。
- 代码块使用
white-space: pre-wrap 防止横向溢出。
- 输出 100% 内联 CSS，避免微信剥离
<style>。
- 正文自动移除 Markdown 第一个 H1，避免和草稿标题重复。
