wechat-draft

name	wechat-draft
description	把【现成】Markdown 文章排版成微信兼容 HTML、选主题预览、确认后推送到公众号草稿箱。触发词：公众号排版、Markdown 转微信、选主题、推草稿；英文：format Markdown for WeChat、preview themes、publish to draft。明确不做：写/创作公众号文章（本 skill 只排版现成稿，创作内容请先用其他写作工具完成）；转幻灯片、做封面/小红书图、润色/rewrite、配图上传、草稿箱管理 也不在范围。

wechat-draft

把现成 Markdown 文章转换为微信兼容 HTML，确认预览后推送到公众号草稿箱。

现成 = 输入是一篇已成稿、可直接排版的文章。本 skill 只排版，不改写字面、不创作内容；结构过弱时只补最小标记（标题/段落/列表/加粗）。

Execution Skeleton

步骤 1：读取输入

读取文章路径、标题、用户意图（只排版 or 排版+推送）。

如果	则
文件不存在 / 非 .md	确认路径拼写或提示仅支持 Markdown
文件为空	提醒内容过少，继续排版但标注

✅ 完成：路径、标题、意图三项已知。

步骤 2：预处理

检查文章是否有基本 Markdown 结构。"缺少结构"的判断标准：

• 无标题（缺少 # / ##）→ 补 # {首行文本}
• 无段落分隔（全文一整块）→ 在空行处插入 \n\n
• 关键词但无强调 → 无需处理（不改内容）

输入是现成稿件——结构混乱需要大改时，告知用户先整理后再来，不替用户改写。

可选增强：需要更强版式表达时，可补 format.py 支持的容器语法（:::dialogue / :::gallery / :::timeline / :::steps 等，不改字面），完整列表见 references/usage.md。

如果	则
文件已是标准 Markdown（有标题/段落/列表）	跳过预处理，直接进步骤 3
文件几乎无结构（纯文本无标记）	补标题+段落分隔，告知用户"已补最小结构"

✅ 完成：最小结构在位，或已告知用户需先整理。

步骤 3：选择主题并排版

• 用户指定主题 → format.py --input <path> --theme <name>
• 未指定主题 → 必须 gallery：format.py --input <path> --gallery --recommend newspaper magazine ink
• 主题推荐：深度长文→newspaper/magazine/ink；科技→bytedance/github/sspai；访谈→terracotta/coffee-house/mint-fresh。完整 30 个主题见 references/themes.md。

如果 format.py 报错：ModuleNotFoundError → pip install -r requirements.txt；其他错误 → 检查文件编码(UTF-8)，仍失败则将报错原文发给用户。 如果 gallery 结果不满意：按内容类型推荐备选主题，或让用户 --theme 手动指定。

✅ 完成：HTML 已生成（单主题）或画廊已展出（gallery）。

步骤 4：预览确认

告知预览路径让用户浏览器打开。🔴 CHECKPOINT · 🛑 STOP：用户未确认"预览满意"前，禁止执行 publish。

✅ 完成：用户已明确说"预览满意/可以推"。

步骤 5：推送草稿（仅在用户明确要求时）

推送前必须检查：config.json 存在且凭据已填、IP 在公众号白名单内、认证服务号（有草稿权限）。

如果报错	修复
config.json 不存在	cp config.example.json config.json 并提示填凭据
40001/40125 凭据无效	检查 app_id/app_secret，仍失败到公众号后台重置
40164 IP 白名单	公众号后台 → 设置 → IP 白名单添加当前 IP
48001 API 未授权	需认证服务号，建议确认公众号类型
排版/推送其他错误	按优先级排查：依赖→编码→Markdown格式→频控(每日2000次)

完整错误码见 references/error-codes.md。

推送成功后返回：预览目录、标题、字数、media_id、公众号后台 https://mp.weixin.qq.com。

Commands

• 排版：scripts/format.py --input <path> --theme <name> [--gallery] [--recommend t1 t2 ...] [--output <dir>] [--no-open] [--format wechat|html|plain]
• 推送：scripts/publish.py --dir <排版输出目录> | --input <path> --theme <name> [--dry-run]
• 完整参数说明见 references/usage.md

Support Resources

• templates/、assets/、config.example.json：模板、资源；首次使用必须 cp config.example.json config.json
• 文档：usage.md · themes.md · wechat-mp-api.md · error-codes.md

操作黑名单（❌ 禁止 → ✅ 正确做法）

❌ 禁止	✅ 正确做法
改写文章内容（非现成稿件）	建议用户先完成内容再来排版
回显 APPSECRET	不显示，或只显示 app_id 前 4 位
手写 HTML/CSS 替代 format.py，或跳过 format 直接 publish	必须先经 format.py 生成 HTML
未确认预览就 publish	🔴 等用户确认"预览满意"
处理封面图/配图/图片上传、管理现有草稿	封面配图与草稿管理在公众号后台操作
跳过前置检查直接 publish	推送前必须检查 config + IP 白名单