微信公众号草稿与受控发布

scripts/ 是仓库自带的零依赖 Python Client（仅用标准库），只调用微信官方接口，见 api.md。输入是 wechat-article-compose 产出的生产单元：

<post-dir>/
├── article.md        # 必需
├── wechat.yml        # 必需
├── cover.png         # 创建草稿时必需（cover 字段可改名）
└── assets/           # 正文图片，可选

渲染器支持 wechat.yml 的 theme（主题名，或 base 加 accent / text / background / link / ink / tint / muted / line / generic 颜色覆盖，值可写 #RRGGBB）以及正文排版块 ::: card / steps / stats / bars / figure，语法见 wechat-article-compose。内置主题：default、white-accent（白底、中性灰，只用强调色点缀）。品牌色写成覆盖项：

theme:
  base: white-accent
  accent: "#2C3E8C"
  link: "#2C3E8C"

运行后在同一目录写入 preview.html、article.html、payload.json、publish-state.json。

前置

依赖缺失时触发统一的 onboard-growth-lab，本 Skill 不自行维护配置流程。

• 本机直连：WECHAT_MP_APP_ID / WECHAT_MP_APP_SECRET，且本机公网出口 IP 已加入公众号后台 API IP 白名单。
• 远程服务（推荐团队使用）：本机只配 WECHAT_PUBLISH_SERVICE_URL / WECHAT_PUBLISH_SERVICE_TOKEN；AppSecret 只放在固定 IP 服务器上，部署见 remote-service.md。
• 账号主体必须具备草稿与发布接口权限：个人主体、未认证企业主体等账号的发布接口可能已被回收，报 api unauthorized 时说明无法自动化，改为人类协作发布。

凭据只从进程环境或根目录 .env.local / .env 读取；不得回显、写入产物或 Memory。

1. 预览（每次都做）

make wechat-preview POST=<post-dir>     # 生成并打开 preview.html
make wechat-render POST=<post-dir>      # article.html + dry-run payload.json

用真实浏览器检查 preview.html：标题、作者、摘要、首屏卡片、小标题节奏、图片居中与清晰度、CTA 链接。发现问题回到 article.md 修改后重新渲染。article.html 是草稿与预览共用的唯一正文，修改 article.md 后必须重新 render。

2. 创建草稿（默认终点）

make wechat-draft POST=<post-dir>          # 本机直连
make wechat-remote-draft POST=<post-dir>   # 远程服务

两者都先跑 check-wechat-compliance.py，未通过即阻断。流程：上传封面为永久素材 → 上传正文本地图片并替换为微信图片 URL → 新建草稿 → 写 publish-state.json 的 draft_media_id。正文外链图片会被拒绝，改用 assets/ 本地图片；正文仍含 ::: figure 配图位时同样拒绝，先换成真实图片再 render。

创建成功后请用户在公众号后台预览草稿；这是人工把关点，不跳过。