发布
公众号 API 直连发布 —— 图文入草稿箱或直接群发，素材上传、发布前检查一站式完成。
套件说明 · 本 skill 属 aws-wechat-article-* 一条龙套件（共 9 个 slug，入口 aws-wechat-article-main）。跨 skill 的相对引用依赖同一 skills/ 目录，建议一并 clawhub install 全套。源码：https://github.com/aiworkskills/wechat-article-skills
能力披露（Capabilities）
本 skill 调 publish.py 直连微信公众号官方 API 发布图文。会把本篇 article.html 与 imgs/* 文件作为 POST body 上传到微信服务器。
- 凭证读取：
aws.env 的 WECHAT_{N}_APPID / WECHAT_{N}_APPSECRET（多槽位，N≥1）
- 凭证外发：
APPID / APPSECRET 以 query string 发给 api.weixin.qq.com/cgi-bin/token 换 access_token；后续请求带 access_token。微信返回的 token 只在进程内存短期缓存，不落盘
- 内容外发：封面与正文插图以 multipart 发给
material/add_material；article.html 正文与标题/摘要以 JSON POST 发给 draft/add、freepublish/submit
- 网络目标：默认
api.weixin.qq.com；可用 WECHAT_{N}_API_BASE / config.yaml.wechat_api_base 自配反代
- 文件读：
.aws-article/config.yaml、aws.env、本篇 article.yaml、article.html、imgs/*
- 文件写：
publish.py 不写 article.yaml——media_id / publish_id / publish_completed 只打印，写回由智能体做（见下「publish_completed 门禁」）- 图片超过微信大小限制时会在源图旁生成压缩缓存
<原名>_compressed.jpg（需 Pillow）。这个文件不会被自动清理，也不会被当作正文图上传
article_init.py 写本篇 article.yaml 与可选 closing.md
- shell：
{python} {baseDir}/scripts/ 下的 publish.py、getdraft.py、article_init.py
建议：首次运行用 publish_method: draft 只入草稿箱确认效果，再切 published 真正群发。
路由
从选题到发出整条流程 → aws-wechat-article-main。本 skill 单独触发适用于已有 article.html 与封面、只差最后一步上传的场景。
配置检查 ⛔
任何操作前先按 首次引导 · 检测顺序 执行，通过后才继续（或用户明确书面确认「本次不检查」）。单独安装本 skill 时的口径见 branches.md「六」。
脚本与子命令
{baseDir} = 本 SKILL.md 所在目录，所有命令在仓库根执行。
| 脚本 / 子命令 | 用途 |
|---|
article_init.py | 初始化或更新本篇 article.yaml（及可选 closing.md）。{python} {baseDir}/scripts/article_init.py <文章目录> [--title … --author … --digest …] |
getdraft.py | 查已群发文章（published-list / published-fields / publish-get / article-get），用于补齐往期推荐链接。见 branches.md「五」 |
check-screening | 校验 config.yaml 的 publish_method |
check-wechat-env | 按 config.yaml 槽位检查 aws.env 的 WECHAT_N_APPID / APPSECRET 是否已填 |
check | 环境检查：aws.env、各槽位、依赖、可选探测 token |
accounts | 列出 config.yaml 中各槽位名称，并标记 aws.env 缺项 |
full | 一键全流程（上传封面 → 上传正文图 → 建草稿 → 视配置提交发布） |
token / upload-thumb / upload-content-image / create-draft / publish / status | 分步操作，见 usage.md |
publish_method（以 .aws-article/config.yaml 为准）⛔
| 值 | 含义 | full 的行为 |
|---|
draft（默认） | 只进草稿箱 | 创建草稿后不调 freepublish |
published | 草稿 + 提交发布 | 创建草稿后继续提交发布（异步）。full --publish 可在 draft 下单次强制带发布 |
none | 用户明确不填微信 | 立即退出，不调任何微信接口（--publish 也被忽略）。其它子命令仍要凭证 |
多账号选槽位 ⛔
- 跑
{python} {baseDir}/scripts/publish.py accounts，把 config.yaml 的 wechat_accounts + wechat_{i}_name 列给用户（例如「您有 2 个账号：1. xiaoming，2. xiaoz」）。必须请用户选一个，不要替他挑。
- 选定后写
config.yaml 的 wechat_publish_slot: <整数>，或命令行 --account <序号或名称>（CLI 优先）。
槽位的数量与名称只来自 config.yaml；aws.env 里只有凭证。字段说明见 articlescreening-schema.md。
publish_completed 门禁 ⛔
字段在本篇 article.yaml。publish.py 不读、不改，由智能体维护：false = 发布流程未闭环，true = 已视为发布完成。
写回 true 之前，四项缺一不可：
article.html 存在；- 文章目录下存在封面
cover.(png|jpg|jpeg|webp)（不在 imgs/ 里）；
article.md 与 article.html 中均不含 placeholder；- 发布命令成功并拿到回执（
media_id 或 publish_id）。
任一不满足：只可标记为「已提交草稿，未闭环」，不得写回 publish_completed: true。
封面裁剪框（2.35:1 / 1:1）的细则见 branches.md「三」。
工作流
发布进度：
- [ ] 第0步：⛔ 配置检查；用户未给路径 → 先定目录并读 publish_completed 分流
- [ ] 第1步：读 config.yaml 的 publish_method（及是否 full --publish）
- [ ] 第2步：accounts 列账号 → ⛔ 请用户选槽位 → check-wechat-env 校验凭证
- [ ] 第3步：发布前检查（pre-publish-checklist + check-screening + check）
- [ ] 第4步：确认本篇目录产物齐全（article.html、cover.*、无 placeholder）
- [ ] 第5步：full（仅草稿或含发布，视第 1 步）
- [ ] 第6步：确认回执并向用户说明
- [ ] 第7步：⛔ 四项门禁全过 → 写回 publish_completed: true
第 0 步的分流表见 branches.md「一」；第 3 步清单见 references/pre-publish-checklist.md；第 5/6 步失败时的四类处理见 branches.md「二」。
命令示例（仓库根）
{python} {baseDir}/scripts/publish.py check-screening
{python} {baseDir}/scripts/publish.py check-wechat-env
{python} {baseDir}/scripts/publish.py accounts
{python} {baseDir}/scripts/publish.py check
{python} {baseDir}/scripts/publish.py --account 1 full drafts/YYYYMMDD-标题slug/
{python} {baseDir}/scripts/getdraft.py published-fields
注意 --account 是全局选项，放在子命令之前。
分支与异常
未给路径的分流、发布失败四分类、封面裁剪框、几处回退、往期链接补齐、单独安装 → references/branches.md。
更多用法：usage.md、submit-guide.md、api-reference.md。
过程文件
| 读取 | 产出 |
|---|
article.html、cover.*、imgs/、本篇 article.yaml、.aws-article/config.yaml、aws.env | 公众号草稿或已提交发布；成功后由智能体把 publish_completed: true 写回 article.yaml（publish.py 不改此键） |