aws-wechat-article-publish

1# 发布
2 
3**公众号 API 直连发布** —— 图文入草稿箱或直接群发，素材上传、发布前检查一站式完成。
4 
5> **套件说明** · 本 skill 属 `aws-wechat-article-*` 一条龙套件（共 9 个 slug，入口 `aws-wechat-article-main`）。跨 skill 的相对引用依赖同一 `skills/` 目录，建议一并 `clawhub install` 全套。源码：<https://github.com/aiworkskills/wechat-article-skills>
6 
7## 能力披露（Capabilities）
8 
9本 skill 调 `publish.py` **直连微信公众号官方 API** 发布图文。**会把本篇 `article.html` 与 `imgs/*` 文件作为 POST body 上传到微信服务器。**
10 
11- **凭证读取**：`aws.env` 的 `WECHAT_{N}_APPID` / `WECHAT_{N}_APPSECRET`（多槽位，N≥1）
12- **凭证外发**：`APPID` / `APPSECRET` 以 query string 发给 `api.weixin.qq.com/cgi-bin/token` 换 `access_token`；后续请求带 `access_token`。微信返回的 token 只在进程内存短期缓存，**不落盘**
13- **内容外发**：封面与正文插图以 multipart 发给 `material/add_material`；`article.html` 正文与标题/摘要以 JSON POST 发给 `draft/add`、`freepublish/submit`
14- **网络目标**：默认 `api.weixin.qq.com`；可用 `WECHAT_{N}_API_BASE` / `config.yaml.wechat_api_base` 自配反代
15- **文件读**：`.aws-article/config.yaml`、`aws.env`、本篇 `article.yaml`、`article.html`、`imgs/*`
16- **文件写**：
17  - `publish.py` **不写 `article.yaml`**——`media_id` / `publish_id` / `publish_completed` 只打印，写回由智能体做（见下「`publish_completed` 门禁」）
18  - 图片超过微信大小限制时会在源图旁生成压缩缓存 `<原名>_compressed.jpg`（需 Pillow）。这个文件**不会被自动清理**，也不会被当作正文图上传
19  - `article_init.py` 写本篇 `article.yaml` 与可选 `closing.md`
20- **shell**：`{python} {baseDir}/scripts/` 下的 `publish.py`、`getdraft.py`、`article_init.py`
21 
22**建议**：首次运行用 `publish_method: draft` 只入草稿箱确认效果，再切 `published` 真正群发。
23 
24## 路由
25…