📦 Aws Wechat Article Publish — 微信公众号文章发布

通过微信公众号 API 将排版稿写入草稿箱或再提交发布（由 config.yaml 的 publish_method 与命令行 --publish 控制）。

配置检查

脚本目录

凭证与 publish_method

publish_method（以仓库 config.yaml 为准）

多账号时如何选槽位

• 运行 python {baseDir}/scripts/publish.py accounts，从 config.yaml 的 wechat_accounts + wechat_N_name 向用户展示列表（例如：您有2个账号：1."xiaoming"，2."xiaoz"）必须询问用户选择哪个账号发布到草稿箱，然后根据用户选择发布到指定的账号。
• 在 config.yaml 写 wechat_publish_slot: <整数>，或命令行 --account <序号或名称>（CLI 优先，见 articlescreening-schema.md）。

全局环境

在仓库根具备 aws.env（微信密钥）与 config.yaml（微信槽位数量与名称）。写作/生图见 validate_env.py（微信未齐仍可先做内容）。publish_method: none 时 full 会跳过；draft/published 发布前建议 check-wechat-env。API 端点优先取 WECHAT_N_API_BASE，若槽位未配则回退 config.yaml.wechat_api_base（两者都空时使用官方）。

作者名回退

full / create-draft 若 article.yaml 无 author，回退 config.yaml 的 default_author。

publish_completed（本篇是否已发布完成）

• 字段在本篇 article.yaml。publish.py 不读、不改；由智能体维护。
• false：发布流程未闭环。
• true：已视为发布完成（草稿已确认 / 或 published 流程成功且运营确认）。

本篇发布真正结束后：将 publish_completed: true 写回 article.yaml。

写回 true 的前置门禁（缺啥补啥）：

• article.html 存在；
• 文章目录存在封面图 cover.(png/jpg/jpeg/webp)；
• article.md 与 article.html 中均不含 placeholder；
• 发布命令成功并拿到回执（media_id 或 publish_id）。

任一不满足：只可标记为“已提交草稿，未闭环”，不得写回 publish_completed: true。

用户仅说「发布」且未明确路径时

在用户未给出 drafts/… 路径、仅说「发布文章」「帮我发一下」等时：

• 确定本篇目录：列出仓库下 drafts/ 中子目录；若多篇，请用户指定一篇或选「最新修改」的一篇再读该目录 article.yaml。勿在未确认目录时假定路径。
• 读取该目录 article.yaml 中的 publish_completed（YAML 布尔：true / false；缺省按 false 处理）。

工作流

发布进度：
[ ] 前置：配置检查（见本节「配置检查」）⛔
[ ] 第0步：若用户未给路径 → 选本篇目录 → 读 publish_completed → 按上表分流（true/false）
[ ] 第1步：读 config.yaml → draft / published（及是否 full --publish）
[ ] 第2步：读取 config.yaml 的 wechat_accounts + wechat_N_name 向用户展示账号列表并询问目标槽位；随后跑 check-wechat-env 校验 aws.env 凭证 → wechat_publish_slot 或 --account
[ ] 第3步：发布前检查（checklist + check-screening + check）
[ ] 第4步：准备文章目录
[ ] 第5步：full（仅草稿或含发布，视上步）
[ ] 第6步：确认结果与用户说明
[ ] 第7步：成功后写回 article.yaml 的 publish_completed: true；按需归档

交互顺序（最小提问）

0) 未给路径时：先按上文 「用户仅说发布」 处理 publish_completed；用户选 继续本篇 后再做下列步骤。

1) 先看 config.yaml 的 publish_method：draft = 默认只进草稿箱；published 或 full --publish = 再提交发布。

2) 多槽位：展示账号列表（来源：config.yaml 的 wechat_accounts + wechat_N_name），请用户选槽位 → wechat_publish_slot 或 --account。

3) 缺微信字段：运行 check-wechat-env，补全 aws.env 后再发。

4) 发布失败（由脚本 stderr / 微信 errcode 判断）： - 网络类（超时、连接失败、5xx）：脚本已对单次请求 自动重试 1 次；仍失败 → 告知「网络不可用，请稍后重试或检查代理」。 - 凭证/配置类（如 token 失败带 errcode、缺字段）→ 提示 第几槽位、检查 APPID/SECRET、IP 白名单，用户改正后再执行 full / publish。

5) 中间产物缺失（封面缺失 / 存在 placeholder）：先补产物再发；若用户坚持先发草稿，必须明确告知“正文配图未完成”，且保持 publish_completed: false。

命令示例（仓库根）

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

详见 references/usage.md、references/submit-guide.md、references/api-reference.md。

过程文件