wechat-article-api

微信公众号文章 API

只使用 api.weixin.qq.com 官方接口，不启动或操作浏览器。只创建草稿，不调用发布、群发或删除接口。

运行条件

• Windows 与 PowerShell 7.2+（pwsh）。
• 公众号已获得草稿接口权限，当前公网出口 IP 已加入公众号 API 白名单。
• AppSecret 只由用户在本机交互式终端输入；不要要求用户在聊天中粘贴。

命令中的 Codex 主目录按 CODEX_HOME 环境变量解析；未设置时使用 %USERPROFILE%\.codex：

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE '.codex' }
$skillRoot = Join-Path $codexHome 'skills\wechat-article-api'

输入

执行前完整阅读 references/package-contract.md。素材目录必须包含 article.json、正文 HTML、封面和正文图片。 account 必填，并且必须与加密凭据中的公众号名称逐字一致。模板默认开启所有用户留言： needOpenComment=1、onlyFansCanComment=0。

先离线校验：

& (Join-Path $skillRoot 'scripts\Test-WeChatArticlePackage.ps1') -InputFolder "D:\成品文章目录"

需要检查素材契约时，可生成一个不会连接微信的完整合成示例包：

& (Join-Path $skillRoot 'scripts\New-WeChatArticleExample.ps1') -OutputFolder "D:\wechat-article-example"

首次配置

打开本机交互式 pwsh，让用户录入 AppID、公众号名称和 AppSecret：

& (Join-Path $skillRoot 'scripts\Set-WeChatOfficialAccountCredential.ps1')

凭据使用当前 Windows 用户的 DPAPI 加密，默认保存到 $CODEX_HOME\secrets\wechat-official-account.dpapi.json；未设置 CODEX_HOME 时保存到 %USERPROFILE%\.codex\secrets\wechat-official-account.dpapi.json。该文件只能由同一台 Windows 计算机上的同一用户解密，不得提交到代码仓。

配置后先验证权限和 IP 白名单：

& (Join-Path $skillRoot 'scripts\Test-WeChatOfficialAccountApi.ps1')

如果微信返回 40164 invalid ip，立即停止并把错误中的公网出口 IP 告诉用户，提醒其进入“设置与开发 → 开发接口管理 → IP 白名单”添加该 IP。用户确认后只重试同一官方 API；禁止改走浏览器、RPA、Cookie Profile 或其他发布通道。

创建草稿

用户明确要求写入草稿后运行：

& (Join-Path $skillRoot 'scripts\Publish-WeChatArticleDraft.ps1') -InputFolder "D:\成品文章目录"

使用 -DryRun 只做离线校验。脚本上传正文图片到 media/uploadimg，封面到 material/add_material，用 draft/add 创建 news 草稿，再用 draft/get 回读标题、封面和正文图片。

重复提交保护与结果

• 同一素材目录使用独占锁，禁止两个进程并发创建草稿。
• 在素材目录原子写入 wechat-article-api-state.json，逐张记录图片 URL、封面 media_id 和草稿 media_id。
• 已保存草稿 media_id 时，同一素材指纹重复执行只回读该草稿，不再次调用 draft/add。
• 调用 draft/add 前先记录 draft_submitting。若网络中断等原因导致服务端结果无法确认，保留不确定状态并禁止自动重试；要求用户先人工核对草稿箱，不能承诺“绝不重复”。
• 微信明确返回错误码时允许修正问题后重试；正文图片或封面上传遇到不确定网络失败时，重试可能产生未引用的重复素材，但不会自动越过不确定的草稿提交状态。
• 素材变化但存在旧检查点时停止，要求使用新目录；不得静默重置。
• 只有 draft/get 回读验收通过，才报告成功。
• 回执原子写入 wechat-article-api-receipt.json。报告账号、标题、media_id、图片数、阶段与微信原始错误码；不得报告“已发表”。
• 任一官方 API 失败均原地报告并保留检查点；本 Skill 没有浏览器/RPA 兜底。