蚁小二微信公众号自动发布 Skill

# 蚁小二微信公众号自动发布 Skill ## 它解决什么问题 当一篇公众号文章已经完成事实核验、正文审校和封面制作后，最容易翻车的往往不是写作，而是发布最后一公里： - 封面上传后素材 key 与 payload 不一致； - 复制旧文章配置，误带旧标题、旧封面或旧账号字段； - 没有预检就正式提交； - 只拿到任务 ID 就宣布“已发布”； - 发布失败后盲目重发，造成重复内容。 这个 Skill 将本机蚁小二 `yxer` CLI 的微信公众号发布过程固化为一个可回查闭环：**封面上传 → 实时字段核验 → 独立 payload → validate → dry-run → 正式发布 → details 回查 → 归档回执**。 ## 适用场景 - 已完成的公众号文章需要通过蚁小二本机通道发布； - 希望把“做完直接发布”变成可验证的流程； - 发布失败时需要先定位阶段与根因，避免重复提交； - 需要把文章标题、正文、摘要、封面、账号和发布结果留成可追溯档案。 ## 发布前的硬条件 1. 文章正文已经过事实审校，标题、摘要与正文结论一致。 2. 封面是最终成品：可以打开、尺寸和格式符合当前平台要求、标题可读、无水印与误导信息。 3. 本机蚁小二账号状态正常，且只能选择 CLI 实时查询到的可用账号。 4. 正式发布属于外部不可逆动作：必须有当轮明确发布授权，或已有清晰的长期自动发布授权。 5. 不在 payload、日志、帖子或回复中保存 Token、Cookie、密钥及其他凭证。 ## 标准流程 ### 1. 先核验环境与账号 不要凭记忆使用旧账号 ID 或旧字段。先从 CLI 实时读取： ```bash yxer doctor yxer accounts list "微信公众号" --status 1 --json yxer --json prepare "微信公众号" article yxer --json schema fields "微信公众号" article ``` 只使用返回结果中的可用账号、当前 `clientId` 与当前 schema。 ### 2. 上传最终封面 先检查最终封面能实际打开，确认尺寸、文件大小、格式和标题可读性。然后上传： ```bash yxer --json upload --file "<cover-file>" ``` 必须使用上传返回的真实素材信息构建 payload，不能沿用旧稿的 `coverKey`。 ### 3. 为本篇文章独立构建 payload payload 必须只服务当前文章，至少包含： - 当前标题、公众号兼容 HTML 正文、摘要、作者名； - 本次上传返回的封面 key 与原始素材字段； - 本轮查询的账号 ID、平台名、clientId； - 发布通道。 核心原则：**标题、正文、封面、账号和 clientId 都必须来自本轮，不复制旧稿。** ### 4. 双重预检后再发布 先执行校验与干跑： ```bash yxer --json validate "微信公众号" article "<payload.json>" --publish-channel local yxer --json publish article "微信公众号" "<payload.json>" --publish-channel local --dry-run ``` 任一步失败，都停止正式发布。先根据 CLI 错误、当前 schema 与实时配置修复，再重新预检。 ### 5. 正式发布并以回查为准 预检全部通过、且具备发布授权后才执行： ```bash yxer --json publish article "微信公众号" "<payload.json>" --publish-channel local ``` 拿到任务集 ID 后立即回查： ```bash yxer --json details "<task-id>" ``` 只有回查结果明确出现以下等价成功证据，才可以说“已发布”： ```text stageStatus: success stages: push publishId: <non-empty-id> ``` “提交成功”或“拿到 taskId”都不等于发布成功。 ## 发布失败时怎么处理 - **账号不可用：** 重新检查 `doctor` 和账号状态，不切换到未知账号。 - **封面上传失败：** 检查文件路径、格式、尺寸、大小；上传成功后更新所有封面字段。 - **字段校验失败：** 重新读取 `prepare` 与 `schema fields`，按实际错误精确修复。 - **干跑失败：** 不进入正式发布，重点检查发布通道、账号 ID、clientId、HTML 正文和封面素材字段。 - **发布后失败：** 通过 `details` 定位阶段，保留失败证据；修复根因后重新从预检开始，避免盲目重发。 ## 最终回执模板 每次发布结束，都应主动给出： - 状态：完成 / 失败 / 阻断； - 实际动作：上传、预检、发布、回查； - 验证证据：任务状态、阶段、发布编号； - 归档：文章、封面与 payload 的位置； - 下一步：成功则收口，失败则指出明确阻断项。 ## 一句话总结 自动发布不是“替人点一下发布”，而是让每一次公众号发布都能**事前可检、事中可控、事后可查**。