# Wechat Layout Publisher

> 当用户要求公众号定稿、公众号配图排版、公众号可复制版、公众号封面、加入公众号草稿箱或公众号收口归档时使用；也承接已确认发往微信公众号的任意上游 Skill 产物。完成定稿或原文保护、语义配图、2.35:1 图文首图、微信安全 HTML、审阅修改、草稿交付和单文件收口。用户只要正文、只写初稿、平台未定或目标为小红书、短视频、网站等其他平台时不使用。默认先交付完整可复制 HTML，用户确认后把同一正文加入草稿箱。

- Skill: `aidenxu-1/wechat-layout-publisher` (Agent Skill, multi-file: 39 files)
- Install (CLI): `npx skillmds@latest add aidenxu-1/wechat-layout-publisher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aidenxu-1/wechat-layout-publisher/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: AidenXu-1 (https://skillmd.com/u/aidenxu-1)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/aidenxu-1/wechat-layout-publisher

---


# 公众号排版发布

把可读取的资料或文章制作成一份公众号正文母版，再由同一母版进入修改、草稿箱和正式归档。收口后只保留本 Skill 的最终可复制 HTML，以及本 Skill 在直接改写入口亲自写出的 Markdown 终稿。

## 进入边界

支持会话直接入口和任意上游 Skill 续接。进入前必须同时满足：

1. `destination` 已确认是 `wechat_official_account`。
2. 当前任务已进入公众号定稿、配图、排版、正式可复制版或草稿箱制作阶段。
3. 源资料或文章可以读取。

用户只要正文、只要初稿、平台待定或目标为其他平台时，继续原工作流。Skill 续接时读取 `references/upstream-handoff.md`；不要向用户展示内部交接模板，也不要让上游替用户猜选择。

## 开局确认

开始制作前只确认内容处理模式：

```text
开始前请确认内容处理模式：

A. 杂乱资料：梳理并产出公众号定稿文案，再配图排版
B. 初稿文案：检查优化内容细节并产出定稿，再配图排版
C. 发布定稿：保持文案内容不变，只做配图、排版和格式规范
```

用户请求或可追溯交接已经明确内容模式时不重复询问。内容模式确定前不得改写、规划配图、生成图片、制作预览或调用微信接口。首次正式可复制版完成前不要求用户决定草稿箱或归档。

把选择原样写入 `image-plan.json`：

- 内容 A：`input_stage: messy_materials`、`content_mode: rewrite`。
- 内容 B：`input_stage: draft_copy`、`content_mode: rewrite`。
- 内容 C：`input_stage: final_copy`、`content_mode: preserve`。
- 首次交付前固定记录 `interaction_contract_version: 3`、`review_choice: pending`、`delivery_mode: copy_ready`、`draft_authorization: none`、`archive_authorization: none`、`approved_body_sha256: ""` 和 `body_image_upload_authorization: copy_ready_request`。
- 同时记录 `content_choice`、`choice_source: direct_user | upstream_user_confirmation`、`destination: wechat_official_account` 和 `entry_mode: direct | skill_handoff`；续接入口另记 `handoff_version: 1` 与 `source_skill`。
- 从创建第一个文件或目录起维护 `artifact_ownership.skill_created_files`、`skill_created_directories` 与 `protected_external_files`。前两者只列本 Skill 本次真实创建的文件和目录；后者列用户文件、上游文档和外部素材，清单不得重叠。

## 默认交付循环

首次正式可复制版完成并通过质量闸门后，提供 HTML 并主动询问：

```text
当前可复制版已经完成。是否通过，可以加入公众号草稿箱？需要修改请直接告诉我。
```

- 用户提出修改：按 `references/publishing.md` 完整退回修改状态并清空旧批准；修改、重验后重新交付完整 HTML。
- 用户确认加入草稿箱：把最新视觉 QA 回执中的正文哈希写入 `approved_body_sha256`，更新为 `review_choice: draft`、`delivery_mode: draft` 和 `post_preview_confirmation` 授权。草稿入口必须核对当前正文与该哈希完全一致；正文有任何变化都停止并重新确认。
- 草稿成功：返回 `media_id`，提醒“进入草稿箱不等于公开发布”，记录 `archive_authorization: post_draft_success`，然后按 `references/archive.md` 自动把同一最终 HTML 写入调用项目提供的正式目标位置；不再询问是否收口。

只有用户明确说“只要手动复制版”时才跳过草稿 API；用户明确要求“直接加入草稿箱”时可以跳过用户预览，但仍完成全部内部质量检查。不要主动向用户展示这些内部路线或状态名。

## 五条硬合同

1. **内容边界**
   - `messy_materials` 保存可追溯源资料，分开事实、观点、经历、数据、重复、冲突和待核项，再按读者理解顺序成文。
   - `draft_copy` 以初稿为母版，保护事实、立场、证据边界和真实声音；按结构与动力、证据连接、段落呼吸、词句准确的顺序修订。
   - `final_copy` 只改变 HTML 结构和视觉节奏。正文字符、标点与顺序不得变化；缺少标题时先请用户补充或取得单独新增授权。副标题按文章需要选用，用户明确不需要时记录 `subtitle_policy: omitted_by_user`，不为通过校验强行新增。
2. **编辑与图片计划**
   - 搜索、生成或绘图前创建 `image-plan.json`。新建或重做的 `rewrite` 任务必须使用 `editorial_contract_version: 1` 和可验证的 `editorial_plan`；`draft_copy` 另含 `voice_fingerprint` 与 `revision_priorities`。
   - 旧文章包只有显式使用验证器的 `--allow-legacy-editorial` 才能走兼容路径；新任务禁止使用该开关。
3. **真实视觉来源**
   - 每个视觉只走 `user_asset`、`evidence_screenshot`、`generated_image`、`coded_visual` 中的一条路线。证据必须来自真实来源，代码图只解释结构。
   - 标题与副标题之后的首图必须由真实生图工具生成，准确 H1 自然融入 `2.35:1` 构图，最终文件至少 `900×383`。纯图、用户图、截图、代码图或脚本贴字不能代替。
   - 当前 Agent 无生图能力时，告知用户并停在本地工作预览；保留完整提示词，首图返回前不得正式交付。
4. **单一正文母版**
   - 正文使用 `ARTICLE HTML START` 与 `ARTICLE HTML END` 标记，只含微信安全的内联 HTML。预览按钮、状态条和脚本只能在标记外。
   - 正文视觉按计划顺序使用唯一 `data-wlp-visual-id`；所有强视觉统一计入密度。相邻强视觉之间必须有承担新信息的正文。
5. **授权与安全**
   - `copy_ready` 可以准备正文图片，但绝不创建草稿。普通路线只有用户确认当前 HTML 后才记录正文哈希并更新草稿授权；直接草稿路线只接受用户当前明确指令。
   - 只有 `delivery_mode: draft`、草稿授权与正文哈希合同同时有效时才能调用 `draft/add`。普通路线发送的 ARTICLE HTML 正文必须与用户最新确认版本逐字节一致。凭据只从环境变量、本地 `.env` 或本 Skill 的标准系统凭据位置读取，不搜索旧聊天、随机文件、shell 历史或无关钥匙串。
   - IP 白名单以微信接口 `40164` 返回的 `invalid ip` 为准。普通公网 IP 探测只作参考；代理、TUN 或分流存在时，不得用与微信实测不同的探测结果指导用户。
   - 收口只删除 `artifact_ownership.skill_created_files` 中逐条登记的文件，只移除 `skill_created_directories` 中已经变空的目录；禁止通配符、目录扫描和整目录递归删除。用户文件、用户目录、上游文档、外部素材及来源不明路径永不移动、覆盖或删除。
   - 不创建名为 `WeChat` 或 `wechat` 的文件夹。临时素材使用当前文章工作目录内的普通子目录，收口后只删除已登记且属于本 Skill 的文件。

## 按需读取

只在进入对应阶段时加载，避免把低频发布细节提前塞进上下文：

| 阶段 | 读取 |
|---|---|
| Skill 续接 | `references/upstream-handoff.md` |
| 内容规划 | `references/content-planning.md`；`rewrite` 再读 `references/editorial-writing.md` |
| 图片计划 | `references/image-placement.md`，从 `assets/image-plan.template.json` 起步 |
| 视觉制作 | `references/visual-quality.md`、`references/cover-system.md` |
| HTML 排版 | `references/style-guide.md`、`references/components.md` |
| 最终检查 | `references/qa-checklist.md` |
| 上传正文图或草稿箱 | `references/publishing.md` |
| 草稿成功或用户明确只收口手动复制版 | `references/archive.md` |

`final_copy` 不加载改写规则。只需要本地预览时不加载发布凭据和草稿 API 细节。

## 执行顺序

1. **收集与核查**：确认源文章、标题、可选副标题、作者或栏目名，以及全部用户图片和视频。先盘点用户素材；相关视频提取带时间戳的代表帧。依赖时效事实时联网核查一手来源。
2. **完成内容规划**：记录内容类型、置信度、依据、核心主张、读者承诺和章节地图。`rewrite` 完成编辑规划与定稿；`entry_mode: direct` 的 `rewrite` 同时写出本 Skill 自有的 `公众号文案终稿.md`，登记后在收口时保留。`preserve` 与 `skill_handoff` 默认不另建 Markdown，原文只登记为受保护外部文件。
3. **完成图片计划**：填写交互合同、编辑合同、素材决策、首节视觉锚点和每个视觉的来源、位置、语义、状态与可追溯信息。先运行计划阶段验证。
4. **制作视觉**：优先使用相关用户素材和真实证据；生成图负责隐喻或氛围；代码图负责流程、关系、时间线、比较、数据或机制。首图生成并人工检查后再继续。
5. **制作 HTML 与本地预览**：使用一致的组件、移动端节奏和内联样式。本地路径只用于内部预览，不能宣称可直接复制到微信。
6. **完成交付前闸门**：依次验证最终图片计划、正文安全、文案和统一布局；内部本地预览只服务制作，不交给用户审阅，也不因截图工具限制阻止正式可复制版生成。
7. **交付与确认**：通过 `publish.ts` 正式准备模式上传或复用正文图，首次交给用户的就是完整可复制 HTML。用户审阅后按意见循环修改；明确确认时生成绑定当前正文与图片计划哈希的视觉回执，锁定正文哈希并按 `references/publishing.md` 创建草稿；成功后按 `references/archive.md` 写入项目提供的正式目标并安全清理。

验证命令从 `scripts/` 目录运行：

```bash
npm run verify-image-plan -- --stage plan --article <source-article> <image-plan.json>
npm run verify-image-plan -- --stage final --article <source-article> --check-files <image-plan.json>
npm run verify-article -- --complete-package --content-mode <rewrite|preserve> --source-article <source-article> <article.html>
npm run verify-copy -- <article.html>
npm run verify-layout -- --article <article.html> --image-plan <image-plan.json>
```

`rewrite` 的文案警告必须修复；`preserve` 只报告。正式交付还要按 `qa-checklist.md` 完成图片来源、移动端截图、`verify-copy-ready` 和视觉回执检查。

## 完成回报

只报告与本次分支有关的信息：

- 内容模式、交付方式、正文母版与预览路径；明确是本地预览还是正式可复制版。
- `rewrite` 的主要改动，或 `preserve` 的原文校验与获准新增节点。
- 首图/封面路径、图片计划路径、视觉来源数量及证据 URL 或失败原因。
- 用户素材的使用位置与跳过理由；当前生图能力和真实工具。
- 正式可复制版的用户审阅状态、尚未解决的视觉或来源风险。
- 创建草稿时返回 `media_id`，并提醒“进入草稿箱不等于公开发布”。
- 首次完成和每轮修改后提供完整可复制 HTML，并主动询问是否通过、可以加入草稿箱。
- 收口时只报告最终 HTML、保留的本 Skill Markdown 终稿（如有）和未触碰的外部文件数量。