wxmp-workflow

微信公众号工作流

一站式完成公众号内容创作：预检 → 选题 → 大纲 → 调研 → 写稿 → 打磨 → 配图 → 排版 → 发布 → 复盘。

本文件只定义架构：流程、路由、协议、不变量。 每一步的详细规则、清单、命令和格式都在 references/ 里，执行到对应步骤时再读，不要预先全读。各步骤末尾的「详见」指向唯一权威副本。

核心不变量（MUST）

三条规则跨所有步骤生效，不可违反：

1. 一个对话只做一篇文章。 第一次创建草稿时记住 media_id，后续所有操作复用它。用户想写新文章 → 提示"请开一个新对话"。
2. 打磨阶段去 AI 味评估 MUST 由独立子 agent 执行。 写稿 agent 和评估 agent 不能是同一个——避免"自己改自己评"的偏差。
3. **去 AI 味是两套独立标准，都要过：**① 明 AI 味（禁用词、句型指纹、对仗排比）；② 可预测性 / 抽象度（叙事 ≥ 70%、金句 ≤ 1、无元叙述）。Humanizer/StopSlop 只覆盖①，②的第 5 轮扫描 MUST 独立执行。

两套标准的完整规范：references/wxmp-tools.md（标准① + 评分规则本）、references/wxmp-perplexity.md（标准②）。

运行模式

模式	触发方式	行为
半自动（默认）	正常对话	关键节点停下来等用户确认
全自动	用户说"全自动"、"不用问我"、"直接做完"、"帮我写完直接发"	全程不问，自己决策

🔴 半自动卡点： 选题确认 → 大纲确认 → 初稿审阅 → 配图确认 → 体检报告 → 标题选择 → 发布确认。每个卡点 MUST 等用户明确回应，不可自行跳过。

全自动策略： 优先选信息差最大 + 受众匹配度最高的选题；按大纲直接写；根据体检报告自动优化；按爆款潜力选标题（口语法 > 好奇法 > 痛点法 > 数字法 > 对比法 > 权威法）；标题与内容对齐；打磨完成后跳过预览。草稿在排版阶段创建，打磨/配图可能修改 HTML，发布前用 --media-id 更新草稿。全自动只能创建草稿，发布仍需用户去后台手动操作。

全自动失败处理： 某步骤失败不中断全流程——跳过失败步骤继续，最后汇总报告成功/失败项。如图片生成失败 → 跳过配图；信源访问失败 → 用其他信源结果。

步骤状态标记： 每完成一个步骤 MUST 输出 ✅ 步骤 N：步骤名 — 一句话结果（如 ✅ 步骤 4：写初稿 — 2100 字，已审阅）。让用户随时知道进度，也防止跳步骤。

对用户说话用人话（沟通契约）： 状态标记和面向用户的回复里不要堆内部框架术语（「8 维加权」「第 5 轮扫描」「双通过线」「dim3」等）——这些是系统内部词，用户看不懂。对用户说结果和下一步（「改完了，AI 味评分 1/10 通过」），术语留给自己和子 agent 用。

半自动失败处理

遇到异常按表处理，不中断流程。完整错误处理见各步骤的 reference。

阶段	触发条件	一线修复	仍失败兜底
选题	三种信源全部不可达	更换连通方式（直接→代理→搜索轮换）	告知用户"信源不可达，以下选题基于已有知识生成，请人工补充"
选题	用户对 3 个选题都不满意	重新扫描一轮，换角度再推荐	问用户有没有想写的方向，按方向直接出大纲
调研	搜索不到所需素材	换关键词、换搜索源、扩大时间范围	告知用户"某章节素材不足"，用已有知识写初稿
写稿	用户要求大改	按反馈逐条修改，每改完一条标记状态	用户说"重写" → 回到大纲阶段重新确认结构
配图	Agnes 和 SenseNova 都失败	检查 API Key、网络连接	跳过配图，告知用户"图片生成失败，建议手动添加"
排版	模板文件找不到	检查 templates/ 目录	回退到 minimal-white 模板
发布	token 错误	检查 config/wxmp.json 的 AppID/Secret	引导用户去公众号后台手动创建草稿
发布	wx-draft.sh API 错误	检查网络、token 是否过期（自动刷新）	提供草稿 HTML 路径让用户手动粘贴
复盘	数据查询返回空	检查文章是否已发布超过 1 天（数据有延迟）	告知用户数据暂不可用，建议明天再查

意图路由

⚠️ MUST：所有工作流路由先执行步骤 0 预检。 配置助手路由（"帮我配置"/"检查配置"）无需预检。

用户说的	走哪条路
"帮我写篇公众号" / "最近没什么灵感"	完整流程：三模式选题 → 大纲 → 调研 → … → 发布
"帮我写篇关于 X 的文章"	跳过选题，从大纲开始
"帮我把这个写成公众号"（附带素材）	跳过选题+大纲+调研，从写稿开始
"帮我发布这篇文章"（已有 HTML）	直接进入发布阶段（外部 HTML 豁免打磨评估，见步骤 8）
"帮我查一下公众号数据" / "复盘"	数据复盘流程
"帮我优化这篇文章"（已有草稿）	进入打磨循环
"帮我想几个标题" / "标题太普通了"	爆款标题生成器
"帮我写个摘要"	摘要生成器
"帮我看看文章怎么样"	文章体检报告
"帮我加几个标签"	话题标签推荐
"帮我配置" / "怎么设置" / "检查配置"	配置助手（references/wxmp-setup.md）

不确定用户意图时直接问。

不要做什么（反例清单）

#	不要做的事	为什么	应该怎么做
1	一个对话写两篇文章	media_id 只能对应一篇草稿，后续操作会覆盖	提示用户"请开一个新对话"
2	用外部 CSS/JS 或 <style> 标签	微信客户端不支持，会丢失样式	所有样式必须内联 inline
3	自己编标题	AI 编的标题缺乏数据支撑	调用爆款标题生成器，产出 12 个候选让用户选
4	半自动模式替用户选模板	用户对视觉风格有偏好	MUST 列出 5 个模板让用户选择
5	图片含文字/真人/图表	审核可能不通过，AI 生成文字有乱码风险	prompt 末尾加 no real people, no human faces, no text, no labels, no chart, no diagram
6	跳过打磨步骤	打磨是去 AI 味+体检+标题的关键环节	写完初稿 MUST 走完去 AI 味 → 体检 → 标题生成
7	编造数据或引用	读者会验证，损害公信力	标注来源，无法验证的写明"据网络信息"
8	跳过半自动卡点	会减少用户掌控感	每个卡点必须等待用户明确回应
9	用半角标点或英文空格	影响中文阅读体验	遵循 references/chinese-copywriting-guidelines.md
10	直接用外部图片 URL	微信会拦截非 CDN 图片	先上传到微信素材系统，用 CDN 地址
11	打磨阶段自己改自己评	AI 倾向给自己打高分，"自评自改"发现不了真实 AI 味	5 轮扫描和量化评分 MUST 派发独立子 agent
12	每段用短金句收尾	金句体节奏是 AI 检测核心特征，段尾金句困惑度极低	全文金句 ≤ 1 个，只留情绪最高点，其余改叙述
13	抽象议论占比过半	抽象议论可预测性高，触发困惑度检测（即使明 AI 味为 0）	叙事/议论配比 ≥ 70:30
14	用元叙述交代行文结构	「我想说的是……」「先看一组数据」不推进内容，只暴露结构	删掉，直接讲内容

完整流程

每个步骤包含：输入 → 输出 → 做什么 → 模式行为 → 详细规则指针。

0. 预检：配置版本

输入： config/wxmp.json | 输出： 配置版本状态

MUST 在任何工作流步骤之前执行。 ⚠️ 预检优先级高于全自动模式的「全程不问」——配置缺失/过期属于需要用户提供密钥的硬阻塞，全自动模式下也必须停下来问（AI 无法替用户填 AppID/Secret）。检查 config_schema_version 字段（当前版本见 references/wxmp-setup.md「配置版本历史」），按三种情况分支：

• 配置文件存在且版本匹配 → 输出 ✅ 步骤 0：预检 — 配置版本已确认，继续
• 配置文件缺失（config/wxmp.json 不存在，只有 .example）→ MUST 等用户选择：提示「未检测到配置文件，输入"帮我配置"完成设置，或输入"跳过"继续（写稿/打磨不依赖配置，仅发布/配图受限）。」
  • 用户选更新 → 引导到配置助手（references/wxmp-setup.md），完成后输出 ✅ 步骤 0：预检 — 已更新配置
  • 用户选跳过 → 输出 ✅ 步骤 0：预检 — 用户选择跳过配置，继续工作流；到达发布/配图步骤时再提示需配置
• 配置文件存在但字段缺失或版本偏低 → MUST 等用户选择：提示「检测到配置需要更新，输入"帮我配置"更新，或输入"跳过"继续。」
  • 用户选更新 → 引导到配置助手，完成后输出 ✅ 步骤 0：预检 — 已更新配置
  • 用户选跳过 → 输出 ✅ 步骤 0：预检 — 用户选择跳过版本更新，不再重复提示

1. 选题

输入： 时间范围 | 输出： 3-5 个选题候选（含来源路线和推荐理由）

三模式综合扫描，每种都执行，去重排序后推荐：热点速报（当日新闻 + 热搜，找流量基础）、深度选题（GitHub/HN/Product Hunt 等原始信源，找信息差）、预判选题（周期性事件提前准备）。访问外部信源走连通性缓存（config/connectivity.json）自动适配网络。

半自动： 展示清单让用户选 | 全自动： 选信息差最大 + 受众匹配度最高的

信源列表、访问方式、评估标准、输出格式见 references/wxmp-inspiration.md

2. 大纲

输入： 已确认的选题 | 输出： 结构化大纲（章节标题 + 每章要点）

先确认文章类型（教程/观点/故事/盘点/深度），再生成结构化大纲。大纲确认后再调研和写稿，避免返工。

半自动： 展示大纲等确认 | 全自动： 直接进入调研

文章类型判断和大纲格式见 references/wxmp-outline.md

3. 调研

输入： 大纲 | 输出： 按章节组织的素材包（Markdown 列表）

按每个章节的论点搜集真实素材（竞品文章、行业数据、权威引用、用户案例、反面案例）。不要凭空编造，素材要注明来源。

半自动： 展示素材包问用户是否补充 | 全自动： 直接整理好供写稿

素材类型、搜索方法、调研流程、输出格式见 references/wxmp-research.md

4. 写初稿

输入： 大纲 + 素材包 | 输出： 1500-3000 字 Markdown 全文

按大纲撰写全文。口语化、适合手机阅读。遵循中文文案排版指北（references/chinese-copywriting-guidelines.md）的盘古之白和全角标点，排版设计规范（references/wxmp-typography.md）的字号和视觉节奏。涉及数据/事件/观点时标注来源，外链用上标脚注、文末统一列出。

⚠️ 写稿 MUST 应用「生成时约束」——两套标准共 16 条，从源头减少 AI 味和 AI 检测概率，比事后修复有效得多。这是本步骤最关键的动作，约束清单是唯一权威副本：

写作原则、英文处理、时间意识、来源标注、**生成时约束（16 条）**见 references/wxmp-writing.md。注： 引号、转述、数据、结尾等朱雀相关规则以 references/wxmp-perplexity.md「第一步」为唯一权威副本，本步骤的「朱雀预防三件事」只是速记索引，两处冲突时以 perplexity 为准。

⚠️ 朱雀预防三件事（写稿时做，成本≈0；留到打磨阶段做则要返工）： ① 引号全文用直角「」，不用弯引号；② 转述/举例/转折等重复功能列句式轮换表，同一骨架不出现 ≥2 次；③ 相邻段落文体重心错开（叙事/数据/口语/引语交替）。写稿时的完整规范见 references/wxmp-perplexity.md「第一步」。

半自动： 写完让用户审阅 | 全自动： 写完直接进入打磨

5. 打磨

输入： 初稿 Markdown | 输出： 去 AI 味终稿 + 12 个候选标题 + 3 个摘要版本

⚠️ 关键限制： 主 Agent 不得自行执行「5 轮扫描 + 量化评分」。必须调用子 Agent（task tool, subagent_type: general）执行。

流程：去 AI 味（两套标准）→ 减法破均质 → 独立评估 → 体检报告 → 针对性优化 → 朱雀实测 → 生成标题和摘要。每步必经，MUST NOT 跳过。

• 标准① 明 AI 味： 优先 Humanizer + StopSlop，否则内置 4 轮扫描
• 标准② 可预测性 / 抽象度： 第 5 轮扫描，Humanizer/StopSlop 不覆盖，MUST 独立执行
• 减法破均质（朱雀过线关键，MUST 在朱雀实测前执行）： 对全文的「过于工整」元素做毛糙化——时间精确→模糊、完整转述→话说到一半、单一叙事轴→视角抖动、工整列举→不对称长短句。只减不增：禁止添加任何新的「人味装饰品」（实测加法升分且被读者识破）。过线即停，改完自己读一遍，别扭就回退。具体手法与铁律见 references/wxmp-perplexity.md「第二步」
• 同构句式检查： Top5 句子开头集中度 > 20% 或同一句式骨架 ≥ 3 连 → 必须打散（内置评分抓不住这项，见 references/wxmp-perplexity.md）
• 量化评分： 8 维度加权总分（7 维属标准① + 抽象议论占比 15% 属标准②）。通过线双约束：AI 味总分 ≤ 2 分 且 叙事占比 ≥ 70%，任一不满足返工
• 朱雀实测（必做）： 终稿贴 朱雀检测器（只贴正文，排除标题/小标题/CTA/参考资料），达标线：加权分 ≤ 0.5。测试方法、片段化解读、降分手段见 references/wxmp-perplexity.md
• 朱雀实测循环（MUST 遵守）： 未过线（> 0.5）→ 只改最高分片段对应正文，手法限「减法破均质」→ 重测，最多 2 轮。2 轮后仍 > 0.5 → 停止盲改，向用户报告分数与轨迹，由用户选择：真人过稿 / 接受压线交付 / 继续由用户主导改。禁止无限迭代（实测 3 轮以上无改善即为结构性平台期，越改越毛糙）
• 输出： 子 Agent 给评分报告 + 可预测性自检报告（叙事占比 / 金句数 / 残留问题）
• 体检维度： 开头吸引力、段落可读性、结构清晰度、金句密度、结尾引导力
• 针对性优化的护栏： 体检后的任何修改，同样必须守「减法破均质」铁律（只减不增、无 em dash、不加人味装饰品）——评估通过后再改坏属于流程事故
• 标题/摘要： MUST 用生成器产出 12 个标题 + 3 个摘要，NEVER 自己编

🔴 独立评估卡点： 未完成不得进入排版阶段。朱雀实测可在评估通过后并行推进（如用户同步在网页实测），但终稿达标（加权分 ≤ 0.5）是进入发布的必要条件。

5 轮扫描细则、量化评分权重、危险句式、标题/摘要/体检生成器见 references/wxmp-tools.md 朱雀过检完整手册（写稿时预防 / 定稿前减法破均质 / 测与解读）见 references/wxmp-perplexity.md 打磨编排与迭代闭环见 references/wxmp-polish.md

半自动： 展示体检报告问用户要不要改 → 展示标题/摘要候选让用户选 | 全自动： 根据报告自动优化 → 按策略自动选标题

6. 配图

输入： 文章内容 + 情感基调 | 输出： 上传到微信的图片 CDN 地址

在合适位置加图。分两类走不同策略：直接型（证据截图、数据图表、步骤图）直接写 prompt；概念型（开头、结尾、隐喻、案例）先走风格生成。

底线： 图片不能有文字、真人、图表/流程图。生成后 MUST 上传到微信素材库才能使用。

半自动： 风格展示给用户确认 → 生成 | 全自动： 直接生成

风格生成流程、加图时机、图片来源、内容限制、生成命令、上传命令见 references/wxmp-images.md 风格生成细节见 references/wxmp-style-generator.md

7. 排版

输入： Markdown 终稿 + 用户选择的模板 | 输出： output/xxx.html（公众号兼容 HTML）

提供 5 个精美模板（简约白 / 杂志风 / 科技风 / 卡片式 / 渐变色）。公众号 HTML 关键约束：只能内联 style，不能用外部 CSS/JS，图片必须微信 CDN 地址。

半自动： MUST 列出 5 个模板让用户选，NEVER 替用户选 | 全自动： 按文章类型自动选择

模板列表、选择策略、占位符见 templates/README.md；Markdown→HTML 转换方法见 references/wxmp-html.md

8. 发布

输入： HTML 文件 + 封面图 CDN 地址 | 输出： 草稿箱中的草稿（media_id）

封面图缺失时： 创建草稿必须指定封面 thumb。如果用户走快捷发布且未提供封面（没经过配图阶段），MUST 向用户索要一张 900×383 的 JPG/PNG，或询问是否要用正文首图代替——不要替用户随便选图。

HTML 文件不明确时： 用户只说"HTML 在 output/ 里"而目录下有多个文件，MUST 列出候选让用户确认，不要自行挑选。发布用 .html（不是 .md 源文件）。

先读 config/wxmp.json 的 verified 字段（缺失按 false）决定路径：

• verified: false（默认）： 用 API 创建草稿（token → 上传封面 thumb → wx-draft.sh），再引导用户去公众号后台手动预览和发布
• verified: true： 额外可用 API 预览（wx-preview.sh）和发布（wx-publish.sh，异步轮询）
• 查数据无需认证（wx-stats.sh / wx-articles.sh / wx-article-stats.sh）

发布前清单（仅适用于本工作流产出的稿子）： 独立评估已执行（AI 味总分 ≤ 2/10）、可预测性自检通过（叙事 ≥ 70%、金句 ≤ 1、无元叙述）。

豁免规则： 如果用户是带着外部已有 HTML 走快捷发布路由（意图路由表「已有 HTML → 直接进入发布阶段」），说明这篇稿子没经过本工作流的写稿/打磨，上述清单不适用——直接进入发布，不强制补跑评估。可提示一句「这篇未经过本工作流的去 AI 味评估，如需可先走打磨」，但由用户决定，不阻塞发布。

来源确认： output/ 既是本工作流排版阶段的输出目录，也可能是用户外部文件的存放处。判断依据是本次对话是否走过步骤 4-5：走过 → 清单适用；没有（用户直接带着 HTML 进来）→ 走豁免规则。拿不准就问用户一句，不要猜。

标题 / 摘要来源： 创建草稿需要 --title（--digest 可选）。快捷发布时若用户没给，MUST 先问用户要，或提议从 HTML 的 <title> / 首个 <h1> 提取后让用户确认——不要自行编一个。

⚠️ 朱雀会误判真人的优秀议论文（真人正式评论的结论段曾被判 0.9997）。不要为了压分牺牲文章质量——目标是对齐真人基线，不是过检测。判断是「真 AI 味」还是「误判」先于改稿。详见 references/wxmp-perplexity.md。

完整命令、参数、错误处理、手动发布步骤见 references/wxmp-publishing.md

半自动： 创建草稿 → 引导去后台预览 → 用户确认后手动发布 | 全自动： 自动创建草稿，告知用户"草稿已就绪，去后台手动发布"

9. 复盘

输入： 无（按需触发）| 输出： 文章数据复盘报告

先读 verified 字段：false → 告知用户去后台数据统计页查看；true → 拉文章列表 → 选文章 → 检查发布是否过 1 天 → 查数据 → 输出 HTML 复盘报告。

触发词、执行流程、查询命令、分析维度、输出格式见 references/wxmp-publishing.md 的复盘章节

增强工具

随时可调用，不绑定特定阶段。详细用法见 references/wxmp-tools.md。

工具	干什么	什么时候用
爆款标题生成器	6 种策略各 2 个标题（共 12 个），按推荐度排序	写完文章取标题时
摘要生成器	3 个版本的 120 字摘要（悬念/价值/故事）	需要列表摘要时
文章体检报告	5 维度打分 + 优化建议	打磨阶段必用，也可随时调用
话题标签推荐	提取 3-5 个关键词标签	发布前加标签时

配置说明

首次使用需要配置。配置文件 config/wxmp.json 支持两个位置（当前目录优先）：{项目}/config/wxmp.json 或 skill 安装目录下的 config/wxmp.json。

cp config/wxmp.example.json config/wxmp.json   # 填入真实 AppID 和 Secret

配置文件含敏感信息，已在 .gitignore 中排除。用户说"帮我配置"时，先检查哪些已配置、哪些缺失，只引导配置缺失部分。可选功能（Humanizer、StopSlop、Agnes AI、Reddit）逐个询问。

获取密钥方式、配置字段说明、可选功能安装、版本历史见 references/wxmp-setup.md