公众号发布流水线 Andiii208/gzhflow

gzhflow · 跨 Agent 公众号内容发布工作流

一套可复用、跨主流 AI Agent 的微信公众号内容发布工作流框架：从「一个主题」到「草稿箱里一篇排好版、配好图、去过 AI 味的文章」，六阶段流水线 + 每步质量门。

适配 Claude Code / Cursor / Codex CLI / Gemini CLI / Qwen Code / DeepSeek 等主流 Agent，也兼容 Hermes 的 SKILL.md 格式（同源标准）。

特性

- 跨 Agent 开箱即用：AGENTS.md 单一真源 + CLAUDE.md 一行桥接，任何 Agent 打开即懂
- 七阶段流水线：素材先行 → 写作 → 去AI味 → 配图 → 排版 → 推草稿箱 → 复盘回写
- 四库 + 状态机：收件箱 / 范文锚 / 风格档案 / 教训库在下沉淀，state.md 跨会话接续
- 质检门有实测依据：规则来自 629 篇 283 万字的对照语料研究（lieflat-less-ai-tone，MIT），不是拍脑袋
- 个人化可替换：文风/配图风格/排版主题全部走 config/ 配置 + examples/ 模板，流程不绑定个人
- 质量门三件套：脚本门（确定性）+ 清单门（LLM 自检）+ 人工门（审阅/dry-run）
- 发布层个人号可用：官方 API draft/add 推草稿箱（个人订阅号可用），手动粘贴兜底
- 纯 CLI 工具：stdlib 优先，无外部依赖，跨平台

快速开始

1. 复制配置模板
cp config/workflow.example.yaml config/workflow.yaml
cp config/styles.example.yaml config/styles.yaml
cp config/themes.example.yaml config/themes.yaml
cp config/publish.example.yaml config/publish.yaml

2. 自检工具链
python scripts/validate_repo.py

3. 对任意 Agent 说：「用 gzhflow 工作流写一篇关于 XX 的公众号文章」

完整步骤见 docs/quickstart.md。

在 DeepSeek Harness 中使用（DSH 插件）

gzhflow 同时打包为 DSH 插件（package.json 声明 dsh.bundle），可一键安装：

全局注册 7 个 gzhflow_* 工具（6 个质检门 + 环境自检）并随包携带 gzhflow skill
dsh plugin --profile web add https://github.com/Andiii208/gzhflow

装完在任意会话说「用 gzhflow 写一篇关于 XX 的公众号文章」，或用 skill 工具加载 gzhflow。

想要「公众号主编」人设（会话级 persona + 环境自检引导）可另装 Agent 预设（opt-in）：

powershell -ExecutionPolicy Bypass -File dsh-preset/install.ps1 # Windows
bash dsh-preset/install.sh # macOS / Linux

详见 dsh-preset/README.md。

七阶段流程

| 阶段 | 作用 | 质量门 |
| ① 素材先行 | 先翻收件箱和对话存量，缺什么才问，只问一轮 | 意图三问 |
| ② 写作 | 读风格档案 + 范文锚，按文风路由写作 | ai_flavor_score.py + 自检四问 |
| ③ 去AI味 | 三环：结构手术 → 冷读重写 → 分视角评审 | ai_flavor_score.py 复检 |
| ④ 配图（可选） | 图源三问 → 风格路由 → 四段式编译 | check_image_prompt.py |
| ⑤ 排版 | 主题路由 → Markdown 转公众号 HTML | validate_gzh_html.py |
| ⑥ 发布 | 推草稿箱（个人号可用） | publish_draft.py --dry-run |
| ⑦ 复盘 | 记日志，每 5 篇回写四库 | — |

四库与状态机

单篇生产只是飞轮的一段弧。底下四个库在下持续沉淀，单篇流程在上取用并回写：

| 库 | 文件 | 变化速度 |
| 输入收件箱 | assets/inbox.md | 快变（日） |
| 范文锚 | assets/voice-samples/ | 慢变（月） |
| 风格档案 | assets/voice.md | 慢变（季度） |
| 教训库 | assets/lessons.md | 事件驱动 |

state.md 是跨会话状态机——多 Agent 之间切换时，靠它接续上下文，不重复提问。

references/ 里 38 份方法论按阶段路由见 references/INDEX.md。

目录结构

gzhflow/
├── AGENTS.md # 跨 Agent 入口（单一真源） ├── CLAUDE.md # Claude Code 桥接（@AGENTS.md） ├── state.md # 跨会话状态机（每次会话先读） ├── assets/ # 四库：inbox / voice / voice-samples / lessons / log ├── skills/gzhflow/ # 主编排 SKILL.md + 七阶段 prompts/ ├── references/ # 方法论活文档 ├── scripts/ # 纯 CLI 质检/排版/裁剪/推草稿 ├── config/*.example # 配置模板（你的文风/主题/凭证） ├── examples/ # 去个人化示例 + 空白模板 └── docs/ # 上手/迁移/Agent 适配

背景

本项目是对作者此前 Hermes 专属个人公众号工作流（Andiii208/andiii-wechat-workflow）的抽象与泛化：保留其精华方法论（文风路由、去 AI 味手册、配图四件套引擎、设计推理层、质检门），剥离 Hermes 绑定与个人化内容，重构为适配主流 Agent 的范式框架。迁移详情见 docs/migration-guide.md。

License

MIT（见 LICENSE）；上游许可边界见 NOTICE.md。