公众号一键发布工具

一个 AI native 产品试点：把已经写好的 Markdown 文档，一键变成配好图、排好版、可直接进公众号草稿箱的文章。

这是 AI产品试点方法论 项目下的第二个试点案例。它本身也是一个产品，做完后会沉淀进 AI产品试点方法论/02-案例库/，并改写成一篇实践方法论文章。

它不只是自用工具，目标是开源给懂技术的朋友和更多人使用：别人下载后，填上自己的公众号账号、配图模型 Key 和风格偏好，零改代码即可使用。

它要解决什么

写完一篇公众号文章后，真正花时间的不是写作，而是：

• 配图和封面（最花时间、最没标准答案）；
• 排版（手动调样式很累）；
• 从「文档」到「草稿箱」的最后一公里。

排版已被开源高度解决，所以本项目聚焦在配图生成和内容发布工作流整合。

目标闭环

• 闭环一（先做）：Markdown → 自动配图 + 封面 → 排好版内容 → 手动粘贴进后台（零门槛验证）。
• 闭环二（后做）：接微信 API，把「手动粘贴」升级为「一键进草稿箱」。

核心策略

和 ChatBI 一致：借鉴复用成熟开源（排版、发布封装），自研聚焦差异化（配图风格、流水线整合）。

最终产出

1. 一个开源的 MCP / CLI 小工具：懂技术的人下载、配置、即可一键发文；
2. 一套用户级配置机制：每个人填自己的账号、密钥、风格，零改代码（复用性的命门）；
3. 一个方法论案例：沉淀进 AI产品试点方法论/02-案例库/，与 ChatBI 互补；
4. 一篇公众号文章：用这个工具发布它自己，并在文末带出仓库链接。

文档索引

文档	内容
使用指南.md	面向用户：安装、配置、写文章、MCP/CLI 发布、报错排查
01-开源项目调研.md	三层赛道全景、关键技术约束、选型建议、待拍板决策点
02-设计规划.md	产品形态、不变内核/可变部分、架构、配图方案、两个闭环、分期

当前状态

• 阶段 0（调研 + 设计）已完成；
• 闭环一（配图 + 排版 + 手动粘贴）已跑通（见 闭环一-实测/）；
• 闭环二（接 API 一键进草稿箱）已跑通（见 闭环二-实测记录.md）；
• 阶段三产品化已完成：从「写死的脚本」升级为「任意 Markdown 通吃」的工具 ——
  • Markdown → 主题化排版自动渲染（mvp/render.mjs + mvp/theme.mjs）；
  • 发布逻辑通用化，接受任意 md 文件（mvp/core.mjs）；
  • 封装成 MCP server（render_preview / publish_to_draft）+ CLI（mvp/cli.mjs）；
  • 用户级配置（.env）+ 用户文档（使用指南.md）。

已拍板：

• 产品形态 = 以 MCP 为主（已补 CLI），不做网页版（理由见 02-设计规划.md 第 7.0 节）；
• 配图风格 = 手绘信息图（风格一致性已验证）；
• 排版 = 墨绿基线版式（已确认，做成可扩展主题）；
• 账号 = 个人订阅号，可一键进草稿箱，群发手动。

下一步：阶段四开源分发 + 写方法论文章。

快速上手

npm install
cp .env.example .env      # 填入 AppID / AppSecret
npm run test:conn         # 验证凭证 + IP 白名单
node mvp/cli.mjs preview 闭环一-实测/范例文章.md   # 离线预览
node mvp/cli.mjs publish 闭环一-实测/范例文章.md   # 进草稿箱

详见 使用指南.md。