# 公众号一键发布工具

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

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

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

## 它要解决什么

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

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

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

## 目标闭环

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

## 核心策略

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

## 最终产出

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

## 文档索引

| 文档 | 内容 |
|---|---|
| [`使用指南.md`](./使用指南.md) | **面向用户**：安装、配置、写文章、MCP/CLI 发布、报错排查 |
| [`01-开源项目调研.md`](./01-开源项目调研.md) | 三层赛道全景、关键技术约束、选型建议、待拍板决策点 |
| [`02-设计规划.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 节）；
- 配图风格 = 手绘信息图（风格一致性已验证）；
- 排版 = 墨绿基线版式（已确认，做成可扩展主题）；
- 账号 = 个人订阅号，可一键进草稿箱，群发手动。

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

## 快速上手

```bash
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`](./使用指南.md)。