/good-mp-post

name: good-mp-post
displayName: Good 公众号发布
description: 微信公众号文章发布完整流程管理，包括AI辅助创作、图片生成、排版和发布。
version: 1.0.0
license: MIT

Good 公众号发布

任务目标

通过AI辅助完成微信公众号文章的创作、排版和发布全流程。

**能力：** 文章创作、图片生成与上传、草稿创建、文章发布

**触发：** 用户需要创建或发布微信公众号文章

使用模式

模式1：Web UI (推荐)

可视化界面，支持文章管理、在线编辑和发布：

# 安装依赖
pip install -r requirements.txt

# 启动服务（默认端口8000）
uvicorn app.main:app --reload

# 浏览器访问
http://localhost:8000

**功能：**

• 文章CRUD操作（创建、查看、编辑、删除）
• Markdown内容编辑
• 数据库持久化（SQLite）
• 直接发布到微信公众号
• 发布历史记录

模式2：脚本 (命令行)

适合自动化场景，与Web UI共享数据库：

# 上传图片
python scripts/upload_media.py /path/to/image.jpg thumb

# 创建草稿
python scripts/create_draft.py --title "标题" --content "内容"

# 发布文章
python scripts/publish_article.py --media_id <草稿ID>

**数据互通：** 脚本发布的文章会自动记录到数据库，Web UI可查看和管理。

前置准备

**依赖：** requests>=2.28.0, python-dotenv>=1.0.0, fastapi>=0.104.1, sqlalchemy>=2.0.35

**凭证配置：**

• 在 .env 文件配置 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET`
• 获取方式：微信公众平台 → 开发 → 基本配置
• 需配置IP白名单

**数据库：** 自动创建 SQLite 数据库（data/articles.db），无需手动配置

标准流程（Web UI）

1. 启动服务

cd skills/good-mp-post
uvicorn app.main:app --reload

2. 创建文章

• 打开 http://localhost:8000
• 填写标题、作者、摘要
• 编写 Markdown 内容
• 保存草稿

3. 发布文章

• 在文章列表点击"发布"按钮
• 自动处理封面图上传、草稿创建、发布流程
• 查看发布状态

脚本流程（命令行）

1. 创作文章内容

• 根据用户需求创作文章（Markdown格式）
• 参考 `assets/templates/article-template.md` 了解格式建议

2. 生成图片

• 生成封面图（建议 900×383px，<5MB）
• 生成插图（宽度≤900px）

3. 上传图片

调用 `scripts/upload_media.py`:

python scripts/upload_media.py /path/to/cover.jpg thumb    # 封面图
python scripts/upload_media.py /path/to/image.png image    # 正文图

4. 创建草稿

调用 `scripts/create_draft.py`:

python scripts/create_draft.py \
  --title "文章标题" \
  --author "作者名" \
  --thumb_media_id <封面图ID> \
  --content "<p>HTML正文</p>" \
  --media_ids '[]'

**注意：** 作者名最长8个中文字符

5. 发布文章

调用 `scripts/publish_article.py`:

python scripts/publish_article.py --media_id <草稿ID>

资源索引

• `app/main.py` - FastAPI 主应用入口
• `app/api/articles.py` - 文章管理 API
• `app/api/images.py` - 图片上传 API
• `app/database.py` - 数据库模型和连接
• `app/static/index.html` - Web UI 界面
• `scripts/upload_media.py` - 上传图片到素材库
• `scripts/create_draft.py` - 创建图文草稿
• `scripts/publish_article.py` - 发布草稿
• `scripts/db_logger.py` - 数据库日志记录（可选）
• `references/api-guide.md` - API详细说明
• `assets/templates/article-template.md` - 文章格式模板

图片路径规范（重要）

AI生成文章时必须遵循以下规范：

禁止使用相对路径

❌ 错误示例：

![封面](./cover.jpg)
![插图](../images/chart.png)
![示例](images/demo.jpg)

正确的图片处理流程

1. 先生成图片文件并保存到临时目录 2. 调用 `upload_media.py` 上传到微信获取 media_id 3. 使用占位符或说明文字，不要直接插入本地路径

✅ 正确示例：

<!-- 步骤1：生成图片 -->
<!-- 步骤2：上传图片 -->
python scripts/upload_media.py /path/to/cover.jpg thumb

<!-- 步骤3：记录 media_id，在创建草稿时使用 -->
<!-- 正文中不插入相对路径 -->

原因说明

• 相对路径在预览和发布时无法正常显示
• 微信公众号要求先上传图片获取 media_id
• 已有的工作流（上传图片→创建草稿）是正确的

关键注意事项

1. **作者名限制：** 最长8个中文字符 2. **图片有效期：** 封面图永久，正文图3天 3. **图片路径：** 禁止使用相对路径（见上方图片路径规范） 4. **HTML要求：** 使用简单标签（p/h1-h3/ul/li/img/a），避免复杂CSS 5. **发布审核：** 发布后需微信审核才能展示 6. **调用频率：** 上传1000次/天，创建草稿100次/天，发布10次/天