Good Mp Post

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 

数据互通： 脚本发布的文章会自动记录到数据库，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， \

--content "HTML正文" \ --media_ids '[]'

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

### 5. 发布文章
调用 `scripts/publish_article.py`:
```bash
python scripts/publish_article.py --media_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生成文章时必须遵循以下规范：

禁止使用相对路径

❌ 错误示例：

正确的图片处理流程

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

✅ 正确示例：

python scripts/upload_media.py /path/to/cover.jpg thumb

原因说明

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

关键注意事项

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ImGoodBai
• Source: ImGoodBai/goodable
• License: MIT
• Homepage: https://goodable.cn

Install and usage instructions live in the source repository linked above.