good-mp-post

Name: good-mp-post
Author: ImGoodBai

9installs43forks

How to install good-mp-post?

imgoodbai/goodable/good-mp-post

$npx -y skills add ImGoodBai/goodable --skill good-mp-post

Installs into the current project.

Summary

微信公众号文章发布完整流程管理，包括AI辅助创作、图片生成、排版和发布。

Files · 1

View on GitHub

SKILL.md

1	# Good 公众号发布
2
3	## 任务目标
4	通过AI辅助完成微信公众号文章的创作、排版和发布全流程。
5
6	能力：文章创作、图片生成与上传、草稿创建、文章发布
7
8	触发：用户需要创建或发布微信公众号文章
9
10	## 使用模式
11
12	### 模式1：Web UI (推荐)
13	可视化界面，支持文章管理、在线编辑和发布：
14
15	```bash
16	# 安装依赖
17	pip install -r requirements.txt
18
19	# 启动服务（默认端口8000）
20	uvicorn app.main:app --reload
21
22	# 浏览器访问
23	http://localhost:8000
24	```
25
26	功能：
27	- 文章CRUD操作（创建、查看、编辑、删除）
28	- Markdown内容编辑
29	- 数据库持久化（SQLite）
30	- 直接发布到微信公众号
31	- 发布历史记录
32
33	### 模式2：脚本 (命令行)
34	适合自动化场景，与Web UI共享数据库：
35
36	```bash
37	# 上传图片
38	python scripts/upload_media.py /path/to/image.jpg thumb
39
40	# 创建草稿
41	python scripts/create_draft.py --title "标题" --content "内容"
42
43	# 发布文章
44	python scripts/publish_article.py --media_id <草稿ID>
45	```
46
47	数据互通：脚本发布的文章会自动记录到数据库，Web UI可查看和管理。
48
49	## 前置准备
50	依赖： requests>=2.28.0, python-dotenv>=1.0.0, fastapi>=0.104.1, sqlalchemy>=2.0.35
51
52	凭证配置：
53	- 在 .env 文件配置 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET`
54	- 获取方式：微信公众平台 → 开发 → 基本配置
55	- 需配置IP白名单
56
57	数据库：自动创建 SQLite 数据库（data/articles.db），无需手动配置
58
59	## 标准流程（Web UI）
60
61	### 1. 启动服务
62	```bash
63	cd skills/good-mp-post
64	uvicorn app.main:app --reload
65	```
66
67	### 2. 创建文章
68	- 打开 http://localhost:8000
69	- 填写标题、作者、摘要
70	- 编写 Markdown 内容
71	- 保存草稿
72
73	### 3. 发布文章
74	- 在文章列表点击"发布"按钮
75	- 自动处理封面图上传、草稿创建、发布流程
76	- 查看发布状态
77
78	## 脚本流程（命令行）
79
80	### 1. 创作文章内容
81	- 根据用户需求创作文章（Markdown格式）
82	- 参考 `assets/templates/article-template.md` 了解格式建议
83
84	### 2. 生成图片
85	- 生成封面图（建议 900×383px，<5MB）
86	- 生成插图（宽度≤900px）
87
88	### 3. 上传图片
89	调用 `scripts/upload_media.py`:
90	```bash
91	python scripts/upload_media.py /path/to/cover.jpg thumb # 封面图
92	python scripts/upload_media.py /path/to/image.png image # 正文图
93	```
94
95	### 4. 创建草稿
96	调用 `scripts/create_draft.py`:
97	```bash
98	python scripts/create_draft.py \
99	--title "文章标题" \
100	--author "作者名" \
101	--thumb_media_id <封面图ID> \
102	--content "<p>HTML正文</p>" \
103	--media_ids '[]'
104	```
105
106	注意：作者名最长8个中文字符
107
108	### 5. 发布文章
109	调用 `scripts/publish_article.py`:
110	```bash
111	python scripts/publish_article.py --media_id <草稿ID>
112	```
113
114	## 资源索引
115	- `app/main.py` - FastAPI 主应用入口
116	- `app/api/articles.py` - 文章管理 API
117	- `app/api/images.py` - 图片上传 API
118	- `app/database.py` - 数据库模型和连接
119	- `app/static/index.html` - Web UI 界面
120	- `scripts/upload_media.py` - 上传图片到素材库
121	- `scripts/create_draft.py` - 创建图文草稿
122	- `scripts/publish_article.py` - 发布草稿
123	- `scripts/db_logger.py` - 数据库日志记录（可选）
124	- `references/api-guide.md` - API详细说明
125	- `assets/templates/article-template.md` - 文章格式模板
126
127	## 图片路径规范（重要）
128
129	AI生成文章时必须遵循以下规范：
130
131	### 禁止使用相对路径
132	❌ 错误示例：
133	```markdown
134	![封面](./cover.jpg)
135	![插图](../images/chart.png)
136	![示例](images/demo.jpg)
137	```
138
139	### 正确的图片处理流程
140	1. 先生成图片文件并保存到临时目录
141	2. 调用 `upload_media.py` 上传到微信获取 media_id
142	3. 使用占位符或说明文字，不要直接插入本地路径
143
144	✅ 正确示例：
145	```markdown
146	<!-- 步骤1：生成图片 -->
147	<!-- 步骤2：上传图片 -->
148	python scripts/upload_media.py /path/to/cover.jpg thumb
149
150	<!-- 步骤3：记录 media_id，在创建草稿时使用 -->
151	<!-- 正文中不插入相对路径 -->
152	```
153
154	### 原因说明
155	- 相对路径在预览和发布时无法正常显示
156	- 微信公众号要求先上传图片获取 media_id
157	- 已有的工作流（上传图片→创建草稿）是正确的
158
159	## 关键注意事项
160	1. 作者名限制：最长8个中文字符
161	2. 图片有效期：封面图永久，正文图3天
162	3. 图片路径：禁止使用相对路径（见上方图片路径规范）
163	4. HTML要求：使用简单标签（p/h1-h3/ul/li/img/a），避免复杂CSS
164	5. 发布审核：发布后需微信审核才能展示
165	6. 调用频率：上传1000次/天，创建草稿100次/天，发布10次/天

People who liked this also viewed

6 picks

Type

find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 20262.6M27k
grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026633k182k
vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026573k29k
improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026522k182k
setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026454k182k
triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026424k182k

good-mp-post

9installs43forks

View on GitHub

How to install good-mp-post?

imgoodbai/goodable/good-mp-post

$npx -y skills add ImGoodBai/goodable --skill good-mp-post

Installs into the current project.

Summary

微信公众号文章发布完整流程管理，包括AI辅助创作、图片生成、排版和发布。

Files · 1

View on GitHub

SKILL.md

1	# Good 公众号发布
2
3	## 任务目标
4	通过AI辅助完成微信公众号文章的创作、排版和发布全流程。
5
6	能力：文章创作、图片生成与上传、草稿创建、文章发布
7
8	触发：用户需要创建或发布微信公众号文章
9
10	## 使用模式
11
12	### 模式1：Web UI (推荐)
13	可视化界面，支持文章管理、在线编辑和发布：
14
15	```bash
16	# 安装依赖
17	pip install -r requirements.txt
18
19	# 启动服务（默认端口8000）
20	uvicorn app.main:app --reload
21
22	# 浏览器访问
23	http://localhost:8000
24	```
25
26	功能：
27	- 文章CRUD操作（创建、查看、编辑、删除）
28	- Markdown内容编辑
29	- 数据库持久化（SQLite）
30	- 直接发布到微信公众号
31	- 发布历史记录
32
33	### 模式2：脚本 (命令行)
34	适合自动化场景，与Web UI共享数据库：
35
36	```bash
37	# 上传图片
38	python scripts/upload_media.py /path/to/image.jpg thumb
39
40	# 创建草稿
41	python scripts/create_draft.py --title "标题" --content "内容"
42
43	# 发布文章
44	python scripts/publish_article.py --media_id <草稿ID>
45	```
46
47	数据互通：脚本发布的文章会自动记录到数据库，Web UI可查看和管理。
48
49	## 前置准备
50	依赖： requests>=2.28.0, python-dotenv>=1.0.0, fastapi>=0.104.1, sqlalchemy>=2.0.35
51
52	凭证配置：
53	- 在 .env 文件配置 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET`
54	- 获取方式：微信公众平台 → 开发 → 基本配置
55	- 需配置IP白名单
56
57	数据库：自动创建 SQLite 数据库（data/articles.db），无需手动配置
58
59	## 标准流程（Web UI）
60
61	### 1. 启动服务
62	```bash
63	cd skills/good-mp-post
64	uvicorn app.main:app --reload
65	```
66
67	### 2. 创建文章
68	- 打开 http://localhost:8000
69	- 填写标题、作者、摘要
70	- 编写 Markdown 内容
71	- 保存草稿
72
73	### 3. 发布文章
74	- 在文章列表点击"发布"按钮
75	- 自动处理封面图上传、草稿创建、发布流程
76	- 查看发布状态
77
78	## 脚本流程（命令行）
79
80	### 1. 创作文章内容
81	- 根据用户需求创作文章（Markdown格式）
82	- 参考 `assets/templates/article-template.md` 了解格式建议
83
84	### 2. 生成图片
85	- 生成封面图（建议 900×383px，<5MB）
86	- 生成插图（宽度≤900px）
87
88	### 3. 上传图片
89	调用 `scripts/upload_media.py`:
90	```bash
91	python scripts/upload_media.py /path/to/cover.jpg thumb # 封面图
92	python scripts/upload_media.py /path/to/image.png image # 正文图
93	```
94
95	### 4. 创建草稿
96	调用 `scripts/create_draft.py`:
97	```bash
98	python scripts/create_draft.py \
99	--title "文章标题" \
100	--author "作者名" \
101	--thumb_media_id <封面图ID> \
102	--content "<p>HTML正文</p>" \
103	--media_ids '[]'
104	```
105
106	注意：作者名最长8个中文字符
107
108	### 5. 发布文章
109	调用 `scripts/publish_article.py`:
110	```bash
111	python scripts/publish_article.py --media_id <草稿ID>
112	```
113
114	## 资源索引
115	- `app/main.py` - FastAPI 主应用入口
116	- `app/api/articles.py` - 文章管理 API
117	- `app/api/images.py` - 图片上传 API
118	- `app/database.py` - 数据库模型和连接
119	- `app/static/index.html` - Web UI 界面
120	- `scripts/upload_media.py` - 上传图片到素材库
121	- `scripts/create_draft.py` - 创建图文草稿
122	- `scripts/publish_article.py` - 发布草稿
123	- `scripts/db_logger.py` - 数据库日志记录（可选）
124	- `references/api-guide.md` - API详细说明
125	- `assets/templates/article-template.md` - 文章格式模板
126
127	## 图片路径规范（重要）
128
129	AI生成文章时必须遵循以下规范：
130
131	### 禁止使用相对路径
132	❌ 错误示例：
133	```markdown
134	![封面](./cover.jpg)
135	![插图](../images/chart.png)
136	![示例](images/demo.jpg)
137	```
138
139	### 正确的图片处理流程
140	1. 先生成图片文件并保存到临时目录
141	2. 调用 `upload_media.py` 上传到微信获取 media_id
142	3. 使用占位符或说明文字，不要直接插入本地路径
143
144	✅ 正确示例：
145	```markdown
146	<!-- 步骤1：生成图片 -->
147	<!-- 步骤2：上传图片 -->
148	python scripts/upload_media.py /path/to/cover.jpg thumb
149
150	<!-- 步骤3：记录 media_id，在创建草稿时使用 -->
151	<!-- 正文中不插入相对路径 -->
152	```
153
154	### 原因说明
155	- 相对路径在预览和发布时无法正常显示
156	- 微信公众号要求先上传图片获取 media_id
157	- 已有的工作流（上传图片→创建草稿）是正确的
158
159	## 关键注意事项
160	1. 作者名限制：最长8个中文字符
161	2. 图片有效期：封面图永久，正文图3天
162	3. 图片路径：禁止使用相对路径（见上方图片路径规范）
163	4. HTML要求：使用简单标签（p/h1-h3/ul/li/img/a），避免复杂CSS
164	5. 发布审核：发布后需微信审核才能展示
165	6. 调用频率：上传1000次/天，创建草稿100次/天，发布10次/天

People who liked this also viewed

6 picks

Type