Files
nanocode/skills/baoyu-post-to-wechat/SKILL.md
T
2026-07-08 16:00:02 +08:00

324 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: baoyu-post-to-wechat
description: |
微信公众号发布工具(增强版),支持图文混排、多图上传、HTML内容、AI图片生成。
与WeWrite使用相同的账号配置,但专注于发布功能。
触发关键词:宝玉公众号发布、baoyu-post、微信API发布、宝玉发布、图文混排、AI配图
不应与WeWrite冲突,使用更具体的触发词。
version: 4.0.0
---
# baoyu-post-to-wechat 增强版 v4.0
## 🎯 功能亮点
### **公众号 + 博客双平台同步(v4.0 NEW)**
- ✅ **一处发布,多处同步**:发布公众号时自动同步到个人博客
- ✅ **图片自动转存**:本地图片自动复制到博客服务器 uploads 目录
- ✅ **独立支线设计**:博客同步失败不影响公众号发布,反之亦然
- ✅ **无感同步**:用户操作不变,自动完成博客同步
- ✅ **后台可调整**:同步的文章默认无分类,可在博客后台手动设置
- 📍 **博客地址**:http://129.211.173.87:8888/
### **图文混排支持**
- ✅ **自动图片上传**:Markdown中的本地图片自动上传到微信
- ✅ **图片引用替换**:`![描述](图片路径)` → 微信图片引用
- ✅ **多图批量上传**:支持批量上传多张图片
- ✅ **HTML内容支持**:支持完整的HTML文章格式
### **AI图片生成**
- ✅ **豆包Seedream集成**:使用WeWrite的图片生成API
- ✅ **自动封面生成**:根据文章标题自动生成封面图
- ✅ **章节配图生成**:为每个章节自动生成配图
- ✅ **图片优化**:自动调整尺寸、压缩质量
### **与 WeWrite 完全兼容**
- **相同账号**:`wx5716fcd6b95dfa05` / `92efe881efd50dbbf04bbb54197e8a6a`
- **相同作者**:蔡贤明
- **配置共享**:使用 WeWrite 的微信API凭证
- **图片API共享**:使用 WeWrite 的豆包Seedream图片生成API
### **智能内容处理**
- **Markdown转HTML**:智能转换标题、列表、引用等
- **图片自动处理**:本地图片自动上传并替换引用
- **摘要生成**:自动生成符合微信要求的摘要
- **Frontmatter支持**:支持YAML frontmatter解析(标题、作者、标签等)
## 🚀 使用方式
### **命令行使用**
```bash
# 发布Markdown文章(支持图文混排)
python3 baoyu_optimized.py markdown <markdown文件> [--title "标题"] [--author "作者"] [--cover "封面图"]
# 发布Markdown文章(自动生成配图)
python3 baoyu_with_image_gen.py markdown <markdown文件> --generate-images
# 发布HTML文章
python3 baoyu_optimized.py html <html文件> [--title "标题"] [--author "作者"] [--cover "封面图"]
# 测试配置
python3 baoyu_optimized.py test
# 示例
python3 baoyu_optimized.py markdown article.md --title "我的文章" --author "蔡贤明"
```
### **在nanobot中使用**
当用户说以下关键词时触发:
- "宝玉公众号发布"
- "baoyu-post"
- "微信API发布"
- "宝玉发布"
- "图文混排发布"
- "AI配图"
- "自动生成配图"
## 📝 图文混排示例
### **Markdown文件示例**
```markdown
# 我的旅行日记
![旅行照片1](/home/ubuntu/photos/trip1.jpg)
*这是我在巴黎拍的第一张照片*
## 第一天:抵达巴黎
今天天气很好,埃菲尔铁塔特别美。
![埃菲尔铁塔](/home/ubuntu/photos/eiffel.jpg)
*埃菲尔铁塔夜景*
### 美食推荐
- 法式面包
- 红酒炖牛肉
- 马卡龙
![美食](/home/ubuntu/photos/food.jpg)
*美味的法国大餐*
```
### **发布流程**
1. 自动提取 `/home/ubuntu/photos/trip1.jpg`、`eiffel.jpg`、`food.jpg`
2. 批量上传到微信素材库
3. 替换为微信图片引用格式
4. 转换为HTML并发布
## ⚙️ 配置说明
配置文件:`/home/ubuntu/.nanobot/workspace/skills/baoyu-post-to-wechat/EXTEND.md`
```yaml
# 微信账号配置(与 WeWrite 相同)
app_id: wx5716fcd6b95dfa05
app_secret: 92efe881efd50dbbf04bbb54197e8a6a
default_author: 蔡贤明
# 发布设置
default_publish_method: api
default_theme: default
default_color: blue
# 评论设置
need_open_comment: 1
only_fans_can_comment: 0
# 图片设置
default_cover_image: /home/ubuntu/default_cover.png
```
## 📊 与 WeWrite 的对比
| 特性 | WeWrite | baoyu-post-to-wechat(增强版) |
|------|---------|-------------------------------|
| **触发词** | 公众号、推文、微信文章 | 宝玉公众号发布、baoyu-post、图文混排、AI配图 |
| **功能定位** | 全流程创作 | 专业发布工具 |
| **图文混排** | ✓ 支持 | ✅ **增强支持**(自动上传+替换) |
| **图片处理** | ✓ AI生成 | ✅ **批量上传** + 自动替换 + **AI生成** |
| **内容格式** | ✓ Markdown/HTML | ✅ **Markdown+HTML** + 智能转换 + **Frontmatter** |
| **博客同步** | ✗ 不支持 | ✅ **自动同步**(v4.0新增) |
| **使用场景** | 从零创作 | 发布现有内容(特别是图文内容) |
## 📁 文件结构
```
baoyu-post-to-wechat/
├── SKILL.md # 技能说明文档
├── EXTEND.md # 配置文件
├── blog_sync.py # 🆕 博客同步模块(v4.0)
├── baoyu_publish.py # 简化版发布脚本(v1.0)
├── baoyu_enhanced.py # 增强版发布脚本(v1.5)
├── baoyu_optimized.py # 优化版发布脚本(v2.0,含博客同步)
└── baoyu_with_image_gen.py # 图片生成增强版(v3.0)
```
## 🔧 技术特性
### **图片处理流程**
1. **提取**:从Markdown中提取 `![alt](path)` 格式的图片
2. **过滤**:只处理本地文件,跳过网络图片
3. **上传**:批量上传到微信素材库
4. **替换**:替换为微信图片引用格式
5. **优化**:自动调整尺寸、压缩质量(使用Pillow)
6. **生成**:可选AI生成封面图和章节配图(使用豆包Seedream)
### **Markdown转HTML**
- 标题:`#` → `<h1>`, `##` → `<h2>`
- 列表:`- item` → `<li>item</li>`
- 粗体/斜体:`**bold**` → `<strong>bold</strong>`
- 引用:`> quote` → `<blockquote>quote</blockquote>`
- 代码块:```code``` → `<pre><code>code</code></pre>`
- **Frontmatter解析**:支持YAML frontmatter(标题、作者、标签、摘要等)
### **错误处理**
- 图片上传失败:跳过该图片,继续处理
- 网络错误:重试机制
- API错误:详细错误信息
## 🧪 测试示例
### **测试图文混排**
```bash
# 创建测试文件
cat > /home/ubuntu/test_article_with_images.md << 'EOF'
# 测试图文混排文章
这是一篇测试文章,包含多张图片。
![测试图片1](/home/ubuntu/default_cover.png)
*这是第一张测试图片*
## 二级标题
更多内容...
![测试图片2](/home/ubuntu/default_cover.png)
*这是第二张测试图片*
### 列表示例
- 项目1
- 项目2
- 项目3
EOF
# 发布测试
cd /home/ubuntu/.nanobot/workspace/skills/baoyu-post-to-wechat
python3 baoyu_optimized.py markdown /home/ubuntu/test_article_with_images.md --title "图文测试" --author "蔡贤明"
```
### **测试AI图片生成**
```bash
# 创建带Frontmatter的测试文件
cat > /home/ubuntu/test_ai_images.md << 'EOF'
---
title: "AI技术发展趋势"
author: "蔡贤明"
tags: [AI, 技术, 未来]
summary: "探讨AI技术的发展趋势和未来展望"
---
# AI技术发展趋势
## 大模型技术
大模型将继续发展...
## 多模态AI
多模态AI将成为主流...
## 边缘计算
边缘AI将更加普及...
EOF
# 发布并自动生成配图
cd /home/ubuntu/.nanobot/workspace/skills/baoyu-post-to-wechat
python3 baoyu_with_image_gen.py markdown /home/ubuntu/test_ai_images.md --generate-images
```
## 🎯 使用建议
### **使用 WeWrite**
- 需要从热点开始创作
- 需要AI生成内容和图片
- 完整的创作流程
### **使用 baoyu-post-to-wechat(增强版)**
- 已有图文混排的Markdown内容
- 需要批量上传多张图片
- 快速发布现有内容
- 特别是旅行日记、产品介绍、教程等图文内容
- **需要AI自动生成配图**:使用 `--generate-images` 参数
### **最佳实践**
1. **创作**:用 WeWrite 创作文章框架
2. **配图**:准备本地图片文件 **或** 使用AI自动生成
3. **排版**:在Markdown中插入图片引用,添加Frontmatter
4. **发布**:用 baoyu-post-to-wechat 一键发布
### **版本选择指南**
- **基础发布**:`baoyu_optimized.py`(推荐,支持Frontmatter+图片优化)
- **AI配图**:`baoyu_with_image_gen.py`(需要自动生成配图)
- **简单发布**:`baoyu_enhanced.py`(兼容旧版本)
- **最小依赖**:`baoyu_publish.py`(仅核心功能)
## ⚠️ 注意事项
1. **图片路径**:使用绝对路径或相对于当前目录的路径
2. **图片格式**:支持 JPG、PNG、GIF 等常见格式
3. **图片大小**:微信有大小限制,大图片会自动压缩
4. **网络要求**:需要能访问微信API服务器
5. **凭证安全**:API凭证已加密存储
6. **AI图片生成**:使用豆包Seedream API,需要网络连接,生成时间约30-60秒/张
7. **Frontmatter格式**:使用标准YAML格式,注意缩进
8. **API 48001 限制**:微信API仅支持创建草稿,不支持自动发布。所有公众号文章需在微信后台手动发布。博客同步不受此限制。
---
**版本**: 4.0.0 (博客同步版)
**更新**: 2026-04-06
**功能**: 图文混排 + 多图上传 + HTML支持 + AI图片生成 + Frontmatter支持 + **博客自动同步**
---
## 🔄 博客同步工作原理
### 同步流程
```
用户执行:发布Markdown到公众号
↓
1. 读取本地 Markdown + 图片
↓
2. 【博客同步支线】
├── 复制图片到博客 uploads/ 目录
├── 生成缩略图
├── 替换 Markdown 中的图片路径
└── 创建博客文章(已发布状态,无分类)
↓
3. 【公众号发布支线】(独立执行,互不阻塞)
├── 上传图片到微信素材库
├── 创建公众号草稿
└── 返回发布结果
↓
4. 结束(两处都有文章)
```
### 同步特性
| 特性 | 说明 |
|------|------|
| **图片处理** | 本地图片 → 复制到博客 uploads/ 目录,自动生成缩略图 |
| **分类处理** | 默认无分类,可在博客后台 `/admin/posts` 手动设置 |
| **重复文章** | 每次发布都会创建新文章,重复可手动删除 |
| **失败处理** | 博客同步失败不影响公众号发布,反之亦然 |
| **URL 访问** | 同步后可立即访问 `http://129.211.173.87:8888/post/{slug}` |
### 依赖与已知问题
- **博客同步依赖**:blog_sync.py 需要 `sqlalchemy` 模块。如果缺失(Python 3.12 环境),博客同步会失败,但不影响公众号发布。
### 博客管理
- **后台地址**:http://129.211.173.87:8888/admin
- **文章管理**:http://129.211.173.87:8888/admin/posts
- **默认账号**:`admin` / `abcd1234`
- **图片管理**:http://129.211.173.87:8888/admin/images