Ubuntu
159 lines
4.7 KiB
Markdown
159 lines
4.7 KiB
Markdown
# baoyu-post-to-wechat 快速使用指南
|
||
|
||
## 🚀 一句话总结
|
||
|
||
**baoyu-post-to-wechat 现在支持通过 WeWrite 的豆包Seedream API 自动生成文章配图！**
|
||
|
||
## 📋 核心功能对比
|
||
|
||
| 版本 | 主要功能 | 推荐场景 |
|
||
|------|----------|----------|
|
||
| **baoyu_optimized.py** (v2.0) | Frontmatter支持 + 图片优化 + 智能摘要 | 常规发布，已有图片 |
|
||
| **baoyu_with_image_gen.py** (v3.0) | AI图片生成 + 自动配图 + 封面生成 | 需要自动生成配图 |
|
||
| **baoyu_enhanced.py** (v1.5) | 图文混排 + 多图上传 | 兼容旧版本 |
|
||
| **baoyu_publish.py** (v1.0) | 基础发布功能 | 最小依赖 |
|
||
|
||
## 🎨 AI图片生成功能
|
||
|
||
### **已配置的API**
|
||
- **提供商**: 豆包Seedream 4.5 (Volcengine Ark)
|
||
- **API Key**: `83a29955-c633-449f-97f1-f49b62295cf6`
|
||
- **模型**: `doubao-seedream-4-5-251128`
|
||
- **来源**: WeWrite 配置 (`/home/ubuntu/wewrite/config.yaml`)
|
||
|
||
### **支持的图片尺寸**
|
||
- **封面图**: 2952×1256 (2.35:1，微信封面比例)
|
||
- **文章配图**: 2560×1440 (16:9，横版内文配图)
|
||
- **竖版配图**: 1088×2560 (9:16，竖版)
|
||
- **方形配图**: 2048×2048 (1:1，方形)
|
||
|
||
## 📝 使用示例
|
||
|
||
### **1. 基础发布（推荐）**
|
||
```bash
|
||
cd /home/ubuntu/.nanobot/workspace/skills/baoyu-post-to-wechat
|
||
|
||
# 发布带Frontmatter的文章
|
||
python3 baoyu_optimized.py markdown 文章.md
|
||
|
||
# 指定标题和作者
|
||
python3 baoyu_optimized.py markdown 文章.md --title "自定义标题" --author "作者名"
|
||
|
||
# 指定封面图
|
||
python3 baoyu_optimized.py markdown 文章.md --cover 封面.jpg
|
||
```
|
||
|
||
### **2. AI自动生成配图**
|
||
```bash
|
||
# 自动生成封面图和章节配图
|
||
python3 baoyu_with_image_gen.py markdown 文章.md --generate-images
|
||
|
||
# 同时指定标题
|
||
python3 baoyu_with_image_gen.py markdown 文章.md --title "AI技术文章" --generate-images
|
||
```
|
||
|
||
### **3. 测试环境和配置**
|
||
```bash
|
||
# 测试所有功能
|
||
python3 baoyu_with_image_gen.py test
|
||
|
||
# 测试图片生成
|
||
python3 test_image_gen.py
|
||
```
|
||
|
||
## 📄 Frontmatter格式
|
||
|
||
### **标准格式**
|
||
```yaml
|
||
---
|
||
title: "文章标题"
|
||
author: "作者名"
|
||
date: 2026-04-03
|
||
tags: [标签1, 标签2, 标签3]
|
||
summary: "文章摘要，不超过120字"
|
||
---
|
||
```
|
||
|
||
### **优先级规则**
|
||
1. **标题**: 命令行参数 > frontmatter > 正文提取 > 文件名
|
||
2. **作者**: 命令行参数 > frontmatter > 配置默认
|
||
3. **摘要**: frontmatter.summary > 自动提取
|
||
|
||
## 🖼️ 图片处理流程
|
||
|
||
### **本地图片**
|
||
1. **提取**: 从 `` 提取本地图片
|
||
2. **优化**: 自动调整尺寸、压缩质量
|
||
3. **上传**: 批量上传到微信素材库
|
||
4. **替换**: 替换为微信图片引用格式
|
||
|
||
### **AI生成图片**
|
||
1. **封面图**: 根据文章标题自动生成
|
||
2. **章节配图**: 为每个二级/三级标题生成配图
|
||
3. **保存**: 生成图片保存到临时目录
|
||
4. **上传**: 自动上传到微信
|
||
|
||
## ⚡ 性能提示
|
||
|
||
### **图片生成时间**
|
||
- **封面图**: 约30-45秒
|
||
- **章节配图**: 每张约30-60秒
|
||
- **建议**: 文章章节不超过5个，否则生成时间较长
|
||
|
||
### **图片优化**
|
||
- **尺寸限制**: 宽度超过2560px自动缩小
|
||
- **大小限制**: 超过1MB自动压缩
|
||
- **格式转换**: 自动转换WebP/GIF等格式为JPEG
|
||
|
||
## 🔧 故障排除
|
||
|
||
### **常见问题**
|
||
1. **图片生成失败**: 检查网络连接，API Key是否有效
|
||
2. **上传失败**: 检查微信API凭证，access_token是否过期
|
||
3. **Frontmatter解析错误**: 检查YAML格式，注意缩进
|
||
4. **图片太大**: 自动压缩，如仍失败手动压缩
|
||
|
||
### **调试命令**
|
||
```bash
|
||
# 测试图片生成
|
||
python3 test_image_gen.py
|
||
|
||
# 测试微信API
|
||
python3 baoyu_optimized.py test
|
||
|
||
# 查看配置
|
||
cat /home/ubuntu/wewrite/config.yaml | grep -A5 "image:"
|
||
```
|
||
|
||
## 📚 相关文件
|
||
|
||
### **配置文件**
|
||
- **WeWrite配置**: `/home/ubuntu/wewrite/config.yaml`
|
||
- **技能配置**: `EXTEND.md`
|
||
- **默认封面**: `/home/ubuntu/default_cover.png`
|
||
|
||
### **脚本文件**
|
||
- **优化版**: `baoyu_optimized.py` (推荐)
|
||
- **AI生成版**: `baoyu_with_image_gen.py`
|
||
- **增强版**: `baoyu_enhanced.py`
|
||
- **基础版**: `baoyu_publish.py`
|
||
|
||
## 🎯 最佳实践
|
||
|
||
### **工作流程**
|
||
1. **写作**: 用Markdown写作，添加Frontmatter
|
||
2. **配图**: 准备本地图片 **或** 使用AI生成
|
||
3. **测试**: 先用 `--generate-images` 测试配图效果
|
||
4. **发布**: 正式发布到公众号草稿箱
|
||
|
||
### **图片建议**
|
||
- **封面图**: 使用 `--generate-images` 自动生成
|
||
- **章节配图**: 每个主要章节配一张图
|
||
- **本地图片**: 使用绝对路径，确保文件存在
|
||
- **图片数量**: 建议3-5张，太多影响加载速度
|
||
|
||
---
|
||
|
||
**更新**: 2026-04-03
|
||
**状态**: ✅ 图片生成功能已集成并测试通过
|
||
**API**: 豆包Seedream 4.5 (WeWrite配置) |