nanocode/skills/baoyu-post-to-wechat/QUICK_START.md

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. 基础发布（推荐）

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自动生成配图

# 自动生成封面图和章节配图
python3 baoyu_with_image_gen.py markdown 文章.md --generate-images

# 同时指定标题
python3 baoyu_with_image_gen.py markdown 文章.md --title "AI技术文章" --generate-images

3. 测试环境和配置

# 测试所有功能
python3 baoyu_with_image_gen.py test

# 测试图片生成
python3 test_image_gen.py

📄 Frontmatter格式

标准格式

---
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. 图片太大: 自动压缩，如仍失败手动压缩

调试命令

# 测试图片生成
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配置)