菜单
微信公众号文章自动创作与发布工具。给定参考文章、文字或文档，自动搜索整理全网相关信息，使用 baoyu-infographic 生成手绘风格配图，生成图文并茂的公众号文章，并发布到微信公众号草稿箱。 触发场景（只要沾边就该使用本skill）： - 用户提到"公众号"、"微信文章"、"推文"、"公号"、"发文"、"mp"等关键词 - 用户要求写文章并发布到微信 - 用户提供参考素材并希望生成公众号内容 - 用户希望把文档/笔记转为微信公众号文章 - 用户要求搜索某个话题并写成公众号文章 - 用户提到"草稿箱"、"群发"等微信公众号相关操作 - 用户要求写一篇适合在微信上传播的文章
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | wechat-publisher |
| description | 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档，自动搜索整理全网相关信息，使用 baoyu-infographic 生成手绘风格配图，生成图文并茂的公众号文章，并发布到微信公众号草稿箱。 触发场景（只要沾边就该使用本skill）： - 用户提到"公众号"、"微信文章"、"推文"、"公号"、"发文"、"mp"等关键词 - 用户要求写文章并发布到微信 - 用户提供参考素材并希望生成公众号内容 - 用户希望把文档/笔记转为微信公众号文章 - 用户要求搜索某个话题并写成公众号文章 - 用户提到"草稿箱"、"群发"等微信公众号相关操作 - 用户要求写一篇适合在微信上传播的文章 |
本skill实现从素材输入到公众号草稿箱的完整自动化流程。核心价值在于：用户只需要提供一个话题或几篇参考资料，skill就能自动完成搜索调研、撰写文章、生成配图、排版美化、上传发布的全部环节。
默认作者：会飞的猪猪侠（除非用户另行指定）
在开始任何工作之前，先检查环境是否就绪：
第一步：检查账号配置
支持两种配置方式：
方式一：accounts.yaml 多账号配置（推荐）
在工作目录下创建 accounts.yaml（参考 accounts.yaml.example）：
default: main # 默认账号
accounts:
main:
name: "我的主公众号"
app_id: "wx1234567890abcdef"
app_secret: "your_app_secret_here"
author: "会飞的猪猪侠"
tech:
name: "技术博客号"
app_id: "wx0987654321fedcba"
app_secret: "another_app_secret"
author: "技术团队"
使用时通过 --account 指定账号：
python3 scripts/publish.py --account tech --html article.html --cover cover.jpg --title "标题"
python3 scripts/image_handler.py --account tech upload image.png
不指定 --account 时使用 default 指定的账号。作者名自动从账号配置中获取。
查看已配置的账号：
python3 scripts/wechat_api.py list-accounts
方式二：.env 单账号配置（向后兼容）
在工作目录（或skill目录、用户主目录）下查找 .env 文件，确认包含：
WECHAT_APP_ID=你的公众号AppID
WECHAT_APP_SECRET=你的公众号AppSecret
如果用户未配置，告知用户需要：
curl ifconfig.me 查询）.env 文件或 accounts.yaml第二步：验证API连接
cd <skill-path>/scripts && python3 -c "from wechat_api import get_access_token; print('API连接正常:', get_access_token()[:10]+'...')"
如果报错 40164，说明IP白名单未配置。如果报错 40001/40002，说明AppID或AppSecret不正确。
第三步：安装依赖
脚本仅依赖 requests 库：
pip install requests --break-system-packages 2>/dev/null || pip install requests
拿到用户的需求后，按以下6个阶段依次推进。每个阶段完成后简要告知用户进度。
目标：搞清楚用户到底想要什么样的文章。
分析用户输入：
提炼写作方向：从素材中提取3-5个核心关键词，形成写作大纲的雏形
这个阶段要快，不要过度确认。如果用户的意图已经很清楚（比如"帮我写一篇关于XXX的公众号文章"），直接进入下一阶段。
目标：围绕主题收集足够多的高质量素材，让文章有深度、有料。
多轮搜索（使用WebSearch工具）：
信息筛选：
形成写作提纲：将素材按逻辑分组，规划文章结构（标题→引言→正文2-4节→总结）
搜索时注意：每次搜索用不同的关键词组合，避免信息同质化。如果某个方向搜索结果不理想，灵活调整关键词。
目标：写出一篇适合微信公众号传播的高质量文章。
文章结构模板（Markdown格式）：
注意：Markdown 中的第一个 # 标题 会被 html_converter 自动跳过（不输出到正文HTML中），因为微信公众号会在文章顶部自动显示标题，正文中重复标题会冗余。标题仅用于 publish.py --title 参数和文件内部标记。
# 标题（抓眼球，15-25字为佳）
> 摘要引言（1-2句话概括核心观点，会显示在分享卡片中）
## 开篇引入
（用故事、数据或热点事件，3-5行内抓住读者注意力）
## 正文小节一：XXX
（展开第一个论点，配合数据/案例，深入分析）
## 正文小节二：XXX
（展开第二个论点，补充不同角度的论据）
## 正文小节三：XXX
（展开第三个论点，加入实操建议或案例故事）
## 正文小节四：XXX（可选）
（如果话题足够丰富，可以展开第四个甚至第五个小节）
## 正文小节五：XXX（可选）
（延伸讨论、未来展望、行业影响等）
## 写在最后
（不要简单总结，给出有力的收束观点、行动建议或开放问题。可加互动引导语。）
文章规模指南：
整体调性：专业但不学术，通俗但不肤浅，有观点但不偏激。让读者觉得"这个作者懂行，而且说人话"。
具体要求：
要避免的"AI味"写法：
关于图片：在写文章时，先用占位符描述需要什么图片，格式为 。后续阶段再替换为真实图片。
目标：为文章生成与主题相关的高质量手绘风格配图。
优先使用 baoyu-danger-gemini-web skill 生成配图：
这是首选的配图方案。通过 gemini-web 可以根据文字描述生成精美的手绘/信息图风格图片，风格统一、与文章内容高度相关。
规划配图内容：根据文章中每个  的位置和上下文，确定每张配图应该表达的核心信息。一篇完整文章通常需要 6-10张配图，类型可以包括：
调用 baoyu-danger-gemini-web 生成图片（首选方案）：
run_in_background），提高效率Skill("baoyu-infographic") 生成更复杂的信息图，适合需要结构化展示数据的场景配图风格规范（默认风格：手绘信息图）：
所有配图必须保持统一的视觉风格。以下是经过验证的默认风格 prompt 模板：
Generate a hand-drawn sketch style infographic in Chinese.
Theme: [具体主题].
[具体内容描述：展示什么元素、什么布局、什么标注文字].
Use blue (#4a6cf7) as accent color on white background.
Style: clean hand-drawn lines, minimalist, tech-illustration feel.
风格要点：
#4a6cf7 作为强调色，与文章排版主题色一致#ff8c42 等对比色，但整体不超过2-3种颜色不同类型配图的 prompt 侧重点：
下载并上传到微信：将生成的图片上传到微信服务器获取CDN链接
python3 scripts/image_handler.py upload /path/to/generated_image.png
替换Markdown中的图片链接：将 placeholder 替换为微信CDN返回的URL
备选方案：使用外部图片
如果 baoyu-infographic 不可用或不适合当前场景，可以退回到搜索免费图片：
python3 scripts/image_handler.py download "图片URL" -d /tmp/wechat_imagespython3 scripts/image_handler.py upload /tmp/wechat_images/图片文件名自动批量处理：如果文章中的图片链接已经是真实URL（而非placeholder），可以一步到位：
python3 scripts/image_handler.py process article.md -o article_processed.md
封面图：从文章图片中选一张最有视觉冲击力的作为封面，或使用 baoyu-infographic 单独生成。封面图建议尺寸：900×383像素（2.35:1比例），这是微信公众号的推荐比例。
目标：将Markdown转换为微信兼容的精美HTML。
为什么需要特殊转换：微信公众号编辑器有许多限制——不支持外部CSS/JS、不支持class属性、所有样式必须内联到每个标签的style属性中。普通的Markdown转HTML工具生成的代码在微信中会显示为纯文本。
执行转换：
python3 scripts/html_converter.py article_processed.md -o article.html
转换器会自动：
排版风格说明：
自定义样式：样式配置在 assets/style_config.json，可以修改颜色、字号、间距等。如果用户要求不同的配色，可以直接编辑这个JSON文件。
检查HTML：转换后可以检查HTML文件，确保没有异常。常见问题：
mmbiz.qpic.cn 开头的微信CDN链接目标：将完成的文章上传到微信公众号草稿箱。
一键发布：
python3 scripts/publish.py \
--input article.md \
--cover /tmp/wechat_images/cover.jpg \
--title "文章标题" \
--digest "120字以内的摘要"
默认作者为"会飞的猪猪侠"，无需额外指定。如需自定义作者，添加 --author "其他作者" 参数。
publish.py 会自动完成：图片处理 → HTML转换 → 封面图上传 → 创建草稿
如果已有排版好的HTML：
python3 scripts/publish.py \
--html article.html \
--cover /tmp/wechat_images/cover.jpg \
--title "文章标题"
发布成功后：脚本会返回草稿的 media_id。告诉用户：
所有脚本位于 scripts/ 目录下：
| 脚本 | 用途 | 何时使用 |
|---|---|---|
wechat_api.py | 微信API封装（token、上传、草稿） | 需要直接调用API时 |
html_converter.py | Markdown→微信HTML转换 | 需要转换排版时 |
image_handler.py | 图片下载/上传/替换 | 需要处理图片时 |
publish.py | 完整发布流程（一键执行） | 最终发布时 |
详细API文档见 references/api_reference.md。
| 错误 | 原因 | 解决方法 |
|---|---|---|
40164 IP不在白名单 | 机器IP未加白名单 | 用 curl ifconfig.me 获取IP，添加到公众平台白名单 |
40001 access_token无效 | token过期或凭证错误 | 检查 .env 中的 AppID/AppSecret 是否正确 |
40009 图片大小超限 | 图片超过10MB | 压缩图片或换一张 |
48001 接口未授权 | 公众号类型不支持 | 需要认证的服务号或订阅号（已认证） |
| 图片下载失败 | 网络问题或URL无效 | 重新搜索图片或使用其他图片源 |
| HTML中图片不显示 | 未上传到微信CDN | 确保所有图片都通过 uploadimg 接口上传 |
--author 参数自定义