公众号推文生成与同步
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @techforgood/wechat-post-sync
技能介绍
要解决什么问题
把一篇写完的公众号文章真正送进草稿箱,中间有不少琐碎环节:排版成微信兼容的 HTML、生成或整理配图、处理 access_token 与 IP 白名单、对付公众平台的字段长度限制。任何一步卡住,都可能要手工重来。这个技能把上述环节串成一条可中断、可恢复的流水线。
核心能力与工作流程
触发方式很直接:说出"帮我做推文""推送至公号"这类指令即激活,用词不精确但意图是制作并发布公众号文章时同样激活。
- Step 0 凭证与 IP 检查:激活时并行检查本地凭证、用
get_ip.py检测公网 IP 并提示加入白名单。凭证存于~/.workbuddy/wechat_credentials.json,脚本自动设置chmod 600权限。 - Step 1 收集内容:支持 docx、纯文本或图片输入,读取后提取结构并和用户确认。
- Step 2-3 配图:可选 AI 生成(封面 1024x1536 竖版、内容图 1024x1024 方版、暖色调扁平插画)或用户上传,生成后用
crop_watermark.py裁掉底部 8% 去水印。 - Step 4 制作 HTML:移动端适配,最大宽度 640px,样式必须全部内联,图片用本地相对路径;引言块、信息卡片、编号列表、CTA 区域均有固定配色规范。
- Step 5 上传:预览确认后由
upload_draft.py推送草稿箱,成功后自动保存凭证。 - 断点恢复:每步都有确认点,随时可以说"继续""改标题""换账号""重新生成配图"。
错误处理内置:access_token 失效自动重试,40164 会自动重新检测 IP 并输出白名单配置步骤,标题超 64 字符自动截断,网络请求统一 30 秒超时加指数退避重试。
适用边界与注意事项
- 凭证为明文 JSON 存储,不要在公共环境使用。
- IP 白名单是硬性门槛,动态 IP 下每次激活都会重新检测,变动后需手动更新。
- HTML 超 20,000 字符只输出警告,需手动精简。
- 封面图走永久素材接口(jpg/png,<2MB),内容图走
uploadimg接口(<1MB)。 - 订阅号与服务号权限不同,遇到
48001需排查账号类型。 - AI 配图禁止文字水印,风格锁定暖色扁平插画,不适合写实或品牌定制视觉。
使用场景
- 技术公益团队要发布一篇活动复盘文章,需要把 docx 初稿排版成公众号图文并推入草稿箱
- 内容运营手里只有几段纯文本和截图,需要 AI 补全配图、裁掉水印后生成可预览的推文 HTML
- 公众号管理员换了网络环境后上传报 40164 错误,需要重新检测公网 IP 并更新白名单配置
- 开发者想把一篇长文适配微信字段限制(标题 64 字符、摘要 120 字符)并上传草稿箱
适合人员
- 技术公益团队的运营,要定期把项目进展整理成公众号文章并发布
- 公众号管理员,需要处理 IP 白名单变动导致的上传失败并更新凭证
- 内容创作者,手里只有零散文本和截图,希望快速生成配图并排版预览
- 负责推文交付的开发者,需要生成微信兼容的内联样式 HTML 并上传草稿箱