公众号自动化助手

解决的问题

微信公众号内容发布流程通常涉及多个独立步骤：从素材收集、文章撰写、配图处理，到将 Markdown 转换为符合微信平台要求的 HTML 格式、上传素材、创建草稿并最终归档。手动执行这些任务不仅耗时，还容易因格式错误（如图片链接失效、封面缺失）或凭证安全问题导致发布失败或数据泄露。该技能旨在将这些机械步骤自动化，让创作者更专注于内容本身。

工作原理

技能采用模块化设计，核心能力分为六个清晰的步骤，并通过 run_pipeline.py 脚本串联发布侧流程（步骤 3-6）。写作环节设计为可插拔，可与其它写作技能集成。

关键步骤详解：

1. 素材收集与整理：支持链接抓取、文本提炼和文档解析。使用 web_fetch 工具获取网页正文，或直接处理文本，提炼出 3-5 条核心干货。图片素材也会被筛选备用。
2. 文章撰写：此步骤由外部可插拔的写作技能完成。技能库中提供了如 wechat-article-writer（多种风格）或 laoluo-article-writer（强人设）等选项，或依据 references/writing-quality.md 中的质量标准（包括反翻译腔终检）自行撰写，产出 article.md。
3. 配图处理：公众号草稿强制要求封面图。技能会压缩封面（建议 ≤800KB）并上传至微信素材库以获取 thumb_media_id。正文配图（建议每 500 字 1 张）同样需要上传，获得微信内部 URL，因为草稿不支持外部图片链接。
4. Markdown 转微信 HTML：使用 markdown_to_wechat_doocs.py 脚本，支持 5 种预设主题（如 cyan 科技、orange 温暖）。转换后进行后处理，将正文中的图片标记替换为微信素材库 URL，并可追加品牌签名块。
5. 创建草稿：通过 create_draft.py 在公众号后台创建草稿。这是默认操作，不自动群发，需人工在公众号后台确认后再发布，保证了安全性。
6. 归档：将最终的文章 Markdown 和包含 media_id、thumb_media_id 等信息的元数据 JSON 文件存档至 articles/published/ 目录。

整个发布侧（步骤 3-6）可通过 run_pipeline.py 一键执行。配置通过 .env 文件或命令行参数提供 app_id 和 app_secret，优先级明确。

注意事项

• 图片规格：微信素材图片大小限制为 2MB，超限会导致 API 返回错误（如 40006）。封面图建议压缩至 ≤800KB。
• 图片链接：微信草稿正文不支持直接外链图片，必须使用通过素材上传获得的微信 URL。run_pipeline.py 的 --body-images 参数会自动处理上传和替换。
• 安全与凭证：AppSecret 是高危凭证，绝不应写入日志、文章或对话 prompt。推荐使用 .env 文件或环境变量进行管理。
• 发布控制：技能默认仅创建草稿，群发操作需要用户在公众号后台手动确认，这是关键的安全设计。
• 网络与配额：脚本内置网络重试机制（3 次指数退避），但需确保能稳定访问 api.weixin.qq.com。微信 API 有每日调用限额，超限需等待次日。