用途
canghe-post-to-wechat 用于将内容发布到微信公众号(WeChat Official Account)。它支持两种发布方式:通过微信公众号 API 发布,或通过 Chrome CDP(浏览器)发布。内容类型包括文章(文章)和图文(图文)短帖。
主要能力
- 文章发布:支持 HTML、Markdown 或纯文本输入,可通过 API 或浏览器方式发布。
- 图文发布:支持带多张图片的短帖,最多 9 张图片。
- Markdown 转 HTML:依赖 canghe-markdown-to-html 技能进行转换,支持 default、grace、simple 三种主题。
- 元数据校验:检查标题、摘要、作者、封面图等字段,缺失时可自动生成或提示补充。
- 评论控制:支持 need_open_comment(默认 1)和 only_fans_can_comment(默认 0)两个开关。
- 环境检查:提供 check-permissions.ts 脚本,检查 Chrome、Bun、剪贴板、API 凭证等环境项。
- 配置扩展:通过 EXTEND.md 设置默认主题、默认发布方式、默认作者、评论开关、Chrome 配置路径等。
使用方式
脚本目录以 SKILL_DIR 表示,脚本包括:
- scripts/wechat-browser.ts:图文发布
- scripts/wechat-article.ts:通过浏览器发布文章
- scripts/wechat-api.ts:通过 API 发布文章
- scripts/check-permissions.ts:验证环境与权限
环境检查(可选):
npx -y bun ${SKILL_DIR}/scripts/check-permissions.ts
图文发布示例:
npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --markdown article.md --images ./images/
npx -y bun ${SKILL_DIR}/scripts/wechat-browser.ts --title "标题" --content "内容" --image img.png --submit
文章发布(API):
npx -y bun ${SKILL_DIR}/scripts/wechat-api.ts <html_file> [--title <title>] [--summary <summary>] [--author <author>] [--cover <cover_path>]
文章发布(浏览器):
npx -y bun ${SKILL_DIR}/scripts/wechat-article.ts --html <html_file>
文章发布流程包含 7 个步骤:加载偏好(EXTEND.md)、确定输入类型、检查 markdown-to-html 技能、转换为 HTML、校验元数据、选择发布方式并配置凭证、发布到微信、报告完成。
EXTEND.md 配置查找优先级:项目级 .canghe-skills/canghe-post-to-wechat/EXTEND.md,然后用户级 $HOME/.canghe-skills/canghe-post-to-wechat/EXTEND.md。若未找到则运行首次设置。
EXTEND.md 支持的键(大小写不敏感,接受 1/0 或 true/false):
- default_author(默认空)
- need_open_comment(默认 1)
- only_fans_can_comment(默认 0)
- default_theme
- default_publish_method(api/browser)
- chrome_profile_path
值优先级:CLI 参数 > Frontmatter > EXTEND.md > 技能默认值。
API 凭证配置:在 .canghe-skills/.env 中设置 WECHAT_APP_ID 和 WECHAT_APP_SECRET。凭证可从 https://mp.weixin.qq.com 的「开发 → 基本配置」获取。
适用场景
- 需要将 Markdown 或 HTML 文章发布到微信公众号草稿箱。
- 需要发布带多张图片的图文短帖。
- 希望通过 API 快速发布,或通过浏览器方式发布。
- 需要统一管理默认作者、评论开关、主题等发布偏好。
限制
- 图文发布不支持纯文本输入、HTML 输入、主题、自动生成元数据、默认封面回退、评论控制,且需要 Chrome。
- 文章 API 方式需要 API 凭证,不需要 Chrome;浏览器方式需要 Chrome 和登录会话,速度较慢。
- Markdown 转换需要安装 markdown-to-html 技能(如 canghe-markdown-to-html),未安装时会提示安装。
- 文章类型为 news 时封面图必填,缺失时会停止并请求提供封面图。
- 环境检查项失败时需按对应指引修复(如安装 Chrome、Bun、xdotool 等)。
- 具体收费、价格、平台支持范围等资料暂未提供。