SuperAPI AI 工具集

post-to-wechat

办公与效率

查看项目

更新于 10-16 08:56

技能介绍

post-to-wechat 是一个面向微信公众号内容发布的技能,核心用途是把 Markdown 转换为适合微信公众号的 HTML,并可选地通过 Chrome CDP(Chrome DevTools Protocol)自动化 md2wechat 网页应用与微信公众号后台。

主要能力

  • Markdown 转微信公众号可用 HTML。
  • 通过 Chrome CDP 驱动网页应用,导出 HTML、复制富文本、选择主题。
  • 可选地打开微信公众号后台,填写元数据、粘贴正文并保存草稿。
  • 支持从 frontmatter 解析 title、author、summary、coverImage、featureImage、cover、image 等元数据,并允许通过命令行参数覆盖。

使用方式 该技能通过脚本 scripts/cdp_export.ts 执行,依赖 Node.js 24+(原生 TypeScript 执行)。默认网页应用为 https://wechat.reshub.vip,默认 CDP 地址为 http://127.0.0.1:9222。使用 --wechat 时需要已登录的微信公众号会话。

快速开始示例:

HTML 导出: node {baseDir}/scripts/cdp_export.ts
--markdown-file "article.md"
--app "https://wechat.reshub.vip/?theme=minimal"
--cdp "http://127.0.0.1:9222"
--action export-html

仅 CDP 复制: node {baseDir}/scripts/cdp_export.ts
--markdown-file "article.md"
--app "https://wechat.reshub.vip"
--cdp "http://127.0.0.1:9222"
--action copy-rich

CDP + 微信公众号后台: node {baseDir}/scripts/cdp_export.ts
--markdown-file "article.md"
--app "https://wechat.reshub.vip"
--cdp "http://127.0.0.1:9222"
--action copy-rich
--wechat

完整草稿示例: node {baseDir}/scripts/cdp_export.ts
--markdown-file "article.md"
--app "https://wechat.reshub.vip/?theme=default"
--cdp "http://127.0.0.1:9222"
--action copy-rich
--wechat
--title "测试标题"
--author "测试作者"
--summary "这是一段测试摘要。"
--cover "./cover.png"

常用参数包括:--markdown-file、--markdown、--theme、--app、--cdp、--launch-local、--wechat、--title、--author、--summary、--cover、--no-submit、--no-original、--copy-strategy selection。默认动作为 copy-rich,默认复制策略为点击“复制富文本”按钮,默认微信行为为保存草稿,默认标记原创,默认 --delay-scale 3、--jitter-ms 800。

主题选择 在应用 URL 后添加 ?theme=<name> 可预选主题,支持内置主题及本地保存的主题草稿。主题草稿的导入/导出格式与命名规则见 references/theme-lab.md。

适用场景

  • 需要把 Markdown 文章转换为微信公众号排版 HTML。
  • 需要复制富文本到微信公众号编辑器。
  • 需要自动化在微信公众号后台填写标题、作者、摘要、封面上传、原创声明并保存草稿。

限制与注意事项

  • 必须使用 Chrome CDP 进行浏览器自动化,不使用 agent-browser。
  • 默认使用“复制富文本”按钮路径,仅在明确要求或按钮失败时使用选择复制。
  • 除非用户明确要求本地开发或调试,否则不要启动本地 Web 服务器。
  • 使用 --wechat 需要已登录的微信公众号会话。
  • 需要 Chrome/Edge 开启远程调试,或允许 --launch-local 启动本地 Chrome。
  • 若脚本需要第三方包,应放在 {baseDir}/scripts/vendor/ 下并通过 file: 引用,保持依赖固定且最小化。
  • 执行后应报告实际完成情况:HTML 生成、富文本复制、微信草稿填写、封面上传、原创标记、草稿保存等。

参考资料

  • references/wechat-cdp.md:CDP 流程、选择器与原创声明步骤。
  • references/theme-lab.md:主题草稿导入/导出与 URL 选择规则。
  • references/troubleshooting.md:常见失败模式与修复。