baoyu-post-to-wechat

baoyu-post-to-wechat skill 概览

baoyu-post-to-wechat 能做什么

baoyu-post-to-wechat 是一个面向微信公众号发布的 skill，覆盖两类不同任务：长文发布和图文发布。它支持 Markdown、HTML 和纯文本输入，然后通过 WeChat API 或基于 Chrome CDP 的浏览器流程完成发布。对大多数用户来说，它真正的价值不只是抽象意义上的“发到微信”，而是把草稿内容整理成微信公众号真正能接受的格式，并尽量减少后续手动清理。

谁适合安装 baoyu-post-to-wechat

这个 skill 适合已经用 Markdown 起草内容、并且需要可重复执行的微信公众号发布流程的作者、运营人员，以及 AI 辅助内容工作流。如果你希望使用 frontmatter 自动提取标题 / 作者 / 摘要，处理图片，借助浏览器自动化，或者在纯 API 发布不够用时保留一个兜底路径，它会特别有用。相反，如果你只是偶尔在微信编辑器里手动发一次内容，直接用普通 prompt 往往更简单。

为什么它和通用 prompt 不一样

baoyu-post-to-wechat skill 提供的是可执行脚本，不只是操作说明。它的实际差异点主要在于：

• 通过 scripts/md-to-wechat.ts 实现 Markdown 到 WeChat HTML 的转换
• 通过 scripts/wechat-article.ts 和 scripts/wechat-browser.ts 区分文章流与图文流
• 同时支持 API 发布和浏览器发布两种方式
• 默认会把普通外链转换为文末引用，这一点非常贴近微信公众号的实际排版约束
• 通过 scripts/check-permissions.ts 检查 Chrome profile 和相关权限

采用前最该先确认什么

是否适配你的本地环境，是安装前最关键的判断点。这个 skill 依赖 bun 或 npx -y bun，需要可用的 Chrome/Chromium/Edge 安装，以及足够的本地浏览器访问能力来完成基于 CDP 的自动化。如果你的工作流不能使用本地浏览器 profile，或者根本不能运行浏览器自动化，请先确认这一限制，再决定是否值得投入时间做配置。

如何使用 baoyu-post-to-wechat skill

安装时先看哪些文件

准备进行 baoyu-post-to-wechat install 时，先进入 skills/baoyu-post-to-wechat，优先阅读：

• SKILL.md
• references/article-posting.md
• references/image-text-posting.md
• references/config/first-time-setup.md
• scripts/check-permissions.ts

仓库默认要求 ${BUN_X} 能解析为已安装的 bun，否则回退为 npx -y bun。在正式尝试发布前，先运行环境检查脚本，确认 Chrome 检测、profile 隔离，以及剪贴板 / 浏览器依赖是否都正常工作。

baoyu-post-to-wechat 实际使用方式

实际可走的入口主要有三条：

• 文章发布（浏览器方式）：scripts/wechat-article.ts
• 文章发布（API 方式）：scripts/wechat-api.ts
• 社媒图文发布：scripts/wechat-browser.ts

常见文章命令：
bun ./scripts/wechat-article.ts --markdown article.md --theme grace

常见图文命令：
bun ./scripts/wechat-browser.ts --markdown source.md --images ./images/ --submit

如果你已经有渲染好的 HTML：
bun ./scripts/wechat-article.ts --html content.html --title "Title"

需要指定某个 Chrome profile 时，使用 --profile <dir>；如果你更看重正文内保留外链，而不是转成引用格式，可以使用 --no-cite。

什么样的输入最容易得到好结果

想把 baoyu-post-to-wechat usage 用好，最理想的起点是一份结构干净、带 frontmatter 的 Markdown 文件：

---
title: Practical WeChat Publishing Workflow
author: Your Name
summary: A concise summary used for article metadata.
---

正文部分建议只保留一个 H1，使用清晰的章节标题，提供有效的本地图片路径，并提前确认你能接受最终链接被转换后的呈现方式。输入质量越高，通常意味着：

• 标题提取错误更少
• 摘要生成更稳定
• 图片替换与上传处理更顺畅
• 在微信编辑器里需要手动修的地方更少

一个很弱的指令是：“post this to WeChat.”
更强的写法则是：“Use baoyu-post-to-wechat to publish drafts/q2-update.md as an article, keep WeChat-friendly citations enabled, apply grace theme, set author to Team Ops, and use Chrome profile ./tmp/wechat-profile.”

减少试错的工作流建议

一个可靠的 baoyu-post-to-wechat guide 可以按下面顺序执行：

1. 先用 scripts/check-permissions.ts 验证环境
2. 先决定走文章流还是图文流
3. 准备带 frontmatter 和本地图片的 Markdown
4. 如果最大风险在格式转换，先用 scripts/md-to-wechat.ts 做转换测试
5. 再选择浏览器路径或 API 路径发布
6. 在 WeChat 内部检查草稿 / 输出效果后，再做最终分发

如果中间出了问题，先去看 scripts/cdp.ts、scripts/wechat-agent-browser.ts 和 scripts/wechat-extend-config.ts，再决定是否改内容。这几个文件能帮助你理解 Chrome 是如何被发现的、浏览器控制是怎么实现的，以及本地配置如何覆盖默认行为。

baoyu-post-to-wechat skill 常见问题

baoyu-post-to-wechat 适合新手吗？

适合，前提是你能接受运行脚本并准备 Markdown。它不太适合只想要纯聊天式体验、完全不做本地配置的用户。这个 skill 的核心价值来自流程可重复，而不是极简到对新手零门槛。

什么时候应该用它，而不是普通 AI prompt？

当真正的难点在执行层面时，就该用 baoyu-post-to-wechat：比如 Markdown 转换、图片处理、适配微信公众号限制，以及减少手动浏览器操作。若你只是需要帮忙写文案、起标题或生成摘要，那么通用 prompt 就足够了。

baoyu-post-to-wechat 在 Social Media 工作里的主要边界是什么？

它是专门为微信公众号发布设计的，不是一个覆盖多平台的社媒排期工具。如果你需要一套流程同时处理 X、LinkedIn、Instagram 和 WeChat，这个 skill 单独使用会显得过窄。它更适合作为更大内容流水线中的“微信公众号专用发布环节”。

什么情况下 baoyu-post-to-wechat 不适合你？

如果你的环境禁止本地浏览器自动化、无法安装兼容 bun 的工具链，或者团队已经有稳定的 CMS-to-WeChat 集成，就可以直接跳过它。对于低频、简单排版、纯手动发布的场景，它也会显得有些过度配置。

如何改进 baoyu-post-to-wechat skill 的使用效果

先给 baoyu-post-to-wechat 更好的源内容

想提升 baoyu-post-to-wechat 的输出质量，最快的办法通常是先把输入整理好：

• 在 frontmatter 里写清 title、author 和 summary
• 全文只保留一个清晰的 H1
• 使用可访问的本地图片路径
• 去掉失效链接或跟踪参数过重的外链
• 提前决定是使用引用转换，还是启用 --no-cite

这样可以显著减少后续编辑，也能让 Markdown 到 WeChat 的转换结果更可预测。

避开最常见的失败点

常见问题大多出在操作层，而不是概念层：

• 找不到 Chrome，或浏览器路径不对
• 直接复用个人 Chrome profile 导致冲突
• Markdown 结构太弱，导致标题 / 摘要提取异常
• 图片路径有问题
• 误以为文章模式和图文模式行为完全一致

建议先跑权限检查，隔离 profile，并在批量使用前拿一小份样本文档做测试。

优化提示词和交接说明

想让 baoyu-post-to-wechat guide 的执行质量更稳定，提示里最好明确写出：

• 发布模式：article 还是 image-text
• 源文件路径
• 是手动覆盖 title，还是以 frontmatter 为准
• 是直接 submit，还是只做 preview / draft
• 主题选择
• 引用处理方式
• profile 路径

好的指令应该具体到让 agent 不需要靠猜测就能选对脚本。

首次输出后如何迭代

第一次跑完后，优先通过调整源 Markdown 再重试，而不是在 WeChat 里把所有问题都手动修掉。先判断问题到底来自内容结构、元数据、图片摆放，还是浏览器环境。对大多数团队来说，长期提升 baoyu-post-to-wechat skill 效果的最佳做法，是建立一套可复用的 Markdown 模板，以及一份经过验证的本地 profile 配置。