核心用法
baoyu-post-to-weibo 是一款基于 Chrome DevTools Protocol (CDP) 的微博自动化发布工具，通过控制真实 Chrome 浏览器实例实现内容发布，有效绕过微博的反爬虫机制。
主要功能
| 功能 | 说明 |
|------|------|
| **常规微博** | 支持纯文字、图片（最多18张）、视频发布 |
| **头条文章** | Markdown 转 HTML 长文发布，支持 YAML frontmatter 配置标题、摘要、封面 |
| **智能识别** | 自动根据输入类型选择发布模式（.md → 头条文章，其他 → 常规微博） |
技术特点
- 真实浏览器模拟：非 headless 模式，使用完整 Chrome 实例，具备人类操作特征
- 会话持久化：首次登录后自动保存 Cookie，后续免登
- 图像智能处理：头条文章支持图片占位符替换机制，自动粘贴上传
- 跨平台支持：macOS、Linux、Windows 全兼容
工作流程
1. 启动 Chrome 并开启远程调试端口
2. 导航至微博发布页面
3. 自动填充内容（标题、正文、图片等）
4. 关键设计：用户需人工审核并点击发布按钮
配置扩展
支持三级配置文件（EXTEND.md）：项目目录 → XDG 配置目录 → 用户主目录，可自定义默认 Chrome 用户配置文件。
显著优点
1. 反检测能力强：真实浏览器环境比纯 HTTP API 或 Puppeteer 无头模式更难被识别
2. 功能完整：支持微博全部内容形态，包括复杂的头条文章富文本编辑
3. 安全边界清晰：强制人工确认发布，避免误操作和滥用
4. 开源可审计：GitHub 公开源码，社区可审查实现逻辑
潜在缺点与局限性
1. 依赖本地 Chrome：需预装浏览器，占用系统资源
2. 运行时依赖：需要 bun 运行时环境，增加部署复杂度
3. 非完全自动化：每次发布需用户手动点击确认，无法无人值守
4. 会话管理局限：未提及多账号切换或会话过期自动处理机制
5. 平台绑定：仅支持微博，无跨平台同步能力
6. 稳定性风险：依赖微博网页版 DOM 结构，界面改版可能导致脚本失效
适合人群
- 内容创作者：需要频繁发布长文头条的微博博主
- 社交媒体运营：管理企业微博账号的运营人员
- 自动化爱好者：希望将内容发布集成到个人工作流的开发者
- Markdown 用户：习惯用 Markdown 写作，希望直接同步到微博
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| **账号安全** | CDP 控制浏览器可能触发微博异地登录检测 | 使用常用 Chrome 配置文件，保持 IP 稳定 |
| **内容合规** | 自动化工具不审核内容，可能误发违规信息 | 强制人工确认机制即为此设计 |
| **技术依赖** | 微博页面改版导致脚本失效 | 开源社区维护，及时跟进更新 |
| **隐私泄露** | Chrome 配置文件存储登录凭证 | 配置文件应设置适当权限，避免共享 |
| **资源占用** | 同时运行多个 Chrome 实例消耗内存 | 脚本自动清理 CDP 实例，避免残留进程 |
版本与维护
当前版本 v1.56.1，由 JimLiu 维护。项目处于活跃开发状态，GitHub 仓库提供问题追踪和更新渠道。