name: baoyu-post-to-x
description: 将内容和文章发布到 X（原 Twitter）。支持带图片/视频的常规推文和 X 文章（长文 Markdown）。使用真实 Chrome 浏览器配合 CDP 协议绕过反自动化检测。当用户要求“发布到 X”、“发推”、“在 Twitter 上发布”或“在 X 上分享”时使用。

发布到 X（原 Twitter）

通过真实 Chrome 浏览器（绕过反机器人检测）向 X 发布文本、图片、视频和长篇文章。

脚本目录

重要提示：所有脚本均位于本技能的 scripts/ 子目录中。

Agent 执行指令：
1. 确定此 SKILL.md 文件的目录路径为 SKILL_DIR
2. 脚本路径 = ${SKILL_DIR}/scripts/<脚本名称>.ts
3. 将此文档中所有的 ${SKILL_DIR} 替换为实际路径

脚本参考：
| 脚本 | 用途 |
|--------|---------|
| scripts/x-browser.ts | 常规推文（文本 + 图片） |
| scripts/x-video.ts | 视频推文（文本 + 视频） |
| scripts/x-quote.ts | 引用推文并添加评论 |
| scripts/x-article.ts | 长篇文章发布（Markdown） |
| scripts/md-to-html.ts | Markdown → HTML 转换 |
| scripts/copy-to-clipboard.ts | 复制内容到剪贴板 |
| scripts/paste-from-clipboard.ts | 发送真实的粘贴按键 |

偏好设置 (EXTEND.md)

使用 Bash 检查 EXTEND.md 文件是否存在（优先级顺序）：

# 首先检查项目级别
test -f .baoyu-skills/baoyu-post-to-x/EXTEND.md && echo "project"

# 然后检查用户级别（跨平台：$HOME 在 macOS/Linux/WSL 上均有效）
test -f "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐
│ 路径 │ 位置 │
├──────────────────────────────────────────────────┼───────────────────┤
│ .baoyu-skills/baoyu-post-to-x/EXTEND.md │ 项目目录 │
├──────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md │ 用户主目录 │
└──────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│ 结果 │ 操作 │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ 找到 │ 读取、解析、应用设置 │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ 未找到 │ 使用默认值 │
└───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md 支持：默认 Chrome 配置文件 | 自动提交偏好设置

先决条件

• Google Chrome 或 Chromium 浏览器
• bun 运行时
• 首次运行：需要手动登录 X（会话会被保存）

参考文档

• 常规推文：查看 references/regular-posts.md 了解手动工作流程、故障排除和技术细节
• X 文章：查看 references/articles.md 了解长篇文章发布指南

常规推文

文本 + 最多 4 张图片。

npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "你好！" --image ./photo.png          # 预览
npx -y bun ${SKILL_DIR}/scripts/x-browser.ts "你好！" --image ./photo.png --submit  # 发布

参数：
| 参数 | 描述 |
|-----------|-------------|
| <text> | 推文内容（位置参数） |
| --image <path> | 图片文件（可重复，最多 4 个） |
| --submit | 发布（默认：预览） |
| --profile <dir> | 自定义 Chrome 配置文件目录 |

视频推文

文本 + 视频文件。

npx -y bun ${SKILL_DIR}/scripts/x-video.ts "看看这个！" --video ./clip.mp4          # 预览
npx -y bun ${SKILL_DIR}/scripts/x-video.ts "精彩内容" --video ./demo.mp4 --submit  # 发布

参数：
| 参数 | 描述 |
|-----------|-------------|
| <text> | 推文内容（位置参数） |
| --video <path> | 视频文件（MP4, MOV, WebM） |
| --submit | 发布（默认：预览） |
| --profile <dir> | 自定义 Chrome 配置文件目录 |

限制：普通用户最长 140 秒，Premium 用户最长 60 分钟。处理时间：30-60 秒。

引用推文

引用现有推文并添加评论。

npx -y bun ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "很有见地！"          # 预览
npx -y bun ${SKILL_DIR}/scripts/x-quote.ts https://x.com/user/status/123 "我同意！" --submit       # 发布

参数：
| 参数 | 描述 |
|-----------|-------------|
| <tweet-url> | 要引用的推文 URL（位置参数） |
| <comment> | 评论文本（位置参数，可选） |
| --submit | 发布（默认：预览） |
| --profile <dir> | 自定义 Chrome 配置文件目录 |

X 文章

长文 Markdown 格式文章（需要 X Premium 订阅）。

npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md                        # 预览
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --cover ./cover.jpg    # 带封面图
npx -y bun ${SKILL_DIR}/scripts/x-article.ts article.md --submit               # 发布

参数：
| 参数 | 描述 |
|-----------|-------------|
| <markdown> | Markdown 文件（位置参数） |
| --cover <path> | 封面图片 |
| --title <text> | 覆盖标题 |
| --submit | 发布（默认：预览） |

Frontmatter：YAML front matter 支持 title、cover_image 字段。

注意事项

• 首次运行：需要手动登录（会话会持久化）
• 使用 --submit 前务必先预览
• 跨平台支持：macOS、Linux、Windows

扩展支持

通过 EXTEND.md 进行自定义配置。有关路径和支持的选项，请参阅偏好设置部分。