Twitter Post

twitter-post — 工具说明

本文是 expert-twitter 专家包内的工具说明书，不独立出现在技能列表中。由相关 Workflow 指引调用。

通过 camoufox-cli 持久化 session twitter 在 Twitter/X 上发布推文（文本 / 图片 / 视频 / 串推 / 引用 / 回复 / 长文）。

输入：推文正文（标准账号 ≤ 280 字符，Premium/Blue ≤ 25,000 字符）、可选媒体文件（图片 ≤ 4 张 / 视频 ≤ 512MB 且 ≤ 2m20s / GIF ≤ 15MB）；引用 / 回复场景另需源推 URL。 输出：发布结果 + 推文链接 + 即时 stats（view / reply / retweet / like / bookmark）。

纯浏览器操作方案：登录态 + 指纹冻结在持久化 session 的磁盘 profile 里。严禁 cookies import 造登录会话，会触发平台风控。本工具与 twitter-interact 共用同一个 session 名 twitter，靠 session 名字符串约定共享同一 profile 目录与登录态——一方登录后另一方不需重登。登录态只在 session profile 里闭环，不导出 cookie/UA 落中央存储（不调用 cookies export / identity export）。

浏览器方案（重要）

优先 camoufox-cli，且除了登录外，其他都可以默认的无头方式进行

下面 workflow 步骤（Navigate / Click / snapshot eval / upload）默认用 camoufox-cli 执行。若 camoufox-cli 在 X 上持续触发风控，等 60s 后开新 session 重试；仍触发则报告用户该平台当日风控未解，择日再试。

探活与登录（本工具自管，不走 login-manager）

探活方式：开 session open 平台首页 + snapshot 看是否跳登录页。

# 探活（默认无头模式）
camoufox-cli --session twitter --persistent --json open "https://x.com/"
sleep 3
camoufox-cli --session twitter --json snapshot
# snapshot 看页面是否跳到登录页 / 出现登录按钮 / 推文是否正常可见
# → 没跳登录页、内容正常 = 登录态有效，探活完即 close session（登录态在磁盘 profile，后续操作按需重起无头复用）
# → 跳到登录页 / 出现登录按钮 = 登录态失效，走重登

重登流程（失效时）——登录流程按 browser-guide skill 走有头手动登录（手机号+验证码 / Twitter APP 扫码），登录完成后close session——登录态落磁盘 profile，不留进程占内存。发布操作时用 --session twitter --persistent 重起无头即恢复，用完再 close。只在 session 卡死时由调用方手动 camoufox-cli --session twitter --json close teardown。

# X 登录风控对无头 + QR 识别严格，有头人工登录最稳
camoufox-cli --session twitter --persistent --headed --json open "https://x.com/login"
# 告知用户「**Twitter/X** 浏览器已打开，请在窗口里手动完成登录（账号密码 / 手机 APP 扫码），完成后告诉我」
# 等用户回复后 snapshot 验登录态就位
# 登录就位后 close session——登录态落磁盘 profile，按需重起无头复用

通用约束

• 文件上传用 forked camoufox-cli 的 upload 命令（camoufox-cli --session <s> --persistent --json upload <ref> <file>，底层 Playwright setInputFiles，无需 DataTransfer hack）
• 正文输入使用 type + slowly: true，不要用 fill()

字符计数规则（X 平台特殊）

• URL 永远算 23 字符（不论实际长度）— 在算 limit 时要预先扣除
• Emoji 算 2 字符 / 个
• 标准 280 字符限制（普通账号）
• Premium/Blue 25,000 字符（"long post"，URL bar 显示"Post all"而非"Post"）

Anti-automation limit

• 单条帖 ≥ 30 min 间隔（不是 15 min——30 min 是平台风险阈值）
• 单日 ≤ 50 帖（含 reply / quote / retweet / 长帖）
• 单周 ≤ 200 帖
• 触发风控后 24h 静默
• 频次跟踪：写到 Workspace 根平台运营文件夹 twitter/twitter-frequency.json（每次 post 后 append，不存在则初始化）

Post Types 决策表

Workflow: Post Plain Text

1. Navigate to https://x.com/compose/post
2. Wait for the compose box to load
3. Click into the text area and type the content
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
4. Verify character count — trim if over limit
5. **立即点击 "Post" 按钮——不要等待用户确认！**
6. Wait for success confirmation (URL changes or "Your post was sent" toast)
7. Extract and report the post URL
8. **Parse stats**：
   - snapshot eval: `JSON.stringify({
       retweet: document.querySelector('[data-testid="retweet"]')?.innerText,
       like: document.querySelector('[data-testid="like"]')?.innerText,
       reply: document.querySelector('[data-testid="reply"]')?.innerText,
       view: document.querySelector('[href*="/analytics"]')?.innerText,
       permalink: window.location.href
     })`
9. Update frequency tracker

Workflow: Post with Image

1. Navigate to https://x.com/compose/post
2. Wait for the compose box to load
3. Upload the image file using camoufox-cli upload（见下方选择器说明）
4. Wait for image upload to complete (thumbnail / "Media" group appears)
5. Click into the text area and type the caption
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
6. **立即点击 "Post" 按钮——不要等待用户确认！**
7. Wait for confirmation and report the post URL
8. Parse stats (same as plain text)
9. Update frequency tracker

文件上传选择器（重要）

X compose 页面有两个 <input type="file" data-testid="fileInput"> 元素（可见 + 隐藏），直接用 input[type=file] 或 [data-testid=fileInput] 会触发 Playwright strict mode violation: resolved to 2 elements。

必须用 >> nth=0 消歧：

camoufox-cli --session twitter --persistent --json upload "[data-testid=fileInput] >> nth=0" /path/to/image.jpg

forked cli 的 upload 命令底层走 Playwright setInputFiles，穿透 shadow DOM，无需 locator.drop() hack。

Workflow: Post with Video

1. Navigate to https://x.com/compose/post
2. Click the media icon
3. Upload the video file (MP4 recommended, max 512MB, max 2min 20sec)
4. Wait for video processing — this can take 30–120 seconds or more for larger files. Look for the thumbnail preview to confirm completion.
5. Click into the caption area and type the caption
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
6. **立即点击 "Post" 按钮——不要等待用户确认！**
7. Wait for upload confirmation and report the post URL
8. Parse stats (same as plain text)
9. Update frequency tracker

Workflow: Thread (multiple posts)

1. Navigate to https://x.com/compose/post
2. Click into the compose box and type the first tweet
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
3. Click the "+" icon to add another tweet to the thread
4. Click into the new compose box and type the second tweet
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
5. Repeat for each additional tweet
6. Click "Post all" to publish the full thread
7. Parse stats for the **last** tweet (representative)
8. Update frequency tracker (count = number of tweets in thread)

Workflow: Quote Tweet

场景：引用别人的推 + 自己的评论（BD / 互动 / 营销场景强）

1. Navigate to source tweet URL（如 https://x.com/username/status/1234567890）
2. Click "Repost" icon → 选择 "Quote"（不是 "Repost"）
   - ⚠️ 区分 "Repost"（纯转推，无评论）vs "Quote"（引用+评论）
3. Compose box 打开，**已自动填入引用卡片**
4. Click into text area below the quoted card
5. Type your comment (max 280 chars)
6. Verify character count
7. **立即点击 "Post" 按钮**
8. Wait for confirmation, report post URL
9. Parse stats (same as plain text)
10. Update frequency tracker

Pitfall：

• ❌ 选 "Repost" 而不是 "Quote" → 推出去没评论，BD 场景失去意义
• ❌ 评论超过 280 字符 → 按钮变灰，不自动转 Long post
• ❌ 评论里直接放 raw URL（占 23 字符）→ 实际可发字符更少

Workflow: Reply to Tweet

1. Navigate to source tweet URL（如 https://x.com/username/status/1234567890）
2. Click "Reply" icon（不是 reply 文本框）
3. Compose box 打开，**自动显示 reply context**
4. Type your reply (max 280 chars)
5. Verify character count
6. **立即点击 "Reply" 按钮**（不是 "Post"）
7. Wait for confirmation, report reply URL
8. Parse stats (replies can also get view counts)
9. Update frequency tracker

Pitfall：

• ❌ 选 "Reply" 时落入 quote 模式（X 旧 UI 行为）→ 不会加 reply 关系
• ❌ 串太长（> 280）→ 按钮变灰
• ❌ 频率过高 → 风控（见 Anti-automation limit）

Workflow: Long Post

前置：用户是 Premium / Blue 订阅（X 蓝标）。普通账号本工作流不适用。

检测 Premium：

snapshot eval: document.querySelector('[data-testid="icon-verified"]') !== null
// 或 UI 中是否有 "Premium" 字样

1. Navigate to https://x.com/compose/post
2. Wait for compose box to load
3. Type content up to 25,000 chars
4. **注意**：URL 仍 23 字符，Emoji 仍 2 字符
5. 按钮文字从 "Post" 变成 "**Post all**"（X 长帖是 1 个"post all"动作，但内容被服务端分页）
6. Click "Post all"
7. Wait for confirmation (URL changes)
8. Extract permalink (实际是 thread 形式：tweet + 续贴)
9. Parse stats for **first** tweet
10. Update frequency tracker (count = 1，long post 算 1 次)

Pitfall：

• ❌ 普通账号硬塞 25K → 按钮变灰 / 截断
• ❌ 不验 Premium 状态 → 普通账号调本工作流失败率高
• ⚠️ Long post 实际上服务端分页（thread-like），permalink 拿的是 first tweet

Workflow: Post Parse Stats

post 后立即拿 stats（view / reply / retweet / like），用于复盘。

1. After post success (any workflow ending with "Wait for confirmation")
2. 已在推文页面，URL = https://x.com/<user>/status/<id>
3. Wait 3-5s for X to populate stats
4. snapshot eval:
   const stats = JSON.stringify({
     retweet: document.querySelector('[data-testid="retweet"]')?.innerText,
     like: document.querySelector('[data-testid="like"]')?.innerText,
     reply: document.querySelector('[data-testid="reply"]')?.innerText,
     view: document.querySelector('a[href*="/analytics"]')?.innerText,
     bookmark: document.querySelector('[data-testid="bookmark"]')?.innerText,
     permalink: window.location.href
   })
5. Output: { ok, permalink, stats: { retweet, like, reply, view, bookmark } }

注意：

• view 数 Premium 账号可见；普通账号无
• 30 min 后 stats 才稳定（X 算法）
• 嵌入 evaluate 走 document.querySelector('selector')?.innerText —— selector 可能因 X UI 改版变，部署后真机验证

Frequency Tracker

# <Workspace 根>/twitter/twitter-frequency.json
{
  "last_post_at": "2026-07-05T09:30:00+08:00",
  "today_count": 5,
  "week_count": 23,
  "platform": "twitter"
}

每次 post 成功后 append：

1. 读 JSON（不存在则初始化 0/0）
2. 距 last_post_at < 30 min → 警告用户 + 询问是否继续（仍可继续，但 mark as high-risk）
3. 距 last_post_at < 5 min → 强制建议延后（强烈风控风险）
4. today_count += N（thread 算 N 条）
5. today_count > 50 → 拒绝 + 告知用户明早再发
6. week_count > 200 → 同上
7. 写入 JSON

Content Limits

Error Handling

Notes

• Do NOT mention internal tool names or errors in any post
• All post content must comply with X's terms of service
• If posting on behalf of company: verify the content tone matches the company voice in MEMORY.md
• 抓 stats 仅在 post 成功页有效；不要在 compose 页面（还没有 stats）
• Quote / Reply 都要先确认是哪种按钮（X UI 把 "Repost" 和 "Quote" 放一起）
• 频率统计：本工具只采集 stats，不做评分

参考

• X Help: Types of Posts — Reply / Quote / Long post 定义
• X Algorithm 2026 — reply weighted 27x like, 30 min 关键窗口