核心用法
x-twitter-browser 是一款基于 Playwright 的浏览器自动化技能，允许用户通过提供浏览器 Cookie 头来复用真实登录会话，在 X（原 Twitter）上执行操作。当前版本主要支持发布纯文本推文。
使用流程三步走：
1. 保存 Cookie：用户从浏览器开发者工具复制完整的 Cookie 请求头，通过 save_cookie_header.py 持久化到本地
2. 验证会话：执行 post_tweet.py --verify-only 确认登录状态有效
3. 执行操作：验证通过后，调用 post_tweet.py --text "内容" 发布推文
技术架构：采用双层设计——会话层负责 Cookie 的存储与管理，动作层基于 Playwright Chromium 执行实际的浏览器交互。运行时敏感文件隔离在 runtime/ 目录下。
显著优点
- 零 API 成本：完全绕过 X 官方 API 的开发者审核与费用门槛
- 真实会话模拟：使用用户自有浏览器 Cookie，行为特征更接近真人操作
- 服务器友好：支持无头模式（headless），可在 Linux VM/容器环境运行
- 低依赖门槛：仅需 Python3 + Playwright，无复杂 OAuth 流程
- 可扩展架构：模块化设计便于后续添加点赞、转发、私信等功能
潜在缺点与局限性
- Cookie 有效期受限：浏览器会话可能因安全策略过期，需定期重新获取
- 功能单一：v1.0.0 仅支持发推，不支持富媒体、线程、定时发布等高级功能
- 反爬风险：X 平台可能检测 headless 浏览器特征，触发额外验证或限流
- 无官方保障：依赖 DOM 结构稳定性，X 前端更新可能导致脚本失效
- 凭证泄露风险：Cookie 包含敏感身份信息，本地存储需严格权限管理
适合人群
- 个人开发者需要低成本、轻量级的 X 自动化方案
- 已有浏览器登录态，希望快速迁移到服务器环境的用户
- 需要绕过 API 限制进行小规模内容发布的场景
- 熟悉 Python 和浏览器开发者工具的技术用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 账号安全 | Cookie 泄露可导致账号被接管 | 使用专用小号，定期轮换 Cookie，runtime 目录设 600 权限 |
| 平台封禁 | 自动化行为可能触发风控 | 控制操作频率，避免高频发布，配合 human-like 延迟 |
| 会话失效 | Cookie 过期或账号异常验证 | 建立监控机制，失效时及时通知用户更新 |
| 依赖故障 | Playwright 或 Chromium 兼容性问题 | 锁定依赖版本，测试目标环境兼容性 |