X私信自动对话助手

要解决的问题

X 没有官方开放的私信自动化接口。运营者面对大量 DM 时，只能手动刷新收件箱、逐条点开会话读上下文、再逐条打字回复，重复且容易漏回。批量触达更麻烦：搜索候选用户、逐个打开会话、发首条消息，全靠手工。本技能用浏览器自动化把这套机械流程封装成可调用的端到端能力，适合已登录浏览器、需要按固定人设批量处理私信的工程师。

核心能力与工作流程

技能的操作边界等于「用户在浏览器里能手动做的事」，只读取页面上已展示的数据，不绕过任何认证或访问控制。JS 逻辑封装在 scripts/ 目录下的 Python 文件中，通过 eval "$(python scripts/xxx.py {params})" 调用，由 browser-act 驱动浏览器。

主要组件：

• 收件箱扫描：scan-inbox-merged.py 合并 API 元数据（fetch-inbox-api.py，带分页）与 DOM 预览
• 会话读取：read-conversation.py 读取消息，scroll-load-history.py 滚动加载历史
• 发送校验：check-composer.py 检查输入框状态，verify-sent.py 用发送前后的消息 ID 对比确认已发出
• 用户搜索：search-users.py 按查询字符串搜索，只返回可私信的用户
• 页面状态：check-page-state.py 检测登录状态与 E2E 加密状态

两个端到端场景：

场景 A（回复未读私信）：扫描收件箱 → 过滤待回复会话（unread: true 或最新消息来自对方、peer_can_dm: true 且未静音未删除）→ 逐条读取最近约 6 条消息 → 由调用方 Agent 结合人设生成回复 → 通过 CDP 真实键盘事件输入并发送 → 随机间隔 8–15 秒串行执行。发送失败不重试，避免重复发送。

场景 B（搜索触达）：按查询搜索候选用户 → 过滤 can_dm: true 且 can_dm_reason: "Allowed"、未被封禁或设为保护 → 按 user_id 计算会话 URL 并打开 → 生成首条消息并发送，间隔 10–20 秒。

适用边界与注意点

• 需要 X 账号已在浏览器登录（页面可见账户菜单），且当前会话可用 browser-act
• 开启端到端加密的账号必须提前提供 4 位 DM 密码；解锁依赖 CDP 真实键盘事件，用 eval 直接设值会被 X 忽略，连续 3 次失败即报错停止
• 回复与首条消息的内容由调用方 Agent 生成，技能不参与文案决策
• 批量操作严格串行并带随机间隔，不做并发；每次执行重新解析浏览器实例 ID，不使用固定会话名
• 执行前应先读取经验文件，其中记录了历史运行中遇到的策略失效、选择器变更、限流阈值等信息