核心用法
抖音私信发送工具（douyin-messager）通过浏览器自动化技术实现抖音网页端的私信功能。主要功能包括：发送私信消息、获取聊天记录、回复消息等。使用前必须满足两大前提：用户已登录抖音账号，且已关闭 xdg-open 系统弹窗。
操作流程
1. 打开抖音首页并等待加载
2. 必须询问用户确认登录状态和弹窗处理
3. 获取页面快照定位私信按钮和目标用户
4. 依次点击私信按钮、目标用户进入聊天界面
5. 使用 type + submit 方式发送消息（禁止用 JavaScript 操作 DOM）
6. 截图确认消息发送成功
显著优点
- 直接对接抖音官方网页端，无需第三方 API
- 支持完整的私信生命周期：发送、接收、查看历史
- 浏览器自动化方案，相对脚本注入更稳定
- 提供详细的问题排查指南和经验总结
潜在缺点与局限性
- 严重依赖人工干预：必须用户手动关闭 xdg-open 弹窗，且 AI 无法检测该弹窗
- ref 动态变化：输入框等元素的 ref 每次加载都变化，需频繁获取快照
- 无永久关闭弹窗方案：每次打开抖音都可能触发系统弹窗
- 快照性能问题：数据量大易超时断网，需控制使用频率
- 消息长度限制 500 字符，超长需分段
- 存在发送频率限制，不适合高频刷屏
适合人群
- 需要批量处理抖音私信的运营人员
- 自动化客服场景（需配合人工监控）
- 需要定时发送消息或自动回复的用户
- 愿意处理系统弹窗等手动步骤的技术使用者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 账号安全 | 需登录真实抖音账号，存在账号被封风险 |
| 操作阻塞 | xdg-open 弹窗会导致所有浏览器操作卡死 |
| 消息乱码 | 错误使用 JS 操作 DOM 会导致内容异常 |
| 超时失败 | 快照数据量大，网络不稳定时易失败 |
| 平台风控 | 自动化行为可能触发抖音反爬机制 |
该工具本质是浏览器自动化 wrapper，核心价值在于封装了抖音网页端的交互细节，但无法解决系统级弹窗和动态 ref 等底层限制，适合低频、辅助性场景，不适合高并发生产环境。