核心用法
douyin-messager 通过浏览器自动化技术实现抖音（Douyin）私信功能的远程操作。用户需先登录抖音账号，AI 协助完成私信发送、聊天记录查看等操作。核心流程包括：打开抖音首页 → 等待加载 → 确认登录状态与弹窗关闭 → 获取页面快照定位私信按钮 → 点击目标用户 → 输入消息并发送 → 截图确认成功。
发送消息的正确方式：必须使用 type + submit 操作，严禁使用 JavaScript 直接操作 DOM，否则会导致中文乱码。
获取回复的方法：需先滚动聊天区域到底部，再通过截图或快照查看对方消息（白色/灰色气泡在左侧）。
显著优点
- 无需官方 API：绕过抖音未开放私信 API 的限制，通过浏览器自动化实现功能
- 可视化确认：通过截图验证消息发送成功，降低失败风险
- 聊天记录可追溯：支持获取历史对话内容
- 操作流程详细：文档提供了完整的步骤指引和常见问题解决方案
潜在缺点与局限性
- 强依赖人工介入：必须用户手动登录、手动关闭 Linux 系统级
xdg-open弹窗，AI 无法自动完成 - 弹窗阻塞风险：xdg-open 弹窗为系统级，AI 无法检测或操作，会导致所有浏览器操作卡死
- DOM 不稳定：输入框 ref 每次页面加载都会变化，需要频繁重新获取快照
- 平台对抗风险：抖音作为内容平台，持续更新反自动化策略，功能可能随时失效
- 快照性能问题：快照数据量大，容易超时或断网
适合人群
- 需要批量或自动化处理抖音私信的个人运营者
- 希望通过 AI 辅助管理多个对话的自媒体从业者
- 有技术背景、能理解浏览器自动化限制的用户
常规风险
- 账号封禁风险：非官方自动化操作违反平台服务条款，可能导致限流或封号
- 隐私泄露风险：需登录个人账号，存在 Cookie/Session 被截获的隐患
- 消息送达不确定性：无法像官方 API 一样确保消息 100% 送达对方 inbox
- 操作中断风险：人工环节（弹窗关闭）若遗漏，将导致整个流程阻塞