Douyin Messager | 抖音私信助手

核心用法

douyin-messager 通过浏览器自动化实现抖音网页版私信功能，主要包含：发送私信、查看聊天记录、获取对方回复三大能力。

标准执行流程：打开抖音 → 等待加载 → 【必须】确认用户登录状态及关闭 xdg-open 弹窗 → 获取快照定位私信按钮 → 点击私信/选择用户 → 输入并发送消息 → 截图确认。

技术要点：必须使用 type + submit 方式发送消息，禁止用 JavaScript 操作 DOM（会导致乱码）；输入框 ref 每次页面加载都会变化，需重新获取快照；减少快照调用频率以避免超时断网。

显著优点

• 零 API 依赖：通过浏览器自动化绕过官方 API 限制，无需申请开发者权限
• 完整会话能力：支持发送、接收、历史记录查看全流程
• 直观确认机制：截图验证确保消息送达

潜在缺点与局限性

• 人工干预前置：必须用户手动登录抖音并关闭 Linux 系统级 xdg-open 弹窗，AI 无法自行完成
• 弹窗阻塞风险：xdg-open 弹窗为系统级，AI 不可见不可操作，会导致全部浏览器操作挂起
• ref 动态变化：DOM 元素引用频繁失效，需反复获取快照，增加操作延迟
• 平台对抗性：依赖抖音网页版 DOM 结构，页面改版即失效
• 数据量大易超时：快照数据体积大，网络不稳时易断网

适合人群

• 需要在无官方 API 场景下批量处理抖音私信的个人用户
• 已熟悉浏览器自动化限制、能接受人工介入确认的技术使用者
• Linux 环境下可及时处理系统弹窗的用户

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 账号封禁 | 自动化行为可能触发平台风控 | 控制发送频率，避免刷屏 |

| 消息乱码 | 错误使用 JS DOM 操作导致 | 严格使用 type + submit |

| 操作挂起 | xdg-open 弹窗阻塞 | 执行前强制用户确认弹窗已关闭 |

| 元素失效 | DOM 结构变化或 ref 过期 | 操作失败后重新获取快照 |

| 隐私泄露 | 聊天记录包含敏感信息 | 确保运行环境安全，避免截图外泄 |

使用建议

• 首次使用务必完整阅读「最大前提」章节
• 操作中断时优先检查是否有未关闭的系统弹窗
• 长消息（>500字符）需手动分段，避免截断

抖音私信发送技能评估

核心用法

本 Skill 采用浏览器自动化方案，通过控制本地浏览器访问抖音官方网页版（www.douyin.com）实现私信功能。核心流程包括：打开抖音首页→等待加载→用户确认登录状态→定位私信入口→选择目标用户→输入消息并发送→截图确认。全程不调用任何第三方 API，所有操作均在用户可视的浏览器环境中执行。

显著优点

安全性顶尖：纯 Markdown 文档型 Skill，无可执行代码，安全评分 S+/100。无第三方依赖，无供应链风险，通过 GDPR、CCPA 等隐私合规检查。

透明度极高：用户全程可见浏览器操作，消息发送前需多次手动确认，避免误操作。明确的 xdg-open 弹窗处理指引，解决 Linux 环境常见问题。

零 API 风险：直接操作官方网页端，不暴露任何 API Key 或 Token，账号安全性由用户自行把控。

潜在缺点与局限性

环境依赖重：强制要求图形化浏览器环境（browser.enabled），无法在纯命令行环境运行。Linux 用户需手动处理 xdg-open 系统弹窗。

操作繁琐：每次使用需重新获取动态变化的 DOM 引用（ref），流程包含多次「等待→快照→点击」循环，效率低于原生 API 方案。

稳定性受限：网页版抖音的 DOM 结构可能更新，导致定位失败；快照数据量大时易超时或断网。

功能边界：仅支持基础文字私信（500字符限制），不支持图片、语音、视频等多媒体消息；无法处理验证码、登录态过期等异常场景。

适合人群

• 需要偶尔发送抖音私信的个人用户
• 重视操作透明度和账号安全、不信任第三方接口的用户
• 具备基础浏览器自动化概念的技术用户
• 已配置好浏览器环境的 OpenClaw 用户

常规风险

1. 平台风控风险：频繁发送可能触发抖音反 spam 机制，建议控制发送频率
2. DOM 变化风险：抖音网页改版可能导致 Skill 失效，需关注更新
3. 消息乱码风险：若误用 JavaScript DOM 操作（文档已明确禁止），会导致中文乱码
4. 隐私泄露风险：浏览器环境若被其他程序监控，聊天记录可能被截取（非 Skill 本身问题）