抖音网页版控制

它解决什么问题

在 Agent 操作抖音网页版时，常见的失败不是“不知道该做什么”，而是把内容策略和底层动作混在一起。Agent 可能一边试图判断该刷什么视频，一边又去点击按钮，结果既没有稳定的执行路径，也难以复现和调试。

douyin-web-control 把职责收窄：它只负责告诉 Agent 如何正确调用 CLI，不负责“该看什么”“为什么点赞”或“怎么做内容创作”。这样，策略层和执行层可以分开演进。

它如何工作

核心工作方式是：Agent 优先通过 skill 自带的包装脚本调用 douyin-web CLI，而不是直接操作网页 DOM。

关键步骤：

• 包装脚本会按顺序查找 CLI：依次检查 $DOUYIN_WEB_CLI、$DOUYIN_CLI_ROOT/bin/douyin-web、当前目录的 bin/douyin-web，以及 PATH 中的已安装版本。
• 页面动作默认截图：每次执行动作后，读取 JSON 里的 data.screenshot.path 做视觉确认，而不是只相信返回状态。
• 会话隔离靠 --profile：并行多个项目时，每条命令都要带同一个 profile 名称，否则会回到默认会话，导致串号或状态污染。
• 录制前先跑 devices：因为 AVFoundation 设备编号可能变化，系统音频优先使用 BlackHole 2ch，避免误录麦克风。
• 登录和风控必须人工介入：如果截图出现验证码、滑块、短信验证或账号风控，立即停止自动化流程，提示用户人工处理，不要用脚本尝试绕过。

对账号有影响的动作需要确认：

• like、follow-author、favorite、share
• comment --submit、danmaku-send --submit

这些动作执行前，Agent 应当先获得用户明确许可。

适用边界与注意点

适合使用的场景：

• 用户要求 Agent 操作抖音网页版（打开页面、检查登录、控制播放器、截图、录制、点赞、关注、收藏、分享、评论或弹幕）
• 测试、验证或扩展 douyin-web CLI 本身

不适合使用的场景：

• 制定刷视频策略、做推荐判断或内容偏好分析
• 生成视频创意、脚本或选题
• 处理创作者中心的完整发布流程

测试时的原则：

• 一次只测试一个动作，或只做小批量连续动作
• 失败时优先修 CLI 或记录为 CLI 限制，不要用直接浏览器操作掩盖失败
• 对于视觉状态不稳定的动作（如 danmaku off、loop、点赞高亮），只报告 CLI 结果和截图，不要声称绝对确认
• 修改倍速或音量后，测试结束尽量恢复默认值