DSH 抖音刷视频子代理插件:谷时自动刷、读评论、发报告

前言

DSH(DeepSeek Harness)的插件化设计让智能体能力扩展变得灵活,但为 DSH 添加第三方网站浏览能力仍需解决登录态管理、API 签名、页面交互等细节。本插件基于 dsh-bili-subagent 模式,配合 yunsur/douyin-mcp 提供的 133 个纯 HTTP 工具,为 DSH 增加抖音浏览能力。它在谷时自动派发子代理刷视频、读评论、筛选并返回报告,减少人工刷抖音的负担。

是什么

这是 DSH 的「刷抖音」插件,由 WU079 维护。插件在谷时(13:00–15:00、19:00–次日 10:00,周末全天)自动触发子代理,用 dy_scan 扫指定方向的视频,读取详情与评论,挑出值得看的,最后生成报告。核心能力来自 yunsur/douyin-mcp 的本地 HTTP 工具集,插件负责定时调度、登录态管理、报告生成。

核心功能

11 个 dy_* 工具

插件提供 11 个工具,覆盖浏览、搜索、评论、发布等操作:

  • dy_status:检查登录态与 MCP 状态
  • dy_config:读写配置文件
  • dy_login:打开受控浏览器登录、导出 cookie
  • dy_search:搜索视频
  • dy_video:读取视频详情
  • dy_comments:批量读取评论
  • dy_comment:评论/回复(直发,需页面签名)
  • dy_publish:发布视频(需额外签名材料)
  • dy_scan:按方向刷视频
  • dy_tools:列出可用工具
  • dy_mcp:调用本地 MCP 服务

谷时定时器

插件内置谷时定时器,窗口为 13:00–15:00 和 19:00–次日 10:00,周末算全天谷时。到点后向目标会话递一句触发,子代理自己执行 dy_scan。配置项 perDay 控制每天最多几轮,gapMin 控制两轮间隔最少多少分钟。

值班章程与报告

插件内置值班章程 prompts/duty.md(可通过 $DSH_HOME/douyin-duty/duty.md 覆盖)。章程要求先验证登录、搜索 2–3 个关键词变体、读取详情与评论、挑出不超过 N 条值得看的,并遵循「宁缺毋滥」原则,不猜测。报告输出到 $DSH_HOME/douyin-duty/out/<日期>.md,配置项 reportLevel 控制详细程度。

安装与启用

安装插件:

dsh plugin --profile <你的 profile> add github:WU079/dsh-douyin-subagent

安装后重启 DSH 或重新加载 profile,dy_* 工具即可使用。

典型用法

1. 配置 MCP 路径

把 douyin-mcp-windows-amd64.exe 放到任意位置,然后告诉插件路径:

dy_config { "patch": { "mcpExe": "D:/tools/douyin-mcp-windows-amd64.exe" } }

也可在宿主环境变量中设置 DOUYIN_MCP_EXE。

2. 登录抖音

先打开受控浏览器进行扫码登录:

dy_login { "action": "open" }

用手机抖音扫官方二维码登录。登录成功后导出 cookie:

dy_login { "action": "save" }
dy_status

下次只需重新导出 cookie 即可,插件会使用独立的 --user-data-dir 保存登录态。

3. 刷视频与搜索

按方向刷视频:

dy_scan { "direction": "本地语音克隆 踩坑", "n": 1 }

搜索关键词:

dy_search { "keyword": "..." }

读取视频详情:

dy_video { "aweme_id": "..." }

读取评论:

dy_comments { "aweme_id": "...", "count": 30 }

4. 评论与回复(0.2.0 起)

评论/回复需要页面签名,dy_comment 会尝试通过已登录的 Chromium/Edge(需开启远程调试端口)直发。先启动带 CDP 端口的 Edge:

"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9333 --user-data-dir=F:\douyin-browser https://www.douyin.com/

然后在 DSH 中调用 dy_comment。

配置项

dy_config 读写 $DSH_HOME/douyin-duty/config.json,常用配置如下:

key 默认值 说明
enabled true 插件总开关
autoMode valley 自动模式:manual / valley / always
noon / night true 中午、晚上谷时窗口开关
perDay / gapMin 2 / 180 每天轮数、两轮间隔(分钟)
direction "" 扫描方向
keywords [] 关键词候选列表
perScan 1 每轮挑选数量
mcpExe "" MCP 二进制路径
mcpPort 18080 MCP HTTP 端口
mcpToken 生成 本地 MCP 服务 Bearer token
browserPort 9222 受控浏览器 CDP 端口
browserProfile <home>/browser 浏览器 --user-data-dir
cookieFile <home>/cookies.txt Cookie 文件位置
targetSession "" 触发目标会话,空则用最近会话
triggerPrompt 内置 递给目标会话的提示文本
reportLevel full 报告详细程度:full / brief / off

插件 0.1.1 起提供 Web 设置面板(路径 /api/douyin-duty/*),可直接在浏览器中修改这些配置。

适用场景与注意

适合需要定期刷抖音、筛选内容、生成摘要报告的场景,例如信息收集、热点追踪、内容策划辅助等。插件以当前 DSH 进程权限运行,安装前建议检查源码与许可证。

注意事项:

  • MCP 服务只监听本机,插件为每次安装生成随机 Bearer token。
  • 发布工具需要 TICKET/TS_SIGN/PRIVATE_KEY 等签名材料,多数账号无法获取,实际发布建议通过创作者中心网页。
  • check_login_status 会误报,判断登录态应看 get_my_profile 返回的 status_code === 0。
  • Cookie 会过期,受控浏览器仍登录时可通过 dy_login { action: "save" } 重新导出。
  • 新号风控较严,评论与发布应控制数量、拉开间隔。
  • 插件与抖音/字节跳动无关,仅用于个人浏览,请遵守对方条款,尊重他人隐私。

结语

本插件为 DSH 增加了抖音浏览能力,结合谷时定时器与值班章程,可自动化刷视频、读评论、发报告。适合需要定期浏览抖音并生成摘要的开发者或研究者。如需了解更多,可查看插件目录页与 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye