前言¶
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:打开受控浏览器登录、导出 cookiedy_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 仓库。