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，常用配置如下：

插件 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 倉庫。