前言¶
在 DSH 裏給陪伴角色接抖音，常見兩種做法：要麼插件自帶一套模型和人設，記憶只留在本插件裏；要麼自己寫工具把畫面採樣結果塞進上下文，和 QQ、微信、B 站那邊的「同一個人」對不齊。dsh-whale-douyin 走另一條路——沿用 LockyBee/dsh-douyin-agent 的本地 Edge 刷抖音與畫面採樣能力，去掉內置 AI 與人格，把觀看記錄、興趣變化和可共享的記憶寫入 dsh-whale-world。下面介紹它是什麼、能做什麼，以及 1.4.6 的安裝與第一次使用步驟。
這是什麼¶
dsh-whale-douyin 由社區維護者 SenuMirai 發佈，DSH 社區目錄分類爲「記憶」。npm 包名仍爲 dsh-douyin-browser-local（與上游 id 一致，便於 Whale 系插件互相識別），當前資料中的版本爲 1.4.6，許可證 MIT。
相對上游 LockyBee/dsh-douyin-agent，本倉庫主要改動是：
- 不再自帶獨立對話模型和內置人格卡；
- 瀏覽、停留、興趣更新等結果接入 dsh-whale-world 記憶中樞，與 dsh-whale-qq、dsh-whale-wechat、dsh-whale-bili 共用同一套「世界」記憶。
運行環境：Windows、Microsoft Edge、兼容 DSH 宿主；資料寫明已覈對 0.2.0-rc.2、0.2.1-rc.2 兩代 SDK，完整允許範圍以包內 package.json 的 engines.dsh 爲準。
核心功能¶
能力大體繼承上游 1.4.6 說明，記憶與人格部分改爲走 Whale 生態。
| 能力 | 說明 |
|---|---|
| 自主觀看 | 在允許時段與每日額度內，於專用 Edge 打開抖音電腦版，按興趣和真實觀看行爲挑片、停留、換片或停止；可手動啓停 |
| 畫面採樣與分鏡 | 觀看決策、分享與觀察工具可將多幀 JPEG 拼成分鏡圖（默認總像素預算 480000），供支持圖片的模型理解 |
| 每日額度 | 「高級選項」可設每日觀看分鐘數、每日模型請求數，或設爲不限 |
| 興趣更新 | 依據播放進度、觀看比例和已確認互動更新興趣；「看到主題」不等於自動標記爲喜歡 |
| 好友互動與分享 | 總開關管理許可會話的回覆與觀看中自主分享；須本人勾選許可好友或羣聊；羣聊僅在被 @ 或叫到設定暱稱時回覆 |
| 觀看日報 | 從本機觀看記錄生成 Markdown，不額外調用模型 |
| 靜默觀看 | 持續靜音，覈實窗口歸屬後嘗試最小化；仍使用有窗口 Edge |
人格與興趣由 dsh-whale-world 與 Whale 系其它插件共用，不再使用原插件內置人格。安裝 dsh-whale-world 後，抖音側刷過的內容和口味變化會進入同一記憶中樞。
同一時刻只運行一條自主觀看；插件版與上游獨立軟件版共享每日賬本（本倉庫 README 仍描述兩版關係，插件入口在 DSH「設置 → 刷抖音」）。
安裝與啓用¶
資料中的固定安裝入口對應 1.4.6。是否在 npm / 市場可下，以 GitHub 與 npm 頁面爲準。
DSH Desktop：打開「應用 → 桌面插件」，填寫包名安裝或更新：
dsh-douyin-browser-local@1.4.6
更新後需完全退出並重新打開同一份 DSH Desktop（profile 由 Electron 管理，不要用普通 CLI 另改一份）。
Web profile 在終端執行：
dsh plugin --profile web add dsh-douyin-browser-local@1.4.6
引擎要求（來自 package.json）：Node >=22.13；DSH >=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.2 <0.3.0-0。
若要與「一整隻 Whale」聯動，資料建議在裝好本插件的同時安裝 dsh-whale-world；QQ、微信、B 站側可選對應 dsh-whale-* 倉庫。社區目錄頁：skillhub.cn/plugins/SenuMirai/dsh-whale-douyin。
典型用法：第一次使用¶
按 README「第一次使用」順序操作即可復現：
- 在 DSH 中配置支持圖片的主模型（插件從 DSH 目錄選擇；不再依賴本插件內置模型）。
- 點擊「打開抖音」，在專用 Edge 中手動登錄或完成驗證碼。
- 在「視頻觀看」選擇時段；按需展開「高級選項」設置每日分鐘數和請求數，再開啓「允許自動觀看」。應用需保持運行，無需先手動開新輪次。
- 在「好友互動」讀取當前會話，覈對穩定身份並勾選許可好友或羣聊；按需填寫羣聊響應暱稱。總開關開啓且模型、名單就緒後，可自動準備回覆；觀看中可自主分享（須先由你指定許可對象）。
遇到問題可先走「自檢與用量 → 一鍵自檢」，按報告處理限定修復項；登錄、驗證碼、無效 Key 等問題不能靠刪除鎖或記憶目錄「硬清」。
適用場景與注意¶
適合誰：已在 Windows 上用 DSH 跑陪伴類智能體，並希望角色在本地 Edge 裏「真的刷抖音」，且希望觀看與興趣與 QQ / 微信 / B 站共用 dsh-whale-world 記憶，而不是再養一套抖音專用人格。
務必注意：
- 插件以當前 DSH 進程權限運行，會驅動本機 Edge 與頁面自動化（Playwright）；安裝前建議閱讀倉庫源碼與 LICENSE、THIRD_PARTY_NOTICES.md。
- 第三方適配，非 DeepSeek 官方發行；社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
- README 列有未完全驗收項（如推薦流換片、長時播放體量等），生產環境宜以自檢結果和本機實測爲準。
- 從源碼安裝上游 agent 的步驟在資料中指向 LockyBee 倉庫的
install-native.ps1；使用 SenuMirai 適配版 時仍以 npm 包dsh-douyin-browser-local@1.4.6或本倉庫發佈爲準，勿與上游 git clone 流程混爲一談。
結尾¶
dsh-whale-douyin 把本地抖音觀看鏈路留在成熟的上游實現上，用「去掉內置 AI + 接入 whale-world」解決記憶與人格分裂問題。若你正在拼 Whale 五件套，刷抖音這一塊可以用它把口味寫回同一只「她」。
