前言¶
在 DeepSeek Harness 裏做「長期陪伴」型智能體時，常見做法是單獨接 IM、單獨做記憶層、再單獨掛一個刷站插件。通道、人設、主人偏好和觀影興趣容易混在同一份上下文裏，既難維護，也不利於隔離私聊內容。鯨伴（WhaleMate）把 QQ 私聊、經篩選的長期興趣記憶，以及 Bili Whale 風格的 B 站選片與分享收進一個 DSH 插件；人設、刷站興趣和主人私人偏好分開存放。下面介紹它是什麼、能做什麼，以及官方 README 中的安裝與使用步驟。
這是什麼¶
鯨伴是維護者 abbccdd 發佈的 DSH 插件，GitHub 倉庫爲 abbccdd/dsh-WhaleMate。npm 包名爲 dsh-pond（當前資料中版本 0.6.0），許可證 MIT。
它解決的核心問題是：在 Windows + DSH Web + QQ + B 站 這一組合下，讓 Harness 中的夥伴通過 QQ 與主人聊天，記住經過篩選的長期興趣，並把 Bili Whale 看過、分析過的視頻按需分享到 QQ。微信與 X 在 README 中列爲後續方向，當前沒有實際接入。功能處於測試階段：自動記憶是檢索與提煉，並非訓練模型；對話與視頻記錄是否準確仍需用戶自行判斷。
核心功能¶
資料中可覈實的能力如下。
QQ 私聊與主人綁定。 通過配套騰訊 DSH QQ Bot 的主人保護適配版連接機器人；生成配對碼後，由主人的 QQ 向機器人發送代碼完成綁定。機器人只接受綁定主人的私聊，配對消息不進入模型。
長期記憶與資料連接。 可在設置中連接「公開人設」「報告和日記」，並開啓「自動提煉長期記憶」。已有 Bili Whale 人設、偏好和文字記錄不會被覆蓋；連接前需確認要共享的資料內容。
B 站刷站與視頻分享。 沿用附帶兼容版 Bili Whale 的選片方式；鯨伴調用該組件分析視頻。需要 B 站登錄、可用網絡與 FFmpeg。默認 4×4 抽幀是視頻抽樣，不等於完整觀看。主動分享視頻到 QQ 默認關閉，啓用後只向已綁定主人發送，插件最多每 24 小時嘗試一次；發送失敗不會自動重試。
隱私與邊界。 公開評論、動態和分享在附帶版本中默認關閉。私聊敏感信息會盡力過濾、隔離，但不保證識別所有祕密。生物鐘僅在 DSH 運行時工作。
安裝與啓用¶
安裝前需已能運行 DeepSeek Harness、Node.js 20.3 或更高、pnpm；若要看視頻畫面還需 FFmpeg 且能在系統路徑中找到。插件依賴下載需要聯網。README 說明：安裝僅在全新隔離環境測試過；已有複雜插件配置、其他操作系統和不同 DSH 版本尚需進一步驗證。
1、安裝鯨伴並重啓 DSH
任選一種方式（命令與表述來自官方 README）：
dsh plugin --profile web add github:abbccdd/dsh-WhaleMate
若已安裝支持自定義 GitHub 來源的社區插件市場，可在市場中輸入 github:abbccdd/dsh-WhaleMate 並安裝。DSH 原生插件列表不一定提供安裝入口；是否被某市場收錄由該市場決定。也可在 DSH 對話中請求安裝到 web 配置，並按界面提示完成授權。
2、安裝配套組件
打開 設置 → 鯨伴，點擊「安裝配套組件」，等待完成後再次重啓 DSH。這一步安裝本項目附帶的兼容版 Bili Whale 和主人保護版騰訊 QQ 適配器，並準備缺失的默認資料；不會覆蓋已有資料。當前界面安裝功能支持 Windows 的 DSH Web 運行方式。
若遇到不同來源的同名組件，安裝程序會停止且不會自動替換；同一目錄已安裝組件會跳過。已有 Bili Whale 或 QQ 插件的用戶請先備份並手動處理版本衝突。
3、B 站與 QQ
在 設置 → 養魚 填寫 B 站登錄信息並檢查依賴；在 設置 → QQ 機器人 掃碼連接機器人。
4、配對與可選能力
在 設置 → 鯨伴 點擊「生成配對碼」，用 QQ 向機器人發送顯示的代碼，再點擊「完成配對」。按需點擊「連接公開人設」「連接報告和日記」，並打開「自動提煉長期記憶」「主動分享視頻到 QQ」。
QQ 主人配對、自動記憶、資料連接及主動分享均需本人操作；安裝本身不會自動登錄或開啓發送。
典型用法與設置路徑¶
可復現的流程與 README「使用和限制」一致，可按下面順序自檢。
- 完成安裝與配套組件後，確認 B 站登錄與 FFmpeg 可用。
- 完成 QQ 機器人掃碼與主人配對。
- 在私聊中與夥伴對話；長期記憶依賴已開啓的提煉與已連接的資料，而非安裝即生效。
- 若啓用主動分享，留意最多每 24 小時嘗試一次的節奏，以及騰訊側權限與平臺規則。
不要將密碼、密鑰等交給機器人。視頻評論、字幕和畫面屬於不可信內容；不要在公開會話中加載私聊。若給刷站會話完整文件權限，它仍可能訪問本機文件；插件以當前 DSH 進程權限運行，安裝前應閱讀源碼與 THIRD_PARTY_NOTICES.md 中的第三方聲明。
組成與生態位置¶
本倉庫附帶 Bili Whale 的兼容修改版與 騰訊 DSH QQ Bot 的主人保護適配版；相關代碼保留各自許可。DeepSeek Harness 的理念是「一切皆插件」；社區目錄站點（如 SkillHub 上的插件頁）與 DeepSeek / 幻方無官方從屬關係，收錄情況以各站點爲準。
結尾¶
鯨伴面向需要在 DSH Web + QQ + B 站 上打通陪伴、分層記憶與觀影分享、且接受測試階段限制的 Windows 用戶。經過上面的步驟，可以從官方倉庫覈對安裝命令與限制說明，再決定是否接入生產環境。
