前言¶
在 DeepSeek Harness（DSH）裏，常見用法是網頁對話和插件擴展能力。若你希望在本機桌面上有一個可拖動、可聊天、並在你明確授權後觀察選定窗口或屏幕的夥伴，而不是隻在瀏覽器裏打字，就需要一類帶獨立 Electron 窗口的客戶端插件。dsh-friend（小鯨桌面陪伴）由 steady-sakura 維護，歸類爲客戶端插件，把 dsh-pet 的動畫角色、自備 API 的聊天，以及經授權的屏幕共享和本機記憶檢索組合在一起；聊天與設置落在本機，向 API 發送記憶或畫面需另行同意。
這是什麼¶
dsh-friend 是 DSH 的桌面陪伴插件：桌邊顯示會動的小鯨，可雙擊展開聊天氣泡、拖動與互動，也可在右鍵菜單裏開啓屏幕共享。它使用你自己配置的 Chat Completions 兼容接口（默認預填 DeepSeek 地址與 deepseek-flash），調用費用由對應服務商收取。插件通過 Cordis 註冊網頁側欄入口與 /friend 等命令，桌寵按需啓動，不隨 Web 自動彈出。
維護者與倉庫：steady-sakura，GitHub，SkillHub 目錄頁。當前 package 版本爲 0.7.4，許可證 MIT。角色與 106 個動作素材來自 dsh-pet，桌面能力由 Electron 提供。
核心功能¶
聊天與界面¶
日常以桌邊聊天氣泡爲主：雙擊桌寵展開，底部輸入發送；長回覆可在氣泡內滾動。需要完整歷史或更大窗口時，可打開「聊天記錄」或「聊天面板」。模型回覆可爲文字、最多三個內置動作，或暫時沉默；輕點、拖動等互動會單獨標註，與你的文字分開傳給模型。
0.6.0 起默認採用自然正文與 companion_control 工具傳遞動作、記憶等控制；舊 JSON 接口可在設置裏手動切到「舊 JSON 兼容模式」。
屏幕共享¶
可在右鍵或面板中選擇應用窗口或整屏共享。共享需手動開啓並授權，畫面會發到你配置的 API 服務商；共享窗口可直接設置「多久看一次」（5 秒至 2 分鐘）。可隨時暫停或結束。使用前請先結束共享再升級或卸載。
本機記憶¶
默認開啓本機記憶：完成的對話可按日期寫入日記，長期摘記寫入 memory/facts.json 等路徑；檢索在本機完成，不依賴向量庫或額外嵌入 API。聊天時會按預算帶入近期與相關記憶；向 API 發送長期記憶、日記或檢索片段需在設置中勾選同意並覈對接口地址。
可分別選擇「角色文件夾」與「記憶文件夾」導入只讀 .md / .txt；路徑僅保存在本機，不發送絕對路徑。
語音與其它¶
面板可開啓本機語音朗讀（默認關閉）；0.7 起使用內置離線中文引擎，需在設置中下載音色。默認每 300 秒可觸發一次「自由活動」（會調用 API），可在設置關閉或調節。
網頁側欄 小鯨陪伴 通過 DSH Gateway 控制打開、關閉桌寵等固定操作，不另開本機 HTTP 服務，不把密鑰送入 DSH 對話。遠程瀏覽器連 DSH 時，桌寵顯示在運行 DSH 的那臺機器上。
安裝與啓用¶
環境要求：Node.js 22.12 或更新；建議使用 DSH 0.2.0-rc.2。插件已附帶網頁模塊，安裝時無需編譯。
在 PowerShell 中執行官方安裝命令：
dsh plugin --profile web add github:steady-sakura/dsh-friend
安裝並啓用後刷新 DSH 網頁。左側欄底部會出現 小鯨陪伴（README 中亦寫作 🐋 小鯨陪伴），點 打開桌寵；首次通常會彈出設置窗口。仍可在 DSH 輸入框執行 /friend。
若 0.5.0 出現 Failed to load plugins / dsh-friend: failed，README 建議更新到 0.5.1 及以上。從 0.4 或更早升級後若看不到網頁入口，需正常重開一次舊 Web 進程。首次啓動可能下載 Electron 43.3.0（準備階段總限時 60 秒）；網絡不可達時可設置環境變量 DSH_FRIEND_ELECTRON 指向兼容的運行時。
在設置中填入自己的 API Key 並 保存設置 後，雙擊桌寵即可聊天。API 地址應填根路徑（例如帶 /v1 的根），不要填完整 /chat/completions 路徑。
典型用法¶
按 README 的首次使用順序：
- 安裝 Node.js 與 DSH，執行上一節安裝命令並刷新網頁。
- 點 小鯨陪伴 → 打開桌寵。
- 在設置窗口填入 API Key，保存。
- 雙擊桌寵聊天；右鍵打開設置、選擇動作、屏幕共享或退出。
相處方式摘要：按住身體拖動，快速鬆手有甩動；右鍵可選 106 個動作之一或共享屏幕。只想聊天時可不開啓屏幕共享與「向 API 發送記憶」選項。
升級前：先結束屏幕共享，在 設置 → 備份、更新與卸載 導出本機備份，再檢查更新；完成後關閉舊桌寵並重新打開，在設置裏覈對運行版本。
卸載：通過 小鯨陪伴 → 卸載插件…、桌寵設置裏的卸載入口，或 DSH 命令 /friend-uninstall 打開本機確認窗口，可選保留或刪除聊天、日記、摘記等資料（詳見 README「卸載與資料保留」）。
獨立運行（不依賴 DSH 會話）：安裝目錄內可用 啓動桌面陪伴.cmd（Windows）或 啓動桌面陪伴.command（macOS / Linux），或在面板點 找到獨立啓動入口 定位目錄。
適用場景與注意¶
適合已在用 DSH、希望桌面側有可視化陪伴且 API 自控的開發者或用戶。插件以當前 DSH 進程權限運行，屏幕與記憶涉及隱私與外傳，安裝前應閱讀倉庫 PRIVACY.md 與源碼、MIT 許可證。SkillHub 目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
直接使用 DSH 自帶插件管理器或 CLI 移除不會經過插件的資料詢問，本機資料需自行處理。Electron 與聊天數據保存在本機插件資料目錄；多個 DSH 配置共用默認資料目錄時，刪除資料會影響其它配置。
結尾¶
dsh-friend 把 DSH 生態裏的網頁控制與獨立桌寵窗口連在一起：自備 API 聊天、dsh-pet 動作、可選屏幕觀察與本機記憶，邊界在授權與設置裏寫清。進一步瞭解請查看 SkillHub 插件頁 與 GitHub 倉庫 的 README。
