前言¶
在 DeepSeek Harness 裏跑任務時，客戶端窗口能看進度，但桌面側往往缺少一個持續在場、能隨任務狀態切換反饋的載體。獨立安裝的桌寵可以補這一層，卻還要單獨維護啓動方式和與 Harness 的聯動。維護者 Doya16 將曾在 B 站獲得 400+ 收藏的「守岸人 DeepSeek 桌寵」收攏爲 npm 插件 dsh-shorekeeper：在 Windows 本機 Harness 中安裝啓用後，從插件入口下載並啓動完整版桌面程序，保留原獨立版的主要交互與素材能力，並去掉創建桌面快捷方式等 Harness 側不需要的步驟。
這是什麼¶
dsh-shorekeeper 是《鳴潮》角色守岸人的桌面桌寵，以 DeepSeek Harness 插件形式分發（MIT 許可證，維護者 Doya16）。插件入口體積約 0.3 MB；首次啓動完整桌寵需另下載約 229 MiB 的運行程序，內置三套共 83 個 GIF、40 個音頻、54 組語音字幕配對和兩款字體，無需安裝 Python。
適用環境：Windows 10/11 x64、本機已安裝並登錄 DeepSeek Harness。README 寫明驗證環境爲 0.2.1-rc.5；package.json 中 engines.dsh 爲 >=0.2.1-rc.5 <0.3.0。原 守岸人 DeepSeek 桌寵獨立安裝版 仍保留；與 Codex 版桌寵 可同時運行，設置分別保存。若與獨立版同時開，可能出現兩隻桌寵，需自行關閉其一。
社區目錄頁：skillhub.cn/plugins/Doya16/dsh-shorekeeper。收錄申請見 dsh-plugin-index #158。
核心功能¶
下列能力均來自項目 README 的功能說明與設置項描述。
任務與 Harness 聯動
- 根據任務階段切換表情：思考、查閱、編寫、執行、等你回應、完成、報錯、暫停等。
- 多個會話分別完成時排隊提醒，先完成的會話也會收到回應。
- 在「設置 → 連接 DeepSeek」中可選隨 Harness 啓動、完全退出時關閉，以及選擇跟隨的會話；托盤可喚醒或隱藏桌寵。
語音、氣泡與素材
- 每個動作可綁定 GIF（或導入 GIF、動態 WebP、PNG、JPG 等）；交互工作室裏可設循環、速度、單次播放、播完停留與下一狀態。
- 同一動作可添加多條音頻（WAV、MP3、OGG、FLAC、M4A、AAC），每條單獨配字幕；播放時隨機一對。氣泡可選「自定義音頻+字幕」。
- 思考階段語音可設爲每輪只播一次；待機可設爲每次進入、每次啓動一次或按概率偶爾播放。
桌面交互與打擾控制
- 摸頭、雙擊、拖動、放下、懸停、投餵等可分別綁定 GIF、音頻與氣泡。
- 「安靜陪伴（靜音）」一鍵停止當前與待播聲音；鎖定后角色區域點擊穿透，懸停時角色與餘額框可一起淡化，任務動畫與提醒仍繼續。
- Ctrl + 滾輪縮放桌寵；字體與氣泡、底欄尺寸可在設置中實時預覽（內置站酷快樂體、霞鶩文楷，可增本地字體）。
餘額與更新（v1.1.4 起可隱藏餘額框）
- 底部餘額框顯示充值與贈送合計；點擊刷新，懸停看明細；無讀數時顯示
--。 - 可在設置或右鍵菜單中隱藏餘額框，隱藏後佈局只按角色範圍計算，配置可遷移。
- v1.2.0：定時檢查新版，無聲更新氣泡常駐；「更新並重啓守岸人」可下載程序更新並保留當前配置與素材；支持「今日不再提醒」及下載中斷恢復。
配置遷移
- 修改自動保存；可導出配置素材包或含運行程序的便攜完整包，換機時一併帶走 GIF、音頻、字幕與全部設置。
演示視頻與部分配圖沿用獨立版 v0.5.1 的橫屏/豎屏演示（README 中註明客戶端窗口、對話、任務、餘額等爲示例，桌寵與設置爲實際界面）。B 站介紹：【DeepSeek x 鳴潮】守岸人來陪你了。
安裝與啓用¶
DeepSeek Harness 生態裏插件通常通過客戶端插件管理安裝；npm 包名爲 dsh-shorekeeper，當前插件版本 1.2.0（見 package.json 與 README）。
推薦路徑（桌面客戶端）
- 安裝並登錄 DeepSeek Harness（README 驗證版本 0.2.1-rc.5）。
- 在 Harness 的插件管理中安裝並啓用
dsh-shorekeeper。 - 點擊窗口右下角 守岸人桌寵 → 下載並安裝完整版（首次約 229 MiB，可選自動、GitHub 或鏡像加速）。
- 點擊 啓動桌寵；右鍵桌寵 設置…，或從插件入口 打開完整設置。
安裝並啓用後無需再裝舊版「連接插件」。README 說明：桌面客戶端的 desktop 配置由客戶端管理，不能用獨立 npm CLI 直接改桌面客戶端裏的插件列表。
非 desktop 配置的 CLI 示例（README 原文）
獨立 npm CLI 用戶可向自己的非 desktop 配置安裝，例如：
dsh plugin --profile shorekeeper add dsh-shorekeeper@1.1.2
上述命令不會把插件裝入桌面客戶端；桌面端仍以客戶端插件管理爲準。選用 CLI 時請注意示例中的版本號與當前 npm 版本（1.2.0）是否一致，按實際需要指定版本。
部署入口隱藏
首次成功啓動桌寵後，右下角部署面板與「守岸人桌寵」按鈕會默認隱藏；之後可在 Harness 設置 → 守岸人桌寵 啓動、關閉、打開完整設置或更新完整版。點擊 顯示部署入口 可恢復右下角按鈕；主動恢復後不會再次自動隱藏。
典型用法¶
從插件到桌寵
完成安裝與完整版下載後，用 啓動桌寵 即可。日常改設置：右鍵桌寵或托盤 → 設置…，同一窗口包含字體與大小、交互工作室、桌面與聲音、保存與遷移、連接 DeepSeek、版本與更新。
按動作定製（交互工作室）
- 在交互工作室左側選中一個動作（如思考、完成、摸頭）。
- 在 GIF 素材 中選擇內置三套之一或導入/放入素材目錄後刷新。
- 在 播放與切換 中調整循環與速度；在 語音與配對氣泡 中添加音頻與字幕，並設置自動播報頻率。
- 需要專心時在右鍵菜單開啓 安靜陪伴（靜音）；需要操作後方窗口時點擊角色上的小鎖鎖定並啓用穿透。
餘額框與外觀
- 不需要餘額展示時：右鍵桌寵或餘額框，在「刷新余額」下一項選擇隱藏，或在 設置 → 字體與大小 → 餘額框大小 旁取消勾選。
- 縮放：Ctrl + 滾輪；解鎖狀態下可拖動氣泡或餘額框邊緣調整寬度。
更新完整版程序
舊用戶 README 建議：先更新 Harness 側插件，再在 設置 → 守岸人桌寵 或桌寵內點擊 更新並重啓守岸人。v1.2.0 支持檢查更新、選擇 GitHub/鏡像來源及中斷恢復。
適用場景與注意¶
適合誰
- 在 Windows 上使用本機 DeepSeek Harness，希望在桌面有一個與任務狀態同步、可自定義表情與臺詞的守岸人桌寵的用戶。
- 已從 B 站或 GitHub 瞭解原獨立桌寵，希望改在 Harness 內統一安裝與啓停的用戶。
使用前請知悉
- 插件在 當前 DSH 進程權限 下運行；安裝前應自行查看 GitHub 倉庫 源碼與 MIT 許可證，確認可接受其網絡下載（完整版約 229 MiB）與本地桌面程序行爲。
- 僅支持 Windows x64；餘額刷新等功能依賴 Harness/DeepSeek 客戶端上下文，README 已說明部分界面爲演示示例。
- skillhub.cn 等社區目錄爲獨立收錄站點，與 DeepSeek / 幻方無官方從屬關係；插件市場「已審查」標籤綁定具體版本哈希，新版本需維護者重新覈對。
結尾¶
dsh-shorekeeper 把守岸人桌寵的完整桌面能力放進 Harness 插件流程：輕量入口、按需下載完整程序，並與任務狀態、語音氣泡、靜音鎖定和配置遷移打通。若要查看簡介與分類（趣味換裝），可打開目錄頁 https://www.skillhub.cn/plugins/Doya16/dsh-shorekeeper；安裝細節、設置表與更新說明以 https://github.com/Doya16/dsh-shorekeeper README 爲準。
