前言¶
DeepSeek Harness（DSH）把對話、工具與插件疊在同一套 Web 界面裏，長時間盯屏寫 prompt、跑任務時，界面往往只有日誌和輸入框。若你希望在不動核心業務的前提下給工作區加一點「存在感」——待機動畫、可拖拽的小窗、偶爾一句碎碎念——需要一種只掛插件、不改 DSH 核心的做法。社區目錄裏的 dsh-pet（維護者 ggxx001，分類 趣味換裝）就是面向這類需求的桌寵插件：默認是一隻「喫白飯的藍色大肥魚」，賴在 Harness 裏，也能 optionally 跑到桌面透明置頂小窗。
下面介紹它是什麼、能做什麼，以及如何按官方文檔安裝與日常使用。
這是什麼¶
dsh-pet 是發佈在 npm 上的 DSH 插件包（當前資料中版本 0.3.8），定位爲 DeepSeek Harness Web UI 上的浮動桌面寵物：待機呼吸、隨機動作（資料稱約 97 段透明動畫，如打瞌睡、玩魔方、寫代碼、喫火鍋等）、屏幕漫遊、點擊與拖拽物理、右鍵菜單點播動作，並可配合餘額展示、系統通知、碎碎念與對話。插件聲明 platform: DeepSeek Harness Web，與 Cordis 插件機制集成；瀏覽器端與可選的 Electron 桌面 Helper 共用 src/shared/ 裏的邏輯，行爲對齊。
社區插件目錄頁：https://www.skillhub.cn/plugins/ggxx001/dsh-pet。源碼與詳細說明見 GitHub：https://github.com/ggxx001/dsh-pet（package 元數據中 homepage 亦指向同名文檔倉庫 lineage）。DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
動畫與交互¶
- 透明動畫鏈：段與段按權重銜接（默認 idle / turn / move 與隨機動作池），雙緩衝 video 交叉淡入；Chrome / Edge / Firefox 與桌面模式（Electron）播放包內 VP9-alpha
.webm。 - 漫遊與朝向：沿 facing 方向行走並做邊界檢查；動畫 CSS 鏡像支持左右朝向。
- 點擊與拖拽：點擊有隨機回應與 Q 彈擠壓；拖拽爲過阻尼彈簧跟手，鬆手後可按軌跡估速甩拋、碰壁反彈、落地摩擦；物理參數可在配置
physics段調整（資料 0.2.5 起），設置頁提供圖形化編輯。 - 右鍵菜單：瀏覽器與桌面共用菜單組件；可回到初始位置、重載配置（桌面）、按分類點播動作；桌面端另有打開 DSH 站點 / 查看餘額等項（具體文案隨宿主略有差異）。
碎碎念、對話與餘額¶
- 碎碎念：按
eventsRefreshSec.whisper週期（默認 300 秒）調用當前會話所用模型生成，默認開啓，可按寵物關閉pets[].whisperEnabled；右鍵可立即催一句。 - 對話：右鍵「對話」或
/chat <消息>；記憶寫在$DSH_HOME/dsh-pet/memory.json，瀏覽器與桌面共享。 - 餘額展示：可按檔位播動畫並顯示聯想氣泡，每隻寵物可獨立開關。
- 模型成本：資料明確——除主動開啓碎碎念或發起對話外，運行時默認 零 LLM/API 調用；表情包配圖開關
whisperImageEnabled/chatImageEnabled會增加 prompt 體量，需自行權衡。
多開、桌面模式與擴展¶
- 多寵物：設置頁可配置多隻，各自 id、大小、位置、顯示位置（僅瀏覽器 / 僅桌面 / 兩者 / 隱藏）。
- 桌面模式：默認
display: "both"時，瀏覽器 overlay 與透明置頂小窗各一份；本機無 Electron 時插件可能從~/.dsh/electron拉取運行時（僅影響桌面端，瀏覽器端仍可用）。 - pet pack：可在
pet/下增加新種類；自定義動畫可放入main-animation/webm/（用戶目錄優先於包內素材）。 - 獨立運行：不打開 DSH 時可用
npx dsh-pet-standalone（見 README「獨立運行」章節）。
macOS Safari 透明通道¶
Safari / WKWebView 對 webm alpha 支持不足時，需將 HEVC-with-Alpha 的 .mov 放入 $DSH_HOME/dsh-pet/main-animation/mov/（素材發佈頁見 README 中 assets-mov release）；未放置時退回 webm（可能黑底但不停播）。
安裝與啓用¶
桌面應用（Electron 版）：在應用內「插件管理」安裝框填寫包名，無需開終端：
dsh-pet
dsh web 用戶在終端執行（資料原文命令）：
dsh plugin --profile web add dsh-pet
裝完後必須重開桌面應用或重啓 dsh web 才生效。寵物默認出現在界面右上角（角落可在設置頁修改）；動畫開箱即用，無需額外生成流程。
首次啓用且選擇「瀏覽器 + 桌面」時，可能先看到瀏覽器內寵物，桌面 Helper 在後臺準備 Electron 後再出現第二份實例；若只想保留一處，在設置頁或寵物右鍵「顯示位置」中切換即可。
典型用法¶
- 安裝並重開 DSH，確認 Web 角落實體可點、可拖。
- 右鍵寵物 → 動作，按分類點播移動或隨機動作，觀察漫遊與邊界行爲。
- 需要陪聊時：右鍵「對話」或輸入
/chat 你好；不需要模型消耗時，在設置裏關閉對應寵物的whisperEnabled。 - 只看餘額：右鍵「查看餘額」（桌面）或等待週期觸發，確認氣泡與檔位動畫。
- 長期桌面陪伴、不開 Harness：按 README 使用
npx dsh-pet-standalone（需自行閱讀該節環境與限制）。 - Safari 用戶：按上文路徑補全
.mov後刷新頁面。
配置持久化在 DSH 用戶目錄下（如 $DSH_HOME/dsh-pet/）；改動物理、多寵物、通知開關等以設置頁與 README「配置」章節爲準。
適用場景與注意¶
適合誰：希望在 DSH 工作或調試 Agent 時保留輕量陪伴感、又不把天氣/監控等業務塞進插件的開發者；需要餘額一眼可見、偶爾跟寵物對話的用戶也可選用。
使用前請知悉：
- 插件隨 當前 DSH 進程權限 運行，安裝前建議閱讀源碼與許可證（資料中 LICENSE 鏈至 GitHub 倉庫）。
- 碎碎念、對話會走當前會話模型，注意額度與隱私；對話記憶默認全量落盤，僅請求時截取最近
chatMemoryRounds輪。 - 桌面模式涉及 Electron 下載與透明窗交互，失敗時通常隻影響桌面端，不影響瀏覽器內寵物。
- 社區目錄信息與 npm 包 dsh-pet 以 README / package 爲準；勿憑插件名自行拼接未在文檔出現的
dsh plugin add github:...安裝串。
結尾¶
dsh-pet 把透明動畫桌寵、可選桌面置頂窗、餘額與輕量 LLM 互動收進一個 DSH 插件，默認不打擾核心工作流，又能在空閒時提供可配置的陪伴與展示。若要從目錄瞭解歸類與簡介，可打開 SkillHub 插件頁；實現細節、配置字段與進階定製見 GitHub 倉庫 README。
