前言¶

DSH 以插件方式擴展 Web 界面能力。日常使用 DSH Web 時，agent 的空閒、思考、調用工具、報錯和完成不一定有足夠直觀的視覺反饋。nzl153/dsh-pet-whale 是一個 Web 桌寵插件，用一隻小鯨魚隨 agent 狀態切換動畫，把當前狀態放到頁面角落。

這是什麼¶

倉庫標識爲 nzl153/dsh-pet-whale，維護者爲 nzl153。它的定位是：桌寵小鯨魚，隨 agent 狀態切換動畫的 DeepSeek Harness Web 桌寵插件（官方輪廓版）。許可證爲 MIT，要求 DSH >=0.1.0-rc.6（web profile）。

核心功能¶

狀態反饋¶

• 狀態機：idle / think / working / celebrate / error / disappointed / wait
• 回合語義：有工具顯示 working，無工具顯示 think 深潛

交互與展示¶

• 單擊戳戳、雙擊 360° 翻滾、拖拽移動並記憶位置、右鍵菜單
• WebAudio 合成六種音效，右鍵可關
• 7 套預設色板換膚：主題藍 / 陶土 / 深海藍 / 抹茶綠 / 櫻粉 / 墨灰 / 夜黑
• 跟隨 DSH 亮/暗主題自動切換樣式
• 中文 / English 兩套完整文案，接入 DSH 官方 locale 服務自動跟隨
• 隱藏到右下角並可召回，小按鈕隨 agent 狀態變色
• 頁面切到後臺自動暫停動畫、音效和思考流
• prefers-reduced-motion 下自動降級爲靜態顯示

安裝與啓用¶

要求：

DSH >=0.1.0-rc.6（web profile）

本地目錄安裝：

dsh plugin --profile web add link:/path/to/pet-whale

git 直裝：

dsh plugin --profile web add "github:<user>/pet-whale#main"

安裝命令包含佔位符：link:/path/to/pet-whale 需要替換爲實際本地路徑，github:<user>/pet-whale#main 需要替換爲實際 GitHub 用戶。

裝完重啓 dsh web；client 半改動硬刷新（Ctrl+F5）。

典型用法¶

在線預覽：

https://nzl153.github.io/dsh-pet-whale/preview.html

構建與測試：

pnpm install
pnpm typecheck
pnpm build
pnpm test

適用場景與注意¶

適合想在 DSH Web 頁面中增加 agent 狀態視覺反饋的人，例如通過小鯨魚動畫、音效、色板、隱藏召回和文案狀態瞭解當前 agent 在做什麼。

注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 安裝命令含佔位路徑/用戶，需要按實際環境替換。
• 可選系統通知默認關，開啓時才申請權限。
• 小按鈕位置、隱藏狀態、部分偏好使用 localStorage 記憶。
• 鯨魚輪廓使用 DeepSeek 官方 FishLogo 路徑（品牌素材，使用請註明出處）。
• patches/ 爲個人自用 DSH 界面定製補丁，不是本插件組成部分。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

nzl153/dsh-pet-whale 把 agent 狀態、交互、換膚、隱藏召回、多語言和無障礙降級放在一個輕量桌寵裏，作爲 DSH Web 的狀態反饋擴展使用。

目錄頁：https://www.skillhub.cn/plugins/nzl153/dsh-pet-whale

GitHub：https://github.com/nzl153/dsh-pet-whale