前言¶
在 DeepSeek Harness（DSH）里長時間跑智能體會話時，界面往往只有輸入框、工具調用和審批提示，缺少對「當前會話在幹什麼」的直觀反饋。下面介紹社區插件 dsh-desktop-pet（維護者 Kris8888888，GitHub 倉庫 Kris8888888/dsh-desktop-pet）：它在 DSH 輸入框上沿（或窗口內可拖拽位置）顯示一隻 DeepSeek 風格鯨魚或像素螃蟹，根據會話狀態切換姿態，並把每輪消耗的 token 當作「進食」來驅動飢餓、睏倦等狀態。狀態與日記保存在瀏覽器 localStorage，README 明確說明不會向外部發送數據。
這是什麼¶
dsh-desktop-pet 是 DSH 的 Web 客戶端插件（package.json 版本 2.0.0，MIT 許可證）。定位一句話：爲 DSH 提供一隻蹲在輸入框邊緣、會對當前會話做出反應的桌寵。社區目錄分類爲「趣味換裝」；倉庫在 SkillHub 插件頁與 GitHub 均可查，與 DeepSeek / 幻方無官方從屬關係，屬於「一切皆插件」生態下的獨立貢獻。
核心功能¶
與會話聯動¶
插件會讀取當前會話進展，README 列出的行爲包括：
- Agent 運行中顯示「工作中」類狀態。
- 工具調用等待你審批時響鈴；點擊可跳轉到對應會話。
- 一輪對話結束時插旗示意完成。
- 出錯時顯示紅點。
Token 與養成¶
每輪對話結束後，插件用該輪的 inputTokens + outputTokens 餵養寵物（cache reads 不計入）。隨時間推移會出現飢餓、睏倦、生病等狀態，需通過右鍵菜單互動（見下）。
交互與右鍵菜單¶
- 餵食：零食每日 3 次。
- 喂藥：生病時使用。
- 撫摸、送它旅行（約 40–120 分鐘後返回並帶明信片）。
- 狀態卡、日記。
寵物默認棲在輸入框上沿，頁面切換時跟隨輸入框；頁面上沒有輸入框時退到窗口右下角。可在窗口內拖拽到任意位置；拖到輸入框附近可再次棲停。
設置項¶
在 DSH 中：Settings → Desktop Pet。README 說明可切換鯨魚 / 螃蟹、四種尺寸、每個角色三種配色皮膚，以及提醒（中午、久坐、日終、深夜）和心形特效等。
可選：桌面浮動版（macOS / Windows）¶
默認在 DSH 窗口內部繪製寵物。另有浮動版：貼在 DSH 窗口外緣頂部，可拖到桌面。因插件本身不能單獨開窗口，該版本需通過安裝腳本修改已安裝的 DSH 應用（app.asar），使用前須閱讀倉庫內 docs/desktop-edition.md。安裝浮動版後，本插件會把設置與會話事件交給浮動寵物，而不再在窗口內重複繪製。
安裝與啓用¶
官方安裝命令（來自 README）：
dsh plugin add git+https://github.com/Kris8888888/dsh-desktop-pet.git
也可在 DSH 內置插件市場中安裝。裝好後在 Settings → Desktop Pet 打開開關並調整角色與提醒。
典型用法¶
- 按上面命令或市場安裝插件並啓用 Desktop Pet。
- 正常在 DSH 裏創建會話、運行 Agent；觀察寵物在工作、待審批、完成、錯誤等姿態變化。
- 出現審批等待時，注意鈴聲，點擊寵物跳轉到待處理會話。
- 右鍵打開菜單：按需餵食、撫摸、送旅行或查看日記；長時間不用時可留意飢餓 / 生病提示。
- 若需要窗口外浮動桌寵，僅在 macOS / Windows 上按
docs/desktop-edition.md操作桌面版，並理解其對 DSH 安裝包的補丁方式。
適用場景與注意¶
適合：希望在 DSH 界面裏用輕量視覺反饋跟蹤會話狀態、並願意用 token 消耗與本地養成機制增加使用趣味的開發者。
注意：
- 插件隨當前 DSH 進程在瀏覽器 / 客戶端環境中運行，安裝前建議通讀倉庫源碼與 MIT 許可證，確認符合你的安全與合規要求。
- 養成與日記數據僅存本地
localStorage，換瀏覽器或清緩存會丟失，需自行備份習慣。 - 桌面浮動版會 patch 官方 DSH 應用包，屬於進階選項，失敗或升級 DSH 後可能需要重新處理；僅在有明確需求時使用。
- README 聲明：非 DeepSeek 官方作品；鯨魚爲基於 DeepSeek logo 的同人圖，螃蟹參考 Claude Code 吉祥物。
結尾¶
dsh-desktop-pet 把會話狀態、審批提醒和 token 消耗綁在一隻可換裝的小寵物上，不改變 DSH 核心工作流，適合作爲長時間編碼 / 調 Agent 時的伴生 UI。查閱分類與簡介可打開社區目錄頁 skillhub.cn/plugins/Kris8888888/dsh-desktop-pet；細節與截圖見 GitHub README。
