前言¶
在 DeepSeek Harness(DSH)裏跑任務時,工具調用、會話切換和上下文佔用都在後臺發生,界面往往只呈現文本流。長時間盯着輸出,很難一眼看出當前是在思考、等批准,還是多個會話並行執行。
DeepSeek Pet 是 maintainer keleus 爲 DSH Web 做的交互式桌寵插件。它把任務狀態映射成角色表情和短句反饋,並支持拖動、縮放和最小化,讓網頁端的使用過程更直觀。下面介紹它的定位、功能、安裝方式和日常操作。
這是什麼¶
DeepSeek Pet 是一個嵌入 DeepSeek Harness 網頁的交互式桌寵插件,分類爲「趣味換裝」。插件簡介是:在你的 deepseek-harness 上養一隻喫白飯的大藍鯨。
它跟隨當前任務、工具調用、上下文佔用和活躍會話自動切換 DeepSeek 表情,並通過呼吸、彈跳、傾斜、視差和淡入動畫呈現 Live2D 風格效果。角色使用完整表情圖切換,不拆分頭部、手腳或五官圖層,避免部件錯位和表情突變。
維護者:keleus
GitHub:https://github.com/keleus/deepseek-pet
社區目錄:https://www.skillhub.cn/plugins/keleus/deepseek-pet
許可證:MIT
核心功能¶
狀態展示與交互¶
- 角色上方用與 Pet 等寬的氣泡輪播狀態短句,並以單行橫向打字機效果跟隨最新輸出;無任務活動時 10 秒後自動隱藏。
- 角色下方用橫條顯示聚焦會話並以亮邊標記,正在執行的會話向下排列,超過三個時自動層疊收起。
- 多個會話並行執行時進入「忙瘋了」狀態。
- 根據分析、回答、編碼、網絡搜索、子 Agent、完成和失敗等場景切換表情;回答階段輪換敲電腦、思考和認真核對等工作形象,思考階段輪換不同狀態標籤。
- 工具等待批准時,可直接在氣泡中允許或拒絕。
- 用戶問題支持選項、自定義輸入、提交和拒絕。
- reasoning 中疑問較多時顯示困惑或壓力錶情。
- 用戶指出回答有誤時顯示道歉表情。
上下文與輸入感知¶
- 上下文達到 62% 時提示「還可以再喫一點」,達到 82% 時顯示「喫飽了」。
- 圖片輸入時顯示矇眼狀態。
待機與時間問候¶
- 無任務 10 分鐘顯示餓了,30 分鐘抱枕犯困,1 小時後睡覺。
- 待機、思考、回覆、成功、等待、錯誤和乾飯等動作按累計時間穩定輪換,不會因重渲染隨機跳圖。
- 根據本地時間顯示早上、中午、下午和晚上的問候,23 點後犯困,凌晨進入睡覺狀態。
佈局與設置¶
- 鼠標移入角色時,在角色腳下顯示「−」最小化按鈕。
- 支持拖動角色、單擊互動、雙擊摺疊;鼠標懸停角色時可用滾輪縮放,並記住位置和尺寸。
- 支持窄屏佈局和
prefers-reduced-motion。 - 設置面板新增「桌寵設置」頁,可配置動作圖片,並提供兩種展示模式:
- 默認:保持當前展示方式不變。
- 頁面置頂:桌寵固定在視口右下角,懸浮在當前網頁所有內容(包括彈窗)之上。
- 設置頁可按動作組啓用或停用具體圖片,每組至少保留一張;思考和執行工具時會在工作與白米飯動作間穩定交替。
安裝與啓用¶
安裝需要 Node.js 和 pnpm。如果已經全局安裝 dsh,運行:
dsh plugin --profile web add github:keleus/deepseek-pet
沒有全局 dsh 命令時,直接通過 npx 執行:
npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet
兩種命令效果相同,都會從 GitHub 拉取插件並安裝到 Web profile。
安裝完成後啓動或重新啓動網頁。全局 CLI:
dsh web
npx:
npx @deepseek-ai/dsh web
如果網頁已經打開,請刷新頁面。
從源碼安裝¶
需要拉取源碼並本地構建時:
git clone https://github.com/keleus/deepseek-pet.git
cd deepseek-pet
npm install
npm run build
dsh plugin --profile web add .
沒有全局 CLI 時,將最後一條命令替換爲:
npx @deepseek-ai/dsh plugin --profile web add .
本地安裝會鏈接當前目錄,修改代碼並重新構建後即可繼續調試。
更新與卸載¶
更新時重新執行安裝命令,隨後重新啓動網頁進程並刷新頁面:
dsh plugin --profile web add github:keleus/deepseek-pet
或:
npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet
卸載:
dsh plugin --profile web remove deepseek-pet
沒有全局 CLI 時:
npx @deepseek-ai/dsh plugin --profile web remove deepseek-pet
典型用法¶
安裝並刷新頁面後,桌寵會隨 DSH 任務狀態自動變化。日常操作如下:
- 拖動角色:調整顯示位置。
- 鼠標停在角色上滾動滾輪:在 65%~140% 範圍內調整 Pet 尺寸。
- 單擊角色:觸發與當前狀態相符的短句反饋。
- 雙擊角色或點擊「−」按鈕:最小化爲右下角靜止圖標。
- 點擊活躍會話:將該會話切換爲聚焦會話。
- 出現批准或提問卡片時:可直接選擇、輸入、允許或拒絕。
如需自定義展示,打開設置面板的「桌寵設置」頁,按動作組啓用或停用圖片,或切換「默認」與「頁面置頂」模式。
適用場景與注意¶
適合在 DSH Web 端長時間使用、希望從界面直接感知任務狀態的用戶。桌寵會響應工具批准、多會話並行、上下文佔用等運行時事件,也能在空閒時段展示待機動畫。
安裝前請注意:
- 插件以當前
dsh進程權限運行,安裝前應檢查源碼與 MIT 許可證。 - 社區目錄 SkillHub 是獨立站點,與 DeepSeek / 幻方無官方從屬關係。
- 開發環境要求 Node.js 22.19 或更高版本,以及 Python 3 和 Pillow;本地修改素材可執行
npm run assets,構建產物在lib/目錄。
結尾¶
DeepSeek Pet 把 DSH 網頁裏的任務狀態轉成可見的表情、短句和會話條,同時保留拖動、縮放和最小化等桌寵交互。需要安裝或查看更新時,可訪問社區目錄頁或 GitHub 倉庫:
- https://www.skillhub.cn/plugins/keleus/deepseek-pet
- https://github.com/keleus/deepseek-pet