前言¶
DeepSeek Harness(下面簡稱 dsh)把模型、工具、會話和 UI 都做成插件,官方的說法是「一切皆插件」。開發者預覽版開放之後,網頁界面成了很多人跑智能體的主入口:左邊對話,中間軌跡,右邊工具調用,任務一多,狀態全擠在文字和進度條裏。
社區裏很快出現一類「趣味」插件:不給模型加新工具,只在網頁上疊一層桌寵,讓當前任務、思考、報錯能用表情說出來。deepseek-pet 走的就是這條路,角色不是通用小貓小狗,而是 DeepSeek 那隻會喫白飯的大藍鯨。
需要先說清楚:本文介紹的安裝入口來自社區插件目錄 deepseek-harness-plugin.com,這是獨立站點,和 DeepSeek / 幻方沒有官方從屬關係,不能當成官方應用商店。插件本身由 GitHub 用戶 keleus 維護,倉庫地址是 keleus/deepseek-pet,MIT 許可證,當前包版本爲 0.1.0。截至 2026-08-17,GitHub 顯示 28 個 star;社區目錄頁當時仍寫 11,星標以倉庫頁面爲準。
這是什麼¶
deepseek-pet 是一個嵌在 DeepSeek Harness 網頁界面裏的交互式桌寵插件。目錄頁上的一句話是:「在你的 deepseek-harness 上養一隻喫白飯的大藍鯨。」
它不改 dsh 內核,也不給模型註冊新工具。package.json 裏聲明瞭 dsh.client.platform 爲 web,客戶端注入 @deepseek-ai/dsh-client-runtime 和 @deepseek-ai/dsh-client-ui-layout,入口把角色註冊到網頁的 shell.overlay 槽。Host 側幾乎是空實現,看得見的行爲都在瀏覽器裏完成。
解決的問題很具體:智能體在分析、調工具、等你批准、寫回答、失敗或閒置時,網頁上缺一個不擋操作、又能跟着狀態變的視覺錨點。這隻藍鯨會讀當前會話快照,切換表情和短句;動畫是呼吸、彈跳、傾斜、視差和淡入,README 寫成「Live2D 風格」,實現上並不是拆圖層的 Live2D 模型,而是整張表情圖切換,再把運動加在整張圖上,避免頭手腳對不齊、表情跳變。
核心功能¶
倉庫 README 和客戶端源碼(src/client/pet-state.js、pet-presentation.js)對得上的能力,可以分成下面幾組。
1、狀態跟着任務走。角色會根據當前任務、工具調用、上下文佔用和活躍會話換表情。分析、回答、編碼、網絡搜索、子 Agent、完成、失敗各有對應形象;回答階段會在敲電腦、思考、覈對之間輪換,思考階段會換不同狀態標籤。源碼裏工具名還會映射成短句,例如 bash / exec_command 顯示「正在敲終端」,web_search 顯示「正在查找資料」。
2、氣泡和會話條。角色上方有一條與寵物等寬的氣泡,輪播狀態短句,並用單行橫向打字機效果跟上最新輸出;沒有任務活動時,約 10 秒後自動隱藏。角色下方用橫條顯示聚焦會話,亮邊標記當前項;正在執行的會話向下排,超過三個會層疊收起。多個會話並行時進入 README 所說的「忙瘋了」狀態。
3、批准和提問可以點在寵物上。工具等待批准時,氣泡裏可以直接允許或拒絕。用戶問題支持選項、自定義輸入、提交和拒絕。點活躍會話,可以把該會話切成聚焦會話。這些交互走的是網頁 overlay,不是另開窗口。
4、上下文和空閒也有表情。上下文佔用到 62% 時提示「還可以再喫一點」,到 82% 時顯示「喫飽了」,源碼用的是 contextRatio >= 0.62 / 0.82。帶圖片輸入時切到矇眼。無任務約 10 分鐘顯示餓了,30 分鐘抱枕犯困,1 小時後睡覺。還會按本地時間做早上、中午、下午、晚上問候,23 點後犯困,凌晨進入睡覺。reasoning 裏疑問較多時顯示困惑或壓力;用戶指出回答有誤時顯示道歉。
5、位置和尺寸可調。支持拖動、單擊互動、雙擊摺疊;鼠標移入角色時,腳下出現「−」最小化按鈕,點它或雙擊會收到右下角靜止圖標。懸停時滾輪縮放,範圍約 65%~140%,位置和尺寸會記住。窄屏和 prefers-reduced-motion 也有處理。
安裝與啓用¶
社區目錄頁給出的安裝命令是:
dsh plugin add github:keleus/deepseek-pet
這是目錄頁原文。該插件只作用於 Web 界面,維護者 README 要求裝到 web profile。已經全局安裝 dsh 時,推薦按倉庫說明執行:
dsh plugin --profile web add github:keleus/deepseek-pet
沒有全局 dsh 時,不必先裝 CLI,直接用 npx:
npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet
README 寫明:安裝需要 Node.js 和 pnpm;兩種命令效果相同,都會從 GitHub 拉取插件並裝進 Web profile。目錄頁還提示,若要可復現安裝,可固定 commit 哈希,例如:
dsh plugin add github:keleus/deepseek-pet#287414d31c9a8fe4122109e85d8fe9dc0299cdc4
上面的哈希是 2026-08-15 倉庫 main 分支當時的最新提交,只作示例;實際使用前請到 GitHub 再核一次。
裝完後啓動或重啓網頁。全局 CLI:
dsh web
npx:
npx @deepseek-ai/dsh web
網頁已經打開的話,刷新即可。更新方法是再跑一遍安裝命令,然後重啓網頁進程並刷新。卸載:
dsh plugin --profile web remove deepseek-pet
沒有全局 CLI 時,把前面換成 npx @deepseek-ai/dsh。
如果要改源碼再裝,README 給出的流程是:
git clone https://github.com/keleus/deepseek-pet.git
cd deepseek-pet
npm install
npm run build
dsh plugin --profile web add .
本地安裝會鏈接當前目錄,改完重新構建就能繼續調試。開發構建還要求 Node.js 22.19 或更高版本,以及 Python 3 和 Pillow,用來從源圖生成透明 WebP 表情並嵌入客戶端;日常只按 GitHub 安裝、不改素材的話,走上面的 dsh plugin add 即可。
典型用法¶
安裝並打開 dsh web 之後,寵物會出現在網頁 overlay 上。README 裏的操作可以按這個順序試:
1、拖動角色,放到不擋對話和軌跡的位置。
2、鼠標停在角色上滾動滾輪,把尺寸調到 65%~140% 之間舒服的一檔。
3、發一條普通任務,看氣泡是否跟上輸出、表情是否切到思考或敲電腦。
4、並行開多個會話,看下方會話條和「忙瘋了」是否出現;點擊某條活躍會話,確認聚焦會切換。
5、遇到工具批准或提問卡片時,直接在氣泡裏允許、拒絕、選擇或輸入。
6、暫時不需要桌寵時,雙擊角色或點腳下的「−」,收到右下角;單擊角色會觸發和當前狀態相符的短句。
這些步驟都不需要額外配置文件。插件讀的是 Harness Web 當前會話快照,沒有獨立的寵物服務器,也沒有要求填 API Key。
適用場景與注意事項¶
適合已經在用 dsh web、希望界面上有一個跟任務狀態同步的視覺提示的人。它是趣味插件,不提供新的模型能力,也不替代 Trajectory、工具面板或通知類插件。終端 TUI、無網頁的運行方式裝了也看不到這隻鯨,因爲客戶端明確標了 platform: web。
使用前有幾條需要單獨看:
1、插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。目錄頁和倉庫都建議先檢查源代碼和許可證。本倉庫許可證是 MIT,版權聲明爲 Copyright (c) 2026 keleus。
2、表情圖是完整切換,不是可換裝的 Live2D 部件。想自己換角色,需要按倉庫的素材流程(npm run assets)重新生成 WebP,而不是丟一個 .moc3 進去。
3、圖片輸入會顯示矇眼,這是插件根據會話內容做的表現,不代表它給模型補上了視覺能力。
4、社區目錄和 GitHub 的元數據可能不同步(星標、最近推送時間都出現過滯後)。安裝命令、profile、commit 哈希以你打開的倉庫 README 和 GitHub 提交爲準。
5、DeepSeek Harness 仍處於開發者預覽,核心插件和 API 會變。這個寵物掛在 shell.overlay 上,以後槽位或會話快照字段若調整,表情映射可能要跟着改。
小結¶
deepseek-pet 做的事情很窄:在 DeepSeek Harness 網頁上放一隻喫白飯的大藍鯨,用整張表情圖和 CSS 動畫,把任務、工具、上下文和空閒翻譯成能看懂的樣子。維護者是 keleus,MIT 開源,裝到 web profile 後刷新即可用。
目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-pet/
GitHub:https://github.com/keleus/deepseek-pet