前言¶
在 DeepSeek Harness（DSH）里長時間寫提示、調插件時，界面往往只有會話和工具面板，缺少一點「人在電腦前」的反饋。貼一張靜態 PNG 可以裝飾桌面，但不會動、不會記位置，也談不上和窗口邊緣的物理感互動。
下面介紹社區插件 dsh-lion-pet（維護者 rumpen233）：把校徽裏的刑小獅做成 DSH 桌寵，待機呼吸、隨機散步、拖拽甩動、點擊回應，並支持 DSH 網頁內與 Electron 桌面懸浮兩種展示。插件不調用模型、不寫會話、不產生 token 費用。社區目錄分類爲「趣味換裝」，倉庫當前版本 1.2.0，GitHub 星標 1（以目錄頁與倉庫公開信息爲準）。
這是什麼¶
dsh-lion-pet 是 DSH 的第三方 bundle 插件，入口爲 lib/index.js，瀏覽器側通過 lib/client.js 注入桌寵 UI（純 DOM + Shadow DOM）。一句話定位：在 DSH 頁面和/或桌面透明小窗裏養一隻刑小獅——會呼吸、會溜達、被拖起來有慣性、點一下會彈跳並說話。
DeepSeek Harness 的生態思路是「一切皆插件」；插件列表站點 SkillHub 目錄頁 與 DeepSeek / 幻方無官方從屬關係，安裝前請自行閱讀 GitHub 倉庫 源碼與許可證。
核心功能¶
網頁與桌面上的行爲¶
- 待機呼吸：輕微上下浮動和擺動。
- 隨機散步：隔一段時間在窗口下方走一小段，自動切換正面 / 側面朝向；桌面模式下主進程用緩動移動整個透明窗口，獅子可走到當前顯示器工作區內，邊緣會自動收住。
- 點擊回應：單擊「摸摸頭」——彈跳、撒愛心和星星，並隨機臺詞。
- 拖拽甩動：按住拖動；鬆手保留速度，碰窗口邊緣輕微反彈。
- 右鍵菜單：摸摸頭、散散步、轉個圈、放大 / 縮小、鎖定位置、回到右下角、隱藏。
- 隱藏與喚醒：隱藏後右下角留圓形小頭像，點一下叫回。
- 記憶：網頁端把位置、大小、鎖定、隱藏存進瀏覽器
localStorage；桌面端窗口位置在用戶數據目錄；顯示模式寫在$DSH_HOME/dsh-lion-pet/config.json。 - 桌面懸浮：Electron 透明置頂小窗（約 280×390），鼠標移出窗口時自動點擊穿透，不擋桌面操作。
- 無障礙：刑小獅可聚焦；Enter / 空格摸摸頭，
M或菜單鍵打開右鍵菜單，Esc 關閉菜單。
顯示模式與擴展¶
在 DSH 設置 → 插件 → 刑小獅 的「顯示位置」可選：
| 模式 | 效果 |
|---|---|
| 兩者都顯示 | DSH 頁面內和桌面懸浮窗同時出現 |
| 僅桌面 | 只保留透明置頂桌面窗口 |
| 僅網頁 | 只在 DSH 網頁界面裏出現 |
| 關閉 | 全部收起，不啓動桌面 helper |
桌面模式依賴本機 Electron。插件優先使用 $DSH_HOME/electron/electron.exe，也可用環境變量 DSH_LION_ELECTRON_PATH 指定。首次切換後若窗口未出現，重啓一次 DSH；host 側代碼不會熱重載。
倉庫內 extension/ 是獨立的 Chrome / Edge MV3 擴展：在任意 http(s) 網頁右下角顯示刑小獅，與 DSH 顯示模式互不影響；擴展只申請 storage 與網頁注入權限，不讀取頁面內容。
安裝與啓用¶
插件以當前 DSH 進程權限運行，安裝前請檢查源碼、MIT 許可證 以及 NOTICE（校徽與刑小獅插畫不在 MIT 範圍內）。要求 Node >= 20，peer 依賴 @deepseek-ai/cordis ^4.0.4。
從本地目錄安裝（README 推薦）¶
先把倉庫放到本機某目錄，再執行（路徑換成你的絕對路徑）：
dsh plugin --profile desktop add file:C:\path\to\dsh-lion-pet
Linux / macOS 示例：
dsh plugin --profile desktop add file:/home/you/dsh-lion-pet
當前 profile 若啓用了 HMR，插件會熱加載；否則重啓 DSH 後生效。也可在 DSH「插件」頁選擇「安裝第三方插件」，填入本地目錄絕對路徑。
手動安裝¶
- 將整個
dsh-lion-pet目錄複製到：
$DSH_HOME/profiles/desktop/node_modules/dsh-lion-pet
- 在 profile 的
package.json中加入依賴與 bundle：
{
"dependencies": {
"dsh-lion-pet": "1.2.0"
},
"dsh": {
"profile": {
"bundles": ["dsh-lion-pet"]
}
}
}
- 重啓 DSH。
典型用法¶
| 操作 | 效果 |
|---|---|
| 單擊刑小獅 | 摸摸頭：彈跳、撒星星、隨機臺詞 |
| 按住拖動 | 搬家；鬆手有慣性，碰到邊緣會反彈 |
| 右鍵 / 菜單鍵 | 打開動作菜單 |
| 滾輪 | 不攔截頁面滾動；請用菜單調大小 |
| 隱藏後點右下角頭像 | 喚醒刑小獅 |
顯示模式也可直接編輯配置文件（示例）：
{ "display": "both" }
display 可取 both / desktop / web / off。
網頁端偏好示例鍵名爲 dsh-lion-pet:v4，字段包括 x、y、size、hidden、locked、positioned。想恢復默認可右鍵選「回到右下角」，或在 DevTools 刪除對應 localStorage 鍵後刷新。
網頁通用版（Chrome / Edge）¶
- 打開
chrome://extensions（Edge 爲edge://extensions），開啓「開發者模式」。 - 「加載已解壓的擴展程序」，選擇倉庫的
extension/目錄。 - 打開任意 http(s) 網頁，右下角出現刑小獅；擴展圖標可關閉或恢復。
適用場景與注意¶
適合希望在 DSH 工作或瀏覽網頁時有一點輕量陪伴、又不需要佔用模型能力的用戶。桌寵純前端與本地 helper 邏輯，適合作爲 DSH「趣味換裝」類插件的體驗向補充。
務必注意：
- 插件與 DSH 同進程權限；第三方 bundle 安裝前請審閱
src/、runtime/desktop-helper/與cordis.patch.yml。 - 素材
assets/來自校徽插畫，再分發須遵守原圖權利人要求；代碼 MIT，插畫不在 MIT 授權範圍內。 - 卸載：
dsh plugin --profile desktop remove dsh-lion-pet
再從 profile 的 dsh.profile.bundles 中移除 dsh-lion-pet 並刷新頁面。
結尾¶
dsh-lion-pet 把刑小獅從靜態校徽變成可呼吸、可散步、可拖拽的 DSH 桌寵，並可選桌面置頂與瀏覽器擴展兩種延伸用法。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub：rumpen233/dsh-lion-pet。
