前言¶
DeepSeek Harness（DSH）支持通過插件擴展 Web 界面功能。開發者在調試或日常使用中，常希望在瀏覽器側增加一點「陪伴感」或「桌面趣味性」。dsh-k-on-pet 插件將原版 Windows 桌寵《K-ON! 輕音少女》移植到 DSH，讓五位角色以桌寵形式懸浮在右下角，與當前會話同時存在。
是什麼¶
dsh-k-on-pet 是一個 DSH 客戶端插件，維護者爲 sunjay-lee。它不修改 DSH 源碼，也不另起窗口，而是通過 DSH 的插件機制，將角色渲染層掛載到 Web GUI 的 overlay 槽位。安裝後，五位角色會出現在右下角，通過點擊、拖動、雙擊等交互與用戶互動，並在 DSH 設置裏提供獨立的開關與配置。
核心功能¶
- 角色與語音：五位角色（平澤唯、秋山澪、田井中律、琴吹紬、中野梓）共 137 條原版語音。每張 96×96 精靈圖集，包含待機、被點擊、打瞌睡、被拎起等動作。
- 點擊交互：單擊切換
react動作並隨機播一條語音，氣泡顯示臺詞。 - 雙擊交互：比心動作 + 隨機臺詞。
- 拖動與拋出：按住拖動會播放
held動作，鬆手後根據速度做拋物線運動，落地後恢復待機。拖出可視區會被自動拉回。 - 閒置與關懷：約 4 分鐘無操作進入
sleep狀態，再久一點冒Zzz氣泡。每 2.5–5 分鐘隨機閒聊一句，每 50 分鐘提醒喝水 / 起身 / 看遠處。 - 角色設置：在 DSH 設置 → K-ON! 桌寵 裏獨立開關五位角色，可同時顯示；支持全部顯示 / 全部隱藏。
- 茶桌功能：默認常駐界面底部偏上（聊天輸入框上方），可在設置裏關閉。拖動桌面可移動茶桌位置，右鍵桌面可固定位置、讓全部角色入座或離座。將角色拖到茶桌範圍內會自動坐到自己的固定座位，從座位拖出即離座。唯、律、紬入座後播放 4×2 的坐姿動畫，澪、梓爲靜態坐姿。
- 外觀與行爲：統一大小（1.0–2.4×）、語音、隨機閒聊、關懷提醒開關，以及一鍵恢復默認。
- 右鍵菜單：隱藏這隻、把這隻重置回右下角。菜單爲頁面內浮層，不依賴瀏覽器彈窗。
- 記憶與持久化：角色顯隱、大小、語音/閒聊/關懷開關、每個角色各自的座標保存在瀏覽器
localStorage，刷新後恢復。設置頁和寵物右鍵菜單讀寫同一份偏好。 - 不擋操作：只有寵物本體接收指針事件，其餘區域點擊穿透。
- 無網絡、無模型調用：不請求外部接口，不上傳任何數據。
安裝與啓用¶
要求：DSH Web profile（桌面端或 dsh web），DSH 0.2.x。當前在 0.2.1-rc.2 上實測通過。
方式一：插件面板（推薦）¶
在 DSH 的「插件 / 插件市場」裏搜索 dsh-k-on-pet，安裝並啓用。面板會同時處理依賴和 bundle 註冊。
方式二：命令行¶
dsh plugin --profile web add dsh-k-on-pet
安裝後，需要讓 profile 加載它。打開 $DSH_HOME/profiles/web/package.json（默認 ~/.dsh/profiles/web/package.json），把 "dsh-k-on-pet" 加進 dsh.profile.bundles 數組：
{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-k-on-pet"]
}
}
}
然後重啓 dsh web / 桌面端。
方式三：從 GitHub 安裝¶
dsh plugin --profile web add github:sunjay-lee/dsh-k-on-pet
同樣把 dsh-k-on-pet 加入 dsh.profile.bundles 後重啓。
卸載¶
從 dsh.profile.bundles 移除 dsh-k-on-pet，然後：
dsh plugin --profile web remove dsh-k-on-pet
典型用法¶
- 單擊角色，觀察動作切換與語音播放。
- 拖動角色，觀察被拎起與拋出效果。
- 將角色拖到茶桌範圍，觀察自動入座與坐姿動畫。
- 在 DSH 設置 → K-ON! 桌寵 裏調整大小、開關語音或關懷提醒。
- 右鍵角色，使用「隱藏這隻」或「回到右下角」。
適用場景與注意¶
- 適合希望在 Web 調試或使用過程中增加一點桌面陪伴感的開發者。
- 插件以當前 dsh 進程權限運行，安裝前建議查看源碼與許可證（代碼 MIT，角色素材爲同人資源，詳見 THIRD_PARTY_NOTICES.md）。
- 設置保存在瀏覽器
localStorage，換瀏覽器或清空站點數據會恢復默認（僅唯、1.5×、右下角）。 - 不依賴 TUI / headless profile，僅支持
webprofile。
短結尾¶
dsh-k-on-pet 將《K-ON! 輕音少女》桌面寵物移植到 DSH Web 界面，通過點擊、拖動、茶桌入座等交互提供陪伴感。代碼 MIT，角色素材爲同人資源。安裝方式見上方命令，詳細配置與使用在 DSH 設置 → K-ON! 桌寵 分區。
- 插件市場：https://www.skillhub.cn/plugins/sunjay-lee/dsh-k-on-pet
- GitHub：https://github.com/sunjay-lee/dsh-k-on-pet
