前言¶
在 DSH web 表面運行多個 session 時,開發者通常需要查看哪些線程在忙、各自在調用什麼工具,以及當前事件處於哪個階段。直接看日誌可以,但信息比較散。
dsh-pet-shura 把這部分信息放到一個動畫桌面寵物上:寵物上方顯示事件氣泡,雙擊或右鍵可以打開線程狀態卡,寵物周圍還能顯示忙碌線程對應的工具節點。
下面介紹它的能力、安裝方式和典型用法。
這是什麼¶
dsh-pet-shura 是 brittanistrehlowll-oss 維護的 DeepSeek Harness (DSH) web 表面動畫桌面寵物,中文名爲“修羅小腦斧”。許可證爲 MIT。
它基於 v2 spritesheet:
1536×2288
8 列 × 11 行
192×208 cells
package.json 版本爲 1.5.0,type 爲 module,主入口爲 lib/index.js。README 聲明它是零依賴宿主插件,並聲明 “Nothing touches your model traffic”。
核心功能¶
事件氣泡與線程概覽¶
- SSE 氣泡:通過
/pet/events在寵物上方顯示 Codex 風格氣泡。 - 線程概覽:跟蹤忙碌線程(session),每 15 秒刷新。
- 中文臺詞庫:按
user/work/done/error/ask/reply/turn-end/workflow/goal等事件類型變化,並有 45–90 秒空閒自說。
動畫、光標跟隨與狀態表達¶
- 完整 v2 動畫:覆蓋 11 行精靈表,包括
idle、running left/right、waving、jumping、failed、waiting、task-running、review和 16 方向環視。 - Look-at-mouse:以 16 方向幀跟隨光標(240px radius)。
- 拖放並記住位置:保存於
localStorage['dsh.pet.pos']。 - 隨機動作:每 7–16 秒進行揮手、跳躍、翻滾或走動,空閒 22 秒進入等待姿勢。
- 狀態符號:思考時顯示
?,錯誤時出現紅色 shake!,成功時對勾閃爍,等待時顯示Zzz。 - 插件環:寵物周圍半圓工具環,最多 6 個節點對應忙碌線程,由
GET /pet/status驅動。 - 核心光暈:工作時增強,呈現可見能量核心狀態。
線程狀態卡、設置與右鍵菜單¶
- 線程狀態卡:雙擊寵物或右鍵選擇“線程狀態”,由
GET /pet/status提供忙碌線程和工具信息。 - 設置面板:右鍵選擇“設置”,可調整大小(60/75/100%)、隨機動作、look-at-mouse、重置位置,保存於
localStorage['dsh.pet.settings']。 - 右鍵菜單:寵物信息、隱藏/召回、線程狀態、設置。
- 安全失敗:spritesheet 不可用時腳本移除自身,不打擾宿主頁面。
安裝與啓用¶
先運行安裝命令:
dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-pet-shura"
然後重啓 dsh web,並刷新頁面。
卸載時運行:
dsh plugin --profile web remove dsh-pet-shura
然後重啓 dsh web。
典型用法¶
1、雙擊寵物,或右鍵選擇“線程狀態”,查看忙碌線程及其工具。
2、右鍵寵物選擇“設置”,調整大小、隨機動作、look-at-mouse 或重置位置。
3、如果要做小改動,通常只需編輯 lib/pet-client.js;該文件由 tapIndex 內聯到 index.html,無需構建步驟。
適用場景與注意¶
適合需要在 dsh web 表面保持對多個線程狀態可見性的開發者。它會把位置設置寫入瀏覽器:
localStorage['dsh.pet.pos']
localStorage['dsh.pet.settings']
運行時使用 /pet/events SSE、GET /pet/status 以及專用 spritesheet 路由。
插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證,只啓用可信的插件。
相關頁面¶
- 目錄頁:https://www.skillhub.cn/plugins/brittanistrehlowll-oss/dsh-pet-shura
- GitHub:https://github.com/brittanistrehlowll-oss/dsh-pet-shura