在 DeepSeek Harness Web GUI (dsh --profile web) 中開發智能體時,Agent 處於思考或等待狀態時往往是靜止的。dakeshui123/dsh-pet-frieren 插件在屏幕上增加了一個 Q 版《葬送的芙莉蓮》桌面寵物,它會跟隨 Agent 的狀態變化做出相應的動作和氣泡提示,爲開發過程提供直觀的視覺反饋。
插件介紹¶
dakeshui123/dsh-pet-frieren 是一個針對 DeepSeek Harness Web GUI 的桌面寵物插件。它通過 dsh.bundle.patch 和 dsh.client 機制集成,無需複雜的構建步驟即可運行。插件包含一個預構建的客戶端包和一個資源服務器,負責在瀏覽器端渲染精靈動畫。
核心功能¶
該插件主要提供以下功能:
-
狀態跟隨
寵物會根據 Agent 的運行狀態切換動作和表情:- 空閒:默認待機狀態。
- 思考:Agent 正在推理。
- 工具調用:Agent 正在執行工具。
- 流式輸出:Agent 正在生成回覆。
- 等待:等待用戶審批或回答。
- 錯誤:Agent 報錯時,寵物會定格在最後失敗的幀上,直到錯誤清除。
-
自動交互
在空閒狀態下,寵物會自動執行動作:- 每隔 12-30 秒自動揮手。
- 每隔 45-90 秒偶爾跳躍。
- 隨機彈出氣泡對話(約 20-40 秒)。
-
用戶交互
- 點擊:向寵物揮手一次。
- 雙擊:讓寵物跳躍一次。
- 拖拽:移動寵物位置(位置會自動保存),拖拽時寵物會左右奔跑。
- 懸停:光標懸停在寵物上時,右上角會出現關閉按鈕,點擊可隱藏寵物。
- 隱藏後:點擊隱藏標記或拖拽標記,可將寵物喚回。
-
兼容性
- 無障礙:尊重系統的
prefers-reduced-motion設置,該模式下只顯示靜態幀,無動畫。 - 資源服務:所有資源通過 HTTP 路由
/dsh-plugin-assets/dsh-pet-frieren提供,無路徑遍歷風險。
- 無障礙:尊重系統的
安裝與啓用¶
安裝該插件需要 DeepSeek Harness 的 Web GUI (dsh --profile web) 環境。
- 執行安裝命令:
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren
插件會作爲標準的 dsh bundle 安裝到 `web` 配置文件中。
- 啓動 DeepSeek Harness Web GUI:
dsh --profile web
啓動後,Frieren 會出現在屏幕上。
常用命令¶
安裝完成後,可以通過以下命令管理插件:
- 更新插件:
dsh plugin --profile web update dsh-pet-frieren
- 固定版本:
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren#v0.1.0
- 移除插件:
dsh plugin --profile web remove dsh-pet-frieren
- 從 Git 安裝:
dsh plugin --profile web add git+https://github.com/dakeshui123/dsh-pet-frieren.git
技術與版權說明¶
- 構建方式:插件客戶端包已預構建(prebuilt),無需
prepare或build步驟,兼容任意版本的 pnpm。 - 資源路徑:遵循 dsh bundle 的 host-serves / client-reads 模式,資源通過 HTTP 讀取,未嵌入打包文件中。
- 版權信息:插件基於 MIT 許可證開源。其中使用的“Frieren”角色形象源自《葬送的芙莉蓮》,屬於個人非商業用途的同人藝術。