前言¶

DSH 支持以插件擴展 Web 界面。dsh-client-ui-pet 是一個 DSH（DeepSeek Harness）Web GUI 插件，用於在頁面中添加一個 Q 桌寵浮層。它把當前會話的活動狀態映射爲 Q 版角色的表情、動作和對話氣泡，便於在 Web 頁面中獲得直觀的狀態提示。

這是什麼¶

dsh-client-ui-pet 由 qweqwe12382 維護，許可證爲 MIT。它定位爲一枚 Q pet desktop companion overlay for DeepSeek Harness web GUI。

插件分爲兩半：

• 宿主（lib/index.js）：佔位空插件，負責把組合行掛到 profile，無宿主行爲。
• 瀏覽器（lib/client.js）：註冊 shell.overlay 插槽的 Q 桌寵浮層，提供圖片幀動畫、對話氣泡與本地偏好持久化。

核心功能¶

下面介紹已確認的能力：

• 以單張圖集幀動畫渲染一個 Q 版角色。
• 跟隨當前會話的活動狀態自動切換表情與動作。
• 空閒時顯示 resting；思考 / 閱讀 / 編輯 / 工作時切換到對應狀態動畫；任務完成慶祝；出錯沮喪。
• 每個狀態輪換多句對話氣泡文案。
• 會話活動經 conversationViews 私有視圖投影爲純展示狀態；組件只消費該投影，不接觸會話原文。
• 氣泡與動畫幀來自內置圖集；圖片以 base64 內聯進 bundle，無靜態文件路由。
• 顯示 / 隱藏偏好保存在瀏覽器 localStorage，鍵爲 dsh.ui-pet.v1。
• 外部依賴僅 react 與 @deepseek-ai/dsh-client-runtime/client。

安裝與啓用¶

已覈實的安裝命令爲：

dsh plugin --profile web add github:qweqwe12382/dsh-client-ui-pet

安裝後重啓 DSH，或等待組合熱加載，然後刷新 Web 頁面。成功時，頁面右下角會出現 Q 桌寵。

典型用法¶

1、安裝完成後刷新 DSH Web 頁面，在右下角查看 Q 桌寵。

2、觀察桌寵隨會話活動變化：空閒爲 resting，思考 / 閱讀 / 編輯 / 工作時切換到對應動畫，任務完成顯示慶祝，出錯顯示沮喪。

3、查看對話氣泡。每個狀態會輪換多句文案，文案與動畫幀均來自內置圖集。

4、切換顯示 / 隱藏偏好後，偏好會保存在瀏覽器 localStorage 的 dsh.ui-pet.v1 中。

適用場景與注意¶

適合在 DSH Web GUI 中增加會話活動視覺反饋的使用者。它只提供展示狀態，不接觸會話原文。

使用前注意：

• 宿主半區沒有宿主行爲，主要能力在瀏覽器半區。
• 圖片以 base64 內聯進 bundle，無靜態文件路由。
• 偏好保存在瀏覽器 localStorage，鍵爲 dsh.ui-pet.v1。
• 外部依賴僅 react 與 @deepseek-ai/dsh-client-runtime/client。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與 MIT 許可證。

結尾¶

dsh-client-ui-pet 的價值在於用一套內置圖集幀動畫，把 DSH 會話活動變成頁面右下角的可讀狀態提示。倉庫地址：https://github.com/qweqwe12382/dsh-client-ui-pet