Night Dog (夜官)：DSH 界面桌寵

在 DeepSeek Harness (DSH) 的開發過程中，除了日誌輸出，開發者往往需要一個直觀且低干擾的視覺反饋來緩解枯燥。dsh-plugin-night-dog 插件提供了一隻名爲“夜官”的土黃色小狗。它是一個純客戶端插件，不涉及宿主側執行、網絡請求或模型訪問，直接嵌入 DSH 的 Web 界面，隨當前主題變化自動適配顏色。

核心功能¶

夜官的交互與行爲邏輯主要分爲用戶交互、自動動作和狀態響應三類。

用戶交互¶

• 點擊夜官：觸發開心蹦跳動作，伴隨吐舌和冒泡效果。左鍵點擊不會隱藏它。
• 按住拖動：1:1 跟隨鼠標移動。位置被持久化保存（版本 dsh.night-dog.state.v6），刷新頁面後位置不變。窗口級監聽配合座標守衛，防止位置跳變。
• 雙擊夜官：將位置復位到右下角默認位置。
• 右鍵夜官：隱藏到右下角呼吸光暈的小圓點（僅當前會話有效，刷新或重啓 DSH 會恢復顯示）。點擊小圓點可喚醒。
• 懸停夜官：頭頂浮現名字“夜官”。
• 長時間無操作：自動趴下睡覺（側臥、頭枕前爪、閉眼、打呼嚕 Zzz）。

自動動作¶

在空閒狀態下，夜官會按週期觸發一系列動作，互不中斷：

1. 張嘴吐舌：約 9 秒，張大嘴哈氣、舌頭伸出、眯眼笑、尾巴狂搖。
2. 雙腳站立：約 26 秒，身體豎直、前爪作揖、彈跳入場。
3. 歪頭：約 32 秒，左右賣萌晃動。
4. 站立走動：約 52 秒，左右踱步，前爪交替邁步。
5. 打哈欠：約 42 秒，大張嘴、眯眼。
6. 兇叫：約 45 秒，怒眉、齜牙、抖動、冒出“汪！”氣泡。
7. 追尾巴轉圈：約 60 秒，原地轉一整圈。
8. 委屈嗚咽：約 78 秒，水汪汪眼睛、撇嘴。

Agent 狀態響應¶

夜官能感知 DSH Agent 的運行狀態，並做出相應反應：

• 思考 / 工具 / 錯誤 / 慶祝 / 睡眠：對應的動畫狀態。
• 連接重置：嚇一跳（X 眼 + 抖動）。
• 執行斜槓命令：開心慶祝（眯眼 + 吐舌頭）。

安裝與啓用¶

通過 DSH CLI 安裝此插件：

dsh profile plugin add dsh-plugin-night-dog

安裝完成後，插件會自動加載並出現在 Web 界面中。由於它是純客戶端組件，無需配置宿主環境或網絡權限。

技術實現與安全¶

• 純客戶端：插件僅運行在瀏覽器端，不觸碰宿主執行、網絡請求或模型訪問。所有副作用（事件監聽、定時器、本地存儲）均在 ctx.effect disposer 內管理，卸載時可完全回收。
• 主題自適應：顏色取自 DSH 主題令牌（--dsw-*），主體使用琥珀色系，確保在不同主題下視覺融合。
• 位置持久化：使用 dsh.night-dog.state.v6 存儲位置數據，包含版本號和視口校驗，防止越界或損壞導致的位置錯誤。

適用場景¶

適合需要在 DSH 界面中獲得陪伴感或簡單視覺反饋的開發者。它不佔用過多系統資源，且作爲開源項目（MIT 許可證），用戶可自行審查源碼與安全性。

• 目錄頁：https://www.skillhub.cn/plugins/zzhi191/dsh-plugin-night-dog
• GitHub：https://github.com/zzhi191/dsh-plugin-night-dog