前言¶
DeepSeek Harness（DSH）提供了一個 AI 對話的工作窗口。在長時間使用或開發調試的過程中，窗口背景可能顯得單調。laym0nd/dsh-labrador 插件通過引入一隻基於照片和狀態機的虛擬拉布拉多寵物，爲窗口增加了低開銷的陪伴元素。它不依賴複雜的渲染引擎，而是通過狀態機控制行爲，適合希望在開發或使用過程中獲得視覺反饋的用戶。
是什麼¶
這是一隻生活在 DeepSeek Harness 窗口角落的虛擬寵物。它的外觀由 17 張特定照片驅動，通過內置的狀態機決定行爲邏輯。插件完全運行在 DSH 進程內部，沒有獨立的桌面窗口。項目採用 MIT 許可證，源代碼託管在 GitHub。
核心功能¶
- 狀態機控制：寵物擁有 7 個核心狀態（空閒、行動、移動、睡眠、反應、拖拽、投擲）。狀態機確保行爲轉換的連貫性，例如從睡眠狀態醒來只會過渡到空閒狀態，不會直接跳變到其他姿態。
- 姿勢庫：內置 17 種姿勢，包括坐、站、向上看、在沙發上、睡覺、嗅、在車裏、戴圓錐等。
- 物理交互：支持點擊戳刺、拖拽移動。投擲功能包含重力、牆壁/地面反彈和落地摩擦力計算；每次撞擊牆壁或地面時，寵物的面部表情會隨之改變。
- 聲音反饋：能夠發出狗叫聲（如 woof、hff、yip、grrr 等），以氣泡形式顯示在頭部上方。
- 右鍵菜單：提供右鍵菜單，支持“撫摸”、“播放動作”或“送回角落”等操作。
- 設置頁面：可在
Settings -> 拉布拉多 / Labrador中調整性格（平靜、專注、活潑）、大小、不透明度，以及控制每個動作的權重和顯示開關。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-labrador
安裝完成後重啓 Harness。寵物將出現在窗口的右下角。
典型用法¶
- 交互：點擊寵物身體可進行戳刺。
- 移動：拖拽寵物可改變其在窗口內的位置。
- 投擲：將寵物扔向牆壁或地面，觀察其反彈和表情變化。
- 菜單：右鍵點擊寵物，選擇“撫摸”、“播放動作”或“送回角落”。
- 配置：在設置頁面調整行爲參數，保存後會自動生效。
注意事項¶
- 移動限制：水平移動功能當前已禁用。插件需要專門的步行動作（包含多幀）才能展示滑行效果，當前姿勢庫不支持。
- 姿勢缺陷：“嗅”姿勢是一個殘缺片段（缺失頭部），以較低的權重包含在內。
- 窗口範圍：寵物僅存在於 Harness 窗口內，沒有脫離窗口的獨立桌面窗口。
- 配置持久化：設置以原子方式寫入
$DSH_HOME/dsh-labrador/main-config.json，非法值會被記錄並回退到默認值。 - 源碼查看：使用前建議查看源碼，確認許可證與依賴兼容性。
結語¶
laym0nd/dsh-labrador 是一個輕量級的桌面寵物插件，通過狀態機和物理交互爲 DSH 窗口增添了趣味性。它適合希望自定義行爲參數或僅僅是尋求視覺陪伴的開發者。更多細節可參考項目目錄頁或 GitHub 倉庫。
