前言¶
在 DeepSeek Harness（DSH）裏做 Agent 開發時，界面往往以對話和工具調用爲主，缺少常駐、可互動的視覺反饋。獨立項目 DaiMeow 已經把 Live2D 模型、動作和交互做得比較完整，但它是另一套運行形態。DaiMeow DSH（yubdey/daimeow-dsh）由維護者 yubdey 發佈，歸類爲趣味換裝類插件，把 DaiMeow 的模型與交互接到 DSH 宿主上，並在桌面上以透明置頂窗口顯示呆喵，同時提供 Agent 工具和截屏識圖點評。下面按安裝、配置和日常用法說明其實際能力，均以倉庫 README 爲準。
這是什麼¶
DaiMeow DSH 是面向 DSH Desktop 的桌寵插件，簡介表述爲：DaiMeow Monster Hunter Palico desktop pet plugin for DeepSeek Harness。當前唯一運行形態是桌面全屏模式：啓用插件後宿主會啓動獨立的 Electron helper，在主顯示器工作區創建透明、無邊框、置頂、默認點擊穿透的窗口，Live2D 呆喵顯示在桌面上，而不是嵌在 DSH 網頁裏。DSH 頁面只保留一個在桌寵隱藏時出現的「顯示呆喵」入口。桌寵與 DSH 通過 stdout 狀態回報、本機迴環 HTTP 控制通道和本地路由通信。
插件版本在 package.json 中爲 1.0.0，源代碼採用 MIT 許可；Live2D Cubism Core、模型素材及《怪物獵人》相關權利另有說明，見倉庫 THIRD_PARTY_NOTICES.md。GitHub 倉庫當前星標爲 1。
核心功能¶
Live2D 與桌面交互¶
- Live2D 模型與 21 個動作，含站姿、坐姿和隨機待機狀態機。
- 點擊互動、拖動、鼠標視線跟隨、氣泡臺詞和右鍵菜單。
- 鼠標穿透由渲染端上報命中區域，主進程按真實光標位置切換
setIgnoreMouseEvents；菜單打開時臨時鎖定完整交互，關閉後恢復穿透。 - 窗口置頂、隱藏/顯示、托盤菜單和「恢復交互」；位置、大小、透明度、固定位置、穿透、置頂和顯隱狀態會持久化。
截屏識圖點評¶
左鍵點擊呆喵時會截取主屏畫面，調用 DSH 當前多模態模型識別內容，並以「元氣隨從喵」人格生成不超過 25 字的短回覆；連續觸發有 5 秒內置冷卻。視覺請求在模型聲明支持時默認使用 reasoningEffort: off，不支持關閉思考的服務商會省略該參數。截圖經壓縮爲 480×270 JPEG，寫入 DSH 附件服務後走 ctx.llm.stream()；插件自身不保存 API Key，原 DaiMeow 的 AI 服務商配置與聊天曆史面板不屬於本插件。
Agent 聯動¶
宿主提供三個 Agent 工具：
pet_say(text, action?, durationMs?)：讓呆喵說短話。pet_control(action)：播放動作、坐下/站起、顯示/隱藏、截屏識圖或恢復默認等。pet_status()：讀取連接數、helper 狀態、最近反應和動作列表。
Agent 開始工作、調用工具和結束輪次時，可依據配置自動播放動作及短臺詞。可用動作示例包括 nod、happy、cheer、hello、thinking、idea、sit、stand_up、capture_screen 等。
運行架構（簡述）¶
DSH Web UI 側的 daimeow-dsh client 只渲染「顯示呆喵」啓動膠囊；index.js 註冊 SSE 與 detached 相關路由，啓動 Electron helper。helper 通過 stdout 公佈本機控制地址，Host 將 daimeow/reaction 等幀 POST 到該地址（僅綁定 127.0.0.1，路徑帶每次啓動的隨機令牌）。頁面輪詢 /daimeow/detached/status，在窗口隱藏時顯示恢復入口；左鍵截屏識圖流程在 helper 與 Host 之間協作完成。更細的模塊劃分見倉庫 README 中的目錄樹說明。
環境要求¶
- 已安裝並可運行的 DSH Desktop。
- 獨立 Electron 運行時，按順序解析：環境變量
DSH_PET_ELECTRON_PATH，或%USERPROFILE%\.dsh\electron\electron.exe。若後者不存在，可設置環境變量，或安裝提供該運行時的dsh-pet。
插件分發包不需要安裝 npm 依賴；Node.js（>=22.12.0）主要用於本地構建與語法檢查。
安裝與啓用¶
插件以當前 DSH 進程權限運行。安裝前應自行查看倉庫源碼與許可證，確認可接受第三方素材與網絡調用（截屏識圖會使用當前配置的模型服務商）。
在 DSH 插件管理器的「添加插件」中填寫倉庫地址：
https://github.com/yubdey/daimeow-dsh.git
也可以將本地絕對路徑作爲插件來源（需先自行取得倉庫目錄）。插件的安裝、啓用和停用應通過 DSH 插件管理界面完成，不要手工修改 profile 的 package.json 或 profile 級 cordis.patch.yml。
從源碼開發時，可在插件根目錄執行：
npm run build
npm run check
npm test
npm run build 會生成 client.js 以及 runtime/electron-helper/assets.js、runtime.js，不要直接編輯這些生成文件。
配置¶
插件在 bundle 自帶的 cordis.patch.yml 中聲明默認配置，例如：
- insert:
- id: daimeow-dsh
name: 'daimeow-dsh'
config:
autoReactions: true
desktop: true
| 字段 | 默認值 | 說明 |
|---|---|---|
autoReactions |
true |
根據 Agent 輪次和工具事件自動播放反應 |
reactionThrottleMs |
1200 |
同類自動反應的節流時間（毫秒） |
desktop |
true |
插件啓用時自動啓動桌面 helper |
啓停與改配置應通過 DSH 插件管理界面或該 bundle 自己的 patch 完成。
典型用法¶
- 在插件管理界面安裝並啓用
daimeow-dsh，確認 Electron 運行時可用後，桌面應出現透明覆蓋層上的呆喵。 - 左鍵點擊：觸發互動並截屏識圖生成一句短評（5 秒內重複點擊不會再次請求模型）；需 DSH 當前模型支持圖片輸入。
- 拖動：改變位置並保存。
- 右鍵：打開動作、縮放（0.75x / 1.0x / 1.25x）、透明度、固定位置、鼠標穿透和置頂等菜單。
- 托盤：顯示、隱藏、恢復交互；「退出呆喵」與右鍵「關閉呆喵」共用停用流程，會同步關閉 DSH 插件。
- 在 Agent 對話中調用
pet_say、pet_control、pet_status，觀察自動反應與手動指令下的動作和臺詞。
若開啓鼠標穿透後無法再點到呆喵，可從托盤選擇「恢復交互」。
適用場景與注意¶
適合誰：希望在 DSH 開發或日常使用的同時，桌面上有 Live2D 桌寵反饋，並讓 Agent 通過工具控制呆喵臺詞與動作；趣味換裝類展示場景下也適用。
侷限（倉庫已說明）：僅覆蓋主顯示器工作區，不含任務欄；helper 崩潰後不會自動重啓；截屏識圖依賴多模態模型與宿主附件服務，純文本模型會提示無法看圖；多顯示器尚未支持。關閉呆喵會經 DSH Remote 停用整個插件 bundle，與在插件頁關開關走同一路徑。
排查提示：桌面窗口未出現時，先確認 Electron 路徑或 DSH_PET_ELECTRON_PATH，再停用並重新啓用插件，並查看 Host 控制台 [daimeow-helper] 日誌。頁面無恢復入口時，重載插件並刷新；/daimeow/detached/status 在隱藏狀態下應體現 visible: false 等字段。
結尾¶
DaiMeow DSH 把 DaiMeow 的 Live2D 桌寵接到 DSH 宿主：桌面透明窗口承載模型與交互，頁面只保留顯隱入口，Agent 側有 Say/Control/Status 三工具，點擊呆喵還可借用當前視覺模型做短評。DSH 生態強調「一切皆插件」；社區目錄站點與 DeepSeek / 幻方無官方從屬關係，本插件信息以維護者倉庫爲準。
- 目錄頁：https://www.skillhub.cn/plugins/yubdey/daimeow-dsh
- GitHub：https://github.com/yubdey/daimeow-dsh
