前言¶
在 DeepSeek Harness（DSH）裏跑智能體或寫插件時，桌面往往只有終端和編輯器。若想在 Windows 上放一隻不擋操作、不搶輸入焦點的 Live2D 桌寵，常見做法是單獨裝桌寵軟件：容易佔任務欄、空白區域仍攔截點擊，點一下還會打斷當前窗口。社區插件 dsh-desktop-pet（維護者 AlaxonYegar，分類：客戶端）把桌寵掛進 DSH 插件體系：DSH 啓動時拉起獨立 Electron 進程渲染 Live2D，宿主側只做進程管理；包內不含任何模型文件，需自行選擇已獲授權的 *.model3.json 目錄。下面介紹它做什麼、怎麼裝、怎麼用，以及和 DSH 運行環境相關的注意點。
這是什麼¶
dsh-desktop-pet 是面向 DSH 的桌面 Live2D 桌寵插件：常駐桌面、始終置頂、按像素做鼠標穿透（僅不透明像素接收點擊）、窗口不可聚焦、不佔任務欄，支持多顯示器拖動、五檔尺寸與滾輪縮放、托盤裏一鍵開機自啓（VBS 靜默）。當前版本在 package.json 中爲 1.0.0，許可證 MIT，目標平臺爲 Windows x64（README 徽章與 keywords 一致）。
- 目錄頁：https://www.skillhub.cn/plugins/AlaxonYegar/dsh-desktop-pet
- 源碼與說明：https://github.com/AlaxonYegar/dsh-desktop-pet
核心功能¶
README 中與「普通桌寵」對比的能力如下，均可在文檔中核對：
| 能力 | 說明 |
|---|---|
| 鼠標穿透 | 空白區域穿透；只有壓在模型不透明像素上才接收點擊 |
| 不搶焦點 | focusable: false |
| 任務欄 | skipTaskbar: true，不多佔圖標 |
| 尺寸 | 五檔 + 滾輪 + 快捷鍵 |
| 模型 | 首次啓動選擇文件夾，導入任意 .model3.json（需你已獲授權） |
| 多顯示器 | 可拖到任意屏 |
| 開機自啓 | 托盤菜單；配置項 autostart 可控制是否在 DSH 啓動時自動拉起 |
工作原理要點：宿主側在 DSH 啓動時 spawn Electron 載入 app/，然後 unref()；關閉 DSH 後桌寵進程仍可留在桌面。插件會去掉子進程環境中的 ELECTRON_RUN_AS_NODE=1，避免 Electron 以 Node 模式啓動導致 app is undefined 崩潰。
安裝與啓用¶
在 DSH 插件市場搜索 dsh-desktop-pet，或執行官方命令：
dsh plugin --profile web add dsh-desktop-pet
裝完後重開 DSH。桌面右下角會出現桌寵；首次爲「選擇模型」界面，指向本地 *.model3.json 所在文件夾。
可選配置（摘自 README）：
- id: desktop-pet
name: dsh-desktop-pet
config:
autostart: true # 設爲 false 則只安裝、不自動拉起
運行時依賴（Electron）¶
插件不打包 Electron（避免體積從約 240KB 漲到 100MB+），按順序查找可執行文件：
| 順序 | 位置 |
|---|---|
| 1 | <插件目錄>/electron/electron.exe（自行放置） |
| 2 | %USERPROFILE%\.dsh\electron\electron.exe（DSH 自帶，多數用戶命中此項） |
| 3 | %LOCALAPPDATA%\.dsh\electron\electron.exe |
| 4 | %LOCALAPPDATA%\Programs\electron\electron.exe |
都找不到時僅在日誌提示，不報錯，也不影響 DSH 主進程。package.json 要求 Node >= 20。
典型用法¶
日常交互（來自 README 表格）：
| 操作 | 效果 |
|---|---|
| 左鍵按住拖動 | 移動（含任務欄區域、多顯示器） |
| 右鍵單擊 | 打開/關閉操作面板 |
| 滾輪 | 縮放 |
Ctrl+Alt+H |
隱藏 / 顯示 |
Ctrl+Alt+L |
強制可交互（像素命中不準時） |
Ctrl+Alt+↑ / ↓ |
放大 / 縮小 |
Ctrl+Alt+Q |
退出 |
托盤菜單另有：大小檔位、回到右下角、始終置頂、開機自啓、退出。
適用場景與注意¶
適合已在 Windows 上使用 DSH、並希望桌寵與 Harness 同生態安裝、且不想被桌寵打斷輸入的開發者。DSH 社區插件目錄（如 skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝前建議閱讀倉庫 LICENSE、NOTICE.md 及源碼——插件以當前 DSH 進程權限拉起子進程，模型版權需自行合規（Cubism Core 爲 Live2D 專有許可，模型不在本包內）。
結尾¶
dsh-desktop-pet 把 Live2D 桌寵做成 DSH 客戶端插件：穿透、不搶焦點、多屏與自啓等能力在 README 中有明確說明，安裝命令爲 dsh plugin --profile web add dsh-desktop-pet。細節與更新見 GitHub 倉庫與 CHANGELOG.md。
