前言¶
在 DSH 上做智能體開發時，最常見的交付物是一個文件、一段命令或者一個工具調用記錄。想讓桌面多少有點「在場感」，以前的做法是去找官方的 dsh-dafeiyu 一類桌寵，再想辦法和現有 profile 調和窗口、端口、動作分組。dsh-dafeiyu-pet 把這件事切成了一個自帶運行時和素材的獨立插件：你裝它，桌面就多一個藍色鯨魚娘，不裝官方桌寵也不影響使用。
下面介紹這個由 lilulj 維護、社區目錄歸類爲「趣味換裝」的插件：定位、安裝命令、配置字段、調用方式，以及它和 dsh-dafeiyu 的關係。
這是一個什麼插件¶
一句話定位：dsh-dafeiyu-pet 是給 DSH 的 Windows 桌面加一個桌寵窗口的插件，自帶 104 個動作、msedge-tts 語音和桌寵運行時，不依賴官方 dsh-dafeiyu。
- 維護者：lilulj
- 最新版本：1.0.4（見其
package.json） - 依賴：僅
msedge-tts（^2.1.1） - 許可：插件代碼 MIT；素材來自
PC2005-cloud/dsh-pet（MIT）；運行時基於dsh-dafeiyu（MIT）改造 - 平臺：Windows x64
它在社區目錄中的分類是「趣味換裝」。倉庫裏明確寫了：本插件是非官方粉絲作品，與 DeepSeek 無關。社區目錄本身也是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不是官方應用商店。
能做什麼¶
按 README 的說明，能力分四塊。
- 桌寵本身：出現在桌面上，透明背景、可拖動、有右鍵菜單和狀態氣泡。
- 跟隨 DSH 的狀態：在 DSH 裏思考、調工具、完成、出錯時，插件切對應動畫。
- 動作：104 個動作，覆蓋喫喝、玩樂、節日、情緒、工作、特效等大類，右鍵「播放動作」分 11 組。
- 語音：msedge-tts 合成，本機播放；配好 QQ 機器人可以把語音發成語音條。
它不需要 key。按 README 的說法，除了 QQ 語音條那一項需要填機器人配置，其餘開箱即用。
安裝前要留意的條件¶
README 列了三條前置條件，值得先看一遍再動手。
| 條件 | 說明 |
|---|---|
| Windows x64 | helper 是 Windows 可執行文件，本機播放用 MediaPlayer COM |
| 已裝 DSH | 0.1.7 及以上 |
| 網絡 | 首次啓動要下載約 580MB 素材，國內建議開代理 |
這裏有一處容易踩的坑。README 專門說明：官方桌寵 dsh-dafeiyu 不是 DSH 自帶的，只有你以前裝過纔會有。如果裝過，需要先禁用它，否則兩隻同時開會搶 7799 控制口、屏幕上出現兩隻。沒裝過的可以直接跳到掛載插件那一步。
安裝與啓用¶
安裝分三步：裝插件、（只對裝過官方桌寵的人）禁用 dsh-dafeiyu、掛上引用、重啓。命令和配置都取自 README。
1. 裝插件¶
三種方式任選。下面這條是從 npm 裝，也是 README 推薦的方式。
dsh plugin --profile desktop add dsh-dafeiyu-pet
也可以在 DSH 裏走 設置 → 插件 → 添加插件，搜 dsh-dafeiyu-pet。想直接從 GitHub 拉則用：
dsh plugin --profile desktop add github:lilulj/dsh-dafeiyu-pet
手動方式是把整個 dsh-dafeiyu-pet 目錄複製到 <DSH 數據目錄>\profiles\desktop\node_modules\ 下。
第一次啓動會自動下載約 580MB 素材（104 個動作加桌寵運行時），日誌裏有進度，只下一次。下載卡住時要注意：插件用系統 curl 下載，會自動走系統代理，所以先確認代理是開着的。
2. 裝過官方桌寵才需要：禁用它¶
沒裝過 dsh-dafeiyu 的跳過這一步。裝過的，編輯 <DSH 數據目錄>\profiles\desktop\cordis.patch.yml，找到 dsh-dafeiyu 那一條，加一行 disabled: true：
- id: dsh-dafeiyu
name: dsh-dafeiyu
disabled: true # ← 加這一行
config:
...
3. 掛上插件¶
在同一個文件的末尾加引用：
- insert:
- id: dafeiyu-pet
name: dsh-dafeiyu-pet
用 dsh plugin add 裝的話，這一步 DSH 通常會自動完成。裝完檢查一下文件裏有沒有這條，沒有就手動加。
4. 重啓 DSH¶
完全退出再打開，托盤裏的進程也要退。第一次啓動會慢十幾秒，因爲要把 Qt 運行庫解壓到數據目錄。見到桌寵就成功了。
配置¶
兩個入口，功能一樣：DSH 設置裏的左側「大肥魚桌寵」，或者瀏覽器打開 http://127.0.0.1:7811/。
必須先配的東西：沒有。不填任何東西，桌寵、104 個動作、本機語音都正常。
想讓語音發到 QQ 語音條，才需要填三項：AppID、AppSecret、OpenID。AppID 從 q.qq.com 創建的機器人拿，AppSecret 是創建時顯示的那串且只顯示一次，OpenID 是收語音條的人的 openid 而不是 QQ 號，在機器人日誌的 Processing: scope=c2c peerId=... 裏找。README 提醒每個人要用自己的機器人，AppSecret 不能共用。
其餘選項都有默認值，默認配置一般不用動：
| 項 | 默認 | 什麼時候改 |
|---|---|---|
| 待機活躍度 | 活潑（12–22 秒動一下） | 嫌鬧改「安靜」（45–90 秒） |
| 角色大小 / 氣泡大小 | 0.6 / 0.8 | 覺得太大太小 |
| 動作延時 | 4500 毫秒 | 她話沒說完就動 → 調大 |
| 自動觸發動作 | 開 | 只想手動叫她 → 關掉 |
| 音色 / 語速 / 音調 | XiaoyiNeural / 1.08 / +6Hz | 聲音不滿意 |
保存後語音和動作在下次調用生效；角色大小、啓用開關要重啓 DSH 才生效。
怎麼讓桌寵動起來¶
按 README，有四條入口，覆蓋手動、自動和跨端：
| 方式 | 說明 |
|---|---|
| 右鍵桌寵 | 「播放動作」子菜單，11 個分組 |
| 對話觸發 | 插件往系統提示注入規則，你回完話她自己動 |
| 手動調用 | 向本機 7799 端口發請求 |
| QQ 裏聊天 | 需要另裝 @tencent-connect/dsh-qqbot |
手動調用的具體寫法：
POST http://127.0.0.1:7799/play
{"clip":"ext_cat"}
想在 PowerShell 裏列出全部可用動作，可以查它的健康接口：
Invoke-RestMethod http://127.0.0.1:7799/health | Select-Object -ExpandProperty clips
適用場景與注意¶
適合誰：用 DSH 0.1.7 及以上、想在 Windows 桌面上有一點動態反饋，或者想給智能體加一個會隨工具調用狀態切換的桌寵的人。如果你已經在用 dsh-dafeiyu，或者不想下載 580MB 素材，這個插件未必合適。
安裝前應該做的檢查：
- 看源碼和許可。插件代碼、角色素材、運行時三部分許可各不相同（MIT、MIT、基於 MIT 改造），光標素材來自 Chromium 項目、爲 BSD-3-Clause。裝之前確認你接受這些條款。
- 知道它以當前 dsh 進程的權限運行。插件在 DSH 進程內執行，helper 是 Windows 可執行文件，會創建桌面窗口、讀本機語音設備、下載素材到數據目錄。請先閱讀源碼再決定是否安裝。
- 配置裏有明文憑證。
<DSH 數據目錄>\dafeiyu-pet\config.json保存設置，含 QQ AppSecret 明文，不要外發。 - 數據都在本地：該目錄下還有
layout.json（窗口位置）、helper.log（桌寵日誌）、voice/（最近 10 條語音臨時文件）、tmp/（Qt 解壓目錄）。刪掉整個目錄即恢復默認設置和位置。
排障時先看兩處日誌：桌寵不出現，查 <DSH 數據目錄>\dafeiyu-pet\helper.log 和 logs\desktop-next.log 裏 dafeiyu-pet 相關行。第一次啓動慢、右鍵菜單缺動作，也先看這兩個文件和是否重啓過 DSH。設置頁 7811 打不開時，可以把環境變量 DAFEIYU_PET_SETTINGS_PORT 設成別的端口。
結尾¶
dsh-dafeiyu-pet 把桌寵做成一個自帶動作、語音和運行時的獨立插件，省掉了和官方 dsh-dafeiyu 搶端口、調素材這一步。如果你用的是 Windows x64、能接受首次下載約 580MB 素材，它基本是裝完即用。目錄頁在 skillhub.cn，源碼在 GitHub。
