前言¶
在 DSH 裏用 dsh-pet 時，窗口、氣泡和語音槽位已經齊了，但人設、動作皮膚和聲音往往還要自己拼。dsh-pet-venti（倉庫 CrazyHao/dsh-pet-venti）把溫迪相關的人設、114 個動作名皮膚、IndexTTS 本地語音，以及基於屏幕與麥克風的吐槽流程收成一套插件；社區目錄歸類爲「趣味換裝」。下面按「它做什麼 → 怎麼裝 → 怎麼用 → 注意點」說明。
這是什麼¶
維護者爲 CrazyHao。插件在已有 DSH 與 dsh-pet 之上工作，不替換桌寵宿主，而是寫入人設、同步動畫、註冊語音實現，並掛上感知與吐槽邏輯。package.json 標註版本 2.0.0，運行需 Node >=22，代碼與文檔爲 MIT 許可證。
核心功能¶
README 用表格歸納了能力，要點如下。
| 能力 | 說明 |
|---|---|
| 人設 | 寫入 ~/.dsh/dsh-pet/main-config.jsonc（僅一次，備份爲 .venti.bak） |
| 皮膚 | 114 個動作名的 webm（共 155 個文件），同步到 ~/.dsh/dsh-pet/main-animation/webm |
| 聲音 | 註冊 IndexTTS 實現，本地零樣本克隆；先合成 mp3，再與氣泡同時呈現，播完纔出下一條 |
| 感知 | 每 3 秒截屏（DXGI + OCR + 畫面統計，跟隨前臺窗口所在顯示器）；麥克風 VAD + whisper |
| 吐槽 | 攢最近 5 幀畫面軌跡與上一句，調模型生成一句（≤35 字），方向跟隨當前屏幕 |
| 小字條 | 桌寵腳下顯示「正在觀看：進程名」 |
熱鍵：Ctrl+Shift+Q 開關麥克風，Ctrl+Shift+P 開關朗讀；若組合鍵被佔用，會自動降級到 Alt 組合。
安裝與啓用¶
安裝分兩步：裝進 DSH，再在本機準備約 20 GB 的運行環境（Windows + PowerShell）。
1. 裝插件¶
在 DSH 中選擇「設置 → 插件 → 安裝本地目錄」，選中本倉庫目錄；或由插件管理器執行：
# 在 DSH 裏：設置 → 插件 → 安裝本地目錄，選中本倉庫目錄
# 或者讓插件管理器執行：
# install_bundle <本倉庫路徑>
資料中未給出統一的 dsh plugin add github:... 一行命令，以上述原文爲準。
2. 裝運行環境¶
在倉庫根目錄執行：
cd <本倉庫>
powershell -ExecutionPolicy Bypass -File .\setup.ps1
# 可選：-DataDir D:\dsh-pet-venti -SkipModels
setup.ps1 會安裝 Python 3.11，創建感知用 venv（winsdk / pillow / sounddevice），拉取 index-tts 源碼，安裝 torch 2.8 cu128 與依賴，從 hf-mirror 下載 IndexTTS-2.5 模型，複製適配器並寫入 paths.json。
3. 參考音頻¶
零樣本克隆需要 5～15 秒、單人、無背景音樂的人聲，放到：
%USERPROFILE%\.dsh\pet-venti\voices\我的音色.wav
放好後重啓 DSH，或在插件頁停用/啓用一次。
4. 驗證¶
正常時桌寵會彈出吐槽，腳下出現「正在觀看：xxx」。需要觀察感知與輸出細節時，可雙擊 watch.cmd 打開常駐窗口，實時查看「在看什麼、說了什麼」。
配置與環境變量¶
日常項在 DSH「設置 → 插件 → 溫迪版桌寵」中調整：截屏間隔、吐槽間隔、語音/麥克風默認開關等。
可選環境變量：
| 變量 | 作用 |
|---|---|
PET_VENTI_VOICE |
參考音色名（voices 目錄內文件名，默認 venti_b） |
PET_VENTI_LLM_PROVIDER / PET_VENTI_LLM_MODEL |
吐槽用模型（默認 deepseek-account / deepseek-flash） |
PET_VENTI_BODY_PORT |
桌寵窗口端口（默認 7891） |
典型用法與代碼結構¶
插件側入口爲 index.js（配置同步、語音、感知、吐槽、投遞）；頁面側 client.js 負責拉隊列、彈氣泡、播音頻（單飛防打斷）。感知與展示由 sense_screen.py、sense_mic.py、pet_caption.py 等腳本配合；adapter.py 爲 IndexTTS HTTP 適配器，由 setup 裝入數據目錄。動畫素材在 assets/webm/。
吐槽鏈路依賴你已配置的 LLM 提供方；語音鏈路依賴 IndexTTS 與自備參考 wav。二者與 dsh-pet 的氣泡/語音槽位對接，無需改 dsh-pet 本體。
適用場景與注意¶
適合誰： 已在用 DSH + dsh-pet、想在桌寵上快速換溫迪主題並願意在 Windows 上跑本地 TTS 與感知腳本的開發者。
權限與審閱： 插件隨當前 DSH 進程權限運行，會週期性截屏、使用麥克風並調用模型；安裝前建議閱讀倉庫源碼與 MIT 許可，並知悉 IndexTTS、模型與素材另有各自許可證說明。
已知限制（README）：
- 114 個動作名部分對應同一段 webm 變體，視覺上可能重複。
- 獨佔全屏遊戲可能抓不到畫面，建議無邊框窗口。
- 顯存空閒不足約 1.2 GB 時，會自動只彈氣泡不朗讀。
- 倉庫不提供參考音頻，音色需自備。
package.json 中 dsh.compatibility 對 0.2.2-rc.1 標爲 compatible，更早/rc 版本爲 unknown，升級 DSH 時以插件聲明爲準。
結尾¶
dsh-pet-venti 把桌寵宿主留給 dsh-pet，自己負責人設、皮膚同步、IndexTTS 語音和屏幕/麥克風吐槽，適合想要「溫迪版桌寵」且能接受本地環境體積的 DSH 用戶。
