前言¶
在 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 用户。
