前言¶

在 DSH 里用 dsh-pet 做网页桌宠时，气泡和碎碎念通常只有文字。若希望桌宠「开口」把气泡内容读出来，需要自己接 TTS 服务或写脚本，和桌宠 UI 的联动也要额外处理。大肥鱼语音（dsh-pet-voice-fishy）是社区维护的 DSH 插件，面向同一桌宠场景：在气泡出现或碎碎念更新时自动朗读，并支持本地离线音色与可选的 Breeze 在线能力。下面介绍它的定位、能力与安装用法。

这是什么¶

• 名称：大肥鱼语音（npm 包 dsh-pet-voice-fishy）
• 维护者：bbfang2025-cyber
• 分类：模型推理（社区目录 SkillHub 插件页）
• 当前版本：V1.3.3（package 1.3.3）
• 作用：给 dsh-pet 的网页桌宠配音；不修改 dsh-pet 仓库里的任何文件，装完即用。
• 源码与说明：GitHub 仓库

插件本体代码约 40KB，模型不进安装包，首次选用离线音色时再按需下载。

核心功能¶

朗读行为¶

• 气泡朗读：桌宠冒气泡或碎碎念时，可把气泡文字念出来；可在设置里开关、调音量。
• 朗读频率：自动朗读的最小间隔可选「不限 / 30 秒 / 60 秒 / 3 分钟」，默认 30 秒，避免连续刷屏式播报。
• 右键再读：右键（或长按）碎碎念气泡可再读一遍，不受频率限制。

音色（共 10 个）¶

鱼鱼酱、鱼鱼姐在设置页下载音色包后即可断网使用（CPU 推理，无需 GPU）。8 个 Kokoro 离线女声来自 Kokoro 中文女声（Apache-2.0，sherpa-onnx 转换版），一次下载约 348MB。

可选：在设置页填写 Breeze API Key（brz_ 开头）使用在线音色，需联网并消耗 Breeze 余额；不填不影响本地离线音色。

实现要点（来自 README）¶

• 推理在 worker 线程（sherpa-onnx / ONNX Runtime CPU），减轻对 DSH 主界面卡顿的影响。
• 模型目录默认在 $DSH_HOME/dsh-pet-voice/models/，可用环境变量 DSH_PET_VOICE_MODELS_DIR 覆盖。

安装与启用¶

插件以 DSH desktop profile 的 bundle 形式安装。装完后需完全退出并重新打开 DSH（不是仅刷新页面）。若已装旧版（≤1.3.0），可在 %USERPROFILE%\.dsh\profiles\desktop 执行升级命令后同样重启。

方式一：插件市场（推荐）¶

DSH → 插件市场 → 搜索「大肥鱼语音」或 dsh-pet-voice-fishy → 安装 → 重启 DSH。

方式二：pnpm 从 GitHub 安装（Agent / 文档常用）¶

在 desktop profile 目录执行：

cd $env:USERPROFILE\.dsh\profiles\desktop
pnpm add github:bbfang2025-cyber/dsh-pet-voice-fishy --registry=https://registry.npmmirror.com

将 dsh-pet-voice-fishy 加入该 profile 的 package.json 中 dsh.profile.bundles，然后重启 DSH。仓库 README 也提供「发给 AI Agent」的一行指令与 AGENT-INSTALL.md 中的验收与排错说明。

方式三：Gitee 直链（国内，v1.3.3 示例）¶

下载 release 包并本地 pnpm add：

Invoke-WebRequest -Uri "https://gitee.com/bbfcyber/dsh-pet-voice-fishy/raw/master/release/dsh-pet-voice-fishy-1.3.3.tgz" -OutFile "$env:TEMP\dsh-pet-voice-fishy.tgz"
cd $env:USERPROFILE\.dsh\profiles\desktop
pnpm add "file:$env:TEMP\dsh-pet-voice-fishy.tgz" --registry=https://registry.npmmirror.com
# 再把 dsh-pet-voice-fishy 加进 package.json 的 dsh.profile.bundles

方式四：GitHub Release 直链（可用 gh-proxy）¶

Invoke-WebRequest -Uri "https://gh-proxy.com/https://github.com/bbfang2025-cyber/dsh-pet-voice-fishy/releases/download/v1.3.3/dsh-pet-voice-fishy-1.3.3.tgz" -OutFile "$env:TEMP\dsh-pet-voice-fishy.tgz"
cd $env:USERPROFILE\.dsh\profiles\desktop
pnpm add "file:$env:TEMP\dsh-pet-voice-fishy.tgz" --registry=https://registry.npmmirror.com
# 再把 dsh-pet-voice-fishy 加进 package.json 的 dsh.profile.bundles

依赖与环境：package 要求 Node >=22；与 DSH 的兼容声明见 package 中 dsh.compatibility（含 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2 等标记为 compatible 的版本）。

典型用法¶

1. 打开 DSH 设置 → 大肥鱼语音。
2. 用「气泡朗读」开关与音量滑杆控制是否朗读及音量。
3. 在「朗读频率」里选择自动朗读最小间隔（默认 30 秒）。
4. 在「音色」中切换并点「试听」；需要 Kokoro 合集时在「离线音色（断网可用）」点 下载（约 348MB）；需要鱼鱼酱 / 鱼鱼姐时分别下载（各约 58MB）。
5. 桌宠气泡出现后，若已开启朗读且未触发频率限制，会自动播放；需要时可右键气泡再读一遍。

配置文件路径：$DSH_HOME/dsh-pet-voice/config.json，示例：

{
  "enabled": true,
  "volume": 0.8,
  "voiceId": "breeze-yuyujiang",
  "breezeApiKey": ""
}

voiceId 与音色表对应（如 breeze-yuyujiang、breeze-yuyujie、kokoro-41 等）。插件还提供 HTTP 路由（如 GET/POST /dsh-pet-voice/state、GET /dsh-pet-voice/tts、音色包安装与进度接口），便于第三方集成；v1.3.3 起 state.packs 为数组结构。

适用场景与注意¶

适合谁

• 已在 DSH 中使用 dsh-pet 网页形态桌宠，希望气泡/碎碎念带语音反馈的开发者或个人用户。
• 希望优先离线、无 Key 使用（鱼鱼酱 / 鱼鱼姐或 Kokoro 女声），或可选接入 Breeze 在线音色。

限制与合规（README 明示）

• 仅覆盖网页形态桌宠；桌面浮动版由 dsh-pet 的 Electron 助手渲染，需上游支持。
• 鱼鱼酱 / 鱼鱼姐基于 Piper 中文模型与 BZNSYP 相关数据微调，仅供个人非商业使用；插件代码为 MIT，模型许可见各上游仓库。
• 离线模型对中文里个别英文单词可能出现 OOV 式读法问题。
• 音色包首次下载需等待，支持进度与断点续传。

安全与权限

DSH 插件在当前 DSH 进程权限下运行。安装前应阅读仓库源码与 LICENSE（MIT），并理解本机会保存 breezeApiKey（仅本地、README 称不上传）以及按需下载的模型文件体积（单包约 58MB 或 Kokoro 合集约 348MB）。

结尾¶

大肥鱼语音把 dsh-pet 气泡文字和 TTS 收成一套 DSH 插件：小体积安装、按需拉模型、默认频率限制与右键复读，并兼顾本地 sherpa-onnx 与可选 Breeze。社区目录与 GitHub 是同一项目的公开入口，DeepSeek Harness 生态强调「一切皆插件」，SkillHub 等为独立社区站点，与 DeepSeek / 幻方无官方从属关系。

• 目录页：https://www.skillhub.cn/plugins/bbfang2025-cyber/dsh-pet-voice-fishy
• GitHub：https://github.com/bbfang2025-cyber/dsh-pet-voice-fishy