大肥鱼语音（dsh-pet-voice-fishy）

当前版本：V1.1（package 1.1.0）

给 dsh-pet 的网页桌宠配音：桌宠冒气泡 / 碎碎念时，自动把气泡里的文字念出来。

• 10 个音色：2 个在线 Breeze 自定义音色（需要你自己的 API Key）+ 8 个离线中文女声
• 离线可用：离线音色包下载一次后，断网也能说话
• 朗读频率限制：自动朗读最小间隔可设「不限 / 30 秒 / 60 秒 / 3 分钟」，默认 30 秒，不会一直说话
• 右键朗读：右键（或长按）碎碎念气泡，直接再读一遍这条内容，不受频率限制
• 插件本体很小：代码约 40KB，模型不进安装包，首次按需下载
• 不修改 dsh-pet 的任何文件，装完即用

音色

音色	类型	说明
鱼鱼酱（默认）	在线 Breeze	自定义少女音，语速 1.31x
鱼鱼姐	在线 Breeze	自定义御姐音，语速 1.15x
奶糖鱼	离线	萌系：音调最高、奶甜软糯
果冻鱼	离线	萌系：清亮带点俏皮
泡泡鱼	离线	萌系：软乎乎的少女音
团子鱼	离线	萌系：圆润黏人的小嗓音
冷月鱼	离线	御姐：低沉冷静、气场足
知性鱼	离线	御姐：温柔知性、娓娓道来
低语鱼	离线	御姐：轻声细语、耳边低语
夜莺鱼	离线	御姐：偏中性的成熟女声

• 在线音色走 BreezeBlue 开发者 API，需要到 Breeze 后台创建 API Key（brz_ 开头），在插件设置里粘贴；
• 离线音色来自 Kokoro 中文女声（Apache-2.0，sherpa-onnx 转换版），一次下载约 348MB，8 个音色一起可用。

安装

方式零：让 AI Agent 帮你装（复制这一句就行）

从这个仓库安装插件：https://github.com/bbfang2025-cyber/dsh-pet-voice-fishy，装好加进 DSH desktop profile 的 dsh.profile.bundles，然后提醒我重启。

Agent 会执行 pnpm add github:bbfang2025-cyber/dsh-pet-voice-fishy。完整的给-agent 指令、验收标准和排错见 AGENT-INSTALL.md。

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

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

方式二：GitHub 直链一键安装（推荐，国内可用 gh-proxy 加速）

# 国内下载下面这个 tgz 如果慢，可以在链接前加 https://gh-proxy.com/ 前缀
Invoke-WebRequest -Uri "https://github.com/bbfang2025-cyber/dsh-pet-voice-fishy/releases/download/v1.0.0/dsh-pet-voice-fishy-1.0.0.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

方式三：本地安装

cd $env:USERPROFILE\.dsh\profiles\desktop
pnpm add file:D:\path\to\dsh-pet-voice-fishy-1.0.0.tgz --registry=https://registry.npmmirror.com
# 然后在 profile 的 package.json 里把 "dsh-pet-voice-fishy" 加进 dsh.profile.bundles

也可以把 dist/INSTALL.md 里的「发给 AI agent」那段话直接丢给 agent，让它帮你装。

装完完全退出并重新打开 DSH，在页面里刷新一次。

使用

1. 打开 设置 → 大肥鱼语音；
2. 「气泡朗读」开关控制是否朗读，音量滑杆调音量；
3. 「朗读频率」选择自动朗读的最小间隔（不限 / 30 秒 / 60 秒 / 3 分钟，默认 30 秒；主动点击与右键不受限）；
4. 「音色」里点一下切换，点「试听」先听声音；
5. 想用离线音色：在「离线音色（断网可用）」里点 下载（约 348MB，有进度条），装完选任意离线女声；
6. 想用鱼鱼酱 / 鱼鱼姐：在「自定义音色（Breeze 在线）」里粘贴你的 Breeze API Key 并保存。

离线音色包下载完成后即可断网使用；在线音色需要联网和有效的 API Key。

离线是怎么做到"插件小"的

• 安装包里只有代码，没有任何模型；
• 第一次用到离线音色时，才从镜像下载 Kokoro 模型包（tar.bz2，约 348MB）到 $DSH_HOME/dsh-pet-voice/models/kokoro-multi-lang-v1_1/；
• 推理跑在 worker 线程（sherpa-onnx / ONNX Runtime CPU），不会卡 DSH 主界面；
• 已下载过的模型不会重复下载；模型就绪后，朗读不产生任何网络请求。

配置

$DSH_HOME/dsh-pet-voice/config.json：

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

• voiceId 可选值见上面的音色表（如 kokoro-41、breeze-yuyujie）；
• breezeApiKey 只保存在本机，不会上传；
• 模型目录也可以用环境变量 DSH_PET_VOICE_MODELS_DIR 覆盖。

路由

GET  /dsh-pet-voice/state                    → 配置、音色、音色包状态
POST /dsh-pet-voice/state                    → 修改配置（enabled / volume / voiceId / breezeApiKey）
GET  /dsh-pet-voice/tts?voice=&text=         → audio/mpeg（在线）或 audio/wav（离线）
GET  /dsh-pet-voice/packs                    → 音色包安装状态
POST /dsh-pet-voice/packs/install?id=kokoro  → 开始下载/安装音色包
GET  /dsh-pet-voice/packs/progress?id=kokoro → 下载进度
GET  /dsh-pet-voice/breeze/voices            → 列出 Breeze 账号里的音色

已知限制

• 只覆盖网页形态的桌宠；桌面浮动版由 dsh-pet 自己的 Electron 助手渲染，需要上游支持；
• 在线音色（Breeze）必须联网 + 自己的 API Key，且消耗你的 Breeze 余额；
• 离线音色包首次下载约 348MB，网速慢时需要等（有进度条，支持断点续传）；
• 中文里的英文单词可能被读成"忽略"（离线模型的 OOV 限制）。

版权与合规

• 插件代码 MIT；离线语音模型 不随包分发，由使用者按需从 k2-fsa/sherpa-onnx 的公开 release 下载；
• Kokoro 模型为 Apache-2.0；BreezeBlue 为第三方云服务，使用需遵守其服务条款；
• 本插件不包含任何影视 / 游戏角色音色模型。

许可

MIT。模型与推理引擎许可见各自仓库（sherpa-onnx、Kokoro）。