dsh-dania-voice

dsh plugin --profile web add dsh-dania-voice

dsh-dania-voice

[English](README.md) | 简体中文

给 DeepSeek Harness 用的本地 GPT-SoVITS 语音朗读插件：把助手的回复用达妮娅的音色念出来，

旁边挂着一个可拖动的小挂件控制开关。

全部在本机运行，文字和音频都不出本地。

工作原理

DSH 会话事件（assistant/message + turn/end）
      │  取最终回复正文，剔除代码块 / 表格 / 链接
      ▼
Host：清洗 + 按 120 字聚合分段
      │  POST http://127.0.0.1:9880/tts
      ▼
GPT-SoVITS api_v2.py（本地，GPU）
      │  wav → 缓存目录 → 队列
      ▼
浏览器：轮询 /dania-voice/next → Web Audio 播放

播放放在浏览器里是刻意的：Host 进程没有声卡，而且声音应该出现在你正坐着的那台机器上。

环境要求

项目 · 说明

DSH · >= 0.1.7-rc.1

Python · 3.10 – 3.12（安装器只负责找，不负责装）

显卡 · 建议 NVIDIA、8 GB 以上显存；用 CPU 也能跑，但慢好几倍

磁盘 · 约 5 GB（PyTorch + 底模 + 音色模型）

ffmpeg · 多数情况下用不到，装了更保险

安装

dsh plugin --profile web add dsh-dania-voice

然后打开挂件面板，点 「一键部署」。安装器是独立进程，进度会实时显示在同一个面板里：

1. 在安装目录下建 Python 虚拟环境

2. 装 PyTorch（检测到 nvidia-smi 就装 CUDA 版）

3. 装推理依赖

4. 下载 GPT-SoVITS 源码（约 50 MB）

5. 下载预训练底模（约 1.6 GB）

6. 下载音色模型与参考音频（约 320 MB）

可以反复重跑：中途失败再点一次，已完成的步骤会自动跳过。第 5 步是 1.6 GB 的下载，这个特性很重要。

默认装在 $DSH_HOME/dania-voice。想放别的盘，改配置里的 installDir。

使用

窗口顶部正中挂着一只达妮娅：

• 单击 —— 开关朗读
• 拖动 —— 挪到任意位置，位置会记住
• 右键 / Shift+单击 —— 打开设置面板
• 正在念的时候会轻轻晃动

面板里可以调音量、语速、温度（越低越稳、气音越少）、句间停顿，还有「重读上一段」和「让她说一句」用于试听。

语速/温度改完对下一条生效；音频按「文本 + 参数」缓存，参数不变时重读是秒回的。

配置

面板写入 $DSH_HOME/dania-voice/config.json。profile patch 里的 config: 段也可以写，会被面板覆盖。

键 · 默认 · 含义

enabled · true · 朗读总开关

volume / speed / temperature · 1 / 1 / 0.7 · 播放与采样参数

speakUser · false · 是否也念你自己发的消息

installDir · $DSH_HOME/dania-voice · 引擎安装目录

pythonPath / root / cacheDir · 自动派生 · 只有手动部署过才需要填

baseUrl · http://127.0.0.1:9880 · GPT-SoVITS 地址

autostart · true · 需要时自动拉起服务

故障排查

• 挂件是红边 —— 插件路由没响应，检查插件是否启用。
• 提示「还没部署」 —— 点一键部署，或看 $DSH_HOME/dania-voice/install.log。
• 面板显示已就绪但没声音 —— 浏览器拦了自动播放，点一下挂件即可。
• 第一句很慢 —— 模型要 20~40 秒加载进显存，之后每句 1~3 秒。

版权

• GPT-SoVITS（RVC-Boss）—— MIT。
• 达妮娅音色模型来自 ModelScope 上的 villia/dania，

安装器从原仓库下载，本仓库不再分发。

• 挂件立绘 © 夜游人（本项目作者）；面板背景使用官方宣传素材，按官方第三方使用规范使用。

本项目是同人作品。《鸣潮》及其角色版权归库洛游戏所有。