🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口，低成本玩转 AI
去看看
DeepSeek Harness Hub
MCP兼容手册

语音播报挂件 wterwt/dsh-sovits-widget

DeepSeek Harness
wterwt23 天前有提交已提供中文文档扫描：含敏感能力
在 GitHub 查看 ↗

GPT-SoVITS 语音播报插件 for DeepSeek Harness — 角色音色、情感映射、流式播放与打断

31/100
综合分
2
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/10/17 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add wterwt/dsh-sovits-widget
该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位：已验证
是什么
dsh 原生插件 · other
装得上吗
本站已在 dsh 0.2.1-rc.5 下真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖，不等同于无风险
还在维护吗
活跃：最近一次提交在 23 天前
档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-sovits-widget（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=18 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/10 21:27:04

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描：含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求
查看扫描证据（共 47 处，展示前 45 条）
  • 发起网络请求
    src/client/api.ts:11
    const res = await fetch(url, { cache: 'no-store', ...init });
  • 发起网络请求
    src/client/api.ts:100
    audio: (token: string) => fetch(`${BASE}/audio.bin?token=${encodeURIComponent(token)}`, { cache: 'no-store' }),
  • 读取本地文件
    src/host/audio-tool.ts:45
    if (existsSync(candidate)) return candidate;
  • 执行外部命令来自配置/变量
    src/host/audio-tool.ts:49
    const probe = spawnSync(candidate, ['-version'], { windowsHide: true, stdio: 'ignore', timeout: 5000 });
  • 写入本地文件
    src/host/audio-tool.ts:66
    mkdirSync(options.outputDir, { recursive: true });
  • 执行外部命令来自配置/变量
    src/host/audio-tool.ts:87
    const result = spawnSync(ffmpeg, args, { windowsHide: true, timeout: 120000, encoding: 'utf8' });
  • 读取本地文件
    src/host/audio-tool.ts:92
    if (!existsSync(tmpPath)) {
  • 写入本地文件
    src/host/audio-tool.ts:97
    renameSync(tmpPath, outPath);
  • 执行外部命令来自配置/变量
    src/host/audio-tool.ts:112
    const probe = spawnSync(ffmpeg, ['-i', path], {
  • 读取本地文件
    src/host/config-store.ts:34
    if (!existsSync(this.configDir)) return [];
  • 读取本地文件
    src/host/config-store.ts:35
    return readdirSync(this.configDir)
  • 读取本地文件
    src/host/config-store.ts:50
    raw = readFileSync(this.filePath, 'utf8');
  • 读取本地文件
    src/host/config-store.ts:60
    const backupRaw = readFileSync(backup, 'utf8');
  • 读取本地文件
    src/host/config-store.ts:80
    const backupRaw = readFileSync(backup, 'utf8');
  • 写入本地文件
    src/host/config-store.ts:98
    mkdirSync(this.configDir, { recursive: true });
  • 读取本地文件
    src/host/config-store.ts:100
    if (existsSync(this.filePath)) {
  • 写入本地文件
    src/host/config-store.ts:102
    renameSync(this.filePath, join(this.configDir, `dsh-tts-config.json.bak-${stamp}`));
  • 写入本地文件
    src/host/config-store.ts:109
    mkdirSync(dirname(path), { recursive: true });
  • 写入本地文件
    src/host/config-store.ts:111
    writeFileSync(tmp, content, 'utf8');
  • 写入本地文件
    src/host/config-store.ts:112
    renameSync(tmp, path);
  • 删除本地文件
    src/host/config-store.ts:120
    if (s.isFile()) unlinkSync(stale);
  • 写入本地文件
    src/host/diagnostics.ts:52
    mkdirSync(dir, { recursive: true });
  • 写入本地文件
    src/host/diagnostics.ts:55
    appendFileSync(path, `${JSON.stringify({ exportedAt: Date.now(), entries: this.ring }, null, 2)}\n`, 'utf8');
  • 写入本地文件
    src/host/lru-cache.ts:48
    mkdirSync(dir, { recursive: true });
  • 读取本地文件
    src/host/lru-cache.ts:59
    const audio = readFileSync(audioPath);
  • 写入本地文件
    src/host/lru-cache.ts:61
    writeFileSync(metaPath, JSON.stringify(meta), 'utf8');
  • 写入本地文件
    src/host/lru-cache.ts:79
    writeFileSync(tmpAudio, audio);
  • 写入本地文件
    src/host/lru-cache.ts:80
    renameSync(tmpAudio, this.audioPath(key));
  • 写入本地文件
    src/host/lru-cache.ts:81
    writeFileSync(this.metaPath(key), JSON.stringify(meta), 'utf8');
  • 读取本地文件
    src/host/lru-cache.ts:124
    if (!existsSync(this.dir)) {
  • 写入本地文件
    src/host/lru-cache.ts:125
    mkdirSync(this.dir, { recursive: true });
  • 读取本地文件
    src/host/lru-cache.ts:128
    for (const name of readdirSync(this.dir)) {
  • 读取本地文件
    src/host/lru-cache.ts:134
    const meta = JSON.parse(readFileSync(metaPath, 'utf8')) as CacheMeta;
  • 读取本地文件
    src/host/lru-cache.ts:135
    const audioStat = statSync(audioPath);
  • 读取本地文件
    src/host/lru-cache.ts:153
    for (const name of readdirSync(this.dir)) {
  • 删除本地文件
    src/host/lru-cache.ts:172
    if (existsSync(path)) unlinkSync(path);
  • 读取本地文件
    src/host/routes.ts:254
    if (!existsSync(backupPath)) {
  • 读取本地文件
    src/host/routes.ts:258
    const raw = readFileSync(backupPath, 'utf8');
  • 写入本地文件
    src/host/routes.ts:260
    writeFileSync(store.filePath, `${JSON.stringify(restored, null, 2)}\n`, 'utf8');
  • 读取本地文件
    src/host/routes.ts:433
    files = readdirSync(dir)
  • 写入本地文件
    src/host/routes.ts:459
    mkdirSync(uploadDir, { recursive: true });
  • 写入本地文件
    src/host/routes.ts:461
    writeFileSync(tmp, body);
  • 读取本地文件
    src/host/routes.ts:503
    const stat = statSync(clientJsPath);
  • 读取本地文件
    src/host/routes.ts:505
    cache = { mtimeMs: stat.mtimeMs, text: readFileSync(clientJsPath, 'utf8') };
  • 执行外部命令来自配置/变量
    src/host/sovits-process.ts:110
    const child = spawn(pythonExecutable, [apiScript, ...extraArgs], {
扫描于 2026/11/4（0 天前） · 范围 全包扫描（包内未声明入口） · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票，来当第一个
广告精选好物
飞利浦 TAH6519 主动降噪耳机 ¥299
头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。
  • ·anc 主动降噪 · 头戴式无线
  • ·价格与库存以商品页实时为准
去淘宝看看→

功能亮点

  • 克隆音色朗读回复
  • 随时打断重听
  • 角色音色与情感映射

README

由 DeepSeek 最新模型翻译生成
dsh-sovits-widget 给 DeepSeek Harness 的 AI 回复加上语音播报，用你自己喜欢的二次元角色克隆的声音读出来。 基于 GPT-SoVITS。装好后，AI 每回复一段，就用你设定的音色朗读一段。 不需要写代码，不需要装 Node.js，不需要命令行。 三步装好 第 1 步：准备 GPT-SoVITS 去 GPT-SoVITS 官方仓库 的 Releases 页面，下载 Windows 整合包（形如 GPT-SoVITS-v2pro-xxxxxxxx.7z）。 它自带 Python 环境和全部依赖，解压就能用，不需要自己配环境。 解压后启动服务：双击整合包里的 api.bat，或使用本插件提供的 start-sovits.bat（会自动查找安装位置、检查端口占用）。 看到下面这行就是就绪了： Uvicorn running on http://0.0.0.0:9880 第一次启动要加载模型，约 1 分钟，期间请保持窗口打开。
展开完整文档（README 剩余 1 节）
dsh-sovits-widget

给 DeepSeek Harness 的 AI 回复加上语音播报，用你自己喜欢的二次元角色克隆的声音读出来。

基于 GPT-SoVITS。装好后，AI 每回复一段，就用你设定的音色朗读一段。

不需要写代码，不需要装 Node.js，不需要命令行。

三步装好

第 1 步：准备 GPT-SoVITS

去 GPT-SoVITS 官方仓库 的 Releases 页面，下载 Windows 整合包（形如 GPT-SoVITS-v2pro-xxxxxxxx.7z）。

它自带 Python 环境和全部依赖，解压就能用，不需要自己配环境。

解压后启动服务：双击整合包里的 api.bat，或使用本插件提供的 start-sovits.bat（会自动查找安装位置、检查端口占用）。

看到下面这行就是就绪了：

Uvicorn running on http://0.0.0.0:9880

第一次启动要加载模型，约 1 分钟，期间请保持窗口打开。

第 2 步：安装本插件

到 Releases 下载最新版：

dsh-sovits-widget-0.1.0-dist.zip

1. 解压到固定目录，例如 D:\dsh-sovits-widget
2. 进入 scripts 文件夹，双击 install.bat
3. 看到「安装完成」后，完全退出 DeepSeek Harness（托盘图标右键 → 退出），再重新打开

install.bat 会自动找到 dsh 配置目录、备份你原来的配置、写入插件声明。装错了想还原，把备份文件改回原名即可。

第 3 步：配置音色

声音是怎么来的？ 插件用 GPT-SoVITS 把你提供的参考音频（一段几秒的真人录音）克隆成音色，再用这个音色朗读 AI 回复。所以：参考音频决定了说话的声音。

重启后，界面右下角会出现一个 🔊 按钮，点它打开设置面板：

1. 切到「音色管理」→ 点「＋ 新建角色」
2. 填角色名和人设，然后在「参考音频」里选一段 3-10 秒的清晰人声：
- 从列表选择 GPT-SoVITS 已有的参考音频
- 或点「上传并处理」上传一段录音（自动降噪、截取最佳片段）
- 推荐：5 秒左右、单人说话、无背景音乐无回音
3. 点角色卡上的「试听」按钮，先确认声音对不对
4. 满意后点该角色的「启用」按钮
5. 切到「基础设置」→ 勾选「自动播报助手回复」

完成。 以后 AI 每次回复都会用这个声音自动朗读。

更详细的图文步骤（含每步截图说明与排查方法）见 新手安装指南.md。

日常使用

| 想做什么 | 怎么做 |
| 重听某条回复 | 点回复下方的 ▶ 按钮 |
| 换一种读法 | 点回复下方的 ↻ 按钮 |
| 让它停下来 | 点 ⏹ 按钮，或按 Esc |
| 调音量 / 语速 | 播放时右下角弹出的悬浮控制台 |
| 临时关掉播报 | 点右下角 🔊 → 基础设置 → 取消勾选自动播报 |
| 换个声音 | 🔊 → 音色管理 → 新建/切换角色 |
| 试听某个音色 | 🔊 → 音色管理 → 点角色卡的「试听」按钮 |

功能

- 角色与音色绑定：角色卡同时决定人设提示词和朗读音色，切换角色即整体切换
- 情感映射：开心 / 愤怒 / 悲伤 可各自指定不同音色
- 音色混合：按比例混合两个音色（如 70% A + 30% B）
- 文本清洗：自动过滤 Markdown、Emoji、代码块、URL，只读该读的内容
- 智能分段：按标点切分，长句自动在逗号处断开，不会读半截
- 流式播放：分段合成、就绪即播，首句不用等全文合成完
- 打断淡出：发新消息或按 Esc 时 100ms 淡出，不会爆音
- 自动降级：GPT-SoVITS 连续失败 3 次会临时改用浏览器语音，服务恢复后自动切回
- 配置安全：每次保存前自动备份，配置损坏能自动回滚，非法参数会被拒绝加载
- 本地服务托管：可让插件自动拉起常驻 GPT-SoVITS 进程，并检测复用已运行的实例

兼容性

| 项目 | 支持情况 |
| DeepSeek Harness | 桌面版、web profile |
| GPT-SoVITS api_v2.py（新版） | ✅ 完整支持，含流式 |
| GPT-SoVITS api.py（旧版） | ✅ 支持（自动探测协议，无流式） |
| 操作系统 | Windows 10/11 |
| Node.js | 安装不需要（发布包依赖已内联） |

插件启动后会自动探测服务端接口版本并在「诊断」页显示。如果探测不准，可在配置面板「高级参数 → 服务端接口版本」手动指定 v2 或 legacy。

常见问题

右下角没有 🔊 按钮？ 先按 Ctrl + R 刷新界面；仍无则完全重启 dsh。若一直没有，检查 install.bat 是否真的运行成功了。

面板显示「无法连接 GPT-SoVITS 服务」？ 声音服务没在运行。检查启动窗口是否还开着（关掉就停），重新双击 api.bat 或 scripts\start-sovits.bat。刚启动时需等约 1 分钟加载模型。

服务启动就闪退？ 多半是 GPT-SoVITS 的模型配置坏了。打开 你的GPT-SoVITS目录\GPT_SoVITS\configs\tts_infer.yaml，确认 t2s_weights_path 结尾是 .ckpt 文件名而不是文件夹名。

声音听起来很机械？ 说明已降级为浏览器语音。点 🔊 →「诊断」查看失败原因，修好后会自动切回。

每次重启电脑都要手动开服务？ 按 Win + R 输入 shell:startup，把 start-sovits.bat 的快捷方式放进去，即可开机自启。

本地 GPU 显存溢出？ 「高级参数 → 并发合成数」保持 1（默认）。只有远程 API 部署才建议调到 2-4。

卸载

把 dsh 配置目录里的备份改回原名：

%USERPROFILE%\.dsh\profiles\desktop\package.json.bak-sovits
→ 重命名为 package.json

然后重启 DeepSeek Harness。用 CLI 安装的可以执行：

dsh plugin --profile desktop remove dsh-sovits-widget

数据位置

| 内容 | 路径 |
| 插件配置 | %USERPROFILE%\.dsh\sovits\dsh-tts-config.json |
| 配置备份 | 同目录 dsh-tts-config.json.bak-（保留最近 5 份） |
| 音频缓存 | %USERPROFILE%\.dsh\sovits\cache\ |
| 上传的参考音频 | %USERPROFILE%\.dsh\sovits\audio\ |
| 诊断日志 | 插件「诊断」页可导出 |

开发者

pnpm install
pnpm test # vitest 单测（72 个用例，无网络依赖）
pnpm typecheck # tsc --noEmit
pnpm build # esbuild → lib/index.js + assets/sovits-widget.js
node scripts/smoke.mjs # 冒烟：模拟 Cordis 上下文加载构建产物

构建与分发：

node scripts/package.mjs D:\输出目录 # 安装包（运行时必需文件）
node scripts/package.mjs D:\输出目录 --dev # 开发包（含源码与测试）

从源码安装（需先构建）：

pnpm install && pnpm build
dsh plugin --profile desktop add link:D:/dsh-sovits-widget

本仓库不提交构建产物。git clone 得到的目录缺少 lib/ 与 assets/，必须先构建才能作为插件安装；普通用户请直接下载 Releases 里的包。

架构

- 宿主半面（src/host/）：零 @deepseek-ai 运行时依赖，全部 duck-typed 访问（ctx.webServer.register、ctx.systemPrompt.section、ctx.on('session/event')、webserver/index-inject）。协议探测见 provider/protocol.ts。
- 客户端半面（src/client/）：纯 IIFE（esbuild 全内联），经宿主路由 /dsh-sovits/client.js 下发。web 形态走 tapIndex 注入 ，Electron 桌面壳走 webserver/index-inject 结构化行。
- 发布包中 lib/index.js 为自包含构建（zod、p-queue 已内联），因此运行时无需 node_modules。

客户端改动后需 pnpm build 再刷新页面（宿主按 mtime 热读 client.js，无需重启 dsh）。

HTTP 面（/dsh-sovits/）

| 路由 | 方法 | 说明 |
| client.js | GET | 客户端 bundle（mtime 热读） |
| config.json | GET/PUT | 读/存配置（PUT 经 zod 校验，保存前自动备份） |
| backups.json / rollback.json | GET/POST | 备份列表 / 一键回滚 |
| speak.json / stop.json | POST | 触发合成 / 停止（barge-in） |
| status.json?messageId= | GET | 消息合成状态（分段就绪/进度/降级标记） |
| audio.bin?token= | GET | 取音频（WAV） |
| messages.json?since= | GET | 最近消息（客户端自动播报轮询） |
| health.json | GET | 健康状态与服务端协议探测结果 |
| preview.json | POST | 音色试听 |
| upload-audio.json?filename= | POST | 上传参考音频（ffmpeg 降噪 + 截取 3-10 秒） |
| ref-audios.json?dir= | GET | 参考音频目录列表 |
| logs.json / export-logs.json | GET/POST | 诊断日志读取 / 导出文件 |

非回环请求默认拒绝（除非宿主提供信任栅栏）。

目录结构

src/host/ 宿主半面：config(zod)/config-store(备份回滚)/engine(管线)/
provider/(sovits + protocol 协议探测)/task-queue/lru-cache/
text-cleaner/text-segmenter/emotion/style-injector/
sovits-process(进程池)/health/diagnostics/audio-tool(ffmpeg)/
wav/routes/index
src/client/ 客户端半面：player(Web Audio)/console-ui/config-panel/ message-buttons/ui/api/index tests/ vitest 单测（72 用例） scripts/ install.bat(一键安装)/start-sovits.bat/build.mjs/package.mjs/ smoke.mjs/release.mjs/e2e-probe.mjs

相关文档

- 新手安装指南.md — 面向普通用户的逐步操作说明
- INSTALL.md — 完整安装文档（含手动安装、服务配置、故障排查）
- CHANGELOG.md — 版本变更记录
- CONTRIBUTING.md — 贡献指南

许可

MIT，见 LICENSE。
广告精选好物
Type-c 采集卡 ¥50
佳能尼康索尼相机直连电脑，视频开发与直播向。
  • ·相机转电脑采集
  • ·价格与库存以商品页实时为准
去淘宝看看→
预览分享卡片长什么样 ↓wterwt/dsh-sovits-widget
分享 · DeepSeek Harness Hub
wterwt/dsh-sovits-widget

GPT-SoVITS 语音播报插件 for DeepSeek Harness — 角色音色、情感映射、流式播放与打断

相关插件 · 其他

模型破甲清洗HunYiSage/dsh-purge
⚔️ DeepSeek Harness 网络安全红队工具dsh-purge
★ 16,993已汉化DeepSeek 客户端
73
女娲蒸馏alchaincyf/nuwa-skill
输入名人名字，提炼其思维模型与决策方式供你调用
★ 37,308已汉化DSH
72
逆向分析桥接Fanqi89/dsh-rea
REA（Reverse Engineer Anything）MCP 桥接，用来把 REA 逆向工具接入 DSH 插件
★ 51已汉化DSH
72
语音女友beiyege-01/dsh-voice-ai-girlfriend
语音 AI 女友Voice AI girlfriend for DeepSeek Harness：Whisper…
★ 888已汉化DSH
71.6
红队越狱测试套件Minglink/dsh-infinite-gen-5
DeepSeek v4.1 flash 逆向工具无限五代 求 Star 收藏 ⭐欢迎大家提交项目的改进
★ 3,759已汉化DSH
71.4
协同办公空间dream-num/univer-workspace
一个让人类与 AI Agent 共同创作、协作和审阅的开源 Office 工作空间。
★ 2,269已汉化DSH
70.8

这是你的仓库？认领条目

回到顶部