deepseekplugins

DeepSeek Harness 插件

dsh-voice-assistant

DSH 语音助手插件：本地流式语音识别（sherpa）+ 语音指令注入 + 语音朗读回复（vits-zh-ll）+ 天气查询（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
azhe411/dsh-voice-assistant
最近更新
2026年8月20日
分类
工具与能力
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/azhe411/dsh-voice-assistant
插件名：dsh-voice-assistant
作者：azhe411

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

DSH 语音助手（dsh-voice-assistant）

给 DeepSeek Harness 加一个语音助手：对电脑说「你好小智」唤醒，然后直接说指令（"帮我查一下明天天气"），DSH 会执行并把结果朗读给你听。

  • 本地语音识别：sherpa-onnx 流式识别，离线可用，不花钱
  • 语音指令执行：说的话自动变成 DSH 会话指令，由 AI 执行
  • 语音朗读回复：vits-zh-ll 本地合成，把结果念给你听
  • 天气查询：内置天气脚本，说"明天天气"就能听到预报
  • 自动开网页：语音触发时自动打开/激活 DSH 界面

> 仅支持 Windows（本机麦克风 + PowerShell 播放）。需要 DSH web 环境。

---

目录

1. [原理简介](#原理简介) 2. [系统要求](#系统要求) 3. [安装（3 种方式）](#安装) 4. [首次使用](#首次使用) 5. [日常使用](#日常使用) 6. [自定义配置](#自定义配置) 7. [常见问题排查](#常见问题排查) 8. [项目结构](#项目结构) 9. [隐私与安全](#隐私与安全)

---

原理简介

你的声音
   │  (麦克风)
   ▼
sherpa-onnx 本地流式识别 (voice-daemon.cjs，常驻后台)
   │  识别出文字
   ▼
写入 ~/.dsh/voice/commands.txt
   │  (每秒轮询)
   ▼
voice-core 插件（DSH 内）发现新指令
   │  创建独立语音会话注入
   ▼
DSH AI 执行指令（查天气/查资料/写东西…）
   │
   ▼
voice-core 监听回复完成
   │
   ▼
vits-zh-ll 本地合成语音 → 播放朗读 (play-wav.ps1)
  • 识别：voice-daemon.cjs 常驻后台，说「你好小智」唤醒，说完自动判定端点
  • 执行：voice-core.js 是 DSH 插件（host 半），轮询命令队列并注入新会话
  • 朗读：插件监听 agent 状态，回复完成后提取文本→TTS→播放

---

系统要求

项目要求
系统Windows 10/11
Node.jsv18+（node --version 确认）
DSH已装好 dsh web（3080 端口）
麦克风内置/外接均可
磁盘约 500MB（模型 + sherpa）
网络安装时需要（下载模型），运行识别/朗读完全离线

---

安装

方式 A：一键安装脚本（推荐）

git clone https://github.com/<你的用户名>/dsh-voice-assistant.git
cd dsh-voice-assistant
node install.cjs

安装脚本自动完成： 1. 创建 ~/.dsh/voice-plugin 等目录 2. 复制脚本 + 提示音 3. 安装 sherpa-onnx-node（本地识别引擎，约 100MB） 4. 下载中文识别模型（约 300MB，国内 hf-mirror 源） 5. 下载 TTS 朗读模型（vits-zh-ll，约 90MB） 6. 注册 voice-core 插件（固化到 profile） 7. 可选：设置开机自启 8. 启动识别 daemon

> 模型较大，下载需要几分钟，请耐心等待。断网/失败可重跑（已下载的会自动跳过）。

方式 B：DSH 插件命令安装

dsh plugin --profile web add github:<你的用户名>/dsh-voice-assistant

但注意：这种方式只注册插件入口，模型和 sherpa 仍需手动准备（见下节「手动准备模型」），推荐还是用方式 A。

方式 C：手动部署（进阶）

1. 复制 src/voice-daemon.cjs、src/voice-core.js、scripts/*、assets/sounds/* 到 ~/.dsh/voice-plugin/（和 fixed/ 子目录） 2. 在 ~/.dsh/voice-plugin/ 下执行 npm install sherpa-onnx-node --no-save 3. 下载模型到 ~/.dsh/voice-plugin/models/（见下） 4. 复制 src/voice-core.js 到 ~/.dsh/profiles/web/node_modules/@local/voice-core/lib/index.js，写 package.json 5. 在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加： ``yaml - insert: - id: voice-core name: '@local/voice-core' `` 6. 重启 dsh web

#### 手动准备模型

识别模型（放 ~/.dsh/voice-plugin/models/）：

# sherpa-onnx-streaming-zipformer-zh-14M-2023-02-23
# 下载并解压，把 encoder-*.onnx / decoder-*.onnx / joiner-*.onnx / tokens.txt 放到 models/ 下
# 源: https://hf-mirror.com/csukuangfj/sherpa-onnx-streaming-zipformer-zh-14M-2023-02-23

TTS 模型（放 ~/.dsh/voice-plugin/tts-models/vits-zh-ll/）：

# model.onnx / tokens.txt / lexicon.txt
# 源: https://hf-mirror.com/csukuangfj/sherpa-onnx-vits-zh-ll

---

首次使用

1. 安装完成后重启 dsh web（让 voice-core 插件加载） 2. 确认识别 daemon 在跑： ```bash # 应看到 voice-daemon.cjs 进程

tasklist | findstr node

`` 如果没在跑：node ~/.dsh/voice-plugin/voice-daemon.cjs`（建议放后台/开机自启） 3. 对着麦克风说：「你好小智」 - 听到「小智已启动，有什么可以帮您」→ 唤醒成功 4. 说指令，比如： - 「帮我查一下明天天气」 - 「今天几号」 - 「打开记事本」→（AI 会执行/回答） 5. 说完等一两秒，听到「已收到您的指令」，然后 DSH 执行，完成后语音朗读结果

> 唤醒词：「你好小智」/「小智小智」（谐音容错：志/只/之/知 都能触发）

---

日常使用

语音指令示例

你说DSH 会
「明天天气怎么样」运行天气脚本 → 播报明天预报
「帮我写一段自我介绍」AI 生成 → 朗读
「今天星期几」回答 → 朗读
「搜一下 XX」联网搜索 → 总结朗读
任何想做的事转成指令执行 → 朗读结果

关键提示音

提示音含义
「小智已启动，有什么可以帮您」唤醒成功，可以说指令
「已收到您的指令」指令已提交给 DSH
（朗读内容）执行结果

手动启动/停止

# 启动识别 daemon（后台）
start /b node ~/.dsh/voice-plugin/voice-daemon.cjs

# 停止（杀掉 daemon 进程）
taskkill /f /im node.exe  # 谨慎：会杀掉所有 node，仅当你知道自己在做什么

开机自启

安装时选择 y 会自动设置；手动设置：

  • 把 voice-daemon.vbs 放到 启动 文件夹（Win+R → shell:startup）
  • vbs 内容：Set sh = CreateObject("WScript.Shell") : sh.Run "node <daemon路径>", 0, False

---

自定义配置

唤醒词

编辑 ~/.dsh/voice-plugin/voice-daemon.cjs，找到 WAKE_RE 正则，修改匹配词。

语音指令提示词

编辑 ~/.dsh/profiles/web/node_modules/@local/voice-core/lib/index.js，找到「语音指令规则」那段文字（注入给模型的提示词），可自定义。

播报长度

index.js 里 speakText 前的 .slice(0, 80) 控制朗读字数上限。

麦克风选择

voice-daemon.cjs 里 device 参数可指定设备名（中文设备名可能需用 ASCII 替代名，见排查）。

数字转中文

digitsToCn() 函数处理阿拉伯数字→中文读音（TTS 不认阿拉伯数字）。符号映射：℃→摄氏度、km/h→公里每小时。

---

常见问题排查

症状原因与解决
唤醒没反应daemon 没跑：node ~/.dsh/voice-plugin/voice-daemon.cjs 手动启动看报错
daemon 报麦克风错误设备名不对：改 device 参数；或 System.Speech 与 sherpa 抢麦克风（关掉 voice-boot 待机）
识别到了但 DSH 没执行voice-core 插件没加载：检查 patch 里有没有 voice-core，重启 dsh
不朗读回复没有【语音播报】标记会读整条；检查 TTS 模型是否下载完整（model.onnx 等三个文件）
播放没声音用 play-wav.ps1（MCI）播放，别用 ffplay；检查系统音量
中文设备名乱码用 ASCII 替代名（Get-PnpDevice 查实际设备名）
提示音把自己也识别进去回声过滤：daemon 播放提示音后 1.5s 内跳过识别帧（已内置）
vbs 开机自启不工作wscript 不支持 UTF-8 编码的 .vbs，必须纯 ASCII 保存
天气查询没反应手动跑 node ~/.dsh/voice-plugin/weather.cjs 1 看输出；城市由 IP 自动定位

---

项目结构

dsh-voice-assistant/
├── install.cjs             # 一键安装脚本（推荐）
├── cordis.patch.yml        # bundle 插件注册（方式 B 用）
├── package.json            # 插件包定义
├── src/
│   ├── voice-core.js       # DSH 插件本体（指令注入 + 朗读）★核心
│   └── voice-daemon.cjs    # 本地识别 daemon（sherpa 流式）★核心
├── scripts/
│   ├── play-wav.ps1        # WAV 播放（MCI，稳定快速）
│   ├── voice-boot.ps1      # 开机兜底（System.Speech 唤醒启动 dsh）
│   ├── weather.cjs         # 天气查询（IP 定位 + 中国天气网）
│   ├── speak.cjs           # 单次 TTS 合成+播放（测试用）
│   ├── stt.mjs             # 豆包在线转录（备用，读 ~/.modlens 的 key）
│   └── gen-fixed.cjs       # 生成提示音（可重新生成）
└── assets/sounds/          # 提示音（唤醒/收到/成功/失败/进行中）

---

隐私与安全

  • 识别和朗读全在本地，声音不上传，sherpa 和 vits 都是本地模型
  • 没有硬编码密钥。唯一的在线能力（天气、可选豆包 STT）用的 key 从 ~/.modlens/config.json 读取，不写死在代码里
  • 天气查询只请求中国天气网公开接口（IP 定位城市）
  • 语音指令会被执行：你说的话会被 DSH 的 AI 执行（能操作电脑），请只在你信任的环境使用

---

License

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类