dsh-voice-assistant 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：npm 同名包「dsh-voice-assistant」归属 supersyh-sss/dsh-voice-assistant，装到的可能不是本插件

dsh-voice-assistant 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-voice-assistant 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/10/2。

本地语音助手 azhe411/dsh-voice-assistant

DeepSeek Harnessv0.5.9

azhe41132 天前有提交已提供中文文档扫描：高危

在 GitHub 查看 ↗

给 DSH 加个语音助手：说「你好小智」唤醒，语音指令自动执行、结果朗读。识别合成全本地，离线可用。

30.8/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

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

自动兼容检查有告警：npm 同名包「dsh-voice-assistant」归属 supersyh-sss/dsh-voice-assistant，装到的可能不是本插件。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add azhe411/dsh-voice-assistant

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · other

装得上吗

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 32 天前

档位由哪些信号合成

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

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查⚠ 装前注意

npm 同名包「dsh-voice-assistant」归属 supersyh-sss/dsh-voice-assistant，装到的可能不是本插件

展开查看检查明细 ↓

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

✓npm 包dsh-voice-assistant @ 0.5.9

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

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

🔴 安全扫描发现高危能力自动 · 静态分析源码

v2.7.0

🔴 扫描：高危尚无人工评估

静态扫描发现安装期即执行代码，或命令参数由运行时变量拼接（参数来源无法静态判定，从严处理）。

命令参数由运行时变量拼接读写/删除本地文件

查看扫描证据（共 31 处，展示前 29 条）

写入本地文件
src/voice-core.js:18
appendFileSync(DIAG_LOG, '[' + new Date().toISOString() + '] ' + args.join(' ') + '\n');
执行外部命令固定命令
src/voice-core.js:28
execFile('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', PLAY_WAV, join(FIXED, name)], { timeout: 6000 }, () => {});
执行外部命令固定命令
src/voice-core.js:40
execFile('powershell.exe', ps, { windowsHide: true, timeout: 5000 }, (err) => {
执行外部命令固定命令
src/voice-core.js:44
execFile('cmd.exe', ['/c', 'start', '', 'http://127.0.0.1:3080'], { windowsHide: true, timeout: 5000 }, () => {});
执行外部命令固定命令
src/voice-core.js:160
execFile('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', PLAY_WAV, WAV_OUT], { timeout: 30000 }, () => {});
写入本地文件
install.cjs:22
function mkdir(p) { fs.mkdirSync(p, { recursive: true }); }
读取本地文件
install.cjs:23
function has(p) { return fs.existsSync(p); }
写入本地文件
install.cjs:37
const out = fs.createWriteStream(dest);
执行外部命令运行时拼接
install.cjs:50
const r = execSync(`tar -xjf "${file}" -C "${destDir}"`, { stdio: 'ignore' });
执行外部命令固定命令
install.cjs:58
try { execSync('node --version', { stdio: 'ignore' }); } catch { console.error('❌ 需要 Node.js'); process.exit(1); }
写入本地文件
install.cjs:81
fs.copyFileSync(path.join(SRC, src), dst);
读取本地文件
install.cjs:85
for (const f of fs.readdirSync(path.join(SRC, 'assets', 'sounds'))) {
写入本地文件
install.cjs:86
if (f.endsWith('.wav')) fs.copyFileSync(path.join(SRC, 'assets', 'sounds', f), path.join(PLUGIN_DIR, 'fixed', f));
执行外部命令运行时拼接
install.cjs:97
execSync(`npm install --prefix "${PLUGIN_DIR}" sherpa-onnx-node --no-save`, { stdio: 'inherit', timeout: 600000 });
执行外部命令运行时拼接
install.cjs:101
execSync(`npm install --prefix "${PLUGIN_DIR}" sherpa-onnx-node --no-save --registry=https://registry.npmmirror.com`, { stdio: 'inherit', timeout: 600
读取本地文件
install.cjs:115
const sub = fs.readdirSync(path.join(PLUGIN_DIR, 'models')).filter((n) => n.startsWith('sherpa-onnx-streaming'));
读取本地文件
install.cjs:118
for (const f of fs.readdirSync(subDir)) fs.copyFileSync(path.join(subDir, f), path.join(PLUGIN_DIR, 'models', f));
删除本地文件
install.cjs:119
fs.rmSync(subDir, { recursive: true, force: true });
删除本地文件
install.cjs:121
fs.rmSync(asrTar, { force: true });
写入本地文件
install.cjs:152
fs.copyFileSync(path.join(SRC, 'src', 'voice-core.js'), path.join(vcDir, 'lib', 'index.js'));
写入本地文件
install.cjs:153
fs.writeFileSync(path.join(vcDir, 'package.json'), JSON.stringify({
读取本地文件
install.cjs:156
if (has(PATCH_FILE) && fs.readFileSync(PATCH_FILE, 'utf8').includes('id: voice-core')) {
执行外部命令来自配置/变量
install.cjs:176
const daemon = spawn(process.execPath, [path.join(PLUGIN_DIR, 'voice-daemon.cjs')], { detached: true, stdio: 'ignore' });
读取本地文件
src/voice-daemon.cjs:15
if (!fs.existsSync(base)) return 'ffmpeg';
读取本地文件
src/voice-daemon.cjs:19
try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return null; }
写入本地文件
src/voice-daemon.cjs:87
fs.mkdirSync(path.dirname(CMD_FILE), { recursive: true });
写入本地文件
src/voice-daemon.cjs:89
fs.appendFileSync(CMD_FILE, line + '\n', 'utf8');
执行外部命令固定命令
src/voice-daemon.cjs:97
try { execFile('powershell.exe', ['-NoProfile', '-Command', cmd], { timeout: 3000 }); } catch {}
执行外部命令来自配置/变量
src/voice-daemon.cjs:106
ff = spawn(FFMPEG, [

扫描于 2026/11/3（1 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

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

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

语音唤醒词触发
语音指令自动执行
结果语音朗读

README

由 DeepSeek 最新模型翻译生成

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 执行指令（查天气/查资料/写东西…

展开完整文档（README 剩余 1 节）

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.js | v18+（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 末尾追加：
- 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 在跑：应看到 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