如何把 dsh-voice-ai-girlfriend 语音插件装进 DSH？dsh plugin 一键安装与 pnpm allowBuilds 坑位解析

想给 DeepSeek Harness（DSH）装上能听会说的女友？本文带你用dsh plugin add一键安装dsh-voice-ai-girlfriend 语音 AI 女友插件：FunASR 语音输入、OmniVoice 声音克隆朗读、数字人口播窗口，并完整拆解 pnpm ≥10 安装 git 依赖时的allowBuilds（esbuild）报错坑位，照着做 5 分钟装好。

dsh-voice-ai-girlfriend 语音 AI 女友插件的待机动画窗形象.jpg>)

这个语音插件能干什么 🎙️

dsh-voice-ai-girlfriend是 DSH 的浏览器语音插件，装进 DSH 后你会得到：

• 🎙️语音输入：点麦克风说话，经 FunASR 中文识别注入对话
• 🔊句子级流式朗读：回复一边生成一边按句 TTS 出声，支持插话打断 / 排队双模式
• 👧女友动画窗：右侧数字人窗口，空闲发呆、说话开口
• 💬QQ 双向（可选）：回复自动推送到 QQ

⚠️ 插件只是「界面的一半」：语音识别/合成依赖配套的 Python 桥接服务（bridge/voice_bridge.py），建议先用 bridge/start-all.cmd 把桥接跑起来，再装插件。

版本兼容：先看你的 DSH 是哪个版本

插件当前为v0.4.0，package.json里声明了兼容范围engines.dsh: ">=0.1.3-alpha.1 <0.3.0"：

详见 dsh-plugin/README.md 与 docs/DSH-0.2.1-适配记录.md。

一键安装步骤：dsh plugin add 只要一条命令

1️⃣ 确认前置条件

• 已装好 Node.js（LTS）与 pnpm，node --version、pnpm --version能输出版本号
• 本地有一份可用的dshCLI（0.2.x 起插件独立安装，无需把代码复制进 harness 源码树）
• 桥接服务已在http://127.0.0.1:8765运行（/api/health返回{"status":"ok",...}）

2️⃣ 执行安装命令

把<profile>换成你的 DSH profile 名（0.2.x 常用web-v021）：

dsh plugin --profile <profile> add github:beiyege-01/dsh-voice-ai-girlfriend-plugin

📌易错点：--profile必须写在add之前——DSH 0.2.1 起dsh plugin只在该位置识别这个参数，放错位置会直接报错。

3️⃣ 重启并验证

安装完成后重启该 profile 的 dsh，浏览器刷新页面，输入框上方出现音色 / 形象 / 待机 / 麦克风 / 朗读 / 数字人 / QQ / 女友窗 / 插话一排语音工具行，说明安装成功。控制台看到[ui-voice] loaded, bridge = http://127.0.0.1:8765且无报错即可收工。

pnpm allowBuilds 坑位解析 🔧

如果安装时 pnpm（≥10）卡住或报错，提示Ignored build scripts/esbuild相关警告，大概率就是踩中这个坑：

原因：插件的prepare脚本会用 esbuild 构建浏览器 bundle（见 dsh-plugin/package.json 的scripts.prepare）。pnpm ≥10 对 git 依赖的构建脚本默认不执行（allowBuilds 白名单机制），导致lib/client.js产物缺失，插件加载失败。

解法（三步）：

1. 看 pnpm 安装时打印的提示，它会明确列出被拦截的包名（这里是esbuild）

2. 打开该 profile 目录下的pnpm-workspace.yaml，在onlyBuiltDependencies里加一行：

   onlyBuiltDependencies: - esbuild

3. 重新执行上面的dsh plugin add命令，让 esbuild 跑完prepare构建

💡 注意改的是profile 自己的pnpm-workspace.yaml（DSH 按 profile 隔离依赖），不是主仓库的；改完必须重跑安装命令才会重新构建产物。

装完之后：3 分钟体验路径

1. 点麦克风开始说话 —— 识别文本自动注入对话
2. 点⚡ 插话开关：亮着 = 你说话即打断朗读；关掉 = 排队等回复读完
3. 点👧 女友窗打开右侧动画窗，点🎭 数字人开启口播视频（需已部署 DUIX，配置见 bridge/bridge-config.example.json）

想自己改代码或自行构建插件，源码镜像在本仓库 dsh-plugin/ 目录（构建入口 dsh-plugin/src/index.ts，工具栏 UI 在 dsh-plugin/src/client/VoiceToolbar.tsx），执行node build.mjs产出lib/client.js即可。

常见资料速查 📚

安装顺利的话，你的 DSH 已经「开口说话」了。遇到--profile位置、allowBuilds 之外的报错，优先看 README.md 的「常见问题」章节对照排查。