浏览器麦克风 ──AudioWorklet 采集──▶ VAD 断句 ──POST /funasr-voice/asr（原始 f32 PCM @16kHz）
                                           │ host 半代理
                                           ▼
                              本地 FunASR Python 服务（SenseVoiceSmall）
                                           │
              输入框 ◀── 识别文字 ──────────┘

浏览器只做采集 + 端点检测，ASR 全部在 host 侧本地 Python 进程里跑。
host 半懒加载拉起 FunASR 服务（首次识别约 2~3 秒加载模型，之后常驻复用）。
客户端用 AudioWorklet 采音（不是已废弃的 ScriptProcessorNode）。

环境要求

依赖	说明
DeepSeek Harness Desktop	2.0.2（本插件的开发/测试版本）
Python venv + FunASR 1.4.x + torch	本地 ASR 引擎
SenseVoiceSmall 模型	本地离线加载
Node ≥ 20	插件 host 半

⚠️ DSH Desktop 2.0.2 存在麦克风权限 Bug，直接使用会拿到静音流、无法识别。详见下方「已知 Bug 与修复」，需要先给 DSH Desktop 打一个补丁。

安装 FunASR 环境

插件需要一个装好 FunASR 的 Python 环境 + SenseVoiceSmall 模型。以 macOS 为例：

# 1. 创建独立 venv
python3 -m venv ~/Documents/ASR/funasr/.venv
source ~/Documents/ASR/funasr/.venv/bin/activate

# 2. 安装 FunASR（会自动带上 torch、modelscope 等依赖，约数 GB 磁盘空间）
pip install --upgrade pip
pip install funasr

# 3. 下载 SenseVoiceSmall 模型（约 1 GB，二选一）
mkdir -p ~/Documents/ASR/funasr/models
cd ~/Documents/ASR/funasr/models

#    方式 A：ModelScope（国内更快）
python -c "from modelscope import snapshot_download; snapshot_download('iic/SenseVoiceSmall', local_dir='SenseVoiceSmall')"

#    方式 B：HuggingFace
pip install huggingface_hub
python -c "from huggingface_hub import snapshot_download; snapshot_download('FunAudioLLM/SenseVoiceSmall', local_dir='SenseVoiceSmall')"

装完后：

python 路径：~/Documents/ASR/funasr/.venv/bin/python
模型目录：~/Documents/ASR/funasr/models/SenseVoiceSmall（需包含 model.pt 和 config.yaml）

把这两个填进插件的 python / model 配置（见下方「配置」）即可，也可以用插件设置里的「自动检测 Python 与模型」自动识别。

安装

准备好 FunASR 环境（venv + SenseVoiceSmall 模型目录）。
在你 profile 的 cordis.patch.yml（如 ~/.dsh/profiles/<profile>/cordis.patch.yml）里配置 python / model（见下方「配置」）。

安装插件：

dsh plugin --profile <你的profile> add <本插件目录或仓库地址>

重启 DSH，点输入框右侧的话筒图标即可。首次会请求麦克风权限，允许即可。

配置

有两种方式配置 python / model：

① GUI（推荐）：DSH 设置 → 通用 → 语音输入，点「自动检测 Python 与模型」会自动识别本机 FunASR venv 和 SenseVoiceSmall 目录；也可手动填写。持久化到 ~/.dsh/dsh-funasr-voice.json，优先级高于 YAML 配置。

② YAML：插件源码不带个人路径（默认 python: python3、model 为空）。在你自己 profile 的 cordis.patch.yml 里覆盖：

# ~/.dsh/profiles/<你的profile>/cordis.patch.yml
- id: dsh-funasr-voice
  config:
    python: /你的/FunASR/.venv/bin/python
    model: /你的/SenseVoiceSmall/模型目录

可配置字段：

字段	默认	说明
`enabled`	`true`	总开关
`basePath`	`/funasr-voice`	HTTP 路由前缀（一般别改）
`python`	`python3`	FunASR venv 的 python 解释器（必配）
`model`	（空）	SenseVoiceSmall 模型目录（必配）
`port`	`18765`	本地 ASR 服务端口
`language`	`auto`	`auto` \| `zh` \| `en` \| `ja` \| `ko` \| `yue`
`useItn`	`true`	逆文本正则化
`autoSend`	`false`	识别后自动发送

已知 Bug 与修复：DSH Desktop 2.0.2 麦克风权限

Bug 现象：DSH Desktop 2.0.2 的 Electron 主进程没有处理 getUserMedia 的 media 权限。结果是浏览器拿到一条静音流，且 macOS 从不弹「想要访问麦克风」授权框——语音插件表现为「录音了但识别不出、输入框没反应、没有文字」。

根本原因：dsh-plugin-desktop/src/main.ts 缺少 session.setPermissionRequestHandler，也从不调用 systemPreferences.askForMediaAccess('microphone') 去触发 macOS 的系统授权弹窗。

修复方式：给 DSH Desktop 源码打补丁（dsh-plugin-desktop/src/main.ts，在 app.whenReady() 之后）：

import { session, systemPreferences } from 'electron'

session.defaultSession.setPermissionRequestHandler((_wc, permission, callback, details) => {
  if (permission !== 'media') {
    callback(true)
    return
  }
  const mediaTypes = 'mediaTypes' in details ? details.mediaTypes : undefined
  const checks: Promise<boolean>[] = []
  if (!mediaTypes || mediaTypes.includes('audio')) checks.push(systemPreferences.askForMediaAccess('microphone'))
  if (!mediaTypes || mediaTypes.includes('video')) checks.push(systemPreferences.askForMediaAccess('camera'))
  void Promise.all(checks).then(results => callback(results.every(Boolean)))
})

重新构建并启动后，点麦克风会弹出系统授权框，允许后即可正常识别。若不想改源码，也可等官方修复该 Bug 后升级 DSH Desktop。

目录结构

.
├── lib/index.js       # host 半：拉起/代理 FunASR + HTTP 路由
├── lib/client.js      # client 半：话筒按钮 + VAD + 计时
├── asr_server.py      # FunASR(SenseVoice) HTTP 服务，host 半自动拉起
├── cordis.patch.yml   # 插件树插入补丁（配置）
└── package.json