dsh-listener

DeepSeek Harness 云端实时语音输入插件。按住右 Alt 说话，松开停止；识别文字追加到当前会话草稿，默认不发送。

当前版本 0.4.0。安装与检查更新统一使用 npm 默认渠道。兼容 Harness 0.2.0-rc.2、Node.js 22.19+（22.x）或 24+，推荐 Chrome / Edge。更新记录见 CHANGELOG.md。

安装

在 DSH Desktop 的 插件 → 添加插件 中填写 dsh-listener 安装最新版。安装后完全退出并重新打开 Desktop。

命令行安装：

npm install -g @deepseek-ai/[email protected]
dsh plugin --profile web add dsh-listener
dsh web

配置

打开 插件 → dsh-listener → 设置，或右键会话输入框旁的麦克风。填写百炼 API Key，确认地域与 Workspace ID，点击保存。Workspace ID 支持粘贴完整 API Host 自动提取。

设置	默认值 / 说明
地域	北京，可选新加坡；须与密钥匹配
Workspace ID	工作空间 ID；留空使用传统 DashScope 域名
识别模型	qwen-audio-3.1-asr-flash-streaming；须支持 DashScope 流式 ASR 协议
快捷键	右 Alt，可录入单键或组合键
录音模式	长按，可切换为点按
自动发送	关闭；开启后连同原草稿一起发送

API Key 由 Harness 凭据服务保存，设置接口不回传密钥；也支持启动环境变量 DSH_LISTENER_API_KEY。环境变量优先时页面可能无法修改密钥。“清除已保存配置”会清除已保存密钥并恢复默认设置。

使用

• 选择会话并允许麦克风权限，按钮变绿后开始收音。长按快捷键录音，松开停止；点按模式和麦克风按钮均为再次点击停止。
• 录音中悬停麦克风可查看预览；停止后等待最终文字追加到草稿，原内容与引用保留。没有识别到语音时安静结束。
• 输入框不可编辑时保留识别文字，可通过“恢复识别文字”追加、复制或明确丢弃；处理前不会启动新录音。切换会话后返回仍可恢复，重新加载页面会清除尚未处理的文字。
• 快捷键仅在页面获得焦点时生效。AltGr 用户请改绑其他键；浏览器或系统保留的组合可能不可用。
• 切换会话、标签页或窗口失焦会取消本次录音。每次最多录音 120 秒；远程页面需要 HTTPS，localhost 可直接使用。

更新

设置中的 插件管理 提供检查更新、更新及下载进度，与安装统一查询 npm 的 latest。发布新版后，点击检查更新即可发现；本地修改尚未发布时不会推送给用户。录音期间禁止更新，安装后按提示重启 Desktop。

下载来源默认 npm 官方，可切换为 npm 镜像（默认 https://registry.npmmirror.com）。镜像可能延迟同步，刚发布后优先使用官方来源；失败时不会自动回退。下载设置自动保存，镜像不代理百炼音频或密钥。安装前验证安装包完整性与插件版本。

更新包保留在 profile 的 .plugin-manager/archives/，pnpm 的后续安装仍会引用这些文件，请勿手动删除正在引用的安装包。旧版本更新若报安装包缺失，请从 Desktop 插件管理日志找到旧路径，恢复对应版本的原包后再更新。

从 0.3.x 首次升级到 0.4.0，请通过 Desktop 插件管理安装 npm 新版并重启；旧版自带更新器仍会清理临时包，不能靠安装新版自动改变旧更新器的清理行为。

此前使用旧包名安装的用户，请在 Desktop 插件管理中停用旧插件，安装 dsh-listener 并重启，重新填写密钥和设置。安装新包后，后续版本可通过设置检查 npm 更新。

隐私与排错

音频经 Harness Host 上传至阿里云百炼，插件不保存音频文件或录音日志；最终文字遵循 Harness 草稿和消息的保存行为。取消无法撤回已上传音频，可能已经计费。同一 Host/profile 的设置与密钥由已授权用户共享，默认凭据存储不是加密钥匙串。

按钮不可用时检查会话与 HTTPS；本地握手失败时更新插件并重启 Desktop；百炼 401/403 时检查密钥、地域、空间和模型权限。失败不会自动重试或切换服务。

真实百炼准确率、延迟、计费及各 Desktop 环境仍需实际验收。远程网络延迟较高时，HTTP 音频上传可能积压并超时。

开发

pnpm install --frozen-lockfile
pnpm check
pnpm verify:package

发布流程：通过上述检查后，手动运行 GitHub Actions 的 Publish npm 工作流（需配置 npm Trusted Publisher），或使用 npm 登录后发布 output/dsh-listener-<版本>.tgz。版本号须同步修改 package.json 和 src/shared.ts。

采用 MIT，上游来源与版权见 THIRD_PARTY_NOTICES.md。