前言¶
在 DeepSeek Harness(dsh)里写提示词,常见做法是手打或从别处粘贴。语音输入能省 keystroke,但识别结果常有同音字、漏标点;草稿往往又偏笼统,还要再改一轮。社区插件 dsh-voice-enhance 在消息输入区增加两个控件:按住 Alt 说话,松开后在 Host 上转写并用默认模型纠错再插入光标处;输入框左侧、模型选择器前的 ✨ 按钮则用同一默认模型把当前草稿改写成更清晰、更具体的提示。下面介绍它做什么、依赖什么、如何安装与使用。
这是什么¶
dsh-voice-enhance 由维护者 Chrono-rigger 发布,面向 DeepSeek Harness Web 客户端。插件通过 Cordis patch 注入会话 UI(@deepseek-ai/dsh-client-ui-conversation),在消息 composer 上增加听写与提示增强能力;自身不配置、不读取 API Key,纠错与润色走 Host 的 llm 服务,并使用当前 composition 的 default model route。许可证为 MIT(package.json 版本 1.0.0)。
核心功能¶
按住 Alt 听写¶
- 按住
Alt开始录音;松开Alt停止。 - 录音在 Host 侧转写,再经 Host 模型修正识别常见错误(同音字、错字、缺标点等),结果插入当前光标位置。
- 若松开
Alt时同时还按了其它键(例如Alt+Tab、输入法组合键),本次采集会被丢弃,避免误触。 - 录音过程中按
Esc可取消。
✨ Enhance prompt¶
composer 左侧、紧挨模型选择器之前的 ✨ 按钮,会用默认模型把当前草稿改写成更清晰、更具体的 prompt,并 替换 草稿;完成后提供 Undo 可恢复原文。
进行中的状态条¶
听写或润色进行时,composer 卡片下方会出现状态 pill:已用秒数、「send on release」开关、转写无法自动插入时的 Insert 按钮,以及润色后的 Undo 按钮。
| 按键 / 控件 | 行为 |
|---|---|
Alt(按住) |
开始录音 |
松开 Alt |
停止、转写、纠错、插入 |
Alt + 其它键 |
视为快捷键,丢弃本次采集 |
录音中 Esc |
取消 |
| ✨ 按钮 | 润色当前草稿 |
依赖与运行环境¶
- 语音转写 依赖 Harness 的 Voice Input 插件(
dsh-experimental-voice-input-bundle),须已启用并完成 SenseVoice 模型准备;未就绪时插件会提示语音服务不可用。 - 纠错与润色 在 Host 上通过
llm完成;Remote 侧各有一次性文本改写调用:promptTools/refine,转写纠错为mode: "correct",草稿润色为mode: "enhance"。 - 浏览器 需麦克风权限(HTTPS 或
127.0.0.1,以及系统级麦克风授权)。 - DSH 版本:
engines.dsh要求>=0.2.1-rc.1 <0.3.0-0(见package.json)。
音频链路端到端有超时(权限、recorder flush、解码、重采样、转写等),避免浏览器 API 卡死时出现 endless「transcribing」;录音在转写后丢弃,不写盘。
安装与启用¶
CLI 安装(命令摘自仓库 README,<profile> 换为你的 profile 名):
dsh plugin --profile <profile> add github:owner/dsh-voice-enhance
仓库地址为 github.com/Chrono-rigger/dsh-voice-enhance;若 CLI 要求完整 GitHub 坐标,以你当前 dsh plugin add 文档与上述仓库为准。
或在 Web UI:Settings → Plugins,按包名或从本地目录安装 bundle。
安装前请自行查看 GitHub 源码 与 MIT 许可证;插件在 当前 dsh 进程权限 下运行,与其它 DSH 插件相同,安装前应确认你信任该来源。
典型用法¶
- 确认
dsh-experimental-voice-input-bundle已启用且 SenseVoice 就绪,浏览器已允许麦克风。 - 在会话消息框内将光标放到要插入文字的位置,按住
Alt说话,松手;等待转写与纠错完成后文本出现在光标处。 - 若状态条里出现 Insert,说明未能自动插入,可手动点 Insert。
- 写好草稿后点 composer 左侧 ✨,等待润色完成;不满意则用 Undo 恢复。
- 可选:状态条中的 send on release 开关会写入浏览器本地偏好(
localStorage键dsh-voice-enhance.autoSend);除该项外插件不持久化其它数据。
适用场景与注意¶
- 适合:经常在 DSH Web 里写长 prompt、希望少打字又愿意用 Host 默认模型做一轮识别纠错或结构化润色的开发者。
- 不适合:未安装或未配置 Voice Input / SenseVoice 的环境;需要独立配置 LLM API Key 的场景(本插件不读 Key,完全依赖 Host 路由)。
- UI 样式使用 Host 主题 token(
--dsw-alias-*),亮暗主题无需单独资源。 - 社区目录 skillhub.cn 上的插件页 与 GitHub 均为社区维护信息源,与 DeepSeek / 幻方无官方从属关系;DSH 生态强调「一切皆插件」,是否安装由你自行评估。
结尾¶
dsh-voice-enhance 把听写、识别纠错和草稿润色收进消息 composer 的两个控件里,依赖 Voice Input 做转写、依赖 Host 默认模型做文本改写,本地几乎只存「松手是否发送」一项偏好。进一步了解可访问目录页 https://www.skillhub.cn/plugins/Chrono-rigger/dsh-voice-enhance 与仓库 https://github.com/Chrono-rigger/dsh-voice-enhance。