DeepSeek Harness (DSH) 采用插件化架构。Web GUI 提供了基础对话界面，但缺少语音输入能力。dsh-voice 作为一个官方插件包，为 Web GUI 补齐了这一功能。
它是什么¶
这是由 KotDath 维护的 DSH 插件。它将麦克风按钮和实时波形可视化集成到编辑器中，支持三种转录引擎，无需依赖 Handy 应用。
核心功能¶
- 界面集成：在编辑器发送按钮旁显示麦克风按钮，点击后弹出录音条（带波形）。
- 操作逻辑：录音条提供三个操作：
✕— 取消录音⏹— 停止并插入文本到输入框↑— 停止并直接发送到聊天
- 转录引擎：内置三种模式：
transcribe.cpp(默认)：基于 Handy 引擎，支持 67 种模型。whisper.cpp：本地运行。api：兼容 OpenAI 的 API 转录接口。
- 长录音处理：超过 22 秒的录音会自动分段处理。
- 独立性：无需安装 Handy 应用，引擎可自下载或从 PATH 读取。
安装与启用¶
- 确保已安装 DeepSeek Harness Web GUI（Node.js 环境）。
- 执行安装命令：
dsh plugin --profile web add github:KotDath/dsh-voice
- 重启 Web 进程以加载插件：
dsh web
典型用法¶
- 配置引擎：打开 Web GUI 的设置页面，进入 Voice 选项卡。插件会自动检查引擎状态，点击 “Download engine” 下载（支持多平台）。
- 选择模型：从内置的 67 种模型目录中选择一个，若未下载则点击下载。
- 录音：在编辑器中点击麦克风按钮，开始录音。
- 发送/插入：录音结束后，根据需要选择停止并直接发送，或仅插入文本。
注意事项¶
- 运行环境：仅适用于 DeepSeek Harness Web GUI。
- 主机依赖：主机需安装
bash、curl（下载引擎）和ffmpeg（音频转换）。 - 浏览器限制：麦克风访问需通过 HTTPS 或 localhost 访问。
- 安全：OpenAI API Key 仅在主机端设置，不在页面显示，通过环境变量传递。
- 数据存储：插件数据存储在进程启动目录下的
.engine/、.models/和.tmp/文件夹中。
