前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许社区开发者扩展核心能力。在构建语音交互场景时，开发者通常需要精细的会话控制、明确的用户授权流程以及安全的草稿管理机制。jstn-1g/dsh-live-voice 插件旨在为 DSH 提供一个受控的语音交互层，确保每一次语音交互都在明确授权下进行，并严格隔离会话环境。
插件简介¶
插件名称：jstn-1g/dsh-live-voice
核心价值：提供有条件的一次语音回合、合成演示及草稿移交能力。
维护者：Jstn-1g
许可证：MIT
核心功能¶
该插件主要包含以下已核实能力：
- 有条件的一次语音回合：限制在单次对话回合内，需用户明确确认。
- 精确会话隔离：确保每个语音会话独立运行，避免状态污染。
- 明确的草稿移交：提供明确的按钮操作将转录文本放入草稿区。
- 免凭证本地合成演示：在不依赖外部凭证的情况下提供本地合成演示。
- 手动回合检测：由用户手动触发或控制回合流程。
安装与启用¶
通过 DSH 命令行工具安装该插件。请确保已安装 dsh 客户端。
- 执行以下命令安装指定预览版本：
dsh plugin --profile web add github:Jstn-1g/dsh-live-voice#v0.3.0-preview.5
- 安装完成后，重启 Web profile 并打开一个 Live Session。
典型用法¶
使用该插件进行语音交互的典型步骤如下：
- 在 Live Session 的编辑器控制栏中，点击麦克风图标以打开 DSH Live Voice。
- 在弹出的界面中，确认目标显示为 Local deterministic synthetic demo。
- 开始语音交互，完成回合后，界面会提供两个转录文本。
- 点击 Use my transcript as draft 按钮。
- 注意：此操作仅将文本放入当前草稿区，不会自动提交编辑器。
适用场景与注意事项¶
该插件适合需要在 Web 环境下进行受控语音交互的开发场景。
注意事项：
* 未经验证功能：基于凭证的 Qwen 模型、物理麦克风或扬声器、打包的 Desktop 环境目前尚未经验证。
* 并发限制：不要让多个 Harness 实例同时写入同一个持久化的 Session，这可能导致数据冲突。
* 操作边界：插件设计为安全沙箱，绝不会自动提交编辑器或运行工具。
总结¶
jstn-1g/dsh-live-voice 插件通过明确授权、会话隔离和手动控制，为 DSH 提供了基础的语音交互能力。对于需要构建安全、受控语音界面的开发者，这是一个可用的技术方案。
