description: "从插件管理页启用实验性语音输入。" kind: "package-bundle"

@qilin-agent/experimental-voice-input-bundle

English | 中文

概述

此可选 Bundle 组合语音服务定义、本地 SenseVoice Provider、带认证的 Remote 与浏览器麦克风控件。随包配置默认禁用。

目录

• 使用此包
• 理解实现
• 进一步探索
• 模型体验
• 已知限制与后续工作
• 开发备注

使用此包

打开 Web 侧栏的插件管理页并启用带蓝色声波图标的“语音输入”。模型需要准备时，弹窗提供“前往安装”和“稍后”选项；“前往安装”打开 Bundle 详情。缓存完整时不会提示安装。在详情中选择“下载并准备”；默认折叠的当前步骤摘要可展开为完整步骤列表。下载报告真实字节，校验和加载显示等待时间。就绪后点击模型选择器与发送按钮之间的麦克风，再点击停止以插入转写文字。Bundle 详情通过 Settings 服务保存识别器和语言。禁用 Bundle 会取消当前任务；缓存资源保留在磁盘上。

理解实现

静态 cordis.patch.yml 添加四个语音条目，选择 sensevoice-local 作为默认识别器，并通过 qilinHomePath 提供 Provider 缓存目录。可选 Bundle 安装使插件管理器能够发现此包，但不会在默认配置中选择它。浏览器贡献拥有其生成 Remote 的挂载；稳定 API Remotes 不导入实验性代码。此纯配置包没有独立可变的运行时状态，因此

进一步探索

语音输入子系统

模型体验

无，因为录音与准备不进入模型请求；之后的文字由普通用户提交拥有。

KV 缓存影响

没有直接影响；普通提交拥有消息内容。

已知限制与后续工作

• 此 Bundle 提供一个本地识别器。额外 Provider 使用不同 id 注册到同一服务；云端识别需要显式增加 Provider 与凭据配置。Bundle 不增加模型工具或修改智能体循环。
• 安装 qilin 时会一并安装 sherpa-onnx-node 及其平台原生运行时（含 ONNX Runtime），即使此 Bundle 处于禁用状态。运行时的磁盘占用和下载量独立于“下载并准备”所下载的模型；原生包体积随平台和版本变化。

开发备注

无。