Files
openless/docs/volcengine-setup.md
T
sim 34cab16fce docs: 以源码为准重写 1-app 文档系统(19 篇)
保留目录骨架与文件名,内容全部以当前源码为依据重写:范围与版本锚点
(2.0.0-Beta.1 / crate 0.1.0 / com.openless.app)、架构分层与 Core 模块地图、
桌面验收清单(功能域→源码入口→证据)、Linux 交接 8 篇(沿用 L01-L12 登记体系,
锚点落到 settings.rs/audio.rs/ports.rs 等)、后端接口契约、Android 计划、
运营指南 5 篇(以 provider descriptor 与实际 CSP/.gitmodules 为锚)。
原过程中的计划叙述、截图与历史收口记录不再保留。
2026-09-07 13:48:29 +08:00

1.5 KiB
Raw Blame History

火山引擎(volcengine)ASR 配置

状态:canonical(2026-09-07 以源码为准重写);更新:2026-09-07。

1. 代码中的定义

  • Provider:volcengine(labelKey asrVolcengine),定义于 Core provider_rules.rs;authRequirement = Volcengine(专用鉴权形态),无内置默认端点/模型(defaultEndpoint / defaultModel 为空,按通道配置)。
  • 验证探针:asr_silence_allows_no_final(静音段允许无 final 帧,验证以可取消的静音探测完成)。
  • 凭据字段(provider_rules.rs:300-302):volcengine_auth_mode(鉴权模式,如 ApiKey/官方端点模式)、volcengine_app_key、volcengine_access_key(布尔项 + 模式选择;具体取值在设置界面录入,凭据走系统安全存储,不落明文)。

2. 在应用内配置

设置 → AI 服务 → 语音识别 → 添加渠道,选择火山引擎;按界面提示填入鉴权字段,保存后执行“验证”得到真实验证结果(成功/失败与时间会记录在渠道列表)。

3. 端点与排错

  • ApiKey 模式使用火山官方实时 ASR 端点(历史修复 #931 后的行为,以 crates/openless-core/src/asr/volcengine.rs 当前实现为准)。
  • 弱网行为:连接超时与重试在 Host/Core 实现,失败信息展示在渠道验证结果中。
  • 开通服务、创建应用与获取密钥属火山控制台操作,以火山官方文档为准;本仓库只维护代码行为。