Repository navigation
v1.1 在 v1.0 的「服务器零持有 key」硬约束下,让 BYOK 体验从「能用」升级到「称手」。
🎯 三个核心 feature
1. 多组 provider 配置保存与切换
- 每个用户可保存多组命名 config(含 ⭐ 默认标记)
- 顶部 dropdown 一键切换 active provider
- 导出 / 导入 JSON 防 localStorage 丢失
- 卡片状态点(绿/灰/红)显示上次连接测试结果
2. 连接测试(最小 token JSON ping)
- 验证 provider+model+key 可用 + JSON 输出能力
- 5 类错误精确分类(含 429):
network→ 网络不通 / base_url 不可达 / 5xx / connection refusedauth→ 401 / 403 / key 过期或无权限rate_limit→ 429 触发限流json_format→ HTTP 200 但 model 不返回合法 JSON(agent 调用必败的预警)unknown→ 其他
- 弹窗显示 HTTP status + provider 原始错误 message + 中性建议文案 + 一键复制
3. 语音输入(speech-to-text)
- 单题演练 + 模拟面试 textarea 右下角 🎙 按钮
- 浏览器原生 Web Speech API(zh-CN/zh-TW/en-US 可在 /setup 切换)
- 不支持的浏览器(Firefox / 非 HTTPS)按钮自动不渲染(优雅降级)
- BYOK 不破坏:音频从不进后端
🔧 7 个辅助配套
- localStorage 数据丢失警告 banner
- 全局语音识别语言开关
- 配置导出/导入 JSON(merge by id)
- 顶部导航 ConfigSwitcher dropdown
- 默认配置 ⭐ 标记(删除 active 时 fallback)
- SecretInput 通用组件(password 输入 + 👁 显隐 toggle)
- BYOK 不变量 self-check 写入 docs/byok.md
📊 关键指标
| v1.0 | v1.1 | |
|---|---|---|
| Backend tests | 63 | 88 + 1 skipped real-LLM |
| Frontend lib | 单 config | multi-config store + ui-prefs + speech wrapper |
| 新组件 | — | SecretInput / ConnectionTestDialog / VoiceInput / ConfigSwitcher |
| 新后端 endpoint | — | POST /provider/test |
| BYOK 服务器零持有 key | ✅ | ✅(grep self-check 0 命中) |