Electron 网络与凭据¶

历史背景： 本页面编写于 Electron 与 Tauri 应用共存期间。文中提到的 Tauri 辅助模块、页面、测试和回归结果描述的是那段迁移期；Tauri 外壳此后已被移除，共享代码现在位于 electron/src/shared/。现有 Tauri 安装：参见迁移指南。

设置现在在共享设置外壳中展示网络与凭据。侧边栏搜索包含代理、Hugging Face、DeepL 和 Microsoft 标签。

网络从 /system/info 读取已配置的代理。保存和清除使用与 Tauri 相同的辅助函数更新全部六个大写/小写 HTTP、HTTPS 和 ALL 代理变量。写入按顺序执行；失败会终止后续操作且不显示成功。部分失败可以重试或清除。保存不会修改 audio-tool 可执行文件设置；其链接打开 Audio tools。

凭据显示 Hugging Face 解析器来源（应用、环境、CLI）、掩码值、活动来源和验证状态。普通读取仅使用本地状态。测试现在显式请求重新验证。保存成功后清除密码输入。清除操作以内联方式询问，默认仅清除应用令牌；CLI 文件移除需要其单独的启用开关。环境凭据仍由应用外部管理。机密输入从不进入草稿持久化或浏览器存储。

DeepL 和 Microsoft 密钥/基础 URL 使用现有持久化的 /system/set-env 契约。字段定义与 Tauri 共享。空白输入不能覆盖已存储的凭据；成功保存会清除输入。提供方连接性不会从成功的设置写入中推断。

electron/tests/connection-settings-smoke.mjs 检查代理保存/重新加载/清除、部分失败、本地令牌读取、显式验证、重复提交、仅应用/CLI 清除，以及针对模拟路由的提供方密钥提交。实时后端令牌状态读取返回了预期的来源 schema。验证过程中未更改任何真实代理或凭据值。辅助函数提取后，Tauri 网络和翻译回归测试均通过。

模型设置现在包含 Hugging Face 镜像选择：自动路由、后端通告的预设和自定义 URL。设置读取使用缓存的端点状态；网络测试仅在显式点击时运行。写入使用现有后端并遵循其需要重启的响应。浏览器 fixtures 验证保存、重新加载、失败写入和 Auto 重置。实时只读 schema 已验证；验证期间未更改真实镜像偏好，也未触发探测。

模型下载和 Engine Ready 使用本地后端的安装和运行时状态。Clone、Design、Stories、Audiobook、批处理、档案预览和对比操作共享该本地就绪契约。

共享仅在内联确认后暴露后端。它显示活动中的 PIN 和 LAN 地址，在本地生成 QR 链接，支持可配置的共享端口，并控制后端的 Tailscale serve 集成。这些操作保持显式，不会在设置读取期间运行。

远程后端配置由 Electron 主进程拥有。连接测试验证 VoiceStudio 健康响应，并一次性交换可选的服务端主密钥以获取作用域限定、有时效的会话。渲染器立即清除密钥；仅持久化 URL。主进程将会话注入生产和开发 HTTP 代理流量、原生监视文件夹上传以及路径绑定的听写 WebSocket 票据。随时可以切换回本地后端。