引擎与模型：本地 / 云端如何选、如何配
TransBox 只提供客户端与适配层，不代售、不托管任何第三方大模型服务。
语音识别（ASR）、机器翻译（MT）、语音合成（TTS）均可在设置中心自行选择「本地离线」或「云端服务」，并按提示完成下载或填入 API Key。
1. 默认出厂配置（与当前客户端一致）
| 阶段 | 默认引擎 | 说明 |
|---|---|---|
| 语音识别 | 本地 Qwen3-ASR | 纯本地推理，数据不出机 |
| 机器翻译 | 本地 腾讯混元 Hy-MT2-1.8B | 官方实测优选的本地同传翻译大模型（约 3.6 GB） |
| 语音合成 | 本地 Kokoro-82M | 轻量本地 TTS，首包延迟低 |
若本地权重尚未下载，打开「译文 / 朗读」时会提示先下载；也可在设置中一键切换到云端并填写厂商 API Key。
2. 本地离线模型
2.1 能做什么
下载一次后，拔掉网线仍可进行识别 / 翻译 / 朗读（视所选引擎而定）
适合隐私敏感场景、网络不稳定环境、长期高频使用
经测试,本地 腾讯混元 Hy-MT2-1.8B 延迟以及翻译效果最佳,推荐优先使用本地模型
2.2 下载与存储
- 打开 设置中心 → 语音识别 / 机器翻译 / 语音合成 → 本地离线模型
- 查看硬件评级与占用空间，点击 下载模型
- 可 更改路径 / 打开目录 / 清除缓存
默认缓存位置（Windows 示例）：
- ModelScope：
%USERPROFILE%\.cache\modelscope\models\... - Hugging Face：
%USERPROFILE%\.cache\huggingface\hub\...
2.3 下载镜像源
设置卡片内可切换：
| 镜像源 | 适用 |
|---|---|
| 全球官方节点（Hugging Face） | 海外或网络通畅时优先 |
| 国内高速镜像（ModelScope / 国内 CDN） | 国内网络更稳 |
全球节点失败时，客户端会自动降级到国内备用镜像；也可手动先选国内源。
2.4 本地代理（可选）
仅影响模型下载，默认不启用：
- 勾选 启用代理下载
- 地址默认提示为
http://127.0.0.1:7897（端口因 Clash 等软件而异，请按本机修改） - 取消勾选即停用
- 国内用户若已选「国内高速镜像」，通常无需代理
- 海外用户一般不用开启
- TransBox 不会在未勾选时强制走本机代理
2.5 硬件与性能
- 本地 ASR / MT 建议 NVIDIA 独显；无独显时可回退 CPU（更慢）或改用云端
- 本地 MT（Hy-MT2-1.8B）显存建议约 3.6 GB 以上更流畅
- 具体帧级延迟、准确率与声学环境、语速、术语表有关，不构成性能保证
3. 云端服务（自备 API Key）
3.1 模式说明
| 要点 | 说明 |
|---|---|
| 谁提供能力 | 第三方云厂商（如阿里云百炼、腾讯混元、小米 MiMo 等） |
| 谁付费 | 用户自行在厂商控制台开通、充值、获取 API Key |
| TransBox 角色 | 仅做协议适配、配置界面与调用；不代收、不转售厂商额度 |
| 密钥保存 | 存于本机配置，不会写入创意工坊包或上传到 TransBox 服务器 |
3.2 配置步骤（通用）
- 在厂商官网注册并开通对应模型服务，创建 API Key
- 设置中心选择「云端服务」与具体引擎
- 粘贴 Key、按需修改 Base URL / 模型名
- 点击 测试连接
- 保存并生效
3.3 限流与并发
云端调用受厂商账号的 RPM / TPM 等配额约束（一般按主账号合并计算，不是「仅允许一个连接」）。
个人档默认额度通常足够单人使用；多人共用同一把 Key 会共享额度。遇到 429 / 限流时：
- 稍后重试，或降低同时开译文/朗读的负载
- 到厂商控制台查看配额、申请提额或升级企业档
- 这属于上游限制，不是 TransBox 客户端故障
3.4 隐私
- 本地引擎：音频与文本在本机处理（视插件实现而定）
- 云端引擎：相关内容会发送至你所配置的第三方 API，请自行阅读该厂商隐私政策
- 建议勿在未理解数据流向前，对高度机密会议开启云端识别/翻译
4. 兼容适配与责任边界（请务必阅读）
- TransBox 是客户端软件：Steam 购买的是本软件使用权；本地开源权重与云端 API 均非 TransBox 出品或托管。
- 模型与厂商可能变更：名称、定价、限流、可用区域、鉴权方式由第三方决定；我们会在版本说明中尽量同步，但无法保证与所有上游长期 100% 兼容。
- 适配范围：官方内置适配的引擎以设置页实际选项为准；第三方 MOD 引擎由社区作者维护，使用风险自负。
- 无服务可用性保证：本地模型下载依赖网络与镜像站；云端依赖厂商 SLA。同传延迟、准确率受声学、语种、术语表、硬件等多因素影响，不作结果承诺。
- 费用：本地权重下载可能产生流量费用；云端按厂商计费，与软件买断价无关。
- 合规使用：请遵守当地法律法规与各云厂商服务条款；不得将本软件用于违法监听、侵权传播等用途。
- 技术支持范围：我们协助排查客户端日志、默认引擎与官方文档所列集成；第三方账号开通、扣费、封禁、密钥泄露等请优先联系对应厂商。
5. 我该怎么选？
| 你的情况 | 建议 |
|---|---|
| 注重隐私 / 无稳定外网 | 全选 本地，先下载权重 |
| 要最高识别准确、可接受联网 | ASR 用 云端，MT/TTS 可本地或云端 |
| 显存 < 4 GB | 云端为主，或降低同时加载的本地模型 |
| 国内下载慢 | 镜像源选 国内高速；仍不行再考虑勾选本地代理 |
| 企业/多开共用 Key | 到厂商开通更高配额，或各自使用独立 Key |