账户模型

Glossia 将仓库指令与模型提供商凭据分离。仓库说明应翻译哪些内容，账户则决定由哪个大型语言模型执行翻译。

模型为何归属账户

一个团队通常会通过同一个提供商合作关系翻译多个仓库。使用账户范围的模型后，管理员只需轮换一次提供商密钥或切换一次底层模型，无需编辑每个仓库。

这一边界还可避免将凭据提交到源代码管理系统。仓库中包含的是便于理解的句柄，例如 translation-default，而不是提供商密钥。

句柄提供稳定的意图表达

GLOSSIA.md 中的 model 字段引用账户模型句柄：

model: translation-default

该句柄表达仓库的意图。管理员之后可以更新此句柄选择的提供商模型，同时保持仓库配置不变。

如何使用多个模型

Glossia 为每个文档翻译使用一个已配置的模型。添加多个模型不会创建模型集成、回退链或自动质量等级。仓库作者通过 translation-default、long-form 或 japanese-specialist 等稳定句柄来指定其用途。

模型选择遵循文档和目标区域设置的上下文层级：

1. 对于该区域设置，声明了 model 的最近层级 GLOSSIA/<locale>.md 文件优先。
2. 否则，对于其目录，声明了 model 的最近层级 GLOSSIA.md 文件优先。
3. 当更近层级的文件未声明模型时，将继承父级 GLOSSIA.md 设置。
4. 如果没有适用的上下文文件声明句柄，Glossia 将使用账户默认模型。

显式配置的句柄必须存在。如果句柄未知，Glossia 会报告错误，而不会静默切换到账户默认模型。

默认选择

在仓库拥有自己的 GLOSSIA.md 之前，项目设置过程也需要使用模型。因此，Glossia 会选择账户默认模型。添加到账户的第一个模型将成为默认模型，管理员可以在其他模型的设置页面中将其设为默认模型。

仓库拥有 GLOSSIA.md 后，使用显式句柄可让审阅者清楚了解其模型选择。省略 model 可使仓库继续使用账户默认模型。

人工审阅边界

模型输出是建议的变更，而不是自动合并的结果。设置和翻译活动始终在 Glossia 中可见，而仓库变更则通过拉取请求发布，供团队审阅。这样可以保留团队已在代码工作流中采用的质量与责任边界。