账户模型

Glossia 将存储库指令与模型提供商凭据分开。存储库描述需要翻译的内容，而帐户决定由哪个 大型语言模型 执行工作。

## 为何模型归属于帐户

一个团队通常会与相同的提供商关系翻译多个存储库。帐户范围的模型允许管理员轮换提供商密钥，而无需编辑每个存储库，只需一次切换底层模型。

此边界还将凭据保持在源代码版本控制之外。存储库包含可读句柄，如 translation-default，而不是提供商密钥。

## 句柄提供稳定意图

The model 字段在 L10N.md 中指账户模型句柄：

model: translation-default

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

## 如何使用多个模型

Glossia 为每个文档翻译使用一个配置的 生成式 模型。添加多个模型不会创建集成、回退链或自动质量层级。存储库作者通过稳定的句柄选择其目的，如 translation-default、long-form 或 japanese-specialist。

选择遵循文档和目标语言环境的上下文层级：

1. 声明 model 的最近的 L10N/<locale>.md 文件为该语言环境胜出。
2. 否则，声明 model 的最近的 L10N.md 文件为其目录胜出。
3. 当较近的文件未声明模型时，继承父级 L10N.md 设置。
4. 当没有适用的上下文文件声明句柄时，Glossia 使用帐户默认的生成式模型。

必须存在显式配置的句柄。Glossia 对未知句柄报错，而不是静默切换到帐户默认项。

## 默认选择

在存储库拥有自己的 L10N.md 之前，项目设置需要一个模型。因此，Glossia 选择帐户默认模型。每个类别中首先添加的模型成为该类别的默认模型，管理员可以从其设置页面将另一个模型设为默认。

一旦存储库具有 L10N.md，使用显式句柄会使选择对审稿人清晰明了。省略 model 则存储库保持在帐户默认项。

## 生成式和决策模型

模型配置有两个类别：

• 生成式 模型编写翻译并支持项目设置。存储库模型句柄和语言环境路由规则仅选择此类别。
• 决策 模型根据固定的质量准则评估翻译。当帐户有决策模型时，其默认决策模型会在结构验证之后，自动检查来自内容端点的完整单文档翻译后的每个存储库文档。片段请求是生成原语；存储库运行评估其组装的输出。

这些类别拥有独立默认值。添加 Jev 永远不会改变撰写您翻译的模型。第一个决策模型为后续翻译运行启用评估；删除最后一个则禁用评估。没有决策模型的帐户保留其现有行为。

Glossia 目前支持 TypeSafe Jev 作为决策提供商。Jev 返回预定义的选项和分数，而不是散文。Glossia 将弱点选项转换为修正提示，而不移用它们作为定位的或独立验证的错误。

## 质量检查和修订

评估器接收源语言、翻译、目标语言环境、内容格式、项目说明和解析后的组织上下文。它评估含义保留、完整性、术语、流畅度、文档连贯性、目的和受众契合度以及语言环境适当性。当语音、项目或文档指南可用时，评估语音和语域。

每个维度必须达到配置的最低分，默认为 10 分中的 7 分。重大或关键错误始终请求修正，无论分数如何。置信度包含在实时评估事件中且不改变接受度。这些事件当前不会保留或在仪表板中显示。阈值为 10 需要完美加权分数，通常过于严格。

失败的维度将其预定义的修正提示输入到下一个翻译尝试中。存储库现有的 retries 设置限制这些修订；内容端点允许重试修正三次，通过其 retries 字段从零配置到三次。完整的修订文档在再次通过结构检查和质量评估后才被接受。

瞬态提供商故障重试最多三次，使用指数退避；无效凭据和畸形响应立即失败。用尽的提供商故障停止文件翻译；未检查的输出永远不会被接受。评估使用完整文档，过大的评估输入被拒绝而不是截断。序列化的输入保守限制为状态加最长问题 30,000 字节，整个请求 60,000 字节，以保持在 Jev 的上下文限制 内。自动评分是模型判断，仍然需要通过与双语人工审核进行校准。

评估器配置和准则版本参与翻译锁定文件。启用评估、更改模型或阈值，或删除评估会使先前的翻译对下一次运行过时。提供商密钥不包含在锁定文件中。

## 人工审核边界

模型输出是提议的工作，而非自动合并。设置和翻译活动在 Glossia 中保持可见，而存储库更改通过拉取请求发布，供团队审核。这保持了团队用于代码的相同质量和所有权边界。