@wuyaos/pi-model-config 0.0.0-stage → 0.1.2

package/src/i18n.ts

@@ -0,0 +1,824 @@
+export type UiLanguage = "zh-CN" | "en";
+export type TranslationParams = Record<string, string | number | boolean>;
+
+const ZH = {
+  commandDescription: "模型与服务商配置 / Models and providers",
+  mainTitle: "模型与服务商配置",
+  mainCancel: "取消",
+  back: "返回",
+  panelBack: "[B] 返回",
+  languageTitle: "语言 / Language",
+  languageZh: "简体中文",
+  languageEn: "English",
+  languageSaved: "界面语言已保存：{language}（立即生效）",
+  tuiRequired: "/model-config 需要交互式 TUI；RPC/print/json 模式不支持自定义多选界面",
+  startupIssues: "部分服务商因配置错误未注册，可继续编辑：{issues}{more}",
+  startupMore: "；另有 {count} 项",
+  newProviderTitle: "选择内置服务商（内置不代表已认证或可用）",
+  providerTagCustom: "自定义",
+  providerTagBuiltin: "内置",
+  providerLabelCustom: "★ {display}  [{status}]",
+  providerLabelConfigured: "◆ {display}  [{status}]",
+  providerLabelBuiltin: "{display}  [{status}]",
+  newProviderId: "新服务商 ID",
+  providerExists: "服务商 ID {id} 已存在，将进入现有配置编辑，不会按新服务商覆盖",
+  panelLanguage: "界面语言：{language}",
+  panelSearchProviderPrompt: "搜索服务商：",
+  panelSearchProviderPlaceholder: "名称或 ID",
+  panelNoConfiguredProviders: "没有已配置服务商",
+  panelNoProviderSelected: "选择服务商后查看详情",
+  overviewEnter: "[Enter] 进入服务商",
+  overviewSearch: "[/] 搜索",
+  overviewDisable: "[Ctrl+X] 禁用",
+  overviewEnable: "[Ctrl+X] 启用",
+  overviewDelete: "[Ctrl+Del] 删除服务商",
+  overviewAdd: "[Ctrl+N] 添加服务商",
+  overviewClose: "[Esc] 关闭",
+  overviewLanguage: "[F2] 界面语言",
+  detailConnectionTitle: "连接摘要",
+  detailModelsTitle: "模型概况",
+  detailFetchHint: "进入“配置模型”后按 Ctrl+R 获取远程模型列表",
+  detailEditConnection: "[Ctrl+E] 编辑连接",
+  detailConfigureModels: "[Ctrl+M] 配置模型",
+  detailTakeover: "[Ctrl+T] 接管已有模型",
+  detailDisable: "[Ctrl+X] 禁用服务商",
+  detailEnable: "[Ctrl+X] 启用服务商",
+  detailTestModels: "[Ctrl+P] 批量测试模型",
+  detailBack: "[Esc] 返回总览",
+  connectionModify: "[Enter] 修改字段",
+  connectionPreview: "[Ctrl+S] 预览更改",
+  connectionBack: "[Esc] 返回服务商",
+  editorTitle: "编辑模型参数：{model}",
+  editorName: "名称",
+  editorContext: "Context Window",
+  editorMaxTokens: "Max Tokens",
+  editorReasoning: "Reasoning",
+  editorThinkingMap: "思考档位映射",
+  editorInput: "输入类型",
+  editorOutput: "输出类型",
+  editorCost: "费用",
+  editorReview: "审阅并应用",
+  editorCancel: "取消",
+  editorModify: "[Enter] 修改字段",
+  editorReturn: "[Esc] 返回",
+  editorInlineHint: "输入值后 Enter 确认",
+  editorMapHint: "思考映射：留空恢复默认；输入 - 或 null 禁用该档位",
+  editorMapDefault: "协议/目录默认",
+  editorMapDisabled: "已禁用",
+  editorDone: "完成",
+  editorModalities: "选择模态",
+  valueYes: "是",
+  valueNo: "否",
+  editorKeep: "保持",
+  editorEnable: "启用并设置映射",
+  editorDisable: "禁用",
+  editorPositiveError: "请输入正整数，支持K/M换算",
+  editorMaxError: "maxTokens不能超过contextWindow",
+  editorCostError: "费用必须是非负十进制数",
+  editorModalityEmpty: "至少选择一种模态",
+  editorModalityRequired: "当前字段必须包含 {modality}",
+  editorThinkingSummary: "思考默认档位：{level}（Pi 基线，会话/设置可覆盖）· 映射来源：{source}",
+  thinkingSourceExisting: "现有配置",
+  thinkingSourceRemote: "远程目录",
+  thinkingSourceCatalog: "运行时目录",
+  thinkingSourceProtocol: "协议默认",
+  thinkingSourceUser: "用户编辑",
+  thinkingSourceProbed: "实测",
+  thinkingSourceDefault: "Provider 默认/未显式配置",
+  editorConfirmTitle: "确认应用模型参数到草稿？",
+  editorApply: "[Ctrl+S] 应用到草稿",
+  thinkingProbeBlocked: "仅已保存/reload、enabled、clean、持久认证的managed chat模型可探测思考档位",
+  thinkingProbeTitle: "探测思考档位",
+  thinkingProbeWarning: "将按档位串行发送真实最小请求并可能计费；服务端接受不代表模型具备更强推理能力。",
+  modelSearch: "[/] 搜索",
+  modelSelectFiltered: "[Ctrl+A] 勾选搜索结果",
+  modelDeselectFiltered: "[Ctrl+D] 取消勾选搜索结果",
+  modelCycleType: "[Ctrl+T] 切换模型类型",
+  modelEditParameters: "[Ctrl+E] 编辑模型参数",
+  editorExternalTakeover: "此模型来自 models.json；请先在连接页执行“接管已有模型”后再编辑",
+  editorManagedOnly: "仅当前草稿中已勾选、由本插件管理的模型可编辑参数",
+  modelProbeContext: "[Ctrl+K] 探测上下文容量",
+  modelProbeThinking: "[Ctrl+L] 探测思考档位",
+  modelFetch: "[Ctrl+R] 获取远程模型列表",
+  modelPreview: "[Ctrl+S] 预览更改",
+  modelBack: "[Esc] 返回服务商",
+  addProviderTitle: "添加服务商",
+  addBuiltinChoice: "选择内置服务商",
+  addCustomChoice: "添加自定义服务商",
+  discoveryRequired: "尚未配置模型列表地址（Discovery URL）",
+  discoveryDerivedTitle: "可从模型调用地址推导候选（不代表服务商官方 Discovery endpoint）",
+  discoveryUseDerived: "使用推导地址（加入当前草稿，最终保存后才落盘）：{url}",
+  discoveryUseCandidates: "使用首选地址：{url}（同源备选 {count} 个；成功地址加入草稿，最终保存后才落盘）",
+  discoveryRequiredEdit: "进入编辑连接设置",
+  discoveryRequiredCancel: "取消获取",
+  dirtyLeaveTitle: "放弃尚未保存的更改？",
+  dirtyLeaveBody: "返回总览会放弃当前服务商的连接草稿、模型选择和接管状态；不会写入配置。",
+  confirmCancel: "[Esc] 取消/返回",
+  confirmSave: "[Ctrl+S] 确认保存",
+  confirmEmpty: "[Ctrl+S] 确认清空",
+  confirmTakeover: "[Ctrl+T] 确认接管",
+  dirtyReturnEdit: "[Esc] 返回编辑",
+  dirtyPreviewSave: "[Ctrl+S] 预览并保存",
+  dirtyDiscard: "[Ctrl+D] 放弃更改",
+  enableConfirmTitle: "启用服务商 {provider}？",
+  disableConfirmTitle: "禁用服务商 {provider}？",
+  enableConfirmSummary: "保存并 /reload 后恢复该服务商的底层模型目录。",
+  disableConfirmSummary: "保存并 /reload 后隐藏该服务商的 chat/classifier/image 目录，但保留模型和认证。",
+  confirmEnable: "[Ctrl+X] 确认启用",
+  confirmDisable: "[Ctrl+X] 确认禁用",
+  disabledRetainAuth: "不会删除 models.json、model-config.json 模型或 auth。",
+  toggleProviderSuccess: "服务商 {provider} 已直接更新；生成 {count} 个备份。运行 /reload 使启停生效。",
+  deleteProviderTitle: "删除服务商 {provider}？",
+  deleteProviderSummary: "这是危险操作：将删除服务商 {provider} 的配置与模型目录覆盖。",
+  deleteProviderModels: "将移除 models.json 中该 provider 条目（含其 chat 模型与 API key 引用）。",
+  deleteProviderOverlay: "将移除 model-config.json 中该 provider 配置、managed overlay 与 classifier/image 目录。",
+  deleteProviderAuthRetained: "不会删除 auth.json 中的 Pi 凭据。",
+  deleteProviderOtherExtension: "若该 provider 也由其他扩展管理，删除本地配置条目后其运行时目录可能仍由该扩展决定。",
+  transactionRecovered: "已从中断的配置事务 {txId} 恢复两份配置的旧版本；请检查后重试操作。",
+  deleteProviderBuiltinRestore: "这是 Pi 内置服务商；保存并 /reload 后将恢复 Pi 内置目录。",
+  confirmDeleteProvider: "[Ctrl+S] 确认删除服务商",
+  deleteProviderSuccess: "服务商 {provider} 已通过双文件事务删除；生成 {count} 个备份。运行 /reload 应用目录恢复。",
+  deleteCurrentModelBlocked: "当前会话正在使用该服务商的模型；请先切换模型再删除。",
+  deleteThirdPartyBlocked: "未接管的第三方 runtime extension 服务商不能安全删除。",
+  discoveryCandidateSafety: "候选并非服务商官方保证；只有实际成功 URL 才进入草稿。",
+  discoveryUseAction: "[Ctrl+R] 使用首选候选",
+  discoveryNoCandidate: "没有可安全推导的目录；可进入连接设置显式配置。",
+  finalSaveTitle: "确认保存",
+  finalSaveBody: "确认后将通过双文件事务写入 models.json 与 model-config.json。",
+  discardConfirmTitle: "放弃全部更改？",
+  discardConfirmBody: "这会清空当前服务商的内存草稿和模型选择，不会写入配置。",
+  temporarySaveBlocked: "临时密钥只能用于本次获取列表；请在连接设置中选择 API 密钥、环境变量引用、Pi 已有认证或无需认证后再预览保存",
+  providerEnabled: "已启用",
+  providerDisabled: "已禁用",
+  providerEnabledStatus: "运行状态：{value}",
+  disableCurrentModelBlocked: "当前会话正在使用该服务商的模型；请先切换模型再禁用",
+  disableThirdPartyBlocked: "未接管的第三方 runtime extension 服务商不能通过同名注册安全禁用",
+  disabledSaveHint: "禁用状态将在保存并 /reload 后生效；不会删除模型或认证",
+  testProviderDisabled: "服务商已禁用；请先启用并保存 /reload",
+  testDraftDirty: "存在尚未保存的更改；请先保存并 /reload，再测试当前运行时模型",
+  testNoModels: "当前运行时没有该服务商可测试的模型",
+  testSelectionTitle: "选择要测试的模型",
+  testSelectionHelp: "↑↓ 选择 · Enter/Space 勾选 · Ctrl+S 执行 · Esc 取消；image 默认不选",
+  testImageConfirmTitle: "确认测试图像模型？",
+  testImageRun: "[Ctrl+I] 确认测试图像",
+  testImageConfirmBody: "将真实调用 {count} 个图像模型生成红点，可能计费且超时上限为 120 秒。",
+  testRunConfirmTitle: "确认真实调用模型？",
+  testRunAction: "[Ctrl+S] 开始真实测试",
+  testRunConfirmBody: "将真实调用 {count} 个当前运行时模型，可能产生费用；默认并发为 2。",
+  testRunning: "正在测试；Esc 取消全部剩余请求…",
+  testResultsTitle: "模型可用性测试结果",
+  testResultsHelp: "←/→ 水平切换操作 · Enter 执行",
+  testResultsBack: "[Esc] 返回",
+  testResultsRetry: "重试失败项",
+  panelSummaryName: "服务商名称：{value}",
+  panelSummaryId: "服务商 ID：{value}",
+  panelSummaryProtocol: "调用协议：{value}",
+  panelSummaryBaseUrl: "模型调用地址：{value}",
+  panelSummaryDiscoveryUrl: "模型列表地址：{value}",
+  panelSummaryAuth: "认证方式：{value}",
+  panelSummaryProxy: "专属代理：{value}",
+  panelSummaryModels: "模型：聊天 {chat} · 判定 {classifier} · 图像生成 {image}",
+  panelTakeoverCount: "尚未接管的 models.json chat：{count}",
+  panelDescName: "设置界面显示名称；不会改变服务商 ID。",
+  panelDescId: "配置标识，只读。provider/model identity 使用此 ID。",
+  panelDescOwnership: "决定 classifier/image 是否由本插件注册；不要接管 Pi 内置服务商。",
+  panelDescBaseUrl: "模型实际调用地址。可使用默认地址或设置自定义地址。",
+  panelDescDiscoveryUrl: "仅用于获取远程模型列表，不会自动假设 /models。",
+  panelDescAuth: "选择 API 密钥、环境变量引用、Pi 已有认证、临时密钥或无需认证。",
+  panelDescDiscoveryAuth: "仅用于获取模型列表的认证头；none 不转发 Pi auth headers。",
+  panelDescProxy: "代理只作用于此服务商，不修改进程环境或全局 dispatcher。",
+  panelDescDefaultType: "远程列表缺少类型时使用；落盘值仍为 chat/classifier/image。",
+  panelDescChatApi: "聊天模型调用协议；API 名保持原文。",
+  panelDescClassifierApi: "判定模型调用协议；API 名保持原文。",
+  panelDescImageApi: "图像生成模型调用协议；API 名保持原文。",
+  panelDescContext: "远程模型缺少 context window 时使用的默认值。",
+  panelDescMaxTokens: "远程聊天模型缺少 max tokens 时使用的默认值。",
+  panelModelName: "模型名称：{value}",
+  panelModelId: "模型 ID：{value}",
+  panelModelType: "模型类型：{value}",
+  panelModelApi: "调用协议：{value}",
+  panelModelContext: "Context window：{value}",
+  panelModelMaxTokens: "Max tokens：{value}",
+  panelModelInput: "输入模态：{value}",
+  panelModelOutput: "输出模态：{value}",
+  panelModelCost: "费用：input {input} · output {output} · cache read {cacheRead} · cache write {cacheWrite}",
+  compatContextDisplay: "上下文：128K · Pi兼容默认值（未验证）",
+  compatMaxDisplay: "最大输出：16K · Pi兼容默认值（未验证）",
+  compatSaveRisk: "以下模型使用 Pi 兼容默认值（未验证），将显式写入 128000/16384：{items}",
+  probeBlocked: "仅已保存并 /reload、已启用、非dirty且使用持久认证的managed chat/classifier模型可探测；image不支持",
+  probeChooseTitle: "选择上下文探测上限",
+  probeCostWarning: "将发送近似大输入进行真实API调用，可能计费；tokenizer、网关截断或压缩会使结果不精确。",
+  contextProbeRun: "[Ctrl+K] 开始串行探测",
+  probeRun: "[Ctrl+L] 开始串行探测",
+  probeUse: "使用已验证安全下限",
+  probeKeep: "保持当前值",
+  probeBack: "返回",
+  probeNoSuccess: "没有成功下限，无法写入探测结果",
+  probeMaxConflict: "探测下限小于当前maxTokens；不会自动调整maxTokens，请等待逐模型参数编辑功能",
+  panelModelBaseUrl: "Base URL：{value}",
+  panelModelReadonly: "此模型只读，不能在这里修改或移除。",
+  panelModelReadonlyExternal: "此模型来自 models.json，但尚未由本插件管理；可先执行“接管已有模型”。",
+  panelModelReadonlyRuntime: "此模型来自 Pi 内置目录或其他运行时扩展；本插件不能把取消勾选伪装成删除。",
+  takeoverModelsTitle: "接管已有模型？",
+  takeoverModelsBody: "仅接管服务商 {provider} 在 models.json 中已有的 {count} 个 chat 模型。接管只修改内存草稿；取消、返回或放弃不会写盘，最终确认保存后才更新 managedChatIds。Pi 内置目录和其他运行时扩展模型不在接管范围。",
+  takeoverModelsNone: "当前服务商没有可接管的 models.json chat 模型",
+  previewConfirmSave: "[Ctrl+S] 确认保存",
+  previewBackEdit: "[Esc] 返回继续编辑",
+  previewDiscard: "[Ctrl+D] 放弃全部更改",
+  providerTitle: "服务商连接设置：{id}",
+  fieldName: "服务商名称：{value}",
+  fieldId: "服务商 ID：{value}（只读）",
+  fieldIdReadonly: "服务商 ID 用于配置标识，当前不能在这里修改",
+  fieldOwnership: "配置归属：{value}",
+  owned: "本插件管理的自定义服务商",
+  externalOwned: "内置或外部服务商（不接管目录）",
+  fieldBaseUrl: "模型调用地址（Base URL）：{value}",
+  fieldDiscoveryUrl: "模型列表地址（Discovery URL）：{value}",
+  fieldAuth: "认证方式：{value}",
+  fieldDiscoveryAuth: "获取模型列表时的认证头：{value}",
+  fieldProxy: "仅此服务商使用代理：{value}",
+  fieldDefaultType: "远程模型默认类型：{value}",
+  fieldChatApi: "调用协议（聊天）：{value}",
+  fieldClassifierApi: "调用协议（判定）：{value}",
+  fieldImageApi: "调用协议（图像生成）：{value}",
+  fieldContext: "默认 context window：{value}",
+  fieldMaxTokens: "默认 max tokens：{value}",
+  providerDisplayName: "服务商名称",
+  takeoverTitle: "接管服务商目录",
+  takeoverBody: "插件自有服务商会由本插件注册完整目录；仅应对自定义服务商启用，不能用于接管 Pi 内置服务商。",
+  urlSet: "使用自定义地址",
+  urlRestore: "使用默认地址（移除自定义地址）",
+  discoveryUrlSet: "设置模型列表地址",
+  discoveryUrlClear: "清除模型列表地址",
+  proxySet: "设置此服务商专属代理",
+  proxyDisable: "关闭此服务商专属代理",
+  clear: "清空",
+  baseUrl: "Base URL",
+  discoveryUrl: "Discovery URL（独立于 Base URL）",
+  proxyUrl: "服务商专属代理 URL（例如 http://127.0.0.1:7890，仅示例）",
+  authTitle: "认证方式",
+  authLiteralOption: "API 密钥",
+  authEnvOption: "环境变量引用",
+  authReuseOption: "使用 Pi 已有认证",
+  authTemporaryOption: "临时密钥（仅本次获取列表）",
+  authAnonymousOption: "无需认证",
+  authModelsJson: "API 密钥或环境变量引用",
+  authReuse: "使用 Pi 已有认证",
+  authTemporary: "临时密钥（仅本次获取列表）",
+  authAnonymous: "无需认证",
+  authSourceAnonymous: "匿名",
+  authSourceStored: "已存储凭据",
+  secretApiKey: "输入 API key",
+  secretTemporary: "输入临时 API key（不会写入磁盘）",
+  envName: "环境变量名（不含 $）",
+  discoveryAuthTitle: "Discovery 认证头",
+  authHeaderAuto: "自动（按调用协议）",
+  authHeaderBearer: "Bearer Authorization",
+  authHeaderXApiKey: "x-api-key",
+  authHeaderApiKey: "api-key（Azure）",
+  authHeaderGoogle: "x-goog-api-key（Google）",
+  authHeaderAnthropic: "Anthropic x-api-key + version",
+  authHeaderNone: "不发送认证头",
+  defaultTypeTitle: "远程缺少类型时使用",
+  defaultContextTitle: "默认 context window",
+  defaultMaxTitle: "默认 max tokens",
+  fetching: "正在从 {url} 获取模型…",
+  fetchCancelled: "已取消远程获取",
+  temporaryMustPersist: "临时密钥只用于获取列表；保存前请选择持久认证方式",
+  emptyTitle: "确认清空插件管理集合",
+  emptyBody: "这会移除该服务商下所有由 pi-model-config 管理的条目，但不动内置目录和其他服务商。",
+  previewTitle: "预览更改",
+  previewProviderSettings: "服务商设置：{provider}",
+  previewModelConfig: "模型配置：{provider}",
+  previewSettingsChanged: "服务商设置有更改",
+  previewSettingsUnchanged: "服务商设置无更改",
+  previewKeyUpdated: "API 密钥：将更新，内容已隐藏",
+  previewModelsAdded: "添加模型：{items}",
+  previewModelsRemoved: "移除模型：{items}",
+  previewModelsModified: "修改模型：{items}",
+  previewModelsUnchanged: "未变化模型：{count}",
+  saveSuccess: "配置已原子写入；生成 {count} 个备份。运行 /reload 使服务商 transport/classifier/image 注册生效。",
+  selectorTitle: "配置模型：{provider}",
+  selectorSearchPrompt: "搜索模型：",
+  selectorSearchPlaceholder: "搜索模型名称或 ID",
+  selectorHelp: "Tab/Shift+Tab 切换焦点 · Enter 勾选 · Space 输入搜索 · Ctrl+T 切换远程类型 · Ctrl+A/D 批量 · Ctrl+S 预览",
+  selectorSemantics: "勾选 = 保存后保留或添加；取消勾选 = 保存后移除。获取和勾选不会立即保存。",
+  selectorNarrow: "终端过窄；请扩宽后重试，Esc 返回",
+  selectorNoMatches: "  没有匹配的模型",
+  selectorReadonlyStatus: "此模型不由本插件管理，当前不能在这里修改或移除",
+  selectorReadonlyExternal: "此模型来自 models.json，需先使用“接管已有模型”后才能修改或移除",
+  selectorReadonlyRuntime: "此模型来自 Pi 内置目录或其他运行时扩展，不能在这里移除",
+  selectorTypeConflict: "不能切换为{type}：{identity} 已存在",
+  selectorReadonlyTag: "只读",
+  selectorTypeChat: "聊天",
+  selectorTypeClassifier: "判定",
+  selectorTypeImage: "图像生成",
+  selectorFooter: "可见 {filtered} / 总计 {total} · 已选 {selected} · 只读 {readonly}",
+  maskedLabel: "密钥: ",
+  maskedHelp: "Enter 保存 · Esc 取消 · Ctrl+U 清空 · 输入始终掩码",
+  diffConnection: "连接: {before}\n→ {after}",
+  diffSafety: "密钥值未显示；未勾选只移除本插件管理集合，不删除其他服务商或内置目录。",
+  valueDefault: "默认",
+  valueInvalidUrl: "[无效 URL]",
+  valueAnonymous: "无需认证",
+  valueReuseAuth: "使用 Pi 已有认证",
+  valueUnset: "未配置",
+  valueProxyDisabled: "关闭",
+  valueEnv: "环境变量 {value}",
+  valueLiteralMasked: "literal（已掩码）",
+  valueRedacted: "[已隐藏]",
+  errorExternal: "[{code}] 外部或系统错误（以下仅为不可信诊断文本）：{detail}",
+  errorUnknownDetail: "详情不可安全显示",
+} as const;
+
+export type TranslationKey = keyof typeof ZH;
+
+const EN = {
+  commandDescription: "Models and providers / 模型与服务商配置",
+  mainTitle: "Models and Providers",
+  mainCancel: "Cancel",
+  back: "Back",
+  panelBack: "[B] Back",
+  languageTitle: "Language / 语言",
+  languageZh: "简体中文",
+  languageEn: "English",
+  languageSaved: "UI language saved: {language} (effective immediately)",
+  tuiRequired: "/model-config requires the interactive TUI; custom multi-select is unavailable in RPC/print/JSON modes",
+  startupIssues: "Some providers were not registered because of configuration errors. You can continue editing: {issues}{more}",
+  startupMore: "; {count} more",
+  newProviderTitle: "Choose a Built-in Provider (built-in does not mean authenticated or available)",
+  providerTagCustom: "Custom",
+  providerTagBuiltin: "Built-in",
+  providerLabelCustom: "★ {display}  [{status}]",
+  providerLabelConfigured: "◆ {display}  [{status}]",
+  providerLabelBuiltin: "{display}  [{status}]",
+  newProviderId: "New Provider ID",
+  providerExists: "Provider {id} already exists. Opening the existing configuration instead of overwriting it as new.",
+  panelLanguage: "Interface language: {language}",
+  panelSearchProviderPrompt: "Search providers: ",
+  panelSearchProviderPlaceholder: "Name or ID",
+  panelNoConfiguredProviders: "No configured providers",
+  panelNoProviderSelected: "Select a provider to view details",
+  overviewEnter: "[Enter] Open provider",
+  overviewSearch: "[/] Search",
+  overviewDisable: "[Ctrl+X] Disable",
+  overviewEnable: "[Ctrl+X] Enable",
+  overviewDelete: "[Ctrl+Del] Delete provider",
+  overviewAdd: "[Ctrl+N] Add provider",
+  overviewClose: "[Esc] Close",
+  overviewLanguage: "[F2] Interface language",
+  detailConnectionTitle: "Connection Summary",
+  detailModelsTitle: "Model Overview",
+  detailFetchHint: "Open Configure models, then press Ctrl+R to fetch the remote model list",
+  detailEditConnection: "[Ctrl+E] Edit connection",
+  detailConfigureModels: "[Ctrl+M] Configure models",
+  detailTakeover: "[Ctrl+T] Manage existing models",
+  detailDisable: "[Ctrl+X] Disable provider",
+  detailEnable: "[Ctrl+X] Enable provider",
+  detailTestModels: "[Ctrl+P] Batch test models",
+  detailBack: "[Esc] Back to overview",
+  connectionModify: "[Enter] Modify field",
+  connectionPreview: "[Ctrl+S] Preview changes",
+  connectionBack: "[Esc] Back to provider",
+  editorTitle: "Edit model parameters: {model}",
+  editorName: "Name",
+  editorContext: "Context Window",
+  editorMaxTokens: "Max Tokens",
+  editorReasoning: "Reasoning",
+  editorThinkingMap: "Thinking level map",
+  editorInput: "Input modalities",
+  editorOutput: "Output modalities",
+  editorCost: "Cost",
+  editorReview: "Review and apply",
+  editorCancel: "Cancel",
+  editorModify: "[Enter] Modify field",
+  editorReturn: "[Esc] Back",
+  editorInlineHint: "Enter a value, then press Enter",
+  editorMapHint: "Thinking maps: blank restores default; - or null disables this level",
+  editorMapDefault: "protocol/catalog default",
+  editorMapDisabled: "disabled",
+  editorDone: "Done",
+  editorModalities: "Choose modalities",
+  valueYes: "Yes",
+  valueNo: "No",
+  editorKeep: "Keep",
+  editorEnable: "Enable and map",
+  editorDisable: "Disable",
+  editorPositiveError: "Enter a positive integer; K/M suffixes are supported",
+  editorMaxError: "maxTokens cannot exceed contextWindow",
+  editorCostError: "Cost must be a non-negative decimal number",
+  editorModalityEmpty: "Select at least one modality",
+  editorModalityRequired: "This field must include {modality}",
+  editorThinkingSummary: "Default thinking level: {level} (Pi baseline; session/settings may override) · map source: {source}",
+  thinkingSourceExisting: "existing config",
+  thinkingSourceRemote: "remote catalog",
+  thinkingSourceCatalog: "runtime catalog",
+  thinkingSourceProtocol: "protocol default",
+  thinkingSourceUser: "user edit",
+  thinkingSourceProbed: "probe",
+  thinkingSourceDefault: "provider default / unspecified",
+  editorConfirmTitle: "Apply model parameters to the draft?",
+  editorApply: "[Ctrl+S] Apply to draft",
+  thinkingProbeBlocked: "Only saved/reloaded, enabled, clean managed chat models with persistent auth can probe thinking levels",
+  thinkingProbeTitle: "Probe thinking levels",
+  thinkingProbeWarning: "This serially sends real minimal requests per level and may incur cost; server acceptance does not prove stronger reasoning ability.",
+  modelSearch: "[/] Search",
+  modelSelectFiltered: "[Ctrl+A] Check search results",
+  modelDeselectFiltered: "[Ctrl+D] Uncheck search results",
+  modelCycleType: "[Ctrl+T] Change model type",
+  modelEditParameters: "[Ctrl+E] Edit model parameters",
+  editorExternalTakeover: "This model comes from models.json. Use Manage existing models on the connection page before editing it.",
+  editorManagedOnly: "Only checked models managed by this plugin in the current draft can be edited",
+  modelProbeContext: "[Ctrl+K] Probe context capacity",
+  modelProbeThinking: "[Ctrl+L] Probe thinking levels",
+  modelFetch: "[Ctrl+R] Fetch remote model list",
+  modelPreview: "[Ctrl+S] Preview changes",
+  modelBack: "[Esc] Back to provider",
+  addProviderTitle: "Add Provider",
+  addBuiltinChoice: "Choose built-in provider",
+  addCustomChoice: "Add custom provider",
+  discoveryRequired: "No model catalog address (Discovery URL) is configured",
+  discoveryDerivedTitle: "A candidate can be derived from the model API address (not guaranteed to be the provider official Discovery endpoint)",
+  discoveryUseDerived: "Use derived address (add to this draft; persisted only after final save): {url}",
+  discoveryUseCandidates: "Use preferred address: {url} ({count} same-origin fallback(s); successful URL enters the draft and persists only after final save)",
+  discoveryRequiredEdit: "Open connection settings",
+  discoveryRequiredCancel: "Cancel fetch",
+  dirtyLeaveTitle: "Discard unsaved changes?",
+  dirtyLeaveBody: "Returning to the overview discards this provider's connection draft, model selection, and takeover state. Nothing will be written.",
+  confirmCancel: "[Esc] Cancel / Back",
+  confirmSave: "[Ctrl+S] Confirm Save",
+  confirmEmpty: "[Ctrl+S] Confirm Empty",
+  confirmTakeover: "[Ctrl+T] Confirm Takeover",
+  dirtyReturnEdit: "[Esc] Return to Editing",
+  dirtyPreviewSave: "[Ctrl+S] Preview and Save",
+  dirtyDiscard: "[Ctrl+D] Discard Changes",
+  enableConfirmTitle: "Enable provider {provider}?",
+  disableConfirmTitle: "Disable provider {provider}?",
+  enableConfirmSummary: "After save and /reload, restore the provider underlying model catalog.",
+  disableConfirmSummary: "After save and /reload, hide this provider chat/classifier/image catalog while retaining models and auth.",
+  confirmEnable: "[Ctrl+X] Confirm Enable",
+  confirmDisable: "[Ctrl+X] Confirm Disable",
+  disabledRetainAuth: "models.json, model-config.json models, and auth are retained.",
+  toggleProviderSuccess: "Provider {provider} was updated directly; {count} backup(s) created. Run /reload to apply the enablement state.",
+  deleteProviderTitle: "Delete provider {provider}?",
+  deleteProviderSummary: "This is dangerous: the provider {provider} configuration and model catalog overlay will be deleted.",
+  deleteProviderModels: "The models.json provider entry will be removed, including its chat models and API-key reference.",
+  deleteProviderOverlay: "The model-config.json provider configuration, managed overlay, and classifier/image catalog will be removed.",
+  deleteProviderAuthRetained: "Pi credentials in auth.json are not deleted.",
+  deleteProviderOtherExtension: "If another extension manages this provider, its runtime catalog may still be determined by that extension after the local entry is removed.",
+  transactionRecovered: "Recovered both configuration files to their old generation from interrupted transaction {txId}; review them before retrying.",
+  deleteProviderBuiltinRestore: "This is a Pi built-in provider; save and /reload restores Pi's built-in catalog.",
+  confirmDeleteProvider: "[Ctrl+S] Confirm Delete Provider",
+  deleteProviderSuccess: "Provider {provider} was deleted through the two-file transaction; {count} backup(s) created. Run /reload to restore/apply catalogs.",
+  deleteCurrentModelBlocked: "The current session is using a model from this provider. Switch models before deleting it.",
+  deleteThirdPartyBlocked: "An unowned third-party runtime extension provider cannot be deleted safely.",
+  discoveryCandidateSafety: "The candidate is not guaranteed by the provider; only an actually successful URL enters the draft.",
+  discoveryUseAction: "[Ctrl+R] Use Preferred Candidate",
+  discoveryNoCandidate: "No candidate can be derived safely; open connection settings to configure one explicitly.",
+  finalSaveTitle: "Confirm Save",
+  finalSaveBody: "This writes models.json and model-config.json through the two-file transaction.",
+  discardConfirmTitle: "Discard all changes?",
+  discardConfirmBody: "This clears the current provider draft and model selection from memory without writing configuration.",
+  temporarySaveBlocked: "A temporary key is only for this catalog fetch. Choose an API key, environment reference, existing Pi authentication, or no authentication before previewing a save.",
+  providerEnabled: "Enabled",
+  providerDisabled: "Disabled",
+  providerEnabledStatus: "Runtime status: {value}",
+  disableCurrentModelBlocked: "The current session is using a model from this provider. Switch models before disabling it.",
+  disableThirdPartyBlocked: "An unowned third-party runtime extension provider cannot be safely disabled by same-name registration.",
+  disabledSaveHint: "The disabled state takes effect after save and /reload; models and authentication are not deleted.",
+  testProviderDisabled: "The provider is disabled. Enable it, save, and /reload first.",
+  testDraftDirty: "There are unsaved changes. Save and /reload before testing runtime models.",
+  testNoModels: "The current runtime has no testable models for this provider.",
+  testSelectionTitle: "Select models to test",
+  testSelectionHelp: "↑↓ select · Enter/Space toggle · Ctrl+S run · Esc cancel; images default off",
+  testImageConfirmTitle: "Test image models?",
+  testImageRun: "[Ctrl+I] Confirm Image Test",
+  testImageConfirmBody: "This makes real paid-capable calls to {count} image model(s) to generate a red dot, with a 120-second timeout.",
+  testRunConfirmTitle: "Make real model calls?",
+  testRunAction: "[Ctrl+S] Start Real Tests",
+  testRunConfirmBody: "This calls {count} currently loaded runtime model(s) and may incur cost; default concurrency is 2.",
+  testRunning: "Testing; press Esc to cancel all remaining requests…",
+  testResultsTitle: "Model availability results",
+  testResultsHelp: "←/→ switch actions · Enter activate",
+  testResultsBack: "[Esc] Back",
+  testResultsRetry: "Retry failures",
+  panelSummaryName: "Provider name: {value}",
+  panelSummaryId: "Provider ID: {value}",
+  panelSummaryProtocol: "Protocols: {value}",
+  panelSummaryBaseUrl: "Model API address: {value}",
+  panelSummaryDiscoveryUrl: "Model catalog address: {value}",
+  panelSummaryAuth: "Authentication: {value}",
+  panelSummaryProxy: "Provider-only proxy: {value}",
+  panelSummaryModels: "Models: Chat {chat} · Classification {classifier} · Image generation {image}",
+  panelTakeoverCount: "Unmanaged models.json chat models: {count}",
+  panelDescName: "Set the display name without changing the provider ID.",
+  panelDescId: "Read-only configuration identity used by provider/model identities.",
+  panelDescOwnership: "Controls classifier/image registration. Never take ownership of a Pi built-in provider.",
+  panelDescBaseUrl: "Address used for model calls. Use the default or set a custom address.",
+  panelDescDiscoveryUrl: "Used only for remote model discovery; /models is never assumed.",
+  panelDescAuth: "Choose an API key, environment reference, existing Pi authentication, temporary key, or no authentication.",
+  panelDescDiscoveryAuth: "Auth header for catalog discovery only; none forwards no Pi auth headers.",
+  panelDescProxy: "Applies only to this provider; process environment and global dispatcher remain unchanged.",
+  panelDescDefaultType: "Used when remote entries omit type; stored values remain chat/classifier/image.",
+  panelDescChatApi: "Chat model protocol; API names remain unchanged.",
+  panelDescClassifierApi: "Classification model protocol; API names remain unchanged.",
+  panelDescImageApi: "Image generation protocol; API names remain unchanged.",
+  panelDescContext: "Default used when a remote model omits context window.",
+  panelDescMaxTokens: "Default used when a remote chat model omits max tokens.",
+  panelModelName: "Model name: {value}",
+  panelModelId: "Model ID: {value}",
+  panelModelType: "Model type: {value}",
+  panelModelApi: "Protocol: {value}",
+  panelModelContext: "Context window: {value}",
+  panelModelMaxTokens: "Max tokens: {value}",
+  panelModelInput: "Input modalities: {value}",
+  panelModelOutput: "Output modalities: {value}",
+  panelModelCost: "Cost: input {input} · output {output} · cache read {cacheRead} · cache write {cacheWrite}",
+  compatContextDisplay: "Context: 128K · Pi compatibility default (unverified)",
+  compatMaxDisplay: "Max output: 16K · Pi compatibility default (unverified)",
+  compatSaveRisk: "These models use unverified Pi compatibility defaults and will explicitly persist 128000/16384: {items}",
+  probeBlocked: "Only saved/reloaded, enabled, clean managed chat/classifier models with persistent auth can be probed; images are unsupported.",
+  probeChooseTitle: "Choose context probe ceiling",
+  probeCostWarning: "This sends approximate large real API inputs and may incur cost; tokenizer behavior, gateway truncation, or compression can make results unreliable.",
+  contextProbeRun: "[Ctrl+K] Start Serial Probe",
+  probeRun: "[Ctrl+L] Start Serial Probe",
+  probeUse: "Use verified safe lower bound",
+  probeKeep: "Keep current value",
+  probeBack: "Back",
+  probeNoSuccess: "No successful lower bound is available to write",
+  probeMaxConflict: "The probe lower bound is below current maxTokens. maxTokens will not be changed automatically; wait for per-model parameter editing.",
+  panelModelBaseUrl: "Base URL: {value}",
+  panelModelReadonly: "This model is read-only and cannot be changed or removed here.",
+  panelModelReadonlyExternal: "This model is in models.json but is not managed by this plugin yet; use Manage existing models first.",
+  panelModelReadonlyRuntime: "This model comes from Pi's built-in catalog or another runtime extension; unchecking it cannot be presented as deletion.",
+  takeoverModelsTitle: "Manage existing models?",
+  takeoverModelsBody: "This takes ownership only of the {count} existing chat model(s) for provider {provider} in models.json. It changes the in-memory draft only; cancel, back, or discard writes nothing. managedChatIds changes only after final save. Pi built-in catalogs and other runtime-extension models are outside this scope.",
+  takeoverModelsNone: "This provider has no models.json chat models available for takeover",
+  previewConfirmSave: "[Ctrl+S] Confirm Save",
+  previewBackEdit: "[Esc] Back to Editing",
+  previewDiscard: "[Ctrl+D] Discard All Changes",
+  providerTitle: "Provider connection settings: {id}",
+  fieldName: "Provider name: {value}",
+  fieldId: "Provider ID: {value} (read-only)",
+  fieldIdReadonly: "Provider ID is the configuration identifier and cannot be changed here",
+  fieldOwnership: "Configuration ownership: {value}",
+  owned: "Custom provider managed by this plugin",
+  externalOwned: "Built-in or external provider (catalog not owned)",
+  fieldBaseUrl: "Model API address (Base URL): {value}",
+  fieldDiscoveryUrl: "Model catalog address (Discovery URL): {value}",
+  fieldAuth: "Authentication: {value}",
+  fieldDiscoveryAuth: "Auth header used to fetch the model catalog: {value}",
+  fieldProxy: "Proxy used only by this provider: {value}",
+  fieldDefaultType: "Default type for remote models: {value}",
+  fieldChatApi: "Protocol (chat): {value}",
+  fieldClassifierApi: "Protocol (classification): {value}",
+  fieldImageApi: "Protocol (image generation): {value}",
+  fieldContext: "Default context window: {value}",
+  fieldMaxTokens: "Default max tokens: {value}",
+  providerDisplayName: "Provider name",
+  takeoverTitle: "Take ownership of provider catalog",
+  takeoverBody: "A plugin-owned provider is registered with its complete catalog. Enable this only for custom providers; never take ownership of a Pi built-in provider.",
+  urlSet: "Use custom address",
+  urlRestore: "Use default address (remove custom address)",
+  discoveryUrlSet: "Set model catalog address",
+  discoveryUrlClear: "Clear model catalog address",
+  proxySet: "Set provider-only proxy",
+  proxyDisable: "Disable provider-only proxy",
+  clear: "Clear",
+  baseUrl: "Base URL",
+  discoveryUrl: "Discovery URL (independent from Base URL)",
+  proxyUrl: "Provider proxy URL (for example http://127.0.0.1:7890; example only)",
+  authTitle: "Authentication method",
+  authLiteralOption: "API key",
+  authEnvOption: "Environment variable reference",
+  authReuseOption: "Use existing Pi authentication",
+  authTemporaryOption: "Temporary key (this catalog fetch only)",
+  authAnonymousOption: "No authentication required",
+  authModelsJson: "API key or environment variable reference",
+  authReuse: "Use existing Pi authentication",
+  authTemporary: "Temporary key (this catalog fetch only)",
+  authAnonymous: "No authentication required",
+  authSourceAnonymous: "anonymous",
+  authSourceStored: "stored credential",
+  secretApiKey: "Enter API key",
+  secretTemporary: "Enter temporary API key (not written to disk)",
+  envName: "Environment variable name (without $)",
+  discoveryAuthTitle: "Discovery auth header",
+  authHeaderAuto: "Auto (from protocol)",
+  authHeaderBearer: "Bearer Authorization",
+  authHeaderXApiKey: "x-api-key",
+  authHeaderApiKey: "api-key (Azure)",
+  authHeaderGoogle: "x-goog-api-key (Google)",
+  authHeaderAnthropic: "Anthropic x-api-key + version",
+  authHeaderNone: "Send no authentication header",
+  defaultTypeTitle: "Type to use when remote entries omit it",
+  defaultContextTitle: "Default context window",
+  defaultMaxTitle: "Default max tokens",
+  fetching: "Fetching models from {url}…",
+  fetchCancelled: "Remote fetch cancelled",
+  temporaryMustPersist: "The temporary key is only for catalog discovery. Choose persistent runtime authentication before saving.",
+  emptyTitle: "Confirm empty managed collection",
+  emptyBody: "This removes every entry managed by pi-model-config for this provider. Built-in catalogs and other providers are untouched.",
+  previewTitle: "Preview Changes",
+  previewProviderSettings: "Provider Settings: {provider}",
+  previewModelConfig: "Model Configuration: {provider}",
+  previewSettingsChanged: "Provider settings changed",
+  previewSettingsUnchanged: "Provider settings unchanged",
+  previewKeyUpdated: "API key: will be updated; content is hidden",
+  previewModelsAdded: "Add models: {items}",
+  previewModelsRemoved: "Remove models: {items}",
+  previewModelsModified: "Modify models: {items}",
+  previewModelsUnchanged: "Unchanged models: {count}",
+  saveSuccess: "Configuration written transactionally; {count} backup(s) created. Run /reload to apply provider transport and classifier/image registration.",
+  selectorTitle: "Configure Models: {provider}",
+  selectorSearchPrompt: "Search models: ",
+  selectorSearchPlaceholder: "Search model name or ID",
+  selectorHelp: "Tab/Shift+Tab focus · Enter check · Space types in search · Ctrl+T remote type · Ctrl+A/D bulk · Ctrl+S preview",
+  selectorSemantics: "Checked = keep or add after saving; unchecked = remove after saving. Fetching and checking do not save immediately.",
+  selectorNarrow: "Terminal too narrow; resize and retry, or press Esc to go back",
+  selectorNoMatches: "  No matching models",
+  selectorReadonlyStatus: "This model is not managed by this plugin and cannot be changed or removed here",
+  selectorReadonlyExternal: "This model comes from models.json; use Manage existing models before changing or removing it",
+  selectorReadonlyRuntime: "This model comes from Pi's built-in catalog or another runtime extension and cannot be removed here",
+  selectorTypeConflict: "Cannot change to {type}: {identity} already exists",
+  selectorReadonlyTag: "read-only",
+  selectorTypeChat: "Chat",
+  selectorTypeClassifier: "Classification",
+  selectorTypeImage: "Image generation",
+  selectorFooter: "Visible {filtered} / Total {total} · Selected {selected} · Read-only {readonly}",
+  maskedLabel: "Key: ",
+  maskedHelp: "Enter save · Esc cancel · Ctrl+U clear · input is always masked",
+  diffConnection: "Connection: {before}\n→ {after}",
+  diffSafety: "Key values are hidden. Unchecked items remove only this plugin's managed collection; other providers and built-in catalogs are untouched.",
+  valueDefault: "default",
+  valueInvalidUrl: "[invalid URL]",
+  valueAnonymous: "no authentication required",
+  valueReuseAuth: "use existing Pi authentication",
+  valueUnset: "not configured",
+  valueProxyDisabled: "off",
+  valueEnv: "environment variable {value}",
+  valueLiteralMasked: "literal (masked)",
+  valueRedacted: "[redacted]",
+  errorExternal: "[{code}] External or system error (untrusted diagnostic text, display only): {detail}",
+  errorUnknownDetail: "details cannot be shown safely",
+} satisfies Record<TranslationKey, string>;
+
+const STRINGS: Record<UiLanguage, Record<TranslationKey, string>> = { "zh-CN": ZH, en: EN };
+
+export function normalizeUiLanguage(value: unknown): UiLanguage {
+  return value === "en" ? "en" : "zh-CN";
+}
+
+export function t(language: UiLanguage, key: TranslationKey, params?: TranslationParams): string {
+  let message: string = STRINGS[language][key];
+  for (const [name, value] of Object.entries(params ?? {})) message = message.split(`{${name}}`).join(String(value));
+  return message;
+}
+
+export type ErrorCode =
+  | "MCFG_E_CONFIG_SHAPE" | "MCFG_E_PROVIDER_SHAPE" | "MCFG_E_MODELS_ARRAY" | "MCFG_E_MODEL_SHAPE"
+  | "MCFG_E_AUTH_MODE" | "MCFG_E_PROVIDER_ID" | "MCFG_E_URL_INVALID" | "MCFG_E_URL_PROTOCOL"
+  | "MCFG_E_URL_CREDENTIALS" | "MCFG_E_URL_SECRET_QUERY" | "MCFG_E_POSITIVE_INTEGER"
+  | "MCFG_E_KEY_EMPTY" | "MCFG_E_KEY_MASKED" | "MCFG_E_ENV_NAME" | "MCFG_E_DISCOVERY_URL"
+  | "MCFG_E_ENV_MISSING" | "MCFG_E_PI_AUTH" | "MCFG_E_DISCOVERY_AUTH_HEADER" | "MCFG_E_DISCOVERY_AUTH_ORIGIN" | "MCFG_E_REDIRECT_LOCATION" | "MCFG_E_REDIRECT_ORIGIN"
+  | "MCFG_E_REDIRECT_LIMIT" | "MCFG_E_PAGINATION" | "MCFG_E_DISCOVERY_HTTP" | "MCFG_E_DISCOVERY_BODY_LIMIT" | "MCFG_E_DISCOVERY_JSON" | "MCFG_E_DISCOVERY_SHAPE"
+  | "MCFG_E_UNSUPPORTED_API" | "MCFG_E_TYPE_API" | "MCFG_E_NOT_OWNED" | "MCFG_E_BASE_URL_REQUIRED"
+  | "MCFG_E_EXTERNAL_TRANSPORT" | "MCFG_E_PROXY_UNSUPPORTED" | "MCFG_E_ANONYMOUS_UNSUPPORTED"
+  | "MCFG_E_AUTH_REQUIRED" | "MCFG_E_LOCK_ACTIVE" | "MCFG_E_LOCK_RECOVERY" | "MCFG_E_LOCK_CHANGED"
+  | "MCFG_E_LOCK_CLEANUP" | "MCFG_E_LOCK_RACE" | "MCFG_E_CONCURRENT_CHANGE" | "MCFG_E_STAGING_CHANGE"
+  | "MCFG_E_ROLLBACK_INCOMPLETE" | "MCFG_E_TRANSACTION_ROLLED_BACK" | "MCFG_E_TX_RECOVERED" | "MCFG_E_TX_RECOVERY_ACTIVE" | "MCFG_E_TX_RECOVERY_FAILED" | "MCFG_E_INTERNAL_CHAT_ONLY"
+  | "MCFG_E_OWNED_PROVIDER_MISSING" | "MCFG_E_NOT_BUILTIN" | "MCFG_E_DISABLE_THIRD_PARTY" | "MCFG_E_EXTERNAL";
+
+const ERROR_ZH: Record<ErrorCode, string> = {
+  MCFG_E_CONFIG_SHAPE: "{file} 的版本或根结构无效",
+  MCFG_E_PROVIDER_SHAPE: "{file} 中服务商 {provider} 必须是对象",
+  MCFG_E_MODELS_ARRAY: "{file} 中服务商 {provider}.models 必须是对象数组",
+  MCFG_E_MODEL_SHAPE: "{file} 中服务商 {provider} 包含无效模型定义",
+  MCFG_E_AUTH_MODE: "{file} 中服务商 {provider}.authMode 无效",
+  MCFG_E_PROVIDER_ID: "服务商 ID 仅允许小写字母、数字、点、下划线和连字符",
+  MCFG_E_URL_INVALID: "{label} 不是有效 URL",
+  MCFG_E_URL_PROTOCOL: "{label} 仅支持 HTTP(S)",
+  MCFG_E_URL_CREDENTIALS: "{label} 不允许在 URL 中嵌入凭据",
+  MCFG_E_URL_SECRET_QUERY: "{label} 不允许在查询参数中嵌入密钥；请使用认证选项",
+  MCFG_E_POSITIVE_INTEGER: "请输入正整数",
+  MCFG_E_KEY_EMPTY: "API key 不能为空",
+  MCFG_E_KEY_MASKED: "掩码占位符不能作为 API key；请重新输入真实密钥或改用 $ENV",
+  MCFG_E_ENV_NAME: "环境变量名无效",
+  MCFG_E_DISCOVERY_URL: "请显式设置 Discovery URL；本插件不会假设 /models",
+  MCFG_E_ENV_MISSING: "环境变量 {name} 未设置",
+  MCFG_E_PI_AUTH: "该服务商没有可复用的 Pi auth",
+  MCFG_E_DISCOVERY_AUTH_HEADER: "{file} 中服务商 {provider}.discoveryAuthHeader 无效",
+  MCFG_E_DISCOVERY_AUTH_ORIGIN: "Discovery 与模型调用地址不同源；已拒绝转发 Pi 已有认证。请改用临时/显式密钥，或选择不发送认证头",
+  MCFG_E_REDIRECT_LOCATION: "Discovery 重定向 {status} 缺少 Location",
+  MCFG_E_REDIRECT_ORIGIN: "Discovery 拒绝跨域重定向，凭据未发送到目标域",
+  MCFG_E_REDIRECT_LIMIT: "Discovery 重定向次数超过 5 次",
+  MCFG_E_PAGINATION: "Discovery 分页暂不支持：{reason}；未把部分结果当作完整目录",
+  MCFG_E_DISCOVERY_HTTP: "Discovery 请求失败：HTTP {status}{detail}",
+  MCFG_E_DISCOVERY_BODY_LIMIT: "Discovery 响应超过 {limit} 字节上限",
+  MCFG_E_DISCOVERY_JSON: "Discovery 响应不是有效 JSON",
+  MCFG_E_DISCOVERY_SHAPE: "Discovery 响应必须是数组或 { data: [] }",
+  MCFG_E_UNSUPPORTED_API: "{identity} 使用不支持的 API {api}",
+  MCFG_E_TYPE_API: "{identity} 的 API {api} 与模型类型不匹配",
+  MCFG_E_NOT_OWNED: "服务商 {provider} 不由本插件管理，不能替换其扩展模型目录",
+  MCFG_E_BASE_URL_REQUIRED: "插件自有服务商的每个模型必须有 model Base URL 或服务商 Base URL",
+  MCFG_E_EXTERNAL_TRANSPORT: "未接管的第三方 extension 服务商无法保证 stream 与 streamSimple 都经过请求级 transport；请移除代理/匿名设置，或仅对自定义服务商明确启用插件自有",
+  MCFG_E_PROXY_UNSUPPORTED: "{identity} 不支持 request-local 代理；已阻止启用代理",
+  MCFG_E_ANONYMOUS_UNSUPPORTED: "{identity} 无法安全匿名调用",
+  MCFG_E_AUTH_REQUIRED: "models.json 认证缺少密钥或 $ENV 引用",
+  MCFG_E_LOCK_ACTIVE: "检测到活动或尚未确认失效的并发配置锁（{path}）",
+  MCFG_E_LOCK_RECOVERY: "另一个进程正在复核失效配置锁；本次未写入",
+  MCFG_E_LOCK_CHANGED: "配置锁在复核期间已更新或其 owner 仍存活；本次未写入",
+  MCFG_E_LOCK_CLEANUP: "检测到失效锁但无法安全清理：{reason}",
+  MCFG_E_LOCK_RACE: "清理失效锁后有其他进程先取得锁；本次未写入",
+  MCFG_E_CONCURRENT_CHANGE: "配置文件已被其他进程修改；未写入任何内容，请重新打开 /model-config",
+  MCFG_E_STAGING_CHANGE: "配置文件在 staging 期间被其他进程修改；未提交临时文件",
+  MCFG_E_ROLLBACK_INCOMPLETE: "事务写入失败，且回滚不完整：{errors}",
+  MCFG_E_TRANSACTION_ROLLED_BACK: "事务写入失败，已回滚两个配置文件",
+  MCFG_E_TX_RECOVERED: "检测到中断事务 {txId}，已恢复两份配置的旧版本",
+  MCFG_E_TX_RECOVERY_ACTIVE: "检测到中断事务 journal（{path}），但配置锁仍活动或未确认失效；未恢复，请稍后重试",
+  MCFG_E_TX_RECOVERY_FAILED: "检测到中断事务 journal（{path}）但恢复失败：{reason}。journal 已保留；请按其中记录的备份路径手动恢复两份配置到同一旧版本",
+  MCFG_E_INTERNAL_CHAT_ONLY: "内部错误：非 chat 模型不能写入 models.json",
+  MCFG_E_OWNED_PROVIDER_MISSING: "自有服务商 {provider} 缺少 models.json 配置",
+  MCFG_E_NOT_BUILTIN: "{provider} 不是内置服务商；未接管的外部服务商无法保证完整请求都经过代理",
+  MCFG_E_DISABLE_THIRD_PARTY: "{provider} 是未接管的第三方 runtime extension 服务商，不能通过同名注册安全禁用",
+  MCFG_E_EXTERNAL: "外部或系统错误",
+};
+
+const ERROR_EN: Record<ErrorCode, string> = {
+  MCFG_E_CONFIG_SHAPE: "{file} has an invalid version or root structure",
+  MCFG_E_PROVIDER_SHAPE: "provider {provider} in {file} must be an object",
+  MCFG_E_MODELS_ARRAY: "provider {provider}.models in {file} must be an array of objects",
+  MCFG_E_MODEL_SHAPE: "provider {provider} in {file} contains an invalid model definition",
+  MCFG_E_AUTH_MODE: "provider {provider}.authMode in {file} is invalid",
+  MCFG_E_PROVIDER_ID: "Provider ID may contain only lowercase letters, digits, dots, underscores, and hyphens",
+  MCFG_E_URL_INVALID: "{label} is not a valid URL",
+  MCFG_E_URL_PROTOCOL: "{label} supports HTTP(S) only",
+  MCFG_E_URL_CREDENTIALS: "{label} must not embed credentials in the URL",
+  MCFG_E_URL_SECRET_QUERY: "{label} must not embed a key in query parameters; use an authentication option",
+  MCFG_E_POSITIVE_INTEGER: "Enter a positive integer",
+  MCFG_E_KEY_EMPTY: "API key must not be empty",
+  MCFG_E_KEY_MASKED: "A masked placeholder cannot be saved as an API key; enter the real key or use $ENV",
+  MCFG_E_ENV_NAME: "Invalid environment variable name",
+  MCFG_E_DISCOVERY_URL: "Set an explicit Discovery URL; the plugin does not assume /models",
+  MCFG_E_ENV_MISSING: "Environment variable {name} is not set",
+  MCFG_E_PI_AUTH: "This provider has no reusable Pi auth",
+  MCFG_E_DISCOVERY_AUTH_HEADER: "provider {provider}.discoveryAuthHeader in {file} is invalid",
+  MCFG_E_DISCOVERY_AUTH_ORIGIN: "Discovery and model API origins differ; existing Pi authentication was not forwarded. Use a temporary/explicit key or choose no authentication header",
+  MCFG_E_REDIRECT_LOCATION: "Discovery redirect {status} has no Location header",
+  MCFG_E_REDIRECT_ORIGIN: "Discovery rejected a cross-origin redirect; credentials were not sent to the target origin",
+  MCFG_E_REDIRECT_LIMIT: "Discovery exceeded 5 redirects",
+  MCFG_E_PAGINATION: "Discovery pagination is unsupported: {reason}; a partial catalog was not accepted as complete",
+  MCFG_E_DISCOVERY_HTTP: "Discovery request failed with HTTP {status}{detail}",
+  MCFG_E_DISCOVERY_BODY_LIMIT: "Discovery response exceeds the {limit}-byte limit",
+  MCFG_E_DISCOVERY_JSON: "Discovery response is not valid JSON",
+  MCFG_E_DISCOVERY_SHAPE: "Discovery response must be an array or { data: [] }",
+  MCFG_E_UNSUPPORTED_API: "{identity} uses unsupported API {api}",
+  MCFG_E_TYPE_API: "{identity} uses API {api}, which does not match the model type",
+  MCFG_E_NOT_OWNED: "Provider {provider} is not plugin-owned, so its extension model catalog cannot be replaced",
+  MCFG_E_BASE_URL_REQUIRED: "Every model in a plugin-owned provider needs a model Base URL or provider Base URL",
+  MCFG_E_EXTERNAL_TRANSPORT: "A third-party extension provider that is not owned by this plugin cannot guarantee request-local transport for both stream and streamSimple; remove proxy/anonymous settings or explicitly own a custom provider",
+  MCFG_E_PROXY_UNSUPPORTED: "{identity} does not support request-local proxying; proxy activation was blocked",
+  MCFG_E_ANONYMOUS_UNSUPPORTED: "{identity} cannot be called anonymously without leaking synthetic authentication",
+  MCFG_E_AUTH_REQUIRED: "models.json authentication needs a key or $ENV reference",
+  MCFG_E_LOCK_ACTIVE: "An active or not-yet-proven-stale configuration lock exists ({path})",
+  MCFG_E_LOCK_RECOVERY: "Another process is checking a stale configuration lock; nothing was written",
+  MCFG_E_LOCK_CHANGED: "The configuration lock changed during recheck or its owner is still alive; nothing was written",
+  MCFG_E_LOCK_CLEANUP: "A stale lock was detected but could not be cleaned safely: {reason}",
+  MCFG_E_LOCK_RACE: "Another process acquired the lock after stale-lock cleanup; nothing was written",
+  MCFG_E_CONCURRENT_CHANGE: "Configuration files changed in another process; nothing was written. Reopen /model-config",
+  MCFG_E_STAGING_CHANGE: "Configuration files changed while staging; temporary files were not committed",
+  MCFG_E_ROLLBACK_INCOMPLETE: "Transaction failed and rollback was incomplete: {errors}",
+  MCFG_E_TRANSACTION_ROLLED_BACK: "Transaction failed; both configuration files were rolled back",
+  MCFG_E_TX_RECOVERED: "An interrupted transaction {txId} was detected; both configuration files were restored to their old generation",
+  MCFG_E_TX_RECOVERY_ACTIVE: "An interrupted transaction journal exists at {path}, but its configuration lock is active or not proven stale; recovery did not run. Retry later",
+  MCFG_E_TX_RECOVERY_FAILED: "An interrupted transaction journal at {path} could not be recovered: {reason}. The journal was kept; restore both files to the same old generation using its recorded backup paths",
+  MCFG_E_INTERNAL_CHAT_ONLY: "Internal error: a non-chat model cannot be written to models.json",
+  MCFG_E_OWNED_PROVIDER_MISSING: "Plugin-owned provider {provider} has no models.json configuration",
+  MCFG_E_NOT_BUILTIN: "{provider} is not built in; a complete proxy wrapper cannot be guaranteed for an unowned external provider",
+  MCFG_E_DISABLE_THIRD_PARTY: "{provider} is an unowned third-party runtime extension provider and cannot be safely disabled by same-name registration",
+  MCFG_E_EXTERNAL: "External or system error",
+};
+
+export class ModelConfigError extends Error {
+  constructor(public readonly code: ErrorCode, public readonly params: TranslationParams = {}, options?: ErrorOptions) {
+    super(code, options);
+    this.name = "ModelConfigError";
+  }
+}
+
+export function mcError(code: ErrorCode, params: TranslationParams = {}, cause?: unknown): ModelConfigError {
+  return new ModelConfigError(code, params, cause === undefined ? undefined : { cause });
+}
+
+export function formatError(language: UiLanguage, error: unknown, safeExternalDetail?: string): string {
+  if (error instanceof ModelConfigError) {
+    const template = language === "zh-CN" ? ERROR_ZH[error.code] : ERROR_EN[error.code];
+    let message = template;
+    for (const [name, value] of Object.entries(error.params)) message = message.split(`{${name}}`).join(String(value));
+    return `[${error.code}] ${message}`;
+  }
+  return t(language, "errorExternal", {
+    code: "MCFG_E_EXTERNAL",
+    detail: safeExternalDetail?.trim() || t(language, "errorUnknownDetail"),
+  });
+}