| name | add-provider |
| description | 新增 AI Provider，覆盖 ProviderType / PROVIDER_PROFILES / STATIC_MODELS / PROVIDER_FACTORIES / 前端图标 / 三语 i18n 全部六处 |
新增 AI Provider
向用户询问以下信息（若已在请求中提供则跳过）：
- Provider ID：小写，如
mistral
- 协议类型：OpenAI 兼容 / 自定义协议
- 默认 baseUrl：如
https://api.mistral.ai/v1
- 默认 modelName：如
mistral-large-latest
- 显示名称与一句话描述（中/英/日三语）：如
Mistral / 「欧洲开源模型，性价比高」
- 图标 emoji：如
🌬️
- 静态模型目录：2–3 个常用 model id（真打
/models 失败时的回退目录）
六处改动（缺一不可）
其中两处漏掉不会编译报错，但会静默出问题——单独标注了。
| # | 文件 | 内容 | 漏了会怎样 |
|---|
| 1 | shared/types/provider.ts | ProviderType 加 | '<id>' | 后续几处全部编译报错 |
| 2 | shared/constants.ts | PROVIDER_PROFILES | 编译报错（Record<ProviderType, _>） |
| 3 | shared/constants.ts | STATIC_MODELS | 编译报错（同上） |
| 4 | sidecar/providers/registry.ts | PROVIDER_FACTORIES | ⚠️ 不报错：createProvider 静默降级为 openai |
| 5 | src/components/settings/ProviderSelector.tsx | PROVIDER_ICONS | 编译报错（Record<ProviderType, string>）——但注意 PROVIDERS = Object.keys(PROVIDER_ICONS)，这里才是下拉框的数据源 |
| 6 | src/i18n/{zh,en,ja}.json | provider_name_<id> + provider_desc_<id> | ⚠️ 不报错：调用点用了 as TranslationKey 断言，UI 会直接显示 key 名字符串 |
实施步骤
1. 读取现有结构
shared/constants.ts 的 ProviderProfile 接口与 PROVIDER_PROFILES、STATIC_MODELS（sidecar/config.ts 仅 re-export，不要在那里加 profile）sidecar/providers/registry.ts 的 PROVIDER_FACTORIESshared/types/provider.ts 的 ProviderTypesrc/components/settings/ProviderSelector.tsx 的 PROVIDER_ICONS
2. shared 层（第 1–3 处）
shared/types/provider.ts：ProviderType 追加 | '<id>'。
shared/constants.ts 的 PROVIDER_PROFILES 追加一行，四个字段全部必填：
<id>: { baseUrl: '<defaultBaseUrl>', model: '<defaultModel>', contentLimit: 1000, timeout: 60_000 },
shared/constants.ts 的 STATIC_MODELS 追加一项（tagKey 复用现有的 model_tag_flagship / _fast / _long / _reasoning / _value，需要新 tag 时同步加三语 key）：
<id>: [
{ value: '<model-a>', tagKey: 'model_tag_flagship' },
{ value: '<model-b>', tagKey: 'model_tag_fast' },
],
3. Sidecar 工厂（第 4 处）
OpenAI 兼容协议（推荐路径） —— sidecar/providers/registry.ts 复用 OpenAIProvider，构造器用位置参数，默认值从 PROVIDER_PROFILES 兜底：
<id>: (cfg) =>
new OpenAIProvider(
cfg.apiKey,
cfg.baseUrl ?? PROVIDER_PROFILES.<id>.baseUrl,
cfg.model ?? PROVIDER_PROFILES.<id>.model,
),
自定义协议 —— 在 sidecar/providers/<id>.ts 实现 AIProvider 接口（接口定义见 sidecar/ai.ts，参考 anthropic.ts），再同样注册。
实时列模型无需改代码：cli-handlers/models.ts 只对 ollama 特判，其余云端 provider 一律真打 /models，空结果自动回退 STATIC_MODELS。别去改那里的分支。
4. 前端（第 5 处）
src/components/settings/ProviderSelector.tsx 的 PROVIDER_ICONS 追加 <id>: '<emoji>',。图标是专有展示不走 i18n；下拉选项由 Object.keys(PROVIDER_ICONS) 派生，不加这里 UI 里就选不到。
5. 三语 i18n（第 6 处）
src/i18n/zh.json / en.json / ja.json 各加两个 key（扁平结构，就近插在其它 provider_name_* / provider_desc_* 旁）：
"provider_name_<id>": "<显示名>",
"provider_desc_<id>": "<一句话描述>"
三语必须齐，缺了不会编译报错但 UI 会显示 key 名。
6. 验证
bun tsc --noEmit
cd sidecar && bun test config providers
再人工确认两处编译器抓不到的：
PROVIDER_FACTORIES 里确有新 provider（否则静默降级 openai）- 三个 locale 各有
provider_name_<id> 与 provider_desc_<id>
python3 -c "
import json
for f in ('zh','en','ja'):
d=json.load(open(f'src/i18n/{f}.json'))
print(f, [k for k in ('provider_name_<id>','provider_desc_<id>') if k not in d] or 'OK')"
