free-coding-models 0.5.95 → 0.5.96

package/README.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   <strong>Find the fastest free coding model in seconds.</strong><br>
-  Live latency, stability and verdicts for 256 models from 24 free AI providers, then install the one you pick straight into your favorite coding tool.<br><br>
+  Live latency, stability and verdicts for 259 models from 25 free AI providers, then install the one you pick straight into your favorite coding tool.<br><br>
   <strong>Works with:</strong> OpenCode CLI / Desktop / WebUI, OpenClaw, Crush, Goose, Aider, Kilo CLI, Qwen Code, OpenHands, Amp, Hermes, Continue, Cline, Xcode, Pi, ZCode, ForgeCode, Copilot, jcode, Caveman Code and more.
 </p>
 
@@ -24,7 +24,7 @@ free-coding-models
 ```
 
 <p align="center">
-  <sub>Then create a free account on one of the <a href="#-providers">24 providers</a> to grab an API key.</sub>
+  <sub>Then create a free account on one of the <a href="#-providers">25 providers</a> to grab an API key.</sub>
 </p>
 
 <p align="center">
@@ -35,7 +35,7 @@ free-coding-models
 
 ## 💡 Why this tool?
 
-There is a large catalog of free and free-limited coding models (**24 providers / 256 live models**, generated from [`sources.js`](./sources.js)). Which one is fastest *right now*? Which one is actually stable, versus just lucky on the last ping?
+There is a large catalog of free and free-limited coding models (**25 providers / 259 live models**, generated from [`sources.js`](./sources.js)). Which one is fastest *right now*? Which one is actually stable, versus just lucky on the last ping?
 
 `free-coding-models` (FCM) answers that by pinging every model in parallel, showing live latency, and computing a **live Stability Score (0-100)** combining p95 latency, jitter, spike rate and uptime. Average latency alone is misleading: a model that randomly spikes to 6 seconds is not reliable.
 
@@ -87,17 +87,17 @@ free-coding-models --fiable              # print the single most reliable model
 
 ## 🟢 Providers
 
-**24 active providers / 256 live models**, sorted by live model count. Top 8:
+**25 active providers / 259 live models**, sorted by live model count. Top 8:
 
 | Provider | Models | Best tier | Env var |
 |----------|--------|-----------|---------|
 | [Alibaba DashScope](https://modelstudio.console.alibabacloud.com) | 29 | S+ | `DASHSCOPE_API_KEY` |
-| [Pollinations AI](https://enter.pollinations.ai) | 23 | S+ | `POLLINATIONS_API_KEY` |
+| [Kilo](https://kilo.ai) | 21 | S+ | `KILO_API_KEY` |
 | [OpenRouter](https://openrouter.ai/keys) | 21 | S+ | `OPENROUTER_API_KEY` |
-| [Kilo](https://kilo.ai) | 20 | S+ | `KILO_API_KEY` |
+| [Pollinations AI](https://enter.pollinations.ai) | 21 | S+ | `POLLINATIONS_API_KEY` |
 | [Ollama Cloud](https://ollama.com/settings/keys) | 20 | S+ | `OLLAMA_API_KEY` |
-| [OVHcloud AI](https://endpoints.ai.cloud.ovh.net) | 17 | S+ | `OVH_AI_ENDPOINTS_ACCESS_TOKEN` |
-| [Cloudflare AI](https://dash.cloudflare.com) | 15 | S+ | `CLOUDFLARE_API_TOKEN` |
+| [Cloudflare AI](https://dash.cloudflare.com) | 15 | S | `CLOUDFLARE_API_TOKEN` |
+| [OVHcloud AI](https://endpoints.ai.cloud.ovh.net) | 13 | S+ | `OVH_AI_ENDPOINTS_ACCESS_TOKEN` |
 | [NVIDIA NIM](https://build.nvidia.com) | 12 | S+ | `NVIDIA_API_KEY` |
 
 > 🧾 **What "free" means here:** free is a property of the *(provider, model)* pair, never of the provider as a whole. A row is listed only when that exact model id costs $0 to call through that provider (permanent free tier, `:free` variant, or free plan), verified live at audit time. The same open-weights model can be free on one host and paid on another - paid siblings are deliberately excluded. Full breakdown and badge legend: [`docs/providers.md`](./docs/providers.md).
@@ -129,6 +129,10 @@ The TUI is the heart of FCM: a live, sortable table of every model with real lat
 
 Mouse support: click headers to sort, double-click a row to launch, right-click to favorite, scroll to navigate.
 
+### Languages
+
+The TUI and Web Dashboard support English (default) and Simplified Chinese (`zh-CN`). Change **Language** in Settings; the preference is shared and saved in your local config.
+
 > 📖 **Full key table, mouse reference and workflows:** [`docs/tui.md`](./docs/tui.md) · Stability score and columns: [`docs/stability.md`](./docs/stability.md)
 
 ---

package/bin/free-coding-models.js

@@ -32,6 +32,7 @@ if (_configDirIdx !== -1 && process.argv[_configDirIdx + 1] && !process.argv[_co
 import chalk from 'chalk';
 import { parseArgs, TIER_LETTER_MAP } from '../src/core/utils.js';
 import { loadConfig, saveConfig } from '../src/core/config.js';
+import { setLocale } from '../src/core/i18n/index.js';
 import { ensureTelemetryConfig } from '../src/core/telemetry.js';
 import { ensureFavoritesConfig } from '../src/core/favorites.js';
 import { buildCliHelpText } from '../src/tui/cli-help.js';
@@ -69,6 +70,7 @@ async function main() {
   const cliArgs = parseArgs(process.argv);
 
   if (cliArgs.helpMode) {
+    setLocale(loadConfig().settings?.language || 'en');
     console.log();
     console.log(buildCliHelpText({ chalk, title: 'free-coding-models' }));
     console.log();

package/changelog/v0.5.96.md

@@ -0,0 +1,22 @@
+# Changelog v0.5.96 - 2026-09-26
+
+Community release: 3 issues fixed, 5 pull requests merged (4 new contributors), 1 declined with reason. The catalog moves to **25 providers / 259 models** with the addition of onomeo and 2 Mistral coding models, minus 6 Pollinations models that silently left the free tier.
+
+### Added
+
+- **🇨🇳 Simplified Chinese localization** (PR #193 by @Mavlan): the TUI and the Web Dashboard now share one i18n layer, English stays the default and `zh-CN` is one setting away. The language preference is persisted in the shared config and exposed through the web Settings API. CLI help, settings, router, install, search and command-palette text are all localized, and CJK display-width handling is reused for TUI columns and overlay clipping.
+- **onomeo provider** (PR #187 by @Owaid0723666, who also disclosed operating the service): 9 free coding models behind a daily check-in credit system (50k credits on day 1, up to 200k/day with a streak, no card). Wired end to end: env var `ONOMEO_API_KEY`, key test against `GET /v1/models`, quota badge `limited`, theme colors, Docker env passthrough and provider card on the website. Model ids verified live against the public catalog; premium models deliberately not listed.
+- **Mistral coding model aliases** (PR #192 by @MrTodone): `mistral-code-latest` and `mistral-code-fim-latest` join the Mistral provider (both live-verified aliases of codestral-2508, 256k context), handy for clients that address the `mistral-code-*` family directly.
+
+### Fixed
+
+- **Daemon dashboard "[object Object]" toast on every open** (issue #189): the daemon's embedded dashboard only stubbed `GET /api/tool-mode`, so the frontend's POST (URL write-back of `?toolMode=`) fell through to the OpenAI-style 404 catch-all. The daemon now handles GET and POST like `web/server.js`: GET returns the persisted `settings.preferredToolMode` instead of a hardcoded `opencode`, POST validates and persists the mode, and the frontend hook extracts nested `error.message` so any future failure reads as a sentence, not `[object Object]`. Covered by 4 new integration tests.
+- **"Unrecognized flag: --model" when launching OpenCode v2** (issue #194): OpenCode v2 rejects flags its entry points don't know, and `opencode web` never accepted `--model` at all. FCM already wrote your pick into `opencode.json` (`config.model`) before every launch, so the flag was redundant: all launch paths (CLI, Web, Desktop, snap/flatpak) now spawn bare and let the config default apply. Works identically on OpenCode v1 and v2.
+- **6 Pollinations models that quietly became paid** (issue #190, reported by @holakoyad): `minimax-m2.7`, `qwen/qwen3.8-max`, `google/gemini-3.1-pro-preview`, `nvidia/nemotron-3-ultra`, `qwen/qwen3-coder-next` and `gemma-4-31b` answer HTTP 200 with the error text embedded in the completion content on free keys, so status-code probes saw them as healthy. All 6 are removed (free alternatives remain on their original providers), and probes now sniff pollinations completions for the paid-Pollen message and report `402` instead of a fake `200`. Covered by 4 new unit tests.
+- **Router v2 failover settings wiped on restart** (PR #191 by @MrTodone): `lastResortModel`, `bodyReadTimeoutMs`, `totalBudgetMs` and `contentValidation` were silently stripped by the config normalizer on every `load() → save()` round-trip. Unknown failover keys now survive normalization (the daemon still sanitizes them at read time), with round-trip regression tests.
+- **Web Settings API key deletion could resurrect itself** (PR #195 by @ming076): `/api/settings` saved keys with a plain `saveConfig()` whose on-disk merge could restore a just-deleted key. Key add/update/delete now goes through the provider-scoped `persistApiKeysForProvider()` helper, and persistence failures return a real error instead of a fake success.
+
+### Changed
+
+- Provider counts: **24 → 25 providers, 254 → 259 models** (minus 6 paid Pollinations, plus 9 onomeo, plus 2 Mistral aliases). `docs/providers.md` regenerated from `sources.js`, README counts and Top-8 table refreshed, website catalog mirror synced.
+- Declined the chalk 5 → 6 dependabot bump (PR #183): chalk 6 requires Node 22 while FCM supports Node 18+ and CI tests Node 20. It will be revisited when the minimum Node version moves to 22.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.5.95",
+  "version": "0.5.96",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/sources.js

@@ -29,7 +29,7 @@
  *   📖 Secondary: https://swe-rebench.com (independent evals, scores are lower)
  *   📖 Leaderboard tracker: https://www.marc0.dev/en/leaderboard
  *
- *   @exports nvidiaNim, groq, cerebras, sambanova, openrouter, githubModels, mistral, codestral, scaleway, googleai, zai, qwen, cloudflare, ovhcloud, opencodeZen, kilo, llm7, routeway, novita, ollamaCloud, pollinations, siliconflow, requesty, orcarouter, vercelGateway — model arrays per active provider
+ *   @exports nvidiaNim, groq, cerebras, sambanova, openrouter, githubModels, mistral, codestral, scaleway, googleai, zai, qwen, cloudflare, ovhcloud, opencodeZen, kilo, llm7, routeway, novita, ollamaCloud, pollinations, siliconflow, requesty, orcarouter, vercelGateway, onomeo — model arrays per active provider
  *   @exports sources — map of active free/free-limited providers, each with { name, url, models }
 
  *   @exports MODELS — flat array of [modelId, label, tier, sweScore, ctx, providerKey]
@@ -227,6 +227,9 @@ export const mistral = [
   ['labs-leanstral-1-5', 'Leanstral 1.5', 'B', '-', '256k'], // Added (2026-09-22) — free-listed on Mistral LP; targets Lean 4 theorem proving, niche coding use
   ['ministral-3b-2512', 'Ministral 3 3B', 'B', '-', '128k'], // Fixed (2026-09-16): ministral-3-3b-25-12 → ministral-3b-2512; ctx 256k → 128k (max_context_length 131072)
   // Removed (2026-09-16): mistral-small-creative-25-12 (Mistral Small Creative) — absent from the live catalog
+  // ── Coding models (codestral-2508 aliases, live-verified 2026-09-22 via api.mistral.ai/v1/models) ──
+  ['mistral-code-latest', 'Mistral Code', 'A', '-', '256k'], // Added (2026-09-22): aliases codestral-2508 / codestral-latest; ctx 256000
+  ['mistral-code-fim-latest', 'Mistral Code FIM', 'A', '-', '256k'], // Added (2026-09-22): FIM alias of codestral-2508; ctx 256000
 ]
 
 // 📖 Mistral Codestral source - https://codestral.mistral.ai
@@ -553,21 +556,25 @@ export const novita = [
 // 📖 Note (2026-09-21): the anonymous tier (text.pollinations.ai/models) now lists ONLY openai-fast;
 // 📖 the models below need the free API key + Pollen credits (gen.pollinations.ai). Re-check the Pollen
 // 📖 free-grant policy at next audit: if grants stop covering these models, this list must shrink to openai-fast.
+// 📖 Note (2026-09-26, issue #190): a subset of models now requires PAID Pollen even with a free key — they
+// 📖 return HTTP 200 with the error embedded in the completion content ("not enough credits / needs paid
+// 📖 Pollen"), so status-code-only probes see them as healthy. 6 such models were removed; when auditing
+// 📖 Pollinations, sniff the completion content for that message, not just the HTTP status.
 export const pollinations = [
   // ── S+ tier — SWE-bench Verified ≥70% ──
   ['laguna', 'Laguna S 2.1', 'S+', '-', '1M'], // Fixed (2026-09-21): alias now resolves to poolside/laguna-s-2.1 (Laguna S 2.1), was Laguna XS.2; score cleared (S 2.1 has no published SWE-bench Verified)
-  ['minimax-m2.7', 'MiniMax M2.7', 'S+', '78.0%', '200k'],
+  // Removed (2026-09-26): minimax-m2.7 (MiniMax M2.7) — now requires paid Pollen: HTTP 200 with an embedded "not enough credits, this model needs paid Pollen" error on free-tier keys (issue #190); replacement: minimax (MiniMax M3, still free via Pollen grants)
   ['glm-5.3', 'Z.ai GLM-5.3', 'S+', '-', '1M'],
   ['kimi', 'Moonshot Kimi K2.6', 'S+', '80.2%', '262k'],
   ['minimax', 'MiniMax M3', 'S+', '80.5%', '524k'],
   ['moonshotai/kimi-k3', 'Moonshot Kimi K3', 'S+', '76.8%', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models; score follows the Kimi K3 entry on NVIDIA
   ['deepseek/deepseek-v4-pro', 'DeepSeek V4 Pro', 'S+', '-', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models
-  ['qwen/qwen3.8-max', 'Qwen3.8 Max', 'S+', '-', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models
-  ['google/gemini-3.1-pro-preview', 'Gemini 3.1 Pro Preview', 'S+', '-', '1M'], // Added (2026-09-21) — canonical id (paid-only on Google AI Studio but free here) // ⚠️ status 'down' on live /v1/models 2026-09-22, re-verify next audit
+  // Removed (2026-09-26): qwen/qwen3.8-max (Qwen3.8 Max) — requires paid Pollen (embedded credits error on free-tier keys, issue #190); still free on DashScope
+  // Removed (2026-09-26): google/gemini-3.1-pro-preview (Gemini 3.1 Pro Preview) — requires paid Pollen (embedded credits error on free-tier keys, issue #190); no free Gemini Pro tier anywhere
   ['openai/gpt-5.5', 'OpenAI GPT-5.5', 'S+', '-', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models
   ['openai/gpt-6-astra', 'OpenAI GPT-6 Astra', 'S+', '-', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models
   ['z-ai/glm-5.3-flash', 'Z.ai GLM-5.3 Flash', 'S+', '-', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models
-  ['nvidia/nemotron-3-ultra', 'NVIDIA Nemotron 3 Ultra', 'S+', '71.9%', '262k'], // Added (2026-09-21) — canonical id, healthy on live /v1/models; score/scale from the NVIDIA entry
+  // Removed (2026-09-26): nvidia/nemotron-3-ultra (NVIDIA Nemotron 3 Ultra) — requires paid Pollen (embedded credits error on free-tier keys, issue #190); still free on NVIDIA NIM
   ['anthropic/claude-opus-5', 'Claude Opus 5', 'S+', '-', '1M'], // Added (2026-09-22) — healthy on live /v1/models, free via Pollen credits
   // ── S tier — SWE-bench Verified 60–70% ──
   ['anthropic/claude-sonnet-5', 'Claude Sonnet 5', 'S', '-', '1M'], // Added (2026-09-22) — healthy on live /v1/models, free via Pollen credits
@@ -575,12 +582,12 @@ export const pollinations = [
   ['deepseek', 'DeepSeek V4 Flash', 'S+', '79.0%', '1M'], // Fixed (2026-09-21): alias now resolves to deepseek/deepseek-v4-flash (V4 Flash 0731), was V3; re-scored per the V4 Flash family entry
   ['kimi-code', 'Kimi K2.7 Code', 'S', '60.4%', '262k'], // Fixed (2026-09-21): alias now resolves to moonshotai/kimi-k2.7-code, was K2 Code
   ['openai', 'OpenAI GPT-5.4 Nano', 'B+', '-', '400k'], // Fixed (2026-09-21): alias now resolves to openai/gpt-5.4-nano (was a generic GPT alias); re-tiered to the nano class
-  ['qwen/qwen3-coder-next', 'Qwen3 Coder Next', 'S+', '70.6%', '262k'], // Added (2026-09-21) — canonical id (new on the network, health still warming up); score from the DashScope entry
+  // Removed (2026-09-26): qwen/qwen3-coder-next (Qwen3 Coder Next) — requires paid Pollen (embedded credits error on free-tier keys, issue #190); still free on DashScope
   ['openai/gpt-5.6-luna', 'OpenAI GPT-5.6 Luna', 'S', '-', '1M'], // Added (2026-09-21) — canonical id, healthy on live /v1/models
   // ── A+ tier — SWE-bench Verified 50–60% ──
   ['deepseek/deepseek-v4.1-flash', 'DeepSeek V4.1 Flash', 'A+', '-', '1M'], // Added (2026-09-22) — healthy on live /v1/models, successor to V4 Flash
   ['meituan/longcat-2.0', 'LongCat 2.0', 'A', '-', '1M'], // Added (2026-09-22) — healthy on live /v1/models, new MoE agentic/coding model on the network
-  ['gemma-4-31b', 'Gemma 4 31B', 'A+', '52.0%', '262k'],
+  // Removed (2026-09-26): gemma-4-31b (Gemma 4 31B) — requires paid Pollen (embedded credits error on free-tier keys, issue #190); the free Gemma route is NVIDIA NIM
   ['gpt-oss', 'GPT OSS 20B', 'A+', '50.3%', '131k'],
   ['qwen3.7-flash', 'Qwen3.7 Flash', 'A+', '-', '1M'],
   // ── B+ tier ──
@@ -706,6 +713,35 @@ export const ollamaCloud = [
   ['nemotron-3-nano:30b', 'Nemotron 3 Nano 30B', 'A-', '38.8%', '1M'],
 ]
 
+// 📖 onomeo source - https://onomeo.com/docs
+// 📖 OpenAI-compatible gateway: https://onomeo.com/v1/chat/completions (streaming + tool calls)
+// 📖 Public beta: not every feature is guaranteed to work; feedback is welcome at https://onomeo.com/feedback.
+// 📖 Free credits come from a daily check-in, no card: 50,000 on day 1, rising to 200,000/day from
+// 📖 day 7 of a streak (a missed day resets it). Every call spends credits and the cost per reply
+// 📖 varies by model (https://onomeo.com/models), so this is a small allowance.
+// 📖 Premium models are not listed; each account that has not paid can spend up to 50,000 credits/day on them.
+// 📖 Optional: $5 one-time buys 1,000,000 credits. Limits: 12 req/min per key, 60 req per 5 hours
+// 📖 per account, 120 per 5 hours per IP, and a site-wide pool of 450 per 5 hours for accounts
+// 📖 that have not bought credits.
+// 📖 Some upstreams may train on prompts; each model page (https://onomeo.com/models/<id>) says which.
+// 📖 Ids and ctx checked 2026-09-26 against the public https://onomeo.com/api/info
+// 📖 (`models`, `modelFacts`); /v1/models needs a key.
+export const onomeo = [
+  // ── S+ tier — SWE-bench Verified ≥70% ──
+  ['deepseek-v4-flash', 'DeepSeek V4 Flash', 'S+', '79.0%', '1M'],
+  ['glm-5.2', 'GLM 5.2', 'S+', '82.8%', '1M'],
+  // ── S tier — SWE-bench Verified 60–70% ──
+  ['gemini-3.1-flash-lite', 'Gemini 3.1 Flash Lite', 'S', '62.8%', '1M'],
+  ['@cf/openai/gpt-oss-120b', 'GPT OSS 120B', 'S', '62.4%', '128k'],
+  ['nvidia/nemotron-3-super-120b-a12b', 'Nemotron 3 Super', 'S', '60.5%', '262k'],
+  // ── A+ tier — SWE-bench Verified 50–60% ──
+  ['openai/gpt-oss-20b', 'GPT OSS 20B', 'A+', '50.3%', '128k'],
+  ['z-ai/glm-5.3-flash-free', 'GLM-5.3 Flash', 'A+', '-', '1M'],
+  ['stepfun/step-3.7-flash:free', 'Step 3.7 Flash', 'A+', '-', '256k'],
+  // ── A tier — SWE-bench Verified 40–50% ──
+  ['codestral-latest', 'Codestral Latest', 'A', '40.0%', '256k'],
+]
+
 // 📖 All sources combined - used by the main script
 // 📖 Each source has: name (display), url (API endpoint), models (array of model tuples)
 // 📖 Providers ordered by generosity of free tier (most generous first)
@@ -898,6 +934,13 @@ export const sources = {
     quotaCode: 'free',
     models: ollamaCloud,
   },
+  onomeo: {
+    name: 'onomeo',
+    url: 'https://onomeo.com/v1/chat/completions',
+    quota: 'Daily check-in credits · 12 RPM · 60 req/5h',
+    quotaCode: 'limited',
+    models: onomeo,
+  },
 }
 
 // 📖 Flatten all models from all sources — each entry includes providerKey as 6th element

package/src/core/config.js

@@ -105,6 +105,7 @@ import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSy
 import { homedir } from 'node:os'
 import { join, resolve, dirname } from 'node:path'
 import { syncShellEnv } from './shell-env.js'
+import { DEFAULT_LOCALE, normalizeLocale } from './i18n/index.js'
 
 // 📖 Expand leading ~/ or bare ~ to homedir so --config-dir ~/.config/... works.
 // 📖 resolve() alone does NOT expand tilde, it would treat ~ as a literal folder.
@@ -188,6 +189,7 @@ const ENV_VARS = {
   requesty:   'REQUESTY_API_KEY',
   orcarouter: 'ORCAROUTER_API_KEY',
   'vercel-gateway': ['VERCEL_AI_GATEWAY_API_KEY', 'AI_GATEWAY_API_KEY'],
+  onomeo:     'ONOMEO_API_KEY',
 }
 
 // 📖 Smart Router defaults are intentionally conservative: balanced probing,
@@ -331,6 +333,7 @@ function normalizeSettingsSection(settings) {
   delete safeSettings.footerHidden
   return {
     ...safeSettings,
+    language: normalizeLocale(safeSettings.language),
     hideUnconfiguredModels: typeof safeSettings.hideUnconfiguredModels === 'boolean' ? safeSettings.hideUnconfiguredModels : true,
     favoritesPinnedAndSticky: typeof safeSettings.favoritesPinnedAndSticky === 'boolean' ? safeSettings.favoritesPinnedAndSticky : false,
     runAiSpeedTestOnStartup: typeof safeSettings.runAiSpeedTestOnStartup === 'boolean' ? safeSettings.runAiSpeedTestOnStartup : false,
@@ -456,10 +459,22 @@ function normalizeRouterFailover(failover, routerFallback = {}) {
   const rawStreamStall = numberOrNull(safeFailover.streamStallTimeoutMs) ?? numberOrNull(routerFallback.streamStallTimeoutMs)
   const rawRequestTimeout = numberOrNull(safeFailover.requestTimeoutMs) ?? numberOrNull(routerFallback.requestTimeoutMs)
 
+  // 📖 router-v2 documented failover fields (lastResortModel,
+  // bodyReadTimeoutMs, totalBudgetMs, contentValidation — docs/router-v2.md)
+  // are read by the daemon at runtime but are not v1 knobs normalized here.
+  // Carry any unknown keys through so they survive load()/save() round-trips
+  // instead of being silently dropped from the on-disk config.
+  const v1FailoverKeys = new Set(['maxRetries', 'streamStallTimeoutMs', 'requestTimeoutMs'])
+  const extras = {}
+  for (const key of Object.keys(safeFailover)) {
+    if (!v1FailoverKeys.has(key)) extras[key] = safeFailover[key]
+  }
+
   return {
     maxRetries: normalizePositiveInteger(rawMaxRetries, DEFAULT_ROUTER_SETTINGS.failover.maxRetries, { min: 1, max: 20 }),
     streamStallTimeoutMs: normalizePositiveInteger(rawStreamStall, DEFAULT_ROUTER_SETTINGS.failover.streamStallTimeoutMs, { min: 1000, max: 120000 }),
     requestTimeoutMs: normalizePositiveInteger(rawRequestTimeout, DEFAULT_ROUTER_SETTINGS.failover.requestTimeoutMs, { min: 1000, max: 300000 }),
+    ...extras,
   }
 }
 
@@ -1295,6 +1310,7 @@ export function isProviderEnabled(config, providerKey) {
  */
 export function _emptyProfileSettings() {
   return {
+    language: DEFAULT_LOCALE,
     tierFilter: null,     // 📖 null = show all tiers, or 'S'|'A'|'B'|'C'|'D'
     sortColumn: 'avg',    // 📖 default sort column
     sortAsc: true,        // 📖 true = ascending (fastest first for latency)

package/src/core/i18n/index.js

@@ -0,0 +1,49 @@
+import en from './locales/en.js'
+import zhCN from './locales/zh-CN.js'
+
+export const DEFAULT_LOCALE = 'en'
+export const SUPPORTED_LOCALES = Object.freeze(['en', 'zh-CN'])
+export const LOCALE_OPTIONS = Object.freeze([
+  Object.freeze({ value: 'en', labelKey: 'common.language.english' }),
+  Object.freeze({ value: 'zh-CN', labelKey: 'common.language.simplifiedChinese' }),
+])
+
+const dictionaries = Object.freeze({ en, 'zh-CN': zhCN })
+let activeLocale = DEFAULT_LOCALE
+
+export function normalizeLocale(locale) {
+  return SUPPORTED_LOCALES.includes(locale) ? locale : DEFAULT_LOCALE
+}
+
+export function getLocale() {
+  return activeLocale
+}
+
+export function setLocale(locale) {
+  activeLocale = normalizeLocale(locale)
+  return activeLocale
+}
+
+export function createTranslator(resources = dictionaries) {
+  return (locale, key, values = {}) => {
+    if (typeof key !== 'string') return ''
+    const active = normalizeLocale(locale)
+    const localized = resources[active]?.[key]
+    const fallback = resources[DEFAULT_LOCALE]?.[key]
+    const template = typeof localized === 'string' ? localized : typeof fallback === 'string' ? fallback : key
+    return template.replace(/\{([\w.]+)\}/g, (match, name) => {
+      const value = values && Object.prototype.hasOwnProperty.call(values, name) ? values[name] : undefined
+      return value === null || value === undefined ? match : String(value)
+    })
+  }
+}
+
+const translate = createTranslator()
+
+export function t(key, values = {}) {
+  return translate(activeLocale, key, values)
+}
+
+export function hasTranslation(locale, key) {
+  return typeof dictionaries[normalizeLocale(locale)]?.[key] === 'string'
+}