From c007518ac224a6f5928efe5bdc805bf0db5c5235 Mon Sep 17 00:00:00 2001
From: wurongjie <wurongjie@uniontech.com>
Date: Thu, 24 Sep 2026 17:42:19 +0800
Subject: [PATCH 1/6] feat(i18n): add Simplified Chinese
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

zh.ts carries all 375 keys and joins SUPPORTED_LANGUAGES, which is the only
registration the settings picker, the per-language client script and the
language clamping need. Every locale gains the lang.zh and langLocal.zh
names the picker shows, and the README feature line and the assets.ts
comment (one script per language, built at module init) follow.

Placeholder and key parity now iterate SUPPORTED_LANGUAGES instead of a
hardcoded id/sv list, so this locale and any later one are checked the day
they register. New assertions pin zh where the runtime does the work:
Intl.DisplayNames resolves 美国, Intl.NumberFormat groups 1,234,567,
toLocaleDateString renders 7月, the picker labels the other languages in
Chinese, and a lang=zh page links and serves its own client script.
---
 README.md                                   |   2 +-
 src/__tests__/handler/admin-assets.test.ts  |  13 +
 src/__tests__/page/settings-page.test.ts    |  13 +
 src/__tests__/service/admin-service.test.ts |   3 +-
 src/__tests__/unit/big-chart.test.ts        |  16 +
 src/__tests__/unit/country.test.ts          |   7 +
 src/__tests__/unit/format.test.ts           |   7 +
 src/__tests__/unit/i18n.test.ts             |  35 +-
 src/assets.ts                               |   5 +-
 src/i18n/en.ts                              |   2 +
 src/i18n/id.ts                              |   2 +
 src/i18n/index.ts                           |   5 +-
 src/i18n/sv.ts                              |   2 +
 src/i18n/zh.ts                              | 410 ++++++++++++++++++++
 14 files changed, 506 insertions(+), 16 deletions(-)
 create mode 100644 src/i18n/zh.ts

diff --git a/README.md b/README.md
index 7c660b31..4d940e53 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@ The rest of the shortener:
 - **Labels from the page title.** A link created without a label gets the destination page's title fetched in the background, with private and internal hosts refused.
 - **QR codes** as SVG for any slug, from the admin UI, the API, the SDKs and MCP. Scans are tracked separately from link clicks.
 - **Edge redirects.** Slug lookups are cached in Workers KV in front of D1, and click recording runs after the redirect is sent.
-- **Admin dashboard** in English, Indonesian and Swedish, with three themes, per-link and per-bundle analytics, API key management and settings.
+- **Admin dashboard** in English, Indonesian, Swedish and Simplified Chinese, with three themes, per-link and per-bundle analytics, API key management and settings.
 - **Browser extension** for Chrome and Firefox that shortens the current tab against your own deployment. Source and store status in [browser-extensions/README.md](browser-extensions/README.md).
 - **One-click deploy** with automatic provisioning of the database and KV namespace, and migrations that the Worker applies on its first request.
 
diff --git a/src/__tests__/handler/admin-assets.test.ts b/src/__tests__/handler/admin-assets.test.ts
index a18b25e4..dfb490cd 100644
--- a/src/__tests__/handler/admin-assets.test.ts
+++ b/src/__tests__/handler/admin-assets.test.ts
@@ -10,6 +10,7 @@ import { SELF } from "cloudflare:test";
 import { applyMigrations, resetData } from "../setup";
 import { adminStyles } from "../../styles";
 import id from "../../i18n/id";
+import zh from "../../i18n/zh";
 
 function req(path: string, headers: Record<string, string> = {}): Request {
   return new Request(`https://shrtnr.test${path}`, { headers });
@@ -85,7 +86,19 @@ describe("GET /_/assets/*", () => {
   it("gives each language its own script URL", async () => {
     const en = (await pageHtml("/_/admin/settings")).match(SCRIPT)![1];
     const sv = (await pageHtml("/_/admin/settings", { Cookie: "lang=sv" })).match(SCRIPT)![1];
+    const zh = (await pageHtml("/_/admin/settings", { Cookie: "lang=zh" })).match(SCRIPT)![1];
     expect(en).not.toBe(sv);
+    expect(en).not.toBe(zh);
+    expect(sv).not.toBe(zh);
+  });
+
+  it("serves the Simplified Chinese client script to a lang=zh viewer", async () => {
+    const html = await pageHtml("/_/admin/settings", { Cookie: "lang=zh" });
+    const m = html.match(SCRIPT);
+    expect(m![2]).toBe("zh");
+    const res = await SELF.fetch(req(m![1]));
+    expect(res.status).toBe(200);
+    expect(await res.text()).toContain(zh["client.themeUpdated"]);
   });
 
   it("serves this build's content for a hash from another build, uncached, so a deploy window never leaves a page unstyled", async () => {
diff --git a/src/__tests__/page/settings-page.test.ts b/src/__tests__/page/settings-page.test.ts
index 58a7d914..1f6beda8 100644
--- a/src/__tests__/page/settings-page.test.ts
+++ b/src/__tests__/page/settings-page.test.ts
@@ -66,6 +66,19 @@ describe("Settings page analytics filter toggles", () => {
   });
 });
 
+describe("Settings page language picker", () => {
+  it("offers Simplified Chinese and names the other languages in the viewer's language", async () => {
+    const res = await SELF.fetch(
+      new Request("https://shrtnr.test/_/admin/settings", { headers: { Cookie: "lang=zh" } }),
+    );
+    const html = await res.text();
+    expect(html).toMatch(/<option value="zh"[^>]*selected[^>]*>简体中文/);
+    expect(html).toContain("English · 英语");
+    expect(html).toContain("Svenska · 瑞典语");
+    expect(html).toContain("Bahasa Indonesia · 印度尼西亚语");
+  });
+});
+
 describe("Settings page MCP OAuth status row", () => {
   it("renders the status as its own row with a decorative icon and the MCP OAuth label", async () => {
     // Before this row existed, "Not configured" reached the document only
diff --git a/src/__tests__/service/admin-service.test.ts b/src/__tests__/service/admin-service.test.ts
index b1fe6c62..133a0a17 100644
--- a/src/__tests__/service/admin-service.test.ts
+++ b/src/__tests__/service/admin-service.test.ts
@@ -6,6 +6,7 @@ import {
   getAppSettings,
   updateAppSettings,
 } from "../../services/admin-management";
+import { SUPPORTED_LANGUAGES } from "../../i18n";
 
 const TEST_IDENTITY = "test@example.com";
 
@@ -223,7 +224,7 @@ describe("settings theme and language validation", () => {
   });
 
   it("accepts every supported language", async () => {
-    for (const lang of ["en", "id", "sv"]) {
+    for (const lang of SUPPORTED_LANGUAGES) {
       const result = await updateAppSettings(env as any, TEST_IDENTITY, { lang });
       expect(result.ok).toBe(true);
       const settings = await getAppSettings(env as any, TEST_IDENTITY);
diff --git a/src/__tests__/unit/big-chart.test.ts b/src/__tests__/unit/big-chart.test.ts
index 9d3a8f27..d71b4a2a 100644
--- a/src/__tests__/unit/big-chart.test.ts
+++ b/src/__tests__/unit/big-chart.test.ts
@@ -134,4 +134,20 @@ describe("formatBucketLabel", () => {
     expect(out).toContain("2026");
     expect(out).toContain("09:00");
   });
+
+  it("formats a daily bucket with the Chinese month name", () => {
+    // "7月" only comes from zh ICU data. An English fallback would render
+    // "Jul", so this pins the locale reaching the formatter.
+    const out = formatBucketLabel("2026-07-16", "zh");
+    expect(out).toContain("7月");
+    expect(out).toContain("16");
+    expect(out).toContain("2026");
+  });
+
+  it("formats a monthly bucket with the Chinese month name and year only", () => {
+    const out = formatBucketLabel("2026-07", "zh");
+    expect(out).toContain("7月");
+    expect(out).toContain("2026");
+    expect(out).not.toBe(formatBucketLabel("2026-07-01", "zh"));
+  });
 });
diff --git a/src/__tests__/unit/country.test.ts b/src/__tests__/unit/country.test.ts
index 9a4a3942..17769edb 100644
--- a/src/__tests__/unit/country.test.ts
+++ b/src/__tests__/unit/country.test.ts
@@ -25,6 +25,13 @@ describe("countryName", () => {
     expect(result).toBe("Amerika Serikat");
   });
 
+  it("should resolve US to a localized name in Simplified Chinese", () => {
+    // A translated name, not the raw code and not the English fallback, which
+    // is what a runtime without zh ICU data would return.
+    const result = countryName("US", "zh");
+    expect(result).toBe("美国");
+  });
+
   it("should return something for unknown codes without throwing", () => {
     const result = countryName("ZZ", "en");
     expect(typeof result).toBe("string");
diff --git a/src/__tests__/unit/format.test.ts b/src/__tests__/unit/format.test.ts
index 0c96fe75..5798426f 100644
--- a/src/__tests__/unit/format.test.ts
+++ b/src/__tests__/unit/format.test.ts
@@ -20,6 +20,13 @@ describe("fmtNumber", () => {
     expect(out).toMatch(/1.234.567/); // any single separator character
   });
 
+  it("groups thousands for zh", () => {
+    // Chinese groups with commas like en. Pinned so a locale whose ICU data is
+    // missing, and which therefore falls back to the runtime default, is a
+    // deliberate decision rather than a surprise.
+    expect(fmtNumber(1234567, "zh")).toBe("1,234,567");
+  });
+
   it("formats zero and negative values", () => {
     expect(fmtNumber(0, "en")).toBe("0");
     expect(fmtNumber(-12345, "en")).toBe("-12,345");
diff --git a/src/__tests__/unit/i18n.test.ts b/src/__tests__/unit/i18n.test.ts
index f53887c4..79390a54 100644
--- a/src/__tests__/unit/i18n.test.ts
+++ b/src/__tests__/unit/i18n.test.ts
@@ -7,8 +7,6 @@ import {
   SUPPORTED_LANGUAGES,
 } from "../../i18n";
 import en from "../../i18n/en";
-import id from "../../i18n/id";
-import sv from "../../i18n/sv";
 
 function flattenKeys(obj: unknown, prefix = ""): string[] {
   if (obj === null || typeof obj !== "object") return [prefix];
@@ -31,6 +29,7 @@ describe("i18n", () => {
       expect(isSupportedLanguage("en")).toBe(true);
       expect(isSupportedLanguage("id")).toBe(true);
       expect(isSupportedLanguage("sv")).toBe(true);
+      expect(isSupportedLanguage("zh")).toBe(true);
     });
 
     it("returns false for unsupported languages", () => {
@@ -56,6 +55,11 @@ describe("i18n", () => {
       expect(t["nav.dashboard"]).toBe("Översikt");
     });
 
+    it("returns Simplified Chinese translations for 'zh'", () => {
+      const t = getTranslations("zh");
+      expect(t["nav.dashboard"]).toBe("仪表盘");
+    });
+
     it("falls back to English for unsupported language", () => {
       const t = getTranslations("fr");
       expect(t["nav.dashboard"]).toBe("Dashboard");
@@ -65,10 +69,14 @@ describe("i18n", () => {
   describe("placeholder parity", () => {
     // Translations is typed off en, so a missing key fails the build. Nothing
     // types the placeholders inside a value, so a locale can keep the key and
-    // silently drop the interpolation the key exists for.
-    it.each([["id", id], ["sv", sv]] as const)("keeps every %s placeholder that en declares", (_name, locale) => {
+    // silently drop the interpolation the key exists for. Driven off
+    // SUPPORTED_LANGUAGES so a new locale is covered the day it is registered.
+    const translated = SUPPORTED_LANGUAGES.filter((lang) => lang !== DEFAULT_LANGUAGE);
+
+    it.each(translated)("keeps every %s placeholder that en declares", (lang) => {
+      const locale = getTranslations(lang);
       for (const key of Object.keys(en) as (keyof typeof en)[]) {
-        expect(placeholders(locale[key])).toEqual(placeholders(en[key]));
+        expect(placeholders(locale[key]), `${lang} ${key}`).toEqual(placeholders(en[key]));
       }
     });
   });
@@ -148,12 +156,10 @@ describe("i18n", () => {
 
   describe("key parity across locales", () => {
     const enKeys = new Set(flattenKeys(en));
+    const translated = SUPPORTED_LANGUAGES.filter((lang) => lang !== DEFAULT_LANGUAGE);
 
-    it.each([
-      ["id", id],
-      ["sv", sv],
-    ])("locale %s has the same key set as en", (_name, locale) => {
-      const localeKeys = new Set(flattenKeys(locale));
+    it.each(translated)("locale %s has the same key set as en", (lang) => {
+      const localeKeys = new Set(flattenKeys(getTranslations(lang)));
       const missing = [...enKeys].filter((k) => !localeKeys.has(k));
       const extra = [...localeKeys].filter((k) => !enKeys.has(k));
       expect({ missing, extra }).toEqual({ missing: [], extra: [] });
@@ -174,6 +180,7 @@ describe("i18n", () => {
         expect(translations["lang.en"]).toBe("English");
         expect(translations["lang.id"]).toBe("Bahasa Indonesia");
         expect(translations["lang.sv"]).toBe("Svenska");
+        expect(translations["lang.zh"]).toBe("简体中文");
       }
     });
 
@@ -181,14 +188,22 @@ describe("i18n", () => {
       const en = getTranslations("en");
       const id = getTranslations("id");
       const sv = getTranslations("sv");
+      const zh = getTranslations("zh");
 
       expect(en["langLocal.id"]).toBe("Indonesian");
       expect(id["langLocal.id"]).toBe("Indonesia");
       expect(sv["langLocal.id"]).toBe("Indonesiska");
+      expect(zh["langLocal.id"]).toBe("印度尼西亚语");
 
       expect(en["langLocal.sv"]).toBe("Swedish");
       expect(id["langLocal.sv"]).toBe("Swedia");
       expect(sv["langLocal.sv"]).toBe("Svenska");
+      expect(zh["langLocal.sv"]).toBe("瑞典语");
+
+      expect(en["langLocal.zh"]).toBe("Chinese (Simplified)");
+      expect(id["langLocal.zh"]).toBe("Tionghoa (Sederhana)");
+      expect(sv["langLocal.zh"]).toBe("Kinesiska (förenklad)");
+      expect(zh["langLocal.zh"]).toBe("简体中文");
     });
   });
 });
diff --git a/src/assets.ts b/src/assets.ts
index 00173e11..5a64634b 100644
--- a/src/assets.ts
+++ b/src/assets.ts
@@ -12,8 +12,9 @@
  *
  * The hash covers the whole body, so it moves with the app version (the
  * client script embeds it) and with the translations (one script per
- * language). The four assets are fixed for the life of the isolate, so they
- * are built once at module init and served from a map.
+ * language). The asset set is fixed for the life of the isolate, so each
+ * asset is built once at module init and served from a map: every language
+ * registered in SUPPORTED_LANGUAGES costs one script built here.
  *
  * A deploy reaches colos one at a time, so for a short window a document
  * from the new build can request its assets from an isolate on the old one
diff --git a/src/i18n/en.ts b/src/i18n/en.ts
index d0338b41..61fa3bc7 100644
--- a/src/i18n/en.ts
+++ b/src/i18n/en.ts
@@ -406,11 +406,13 @@ const en = {
   "lang.en": "English",
   "lang.id": "Bahasa Indonesia",
   "lang.sv": "Svenska",
+  "lang.zh": "简体中文",
 
   // Language names (translated into this locale)
   "langLocal.en": "English",
   "langLocal.id": "Indonesian",
   "langLocal.sv": "Swedish",
+  "langLocal.zh": "Chinese (Simplified)",
 };
 
 export default en;
diff --git a/src/i18n/id.ts b/src/i18n/id.ts
index 88df388f..ef693dff 100644
--- a/src/i18n/id.ts
+++ b/src/i18n/id.ts
@@ -410,11 +410,13 @@ const id: Translations = {
   "lang.en": "English",
   "lang.id": "Bahasa Indonesia",
   "lang.sv": "Svenska",
+  "lang.zh": "简体中文",
 
   // Language names (translated into this locale)
   "langLocal.en": "Inggris",
   "langLocal.id": "Indonesia",
   "langLocal.sv": "Swedia",
+  "langLocal.zh": "Tionghoa (Sederhana)",
 };
 
 export default id;
diff --git a/src/i18n/index.ts b/src/i18n/index.ts
index 3bf186e5..393ac27b 100644
--- a/src/i18n/index.ts
+++ b/src/i18n/index.ts
@@ -5,15 +5,16 @@ import type { TranslationKey, Translations } from "./types";
 import en from "./en";
 import id from "./id";
 import sv from "./sv";
+import zh from "./zh";
 
 export type { TranslationKey, Translations };
 export type TranslateFn = (key: TranslationKey, params?: Record<string, string | number>) => string;
 
 export const DEFAULT_LANGUAGE = "en";
-export const SUPPORTED_LANGUAGES = ["en", "id", "sv"] as const;
+export const SUPPORTED_LANGUAGES = ["en", "id", "sv", "zh"] as const;
 export type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
 
-const translations: Record<string, Translations> = { en, id, sv };
+const translations: Record<string, Translations> = { en, id, sv, zh };
 
 export function isSupportedLanguage(lang: string): lang is SupportedLanguage {
   return SUPPORTED_LANGUAGES.includes(lang as SupportedLanguage);
diff --git a/src/i18n/sv.ts b/src/i18n/sv.ts
index 349a7a33..7248a2e9 100644
--- a/src/i18n/sv.ts
+++ b/src/i18n/sv.ts
@@ -410,11 +410,13 @@ const sv: Translations = {
   "lang.en": "English",
   "lang.id": "Bahasa Indonesia",
   "lang.sv": "Svenska",
+  "lang.zh": "简体中文",
 
   // Language names (translated into this locale)
   "langLocal.en": "Engelska",
   "langLocal.id": "Indonesiska",
   "langLocal.sv": "Svenska",
+  "langLocal.zh": "Kinesiska (förenklad)",
 };
 
 export default sv;
diff --git a/src/i18n/zh.ts b/src/i18n/zh.ts
new file mode 100644
index 00000000..1950b903
--- /dev/null
+++ b/src/i18n/zh.ts
@@ -0,0 +1,410 @@
+// Copyright 2026 Oddbit (https://oddbit.id)
+// SPDX-License-Identifier: Apache-2.0
+
+import type { Translations } from "./types";
+
+const zh: Translations = {
+  // Language code (used by client-side Intl APIs)
+  "_lang": "zh",
+  // Navigation
+  "nav.dashboard": "仪表盘",
+  "nav.links": "链接",
+  "nav.bundles": "合集",
+  "nav.apiKeys": "API 密钥",
+  "nav.settings": "设置",
+  "nav.openNavigation": "打开导航",
+  "nav.logout": "退出登录",
+  "nav.signedInAs": "已登录为",
+
+  // Topbar (breadcrumb + user chip, rendered above every admin page)
+  "topbar.breadcrumb": "面包屑导航",
+  "topbar.workspace": "shrtnr",
+
+  // Dashboard
+  "dashboard.title": "仪表盘",
+  "dashboard.subtitle": "短链接数据概览",
+  "dashboard.urlPlaceholder": "粘贴长链接以缩短...",
+  "dashboard.shorten": "缩短",
+  "dashboard.totalLinks": "链接总数",
+  "dashboard.totalClicks": "点击总数",
+  "dashboard.clicksPerDay": "日均点击",
+  "dashboard.numDestinations": "目标地址",
+  "dashboard.numCountries": "国家/地区",
+  "dashboard.clickedLinks": "有点击的链接",
+  "dashboard.topCountries": "热门国家/地区",
+  "dashboard.noData": "暂无数据",
+  "dashboard.recentLinks": "最近链接",
+  "dashboard.noLinks": "暂无链接",
+  "dashboard.topReferrers": "热门来源",
+  "dashboard.topDomains": "热门域名",
+  "dashboard.mostClicked": "点击最多",
+  "dashboard.clickToCopy": "点击复制",
+
+  // Links
+  "links.title": "链接",
+  "links.subtitle": "管理你的所有短链接",
+  "links.inputPlaceholder": "粘贴 URL 或搜索链接...",
+  "links.search": "搜索",
+  "links.count": "{count} 条链接",
+  "links.countPlural": "{count} 条链接",
+  "links.recent": "最近",
+  "links.popular": "热门",
+  "links.filterActive": "活跃",
+  "links.filterDisabled": "已停用",
+  "links.filterAll": "全部",
+  "links.filter": "筛选",
+  "links.colLink": "链接",
+  "links.colShort": "短链接",
+  "links.colClicks": "点击量",
+  "links.colClicksRange": "点击量（{range}）",
+  "links.colCreated": "创建时间",
+  "links.pageSummary": "第 {from}-{to} 条，共 {total} 条",
+  "links.perPage": "每页",
+  "links.perPageAria": "每页链接数",
+  "links.colTrend": "趋势",
+  "links.allDisabled": "所有链接均已停用。选择“已停用”筛选即可查看。",
+  "links.noMatches": "没有符合当前筛选条件的链接。",
+  "links.noSearchMatches": "没有匹配“{query}”的链接。",
+  "links.noSearchMatchesInFilter": "在{filter}中没有匹配“{query}”的链接。",
+  "links.empty": "暂无链接。使用上方的“+ 新建链接”按钮开始。",
+  "links.disabled": "已停用",
+  "links.clicks": "次点击",
+  "links.clickToCopy": "点击复制",
+  "links.show": "显示",
+  "links.searchResults": "匹配的 {count} 条链接",
+  "links.clearSearch": "清除",
+
+  // Paginator (shared by the links listing and the link-detail stat pager)
+  "pagination.landmark": "分页",
+  "pagination.prev": "上一页",
+  "pagination.next": "下一页",
+
+  // Link Detail
+  "linkDetail.title": "链接详情",
+  "linkDetail.backToLinks": "返回链接列表",
+  "linkDetail.cancel": "取消",
+  "linkDetail.enable": "启用",
+  "linkDetail.disable": "停用",
+  "linkDetail.delete": "删除",
+  "linkDetail.disabled": "已停用",
+  "linkDetail.copy": "复制",
+  "linkDetail.qr": "二维码",
+  "linkDetail.or": "或",
+  "linkDetail.customSlug": "自定义短码",
+  "linkDetail.createdBy": "创建者",
+  "linkDetail.add": "添加",
+  "linkDetail.expiresAt": "到期时间",
+  "linkDetail.clear": "清除",
+  "linkDetail.save": "保存",
+  "linkDetail.setLabel": "设置标签",
+  "linkDetail.labelPlaceholder": "例如：活动落地页",
+  "linkDetail.noExpiry": "永不过期",
+  "linkDetail.clicksOverTime": "点击量趋势",
+  "linkDetail.noClickData": "暂无点击数据",
+  "linkDetail.totalClicks": "总点击量",
+  "linkDetail.clicksInRange": "所选范围内的点击量",
+  "linkDetail.today": "今天",
+  "linkDetail.todayPartial": "今天（进行中）",
+  "linkDetail.avgPerDay": "日均",
+  "linkDetail.createdOn": "创建于",
+  "linkDetail.neverExpires": "永不过期",
+  "linkDetail.via": "来自",
+  "linkDetail.addSlug": "添加短码",
+  "linkDetail.countries": "国家/地区",
+  "linkDetail.referrers": "来源网址",
+  "linkDetail.domains": "域名",
+  "linkDetail.sources": "来源",
+  "linkDetail.devices": "设备",
+  "linkDetail.os": "操作系统",
+  "linkDetail.browsers": "浏览器",
+  "linkDetail.linkModes": "访问方式",
+  "linkDetail.noData": "暂无数据",
+  "linkDetail.statPager": "第 {from}-{to} 条，共 {total} 条",
+  "linkDetail.clickToCopy": "点击复制",
+  "linkDetail.slugs": "短码",
+  "linkDetail.clicks": "次点击",
+  "linkDetail.primarySlug": "主短码",
+  "linkDetail.autoGenerated": "自动生成",
+  "linkDetail.addCustomSlug": "添加自定义短码",
+  "linkDetail.slugFieldLabel": "短码",
+  "linkDetail.changePrimary": "更换主短码",
+  "linkDetail.duplicate": "创建副本",
+  "linkDetail.deleteSlug": "删除短码",
+  "linkDetail.disableSlug": "停用短码",
+  "linkDetail.enableSlug": "启用短码",
+  "linkDetail.duplicateTitle": "为此目标地址再创建一个链接？",
+  "linkDetail.duplicateBody": "这会创建一条指向同一目标地址的独立链接记录。自定义短码不会被复制。",
+  "linkDetail.duplicateHelper": "当你需要独立的标签、归属、到期时间或生命周期时使用。如果只是想要同一目标地址的另一个短路径，请改为添加自定义短码。",
+  "linkDetail.copyLabel": "复制标签",
+  "linkDetail.confirmDisable": "确定要停用此链接吗？停用后将不再跳转。",
+  "linkDetail.confirmDelete": "删除此链接？此操作会永久删除该链接及其所有短码。",
+  "linkDetail.confirmEnable": "要重新启用此链接吗？",
+  "linkDetail.confirmDeleteSlug": "删除短码 /{slug}？此操作无法撤销。",
+  "linkDetail.confirmDisableSlug": "停用短码 /{slug}？停用后将不再跳转，但点击历史会保留。",
+  "linkDetail.confirmEnableSlug": "要重新启用短码 /{slug} 吗？",
+  "linkDetail.selectPrimary": "选择主短码",
+  "linkDetail.moreActions": "更多操作",
+  "linkDetail.autoGeneratedBadge": "自动",
+  "linkDetail.addToBundle": "添加到合集",
+  "linkDetail.inBundles": "所属合集",
+
+  // Bundles
+  "bundles.detailTitle": "合集详情",
+  "bundles.title": "合集",
+  "bundles.subtitle": "将相关链接归组，统一查看它们的互动情况。",
+  "bundles.newBundle": "新建合集",
+  "bundles.emptyTitle": "暂无合集",
+  "bundles.emptyBody": "将链接归组，跟踪合计互动数据。",
+  "bundles.filterActive": "活跃",
+  "bundles.filterArchived": "已归档",
+  "bundles.filterAll": "全部",
+  "bundles.totalClicks": "总点击量",
+  "bundles.links": "链接",
+  "bundles.linksCount": "{count} 条链接",
+  "bundles.linksCountPlural": "{count} 条链接",
+  "bundles.combinedClicks": "合计点击量",
+  "bundles.clickedLinks": "有点击的链接",
+  "bundles.clickedLinksHint": "合集内 {total} 条链接中有 {count} 条带来流量",
+  "bundles.topPerformer": "表现最佳",
+  "bundles.topPerformerHint": "{clicks} 次点击 · 占合集 {pct}%",
+  "bundles.countriesReached": "覆盖国家/地区",
+  "bundles.topCountry": "最高：{name} · {pct}%",
+  "bundles.linksInThisBundle": "合集内的链接",
+  "bundles.sortedByClicks": "按点击量排序",
+  "bundles.addLinkToBundle": "向此合集添加链接",
+  "bundles.allLinksAdded": "所有链接都已在此合集中。",
+  "bundles.removeFromBundle": "从合集移除",
+  "bundles.noLinks": "此合集还没有链接。",
+  "bundles.countries": "国家/地区",
+  "bundles.devices": "设备",
+  "bundles.os": "操作系统",
+  "bundles.browsers": "浏览器",
+  "bundles.referrers": "来源",
+  "bundles.accessMode": "访问方式",
+  "bundles.directLink": "直接链接",
+  "bundles.qrScan": "二维码扫描",
+  "bundles.combined": "合计",
+  "bundles.tipLabel": "提示",
+  "bundles.tipUtm": "为合集内的每条链接添加 UTM 参数，就能在 shrtnr 里直接看出哪个渠道为该项目带来了最多互动。",
+  "bundles.editBundle": "编辑合集",
+  "bundles.archive": "归档",
+  "bundles.unarchive": "取消归档",
+  "bundles.delete": "删除",
+  "bundles.archived": "已归档",
+  "bundles.createdBy": "创建者",
+  "bundles.createdOn": "创建于",
+  "bundles.formName": "名称",
+  "bundles.formDescription": "描述",
+  "bundles.formIcon": "图标",
+  "bundles.formAccent": "强调色",
+  "bundles.formNameHint": "例如：shrtnr（开源）",
+  "bundles.formDescriptionHint": "这个合集用来做什么？",
+  "bundles.create": "创建合集",
+  "bundles.save": "保存",
+  "bundles.cancel": "取消",
+  "bundles.backToBundles": "返回合集列表",
+  "bundles.backToBundle": "返回合集",
+  "bundles.selectLink": "选择链接",
+  "bundles.linkAlreadyInBundle": "已在此合集中",
+  "bundles.accent.orange": "橙色",
+  "bundles.accent.red": "红色",
+  "bundles.accent.green": "绿色",
+  "bundles.accent.blue": "蓝色",
+  "bundles.accent.purple": "紫色",
+
+  // API Keys
+  "keys.title": "API 密钥",
+  "keys.subtitle": "管理对短链 API 的程序化访问",
+  "keys.docsLink": "API 文档",
+  "keys.authBanner": "在 {header} 请求头中携带密钥来验证请求。",
+  "keys.quickStartTitle": "快速开始",
+  "keys.quickStartHint": "使用 Bearer 密钥列出你的链接。",
+  "keys.sdkCardTitle": "或使用 SDK",
+  "keys.copyCommand": "复制命令",
+  "keys.newKey": "新建密钥",
+  "keys.empty": "暂无 API 密钥。使用上方的“+ 新建密钥”按钮即可启用程序化访问。",
+  "keys.colTitle": "标题",
+  "keys.colKey": "密钥",
+  "keys.colScope": "权限范围",
+  "keys.colCreated": "创建时间",
+  "keys.colLastUsed": "最后使用",
+  "keys.never": "从未",
+
+  // Settings
+  "settings.title": "设置",
+  "settings.subtitle": "配置你的短链接服务",
+  "settings.language": "语言",
+  "settings.theme": "主题",
+  "settings.themeOddbit": "Oddbit",
+  "settings.themeDark": "深色",
+  "settings.themeLight": "浅色",
+  "settings.defaultRange": "默认时间范围",
+  "settings.defaultRangeHint": "未选择范围时，应用于所有分析页面。",
+  "settings.slugLength": "默认短码长度",
+  "settings.analyticsFilters": "分析筛选",
+  "settings.filterBots": "过滤机器人流量",
+  "settings.filterBotsHint": "在所有分析视图中排除被标记为机器人或爬虫的点击。",
+  "settings.filterSelfReferrers": "过滤自身来源",
+  "settings.filterSelfReferrersHint": "排除 Referer 为本站裸域名的点击（站内跳转）。",
+  "settings.save": "保存",
+  "settings.combos": "{count} 种可能组合",
+  "settings.minLength": "最短长度为 3 个字符",
+  "settings.version": "版本",
+  "settings.account": "账户",
+  "settings.checkingUpdates": "正在检查更新...",
+  "settings.installApp": "安装应用",
+  "settings.integrations": "集成",
+  "settings.sdksTitle": "SDK",
+  "settings.sdksDesc": "用你自己的代码管理链接。以程序化方式创建、更新、停用链接并读取点击分析。",
+  "settings.sdkTsLang": "TypeScript",
+  "settings.sdkTsPkg": "npm: @oddbit/shrtnr",
+  "settings.sdkPythonLang": "Python",
+  "settings.sdkPythonPkg": "PyPI: shrtnr",
+  "settings.sdkDartLang": "Dart",
+  "settings.sdkDartPkg": "pub.dev: shrtnr",
+  "settings.mcpTitle": "MCP 服务器",
+  "settings.mcpDesc": "让 AI 助手访问你的链接。支持 Claude Desktop 和 VS Code 中的 GitHub Copilot。",
+  "settings.mcpOAuth": "MCP OAuth",
+  "settings.mcpConfigured": "已配置",
+  "settings.mcpNotConfigured": "未配置。请设置所需的密钥，为 MCP 端点启用 OAuth。",
+  "settings.mcpDocsLink": "MCP 文档",
+  "settings.mcpSetupLink": "README 中的安装指南",
+  "settings.apiTitle": "API",
+  "settings.apiDesc": "直接调用 REST API。在文档中浏览端点、数据结构并试用请求。",
+  "settings.apiDocsLink": "API 文档",
+
+  // Widget
+  "widget.error": "无法加载此面板。",
+  "widget.retry": "重试",
+
+  // Months (short)
+  "month.jan": "1月",
+  "month.feb": "2月",
+  "month.mar": "3月",
+  "month.apr": "4月",
+  "month.may": "5月",
+  "month.jun": "6月",
+  "month.jul": "7月",
+  "month.aug": "8月",
+  "month.sep": "9月",
+  "month.oct": "10月",
+  "month.nov": "11月",
+  "month.dec": "12月",
+
+  // Time ranges
+  "range.24h": "24小时",
+  "range.7d": "7天",
+  "range.30d": "30天",
+  "range.90d": "90天",
+  "range.1y": "1年",
+  "range.all": "全部",
+  "range.long.24h": "24 小时",
+  "range.long.7d": "7 天",
+  "range.long.30d": "30 天",
+  "range.long.90d": "90 天",
+  "range.long.1y": "12 个月",
+  "range.long.all": "全部时间",
+  "range.ariaLabel": "选择时间范围",
+
+  // 404
+  "notFound.label": "未找到",
+
+  // Client-side strings
+  "client.copied": "已复制 {url}",
+  "client.themeUpdated": "主题已更新",
+  "client.themeError": "保存主题失败",
+  "client.languageUpdated": "语言已更新",
+  "client.languageError": "保存语言失败",
+  "client.pasteUrl": "请先粘贴 URL",
+  "client.linkCreatedCopied": "链接已创建并复制！",
+  "client.createLinkError": "创建链接失败",
+  "client.cancel": "取消",
+  "client.urlRequired": "请输入 URL",
+  "client.createApiKey": "创建 API 密钥",
+  "client.keyTitleLabel": "标题 *",
+  "client.keyScopeLabel": "权限范围 *",
+  "client.scopeCreate": "创建",
+  "client.scopeCreateDesc": "可以缩短 URL",
+  "client.scopeRead": "读取",
+  "client.scopeReadDesc": "可以列出链接和分析数据",
+  "client.scopeCreateRead": "创建 + 读取",
+  "client.scopeCreateReadDesc": "完整 API 访问权限",
+  "client.createKey": "创建密钥",
+  "client.titleRequired": "请输入标题",
+  "client.selectScope": "请选择权限范围",
+  "client.createKeyError": "创建密钥失败",
+  "client.keyCreated": "密钥已创建",
+  "client.keyCreatedDesc": "请立即复制你的 API 密钥。它不会再次显示。",
+  "client.keyWarning": "请妥善保管此密钥。之后将无法再次获取。",
+  "client.copy": "复制",
+  "client.done": "完成",
+  "client.apiKeyCopied": "已复制 API 密钥",
+  "client.codeCopied": "已复制命令",
+  "client.confirmDeleteKey": "删除 API 密钥“{title}”？此操作无法撤销。",
+  "client.keyDeleted": "密钥已删除",
+  "client.keyDeleteError": "删除密钥失败",
+  "client.confirmDisable": "停用此链接？停用后将立即停止跳转。",
+  "client.linkDisabled": "链接已停用",
+  "client.disableError": "停用失败",
+  "client.linkDeleted": "链接已删除",
+  "client.deleteError": "删除失败",
+  "client.linkEnabled": "链接已启用",
+  "client.enableError": "启用失败",
+  "client.customAdded": "自定义短码已添加",
+  "client.slugDeleted": "短码已删除",
+  "client.customError": "添加自定义短码失败",
+  "client.setPrimaryError": "设置主短码失败",
+  "client.deleteSlugError": "删除短码失败",
+  "client.disableSlugError": "停用短码失败",
+  "client.enableSlugError": "启用短码失败",
+  "client.expiryUpdated": "到期时间已更新",
+  "client.expiryError": "更新失败",
+  "client.expiryCleared": "已清除到期时间",
+  "client.expiryClearError": "清除到期时间失败",
+  "client.labelUpdated": "标签已更新",
+  "client.labelError": "更新标签失败",
+  "client.close": "关闭",
+  "client.qrCode": "二维码",
+  "client.downloadSvg": "SVG",
+  "client.downloadPng": "PNG",
+  "client.minSlugLength": "短码长度至少为 3",
+  "client.settingsSaved": "设置已保存",
+  "client.settingsError": "保存设置失败",
+  "client.combos": "{count} 种可能组合",
+  "client.minLength": "最短长度为 3 个字符",
+  "client.updateAvailable": "可更新",
+  "client.releaseNotes": "更新日志",
+  "client.viewRepo": "查看仓库",
+  "client.updateHint": "更新方法：在 GitHub 上同步你的 fork，部署会自动重新部署。",
+  "client.upToDate": "已是最新",
+  "client.whatsNew": "新功能",
+  "client.updateCheckFailed": "无法检查更新",
+  "client.bundles.saveError": "保存合集失败",
+  "client.bundles.createError": "创建合集失败",
+  "client.bundles.deleteError": "删除合集失败",
+  "client.bundles.selectBundles": "选择合集",
+  "client.bundles.addToExisting": "添加到已有合集",
+  "client.bundles.createNew": "新建合集…",
+  "client.bundles.noBundles": "你还没有任何合集。创建一个来归组你的链接。",
+  "client.bundles.updated": "合集成员已更新",
+  "client.bundles.created": "合集已创建",
+  "client.bundles.deleted": "合集已删除",
+  "client.bundles.confirmDelete": "删除合集“{name}”？其中的链接不会被删除。",
+  "client.bundles.confirmArchive": "归档合集“{name}”？",
+  "client.bundles.archived": "合集已归档",
+  "client.bundles.unarchived": "合集已取消归档",
+
+  // Language names (displayed in their own language)
+  "lang.en": "English",
+  "lang.id": "Bahasa Indonesia",
+  "lang.sv": "Svenska",
+  "lang.zh": "简体中文",
+
+  // Language names (translated into this locale)
+  "langLocal.en": "英语",
+  "langLocal.id": "印度尼西亚语",
+  "langLocal.sv": "瑞典语",
+  "langLocal.zh": "简体中文",
+};
+
+export default zh;

From 091145aa6b1c5448e603aeaf0f38d815a792b3fb Mon Sep 17 00:00:00 2001
From: wurongjie <wurongjie@uniontech.com>
Date: Wed, 14 Oct 2026 17:12:45 +0800
Subject: [PATCH 2/6] fix(i18n): make the locale table exhaustive over
 SupportedLanguage

The map was typed Record<string, Translations>, so a language could join
SUPPORTED_LANGUAGES with no table here and still compile: TypeScript was
satisfied, isSupportedLanguage said yes, getTranslations returned
undefined, the per-language client script was built as `var T = undefined;`
at module init, and createTranslateFn threw on the first t() call. That
500s every admin page for the viewer who selected the language.

Record<SupportedLanguage, Translations> turns the missing entry into a
build failure. Raised in review; the same map in browser-extensions already
uses the union.
---
 src/i18n/index.ts | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/i18n/index.ts b/src/i18n/index.ts
index 393ac27b..86de8580 100644
--- a/src/i18n/index.ts
+++ b/src/i18n/index.ts
@@ -14,7 +14,11 @@ export const DEFAULT_LANGUAGE = "en";
 export const SUPPORTED_LANGUAGES = ["en", "id", "sv", "zh"] as const;
 export type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
 
-const translations: Record<string, Translations> = { en, id, sv, zh };
+// Keyed by the union rather than by string: a language added to
+// SUPPORTED_LANGUAGES without a table here fails the typecheck instead of
+// serving `undefined` through getTranslations, which would put `var T =
+// undefined;` in that language's client script and throw on the first t().
+const translations: Record<SupportedLanguage, Translations> = { en, id, sv, zh };
 
 export function isSupportedLanguage(lang: string): lang is SupportedLanguage {
   return SUPPORTED_LANGUAGES.includes(lang as SupportedLanguage);

From 4ac4cb84b7e423b28a5a4880b02e746afc56c26b Mon Sep 17 00:00:00 2001
From: wurongjie <wurongjie@uniontech.com>
Date: Wed, 14 Oct 2026 17:12:45 +0800
Subject: [PATCH 3/6] fix(assets): recognize a language-shaped client script
 path

SCRIPT_PATH hardcoded a two-letter code, [a-z]{2}, while the comment above
the module promised one script for every language registered in
SUPPORTED_LANGUAGES. A locale with a subtag (zh-Hant, pt-BR) would build
its asset and serve it from byPath, but a document from another build
asking for it during a deploy window missed the regex and got a 404
instead of the no-store fallback this module exists to provide.

The segment is matched loosely now, and isSupportedLanguage stays the gate
that decides which codes this build holds a script for. The test's copy of
the regex is widened with it, the `zh` URL locals that shadowed the zh
translation table are renamed, and the branded 404 case gains a subtagged
code so it pins that the refusal comes from the supported-language check
rather than from the shape of the path.
---
 src/__tests__/handler/admin-assets.test.ts | 25 +++++++++++++++-------
 src/assets.ts                              | 12 +++++++++--
 2 files changed, 27 insertions(+), 10 deletions(-)

diff --git a/src/__tests__/handler/admin-assets.test.ts b/src/__tests__/handler/admin-assets.test.ts
index dfb490cd..104b6440 100644
--- a/src/__tests__/handler/admin-assets.test.ts
+++ b/src/__tests__/handler/admin-assets.test.ts
@@ -23,7 +23,7 @@ async function pageHtml(path: string, headers?: Record<string, string>): Promise
 }
 
 const STYLESHEET = /<link rel="stylesheet" href="(\/_\/assets\/admin\.[0-9a-f]{8,}\.css)"\s*\/?>/;
-const SCRIPT = /<script src="(\/_\/assets\/client\.([a-z]{2})\.[0-9a-f]{8,}\.js)"><\/script>/;
+const SCRIPT = /<script src="(\/_\/assets\/client\.([A-Za-z-]+)\.[0-9a-f]{8,}\.js)"><\/script>/;
 
 beforeAll(applyMigrations);
 beforeEach(resetData);
@@ -84,12 +84,12 @@ describe("GET /_/assets/*", () => {
   });
 
   it("gives each language its own script URL", async () => {
-    const en = (await pageHtml("/_/admin/settings")).match(SCRIPT)![1];
-    const sv = (await pageHtml("/_/admin/settings", { Cookie: "lang=sv" })).match(SCRIPT)![1];
-    const zh = (await pageHtml("/_/admin/settings", { Cookie: "lang=zh" })).match(SCRIPT)![1];
-    expect(en).not.toBe(sv);
-    expect(en).not.toBe(zh);
-    expect(sv).not.toBe(zh);
+    const enUrl = (await pageHtml("/_/admin/settings")).match(SCRIPT)![1];
+    const svUrl = (await pageHtml("/_/admin/settings", { Cookie: "lang=sv" })).match(SCRIPT)![1];
+    const zhUrl = (await pageHtml("/_/admin/settings", { Cookie: "lang=zh" })).match(SCRIPT)![1];
+    expect(enUrl).not.toBe(svUrl);
+    expect(enUrl).not.toBe(zhUrl);
+    expect(svUrl).not.toBe(zhUrl);
   });
 
   it("serves the Simplified Chinese client script to a lang=zh viewer", async () => {
@@ -120,7 +120,16 @@ describe("GET /_/assets/*", () => {
   });
 
   it("answers the branded 404 for a path that names no asset of this app", async () => {
-    for (const path of ["/_/assets/client.xx.0000000000000000.js", "/_/assets/vendor.js", "/_/assets/admin.css"]) {
+    // "zh-Hant" is language-shaped but not registered, so it has to be the
+    // supported-language check that refuses it, not the shape of the path.
+    // A locale that ever registers such a code gets the no-store fallback
+    // during a deploy window instead of this 404.
+    for (const path of [
+      "/_/assets/client.xx.0000000000000000.js",
+      "/_/assets/client.zh-Hant.0000000000000000.js",
+      "/_/assets/vendor.js",
+      "/_/assets/admin.css",
+    ]) {
       const res = await SELF.fetch(req(path));
       expect(res.status, path).toBe(404);
       expect(res.headers.get("Content-Type"), path).toContain("text/html");
diff --git a/src/assets.ts b/src/assets.ts
index 5a64634b..a5b1429c 100644
--- a/src/assets.ts
+++ b/src/assets.ts
@@ -14,7 +14,9 @@
  * client script embeds it) and with the translations (one script per
  * language). The asset set is fixed for the life of the isolate, so each
  * asset is built once at module init and served from a map: every language
- * registered in SUPPORTED_LANGUAGES costs one script built here.
+ * registered in SUPPORTED_LANGUAGES costs one script built here, whatever
+ * the code's shape (a two-letter code today, a subtagged one if a locale
+ * ever needs it).
  *
  * A deploy reaches colos one at a time, so for a short window a document
  * from the new build can request its assets from an isolate on the old one
@@ -90,7 +92,13 @@ export function adminClientScriptPath(lang: string): string {
 }
 
 const STYLESHEET_PATH = /^\/_\/assets\/admin\.[0-9a-f]+\.css$/;
-const SCRIPT_PATH = /^\/_\/assets\/client\.([a-z]{2})\.[0-9a-f]+\.js$/;
+// The language segment is matched loosely, as any language-shaped code: a
+// subtagged code such as "zh-Hant" or "pt-BR" is recognized here even though
+// no such locale exists yet, so a build that ever registers one serves the
+// no-store fallback during a deploy window instead of a 404.
+// isSupportedLanguage below is the gate that decides which codes this build
+// actually holds a script for.
+const SCRIPT_PATH = /^\/_\/assets\/client\.([A-Za-z-]+)\.[0-9a-f]+\.js$/;
 
 /** The asset another build of this app would have emitted at the path, if the path names one. */
 function sameAssetFromThisBuild(path: string): Asset | undefined {

From 88beabb7a12b9c4d5bea7f4451b8754048ae9d01 Mon Sep 17 00:00:00 2001
From: wurongjie <wurongjie@uniontech.com>
Date: Wed, 14 Oct 2026 17:12:46 +0800
Subject: [PATCH 4/6] test(i18n): pin zh rather than the en-US fallback

Three defects in the assertions this locale added or touched.

format.test.ts asserted fmtNumber(1234567, "zh") === "1,234,567", the exact
output a runtime without zh ICU data produces through the en-US fallback,
so the case held whether or not zh resolved and could not catch the
regression its comment claimed to guard. It asserts the locale the
formatter resolved, then the digits.

i18n.test.ts computed the list of translated languages twice, so a change
to the default language or to the exclusion rule had to be made in two
places. Both suites read one module-scope list.

lists all supported languages checked three toContain calls while the
parity suites iterate SUPPORTED_LANGUAGES, so a locale trimmed from the
array left it green and the parity cases simply stopped running. It
asserts the exact array.
---
 src/__tests__/unit/format.test.ts |  8 +++++---
 src/__tests__/unit/i18n.test.ts   | 18 ++++++++++++------
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/src/__tests__/unit/format.test.ts b/src/__tests__/unit/format.test.ts
index 5798426f..6e8b93d0 100644
--- a/src/__tests__/unit/format.test.ts
+++ b/src/__tests__/unit/format.test.ts
@@ -21,9 +21,11 @@ describe("fmtNumber", () => {
   });
 
   it("groups thousands for zh", () => {
-    // Chinese groups with commas like en. Pinned so a locale whose ICU data is
-    // missing, and which therefore falls back to the runtime default, is a
-    // deliberate decision rather than a surprise.
+    // Chinese groups with commas like en, so the output alone cannot tell a
+    // resolved zh locale from the en-US fallback the runtime uses when it has
+    // no zh ICU data. Assert the locale the formatter actually resolved, then
+    // the digits it produced.
+    expect(new Intl.NumberFormat("zh").resolvedOptions().locale).toMatch(/^zh/);
     expect(fmtNumber(1234567, "zh")).toBe("1,234,567");
   });
 
diff --git a/src/__tests__/unit/i18n.test.ts b/src/__tests__/unit/i18n.test.ts
index 79390a54..53f8d7f8 100644
--- a/src/__tests__/unit/i18n.test.ts
+++ b/src/__tests__/unit/i18n.test.ts
@@ -23,6 +23,14 @@ function placeholders(value: string): string[] {
   return [...(value.match(/\{[a-zA-Z0-9_]+\}/g) ?? [])].sort();
 }
 
+/**
+ * Every supported language except the fallback. Derived once here: the
+ * placeholder and key-parity suites both iterate it, so a change to the
+ * default language or to the exclusion rule lands in one place instead of
+ * two copies that drift apart.
+ */
+const translated = SUPPORTED_LANGUAGES.filter((lang) => lang !== DEFAULT_LANGUAGE);
+
 describe("i18n", () => {
   describe("isSupportedLanguage", () => {
     it("returns true for supported languages", () => {
@@ -71,8 +79,6 @@ describe("i18n", () => {
     // types the placeholders inside a value, so a locale can keep the key and
     // silently drop the interpolation the key exists for. Driven off
     // SUPPORTED_LANGUAGES so a new locale is covered the day it is registered.
-    const translated = SUPPORTED_LANGUAGES.filter((lang) => lang !== DEFAULT_LANGUAGE);
-
     it.each(translated)("keeps every %s placeholder that en declares", (lang) => {
       const locale = getTranslations(lang);
       for (const key of Object.keys(en) as (keyof typeof en)[]) {
@@ -148,15 +154,15 @@ describe("i18n", () => {
     });
 
     it("lists all supported languages", () => {
-      expect(SUPPORTED_LANGUAGES).toContain("en");
-      expect(SUPPORTED_LANGUAGES).toContain("id");
-      expect(SUPPORTED_LANGUAGES).toContain("sv");
+      // The exact set, not one containment per language: a locale dropped from
+      // the array used to leave this test green, because its sibling parity
+      // suites iterate the array itself and would simply run one case fewer.
+      expect([...SUPPORTED_LANGUAGES]).toEqual(["en", "id", "sv", "zh"]);
     });
   });
 
   describe("key parity across locales", () => {
     const enKeys = new Set(flattenKeys(en));
-    const translated = SUPPORTED_LANGUAGES.filter((lang) => lang !== DEFAULT_LANGUAGE);
 
     it.each(translated)("locale %s has the same key set as en", (lang) => {
       const localeKeys = new Set(flattenKeys(getTranslations(lang)));

From 21bda93b39d7731da306885ed2e35d524af3230e Mon Sep 17 00:00:00 2001
From: wurongjie <wurongjie@uniontech.com>
Date: Wed, 14 Oct 2026 17:12:46 +0800
Subject: [PATCH 5/6] fix(i18n): name the filter in the zh empty-search message
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

"在{filter}中没有匹配“{query}”的链接。" substitutes the bare chip label,
so searching under the disabled chip read 在已停用中 with no noun: the
chip label is an adjective and the sentence needs what it modifies. The
placeholder set is unchanged.
---
 src/i18n/zh.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/i18n/zh.ts b/src/i18n/zh.ts
index 1950b903..1e6281e7 100644
--- a/src/i18n/zh.ts
+++ b/src/i18n/zh.ts
@@ -65,7 +65,7 @@ const zh: Translations = {
   "links.allDisabled": "所有链接均已停用。选择“已停用”筛选即可查看。",
   "links.noMatches": "没有符合当前筛选条件的链接。",
   "links.noSearchMatches": "没有匹配“{query}”的链接。",
-  "links.noSearchMatchesInFilter": "在{filter}中没有匹配“{query}”的链接。",
+  "links.noSearchMatchesInFilter": "在“{filter}”筛选下没有匹配“{query}”的链接。",
   "links.empty": "暂无链接。使用上方的“+ 新建链接”按钮开始。",
   "links.disabled": "已停用",
   "links.clicks": "次点击",

From 42e4d3ab4154b8f44f1682dec4a3b313974b1bed Mon Sep 17 00:00:00 2001
From: wurongjie <wurongjie@uniontech.com>
Date: Wed, 14 Oct 2026 17:12:46 +0800
Subject: [PATCH 6/6] docs: point the language list at its source

The feature line enumerated the admin languages by hand, which needs an
edit the next time a locale registers and drifts the first time one is
forgotten. The set lives in src/i18n/.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4d940e53..976c28fb 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@ The rest of the shortener:
 - **Labels from the page title.** A link created without a label gets the destination page's title fetched in the background, with private and internal hosts refused.
 - **QR codes** as SVG for any slug, from the admin UI, the API, the SDKs and MCP. Scans are tracked separately from link clicks.
 - **Edge redirects.** Slug lookups are cached in Workers KV in front of D1, and click recording runs after the redirect is sent.
-- **Admin dashboard** in English, Indonesian, Swedish and Simplified Chinese, with three themes, per-link and per-bundle analytics, API key management and settings.
+- **Admin dashboard** in four languages (see [`src/i18n/`](src/i18n/) for the set), with three themes, per-link and per-bundle analytics, API key management and settings.
 - **Browser extension** for Chrome and Firefox that shortens the current tab against your own deployment. Source and store status in [browser-extensions/README.md](browser-extensions/README.md).
 - **One-click deploy** with automatic provisioning of the database and KV namespace, and migrations that the Worker applies on its first request.