feat: 更多介面語言（i18n 架構擴充，先加日文）

[kiki830621]

Problem

Original text:
「（例如淺色模式、更多語言、Magic Trackpad 判定） 這些直接加然後/idd-all」
— Source: 使用者對話（Claude Code session，2026-07-16）

現有 i18n 僅 zh-TW / en 兩份字典（src/i18n/strings.ts），Locale type 為 'zh-TW' | 'en'，切換 UI 是單一 toggle 鈕（兩語互換）。要支援第三種以上語言，架構需要微調。

Type

feature

Expected

• Locale 擴充為可增列清單；新增語言 = 新增一份字典，TypeScript 型別保證 key 完整性
• 切換 UI 從 toggle 改為語言選單（三語以上時 toggle 語意失效）
• detectLocale 依 navigator.language 前綴對應（ja → ja、zh → zh-TW、其他 → en）
• 第一批候選語言：日文（ja）
• 匯出 JSON 的 language 欄位隨之正確

Actual

兩語 toggle；Record<Locale, Strings> 僅兩個 key。

Impact

非中英語使用者的可用性；工具的國際觸及。

---

Surfaced via: /idd-issue multi-finding mode 2026-07-16T04:22:49.637Z from pasted-text:淺色模式、更多語言、Magic-Trackpad-判定
Action: create
Run log: .claude/.idd/issue-runs/2026-07-16T04:22:49.637Z.jsonl

Current Status

• Phase: verified（PR feat: 更多介面語言（i18n 架構擴充，先加日文） #6 verify-gated PASS, R2）
• Updated: 2026-07-16
• Next: 人工 review PR feat: 更多介面語言（i18n 架構擴充，先加日文） #6 → merge → /idd-close（不 auto-close）

[kiki830621]

Diagnosis

Type

feature

Root Cause / Analysis

需求拆解（對照現有 codebase）：

1. src/i18n/strings.ts：Locale 目前是 'zh-TW' | 'en' 封閉 union；加日文 = union 加 'ja' + 完整 ja 字典（Strings 介面型別保證 ~40 個 key 齊全）
2. src/i18n/index.ts：detectLocale 目前只認 zh 前綴與 stored 兩值；需加 ja 前綴對應與 stored === 'ja'
3. src/app.ts：語言切換目前是 toggle 鈕（兩語互換語意）；三語以上 toggle 失效，改 <select> 語言選單（中文／English／日本語），change 事件走 setLocale + applyI18n
4. langToggle 字串 key 廢棄，選單顯示各語言原生名稱
5. 匯出 JSON language 欄位走 getLocale()，自動正確

Impact

• 影響檔案：src/i18n/strings.ts、src/i18n/index.ts、src/app.ts、src/styles.css（選單樣式）、tests/i18n.test.ts、tests/main-layout.test.ts
• 使用者流程：語言切換 UI 形態改變（鈕→選單）；預設偵測行為向下相容

Strategy

• strings.ts：Locale 加 'ja' + ja 字典（TDD：三字典 key 完全一致）
• index.ts：detectLocale ja 前綴 + stored 白名單加 ja（TDD：ja-JP→ja、stored=ja 優先）
• app.ts：toggle 改 <select> 選單（TDD：renderApp 選單存在、change 換字）
• styles.css：.lang-btn 改 select 適配樣式
• 全測試綠 + build + 瀏覽器三語實測

Conflict Class

C_shared_module_coord — 共享資源：src/i18n/strings.ts 與 src/app.ts（#3 Magic Trackpad 亦需新增 UI 字串 key 於同檔）。batch 內相鄰序列化處理（#2 → #3），不交錯。

Complexity

Plan

• Hard-gate: triggered — 動到 shared abstraction：Locale / Strings 型別被 ≥6 檔引用（i18n/index、app、五個 panels 的 t()）；單一概念（三語架構）散佈約 6 檔（strings/index/app/styles + 2 test）
• Family-wide scope：所有 t() call site 與 data-i18n 消費端不需改（key 集不變、僅 langToggle 廢棄），已列入影響評估
• [Plan tier deliberation 將於 unattended 模式跳過，由 /idd-all 標記]

Risks

• ja 字典翻譯品質（AI 翻譯，建議之後由母語者過一輪——不阻擋）
• select 在深淺主題下的原生樣式差異

Residue

「更廣的國際觸及」為市場意圖，無法 operationalize 為驗收條件——標記不丟棄。

Vagueness Pre-check

• V1: 2 — 要做什麼明確（架構擴充 + 第一批日文）
• V4: 3 — 驗收可操作（key 一致性型別保證、三語實測）；「更多語言」的終態範圍開放但首批已定
• Triggered: no — both axes ≤ 3
• [Layer V: V1=2 V4=3, clarify-default skipped under unattended mode, defaulting to proceed]

[kiki830621]

Implementation Plan

• src/i18n/strings.ts — Locale 加 'ja'、新增日文字典；langToggle key 廢棄改 langSelectLabel（三語）（TDD：三字典 key 完全一致）
• src/i18n/index.ts — detectLocale 改白名單 stored + ja 前綴對應（TDD：ja-JP→ja、stored=ja、無效 stored fallback）
• src/app.ts — toggle 鈕改 <select> 語言選單（原生語言名：中文／English／日本語，不隨介面語言翻譯——語言名以自身語言呈現是 i18n 慣例），change 事件 setLocale + applyI18n + aria-label 重設（TDD：選單存在、預設值正確、切 en/ja 換字）
• src/styles.css — .lang-btn 適配 select
• 全測試綠 + build + 瀏覽器三語實測

[kiki830621]

Implementation Complete

Checklist (synced from TaskList)

• strings.ts：Locale 加 ja + 日文字典 + langSelectLabel（TDD：三字典 key 一致） → 0ae997e
• index.ts：detectLocale 白名單 + ja 前綴（TDD：9 案例） → 0ae997e
• app.ts：select 語言選單（TDD：選單存在/選項/切換換字 en+ja） → 0ae997e
• [~] styles.css select 適配 — skipped：.lang-btn 既有樣式對 select 直接適用，且刻意不動 styles.css 以避免與 PR feat: 淺色模式（light mode）支援 #4（全檔變數化）的合併衝突面
• 全測試綠（43/43 本 branch）+ build 通過 + 瀏覽器日文實測（切 ja 後全頁換字，含標題「Mac トラックパッド健康チェック」）

Changes

• 0ae997e feat: i18n 三語架構 — 新增日文、語言選單取代 toggle (feat: 更多介面語言（i18n 架構擴充，先加日文） #2)

Files Changed

5 files changed, 83 insertions(+), 23 deletions(-)

Scope Compliance

無超出範圍改動。注意：本 branch 自 main 分出，未含 PR #4 的淺色模式改動——兩 PR 皆動 UI 層但檔案交集僅 app.ts header 區塊，先 merge #4 後本 PR 需小幅 rebase（select 元素不受色板變數化影響）。

Next: verification pending

[kiki830621]

Verify (via PR #6, Round 1)

Result: FAIL — 1 blocking（Locale 單一來源，三 AI 獨立收斂）+ 3 in-scope fixes
Full report: #6 (comment)

依 unattended loop 進行修復後跑 Round 2。

[kiki830621]

Verify (via PR #6, Round 2)

Result: PASS — 0 blocking（Locale 單一來源結構性成立、日文潤飾自然、零 regression）
Full report: #6 (comment)