feat(i18n): add zh-tw locale, UI fixes, OpenCode convergence

* feat(i18n): add Traditional Chinese (zh-tw) locale support

- Add zh-tw.mjs generated via OpenCC + Taiwan vocab overrides
- Add tools/generate-zh-tw.mjs conversion script
- Register zh-tw in i18n.dict.mjs and LANGUAGE_META
- Update t() fallback chain: zh-tw -> zh -> en
- Add opencc-js as devDependency
- Add zh-tw tests (key parity, placeholders, fallback chain)

* fix(ui): narrow config overlay scope and remove sidebar version badge

- Config write overlay: fixed -> absolute, scoped to panel body
- Move overlay inside tool-config-write-body in codex/claude/opencode
- Remove v{{appVersion}} from sidebar brand kicker

* refactor(i18n): converge OpenCode tab copy and add lang.zh-tw keys

- Streamline 7 OpenCode descriptions across zh/en/ja/vi/zh-tw
- Add lang.zh-tw key to all locale files
- Recompile web-ui-render.precompiled.js

* chore(release): bump version to 0.0.47

Author: ymkiux

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "codexmate",
-  "version": "0.0.46",
+  "version": "0.0.47",
   "description": "Codex/Claude Code/OpenClaw 配置、会话与任务编排 CLI + Web 工具",
   "main": "cli.js",
   "bin": {
@@ -72,6 +72,7 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@vue/compiler-dom": "^3.5.30",
+    "opencc-js": "^1.3.1",
     "vitepress": "^1.6.4"
   }
 }

package.json

@@ -134,7 +134,7 @@ test('config template keeps expected config tabs in top and side navigation', ()
     assert.doesNotMatch(sideGhostTab, /@click=/);
     assert.doesNotMatch(sideGhostTab, /@keydown/);
     assert.ok(html.indexOf('id="side-tab-trash"') < html.indexOf('id="side-tab-new"'), 'ghost side tab should remain after trash tab to reserve end scroll space');
-    assert.match(html, /<div class="brand-kicker">Codex Mate<span v-if="appVersion" class="brand-version"> v\{\{ appVersion \}\}<\/span><\/div>/);
+    assert.match(html, /<div class="brand-kicker">Codex Mate<\/div>/);
     assert.match(html, /v-if="isAppVersionStatusVisible\(\)"[\s\S]*side-update-notice--'[\s\S]*appVersionStatusKind\(\)[\s\S]*@click="handleAppVersionStatusClick"/);
     assert.match(html, /<span class="side-update-title">\{\{\s*appUpdateNoticeText\(\)\s*\}\}<\/span>/);
     assert.match(html, /<span class="side-update-meta">\{\{\s*appUpdateNoticeMeta\(\)\s*\}\}<\/span>/);

tests/unit/config-tabs-ui.test.mjs

@@ -8,7 +8,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const repoRoot = path.resolve(__dirname, '..', '..');
 const localeDir = path.join(repoRoot, 'web-ui', 'modules', 'i18n', 'locales');
-const expectedLocales = ['zh', 'en', 'ja', 'vi'];
+const expectedLocales = ['zh', 'zh-tw', 'en', 'ja', 'vi'];
 
 function placeholders(value) {
     return [...String(value).matchAll(/\{(\w+)\}/g)]
@@ -131,3 +131,49 @@ test('builtin prompt templates re-localize when language changes', async () => {
     assert.strictEqual(jaDraft.name, DICT.ja['plugins.builtin.commentPolish.name']);
     assert(jaDraft.template.includes(DICT.ja['plugins.builtin.commentPolish.line1']));
 });
+
+test('zh-tw has same keys as zh', () => {
+    const zhKeys = Object.keys(DICT.zh).sort();
+    const twKeys = Object.keys(DICT['zh-tw']).sort();
+    assert.deepStrictEqual(twKeys, zhKeys, 'zh-tw must define exactly the same keys as zh');
+});
+
+test('zh-tw preserves placeholders from zh', () => {
+    for (const [key, value] of Object.entries(DICT['zh-tw'])) {
+        const zhValue = DICT.zh[key];
+        assert.deepStrictEqual(
+            placeholders(value),
+            placeholders(zhValue),
+            `zh-tw placeholder mismatch for key: ${key}`
+        );
+    }
+});
+
+test('zh-tw uses traditional Chinese characters', () => {
+    const tw = DICT['zh-tw'];
+    assert.strictEqual(tw['common.copy'], '複製');
+    assert.strictEqual(tw['common.edit'], '編輯');
+    assert.strictEqual(tw['common.delete'], '刪除');
+    assert.strictEqual(tw['common.loading'], '載入中...');
+    assert.strictEqual(tw['common.export'], '匯出');
+    assert.strictEqual(tw['common.import'], '匯入');
+    assert.strictEqual(tw['common.refresh'], '重新整理');
+    assert.strictEqual(tw['common.save'], '保存');
+    assert.strictEqual(tw['common.uninstall'], '解除安裝');
+    assert.strictEqual(tw['settings.language.title'], '語言');
+    assert.strictEqual(tw['lang.zh-tw'], '繁體中文');
+});
+
+test('zh-tw fallback resolves through zh before en', () => {
+    const table = DICT['zh-tw'] || DICT.zh;
+    const fallbackZh = DICT.zh;
+    const fallbackEn = DICT.en;
+    // Simulate the i18n.mjs t() fallback chain
+    const tFallback = (key) => {
+        return (table && table[key]) || (fallbackZh && fallbackZh[key]) || (fallbackEn && fallbackEn[key]) || key;
+    };
+    // For keys present in zh-tw, it should use zh-tw value (which differs from zh for UI terms)
+    assert.strictEqual(tFallback('common.copy'), DICT['zh-tw']['common.copy']);
+    // For a hypothetical missing key, it would fall back to zh then en
+    assert.strictEqual(tFallback('nonexistent.key.xyz'), 'nonexistent.key.xyz');
+});

tests/unit/i18n-locales.test.mjs

@@ -0,0 +1,62 @@
+import { readFileSync, writeFileSync } from 'fs';
+const OpenCC = (await import('opencc-js')).default;
+const converter = OpenCC.Converter({ from: 'cn', to: 'tw' });
+
+const src = readFileSync('web-ui/modules/i18n/locales/zh.mjs', 'utf8');
+
+// Taiwan vocab overrides (applied AFTER OpenCC cn→tw conversion)
+// Keys must be Traditional forms (post-OpenCC output)
+const OVERRIDES = [
+  ['服務器', '伺服器'],
+  ['設置', '設定'],
+  ['默認', '預設'],
+  ['當前', '目前'],
+  ['加載', '載入'],
+  ['導出', '匯出'],
+  ['導入', '匯入'],
+  ['自定義', '自訂'],
+  ['信息', '資訊'],
+  ['數據', '資料'],
+  ['視頻', '影片'],
+  ['内存', '記憶體'],
+  ['登錄', '登入'],
+  ['注銷', '登出'],
+  ['文件夾', '資料夾'],
+  ['網絡', '網路'],
+  ['打印', '列印'],
+  ['鼠標', '滑鼠'],
+  ['剪切', '剪下'],
+  ['搜索', '搜尋'],
+  ['替換', '取代'],
+  ['菜單', '選單'],
+  ['圖標', '圖示'],
+  ['配置', '設定'],
+  ['禁用', '停用'],
+  ['卸載', '解除安裝'],
+  ['发送', '傳送'],
+  ['啓用', '啟用'],
+  ['啓動', '啟動'],
+  ['啓', '啟'],
+  ['開啓', '開啟'],
+  ['重啓', '重新啟動'],
+  ['刷新', '重新整理'],
+];
+
+function postProcess(text) {
+  let r = text;
+  for (const [from, to] of OVERRIDES) {
+    r = r.split(from).join(to);
+  }
+  return r;
+}
+
+const converted = postProcess(converter(src));
+
+// Fix export name: const zh → const zhTw
+const fixed = converted
+  .replace(/^const zh = /m, 'const zhTw = ')
+  .replace(/^export \{ zh \};/m, 'export { zhTw };')
+  .replace(/^export default zh;/m, 'export default zhTw;');
+
+writeFileSync('web-ui/modules/i18n/locales/zh-tw.mjs', fixed, 'utf8');
+console.log('zh-tw.mjs generated, lines:', fixed.split('\n').length);

tools/generate-zh-tw.mjs

@@ -1,10 +1,12 @@
 import { zh } from './i18n/locales/zh.mjs';
+import { zhTw } from './i18n/locales/zh-tw.mjs';
 import { en } from './i18n/locales/en.mjs';
 import { ja } from './i18n/locales/ja.mjs';
 import { vi } from './i18n/locales/vi.mjs';
 
 const DICT = Object.freeze({
     zh,
+    'zh-tw': zhTw,
     en,
     ja,
     vi

web-ui/modules/i18n.dict.mjs

@@ -4,6 +4,7 @@ const I18N_STORAGE_KEY = 'codexmateLang';
 
 const LANGUAGE_META = Object.freeze([
     Object.freeze({ code: 'zh', nativeName: '中文', englishName: 'Chinese', htmlLang: 'zh-CN', dir: 'ltr' }),
+    Object.freeze({ code: 'zh-tw', nativeName: '繁體中文', englishName: 'Chinese-TW', htmlLang: 'zh-TW', dir: 'ltr' }),
     Object.freeze({ code: 'en', nativeName: 'English', englishName: 'English', htmlLang: 'en', dir: 'ltr' }),
     Object.freeze({ code: 'ja', nativeName: '日本語', englishName: 'Japanese', htmlLang: 'ja', dir: 'ltr' }),
     Object.freeze({ code: 'vi', nativeName: 'Tiếng Việt', englishName: 'Vietnamese', htmlLang: 'vi', dir: 'ltr' })
@@ -102,9 +103,9 @@ export function createI18nMethods() {
         t(key, params = null) {
             const lang = normalizeLang(this.lang);
             const table = DICT[lang] || DICT.zh;
-            const fallbackEn = DICT.en;
             const fallbackZh = DICT.zh;
-            const raw = (table && table[key]) || (fallbackEn && fallbackEn[key]) || (fallbackZh && fallbackZh[key]) || key;
+            const fallbackEn = DICT.en;
+            const raw = (table && table[key]) || (fallbackZh && fallbackZh[key]) || (fallbackEn && fallbackEn[key]) || key;
             return interpolate(raw, params);
         }
     };

web-ui/modules/i18n.mjs

@@ -1,6 +1,7 @@
 const en = Object.freeze({
     // Global
     'lang.zh': '中文',
+    'lang.zh-tw': '繁體中文',
     'lang.en': 'English',
     'lang.vi': 'Vietnamese',
     'lang.label': 'Language',
@@ -811,15 +812,15 @@ const en = Object.freeze({
     'toolConfig.claude.lockedDesc': 'Claude config will not be modified. Enable writes in this tab to add, apply, edit, or delete providers.',
     'toolConfig.claude.confirmMessage': 'After enabling this, apply actions in the Claude tab may write ~/.claude/settings.json and related Claude config.',
     'toolConfig.opencode.title': 'OpenCode config writes',
-    'toolConfig.opencode.desc': 'OpenCode config is read-only by default; enable this before writing the XDG OpenCode config file (for example ~/.config/opencode/opencode.jsonc).',
-    'toolConfig.opencode.lockedTitle': 'OpenCode config is read-only',
-    'toolConfig.opencode.lockedDesc': 'OpenCode config will not be modified until writes are enabled for this tab.',
+    'toolConfig.opencode.desc': 'Read-only by default; enable to write OpenCode config.',
+    'toolConfig.opencode.lockedTitle': 'Read-only',
+    'toolConfig.opencode.lockedDesc': 'Enable write access to save, import, or apply config.',
     'toolConfig.opencode.confirmMessage': 'After enabling this, actions in the OpenCode tab may write the XDG OpenCode config file (for example ~/.config/opencode/opencode.jsonc) or the file specified by OPENCODE_CONFIG.',
     'opencode.providerModel.title': 'OpenCode provider / model',
     'opencode.writeAria': 'OpenCode write access',
     'opencode.applySelection': 'Apply to OpenCode',
     'opencode.targetFile': 'Active OpenCode config: {path} · {status}',
-    'opencode.providerStoreFile': 'CodexMate provider store: {path} (multiple providers are stored here; only the selected provider is projected to OpenCode)',
+    'opencode.providerStoreFile': 'Provider draft store: {path} (written to OpenCode on apply)',
     'opencode.field.agent': 'Agent',
     'opencode.field.apiKeyKeep': 'API key (leave blank to keep current key)',
     'opencode.field.maxTokens': 'maxTokens (optional)',
@@ -828,15 +829,15 @@ const en = Object.freeze({
     'opencode.option.reasoningLow': 'low',
     'opencode.option.reasoningMedium': 'medium',
     'opencode.option.reasoningHigh': 'high',
-    'opencode.applyToCoreAgents': 'Apply to build / plan / general / title / summary / compaction',
+    'opencode.applyToCoreAgents': 'Apply to all core agents',
     'opencode.enableAutoCompaction': 'Enable compaction.auto',
     'opencode.disableProvider': 'Disable this provider',
     'opencode.configFile.title': 'OpenCode config file',
     'opencode.importParse': 'Import / parse file',
     'opencode.saveConfig': 'Save config',
     'opencode.parsedFile': 'Parsed: {file}',
-    'opencode.textarea.placeholder': 'View/edit ~/.config/opencode/opencode.jsonc here',
-    'opencode.configFile.hint': 'This is the active OpenCode config. CodexMate stores multiple provider drafts separately to avoid polluting native OpenCode config.',
+    'opencode.textarea.placeholder': 'Edit OpenCode config',
+    'opencode.configFile.hint': 'Active config preview; drafts stored in separate Provider store.',
     'opencode.summary.title': 'Parsed summary',
     'opencode.summary.noApiKey': 'No API key configured',
     'opencode.summary.noModel': 'No model set',

web-ui/modules/i18n/locales/en.mjs

@@ -2,6 +2,7 @@ const ja = Object.freeze({
 
     // Global
     'lang.zh': '中国語',
+    'lang.zh-tw': '繁體中文',
     'lang.en': 'English',
     'lang.vi': 'ベトナム語',
     'lang.label': '言語',
@@ -800,15 +801,15 @@ const ja = Object.freeze({
     'toolConfig.claude.lockedDesc': 'Claude 設定には書き込みません。追加・適用・編集・削除するには、このタブの書き込みを有効化してください。',
     'toolConfig.claude.confirmMessage': '有効化すると、Claude タブ内の適用操作が ~/.claude/settings.json などの Claude 設定を書き込みます。',
     'toolConfig.opencode.title': 'OpenCode 設定の書き込み',
-    'toolConfig.opencode.desc': '既定では OpenCode 設定を読み取り専用で表示します。有効化した場合のみ XDG OpenCode 設定ファイル（例: ~/.config/opencode/opencode.jsonc）に書き込みます。',
-    'toolConfig.opencode.lockedTitle': 'OpenCode 設定は読み取り専用です',
-    'toolConfig.opencode.lockedDesc': 'OpenCode 設定には書き込みません。保存・インポート・provider/model 適用には、このタブの書き込みを有効化してください。',
+    'toolConfig.opencode.desc': 'デフォルトは読み取り専用。有効化すると OpenCode 設定ファイルに書き込みます。',
+    'toolConfig.opencode.lockedTitle': '読み取り専用',
+    'toolConfig.opencode.lockedDesc': '書き込み権限を有効化すると、保存・インポート・設定の適用ができます。',
     'toolConfig.opencode.confirmMessage': '有効化すると、OpenCode タブ内の操作が XDG OpenCode 設定ファイル（例: ~/.config/opencode/opencode.jsonc）または OPENCODE_CONFIG 指定ファイルを書き込みます。',
     'opencode.providerModel.title': 'OpenCode provider / model',
     'opencode.writeAria': 'OpenCode 書き込み',
     'opencode.applySelection': 'OpenCode に適用',
     'opencode.targetFile': '有効な OpenCode 設定: {path} · {status}',
-    'opencode.providerStoreFile': 'CodexMate provider store: {path} (multiple providers are stored here; only the selected provider is projected to OpenCode)',
+    'opencode.providerStoreFile': 'プロバイダ下書きストア：{path}（適用時に OpenCode へ書き込み）',
     'opencode.field.agent': 'Agent',
     'opencode.field.apiKeyKeep': 'API Key（空なら既存 key を保持）',
     'opencode.field.maxTokens': 'maxTokens（任意）',
@@ -817,15 +818,15 @@ const ja = Object.freeze({
     'opencode.option.reasoningLow': 'low',
     'opencode.option.reasoningMedium': 'medium',
     'opencode.option.reasoningHigh': 'high',
-    'opencode.applyToCoreAgents': 'build / plan / general / title / summary / compaction に適用',
+    'opencode.applyToCoreAgents': 'すべてのコア agent に適用',
     'opencode.enableAutoCompaction': 'compaction.auto を有効化',
     'opencode.disableProvider': 'この provider を無効化',
     'opencode.configFile.title': 'OpenCode 設定ファイル',
     'opencode.importParse': 'ファイルをインポート/解析',
     'opencode.saveConfig': '設定を保存',
     'opencode.parsedFile': '解析済み: {file}',
-    'opencode.textarea.placeholder': 'ここで ~/.config/opencode/opencode.jsonc を表示/編集',
-    'opencode.configFile.hint': 'This is the active OpenCode config. CodexMate stores multiple provider drafts separately to avoid polluting native OpenCode config.',
+    'opencode.textarea.placeholder': 'OpenCode 設定を編集',
+    'opencode.configFile.hint': '有効設定のプレビュー。下書きは個別のプロバイダストアに保存されます。',
     'opencode.summary.title': '解析サマリー',
     'opencode.summary.noApiKey': 'API Key 未設定',
     'opencode.summary.noModel': 'model 未設定',

web-ui/modules/i18n/locales/ja.mjs

@@ -10,6 +10,7 @@ const vi = Object.freeze({
     'plugins.builtin.ruleAck.line1': 'Hãy làm theo【{{rule}}】, nhận được thì phản hồi',
     // Global
     'lang.zh': 'Tiếng Trung',
+    'lang.zh-tw': 'Tiếng Trung (Phồn thể)',
     'lang.en': 'Tiếng Anh',
     'lang.vi': 'Tiếng Việt',
     'lang.label': 'Ngôn ngữ',
@@ -163,15 +164,15 @@ const vi = Object.freeze({
     'toolConfig.claude.lockedDesc': 'Cấu hình Claude sẽ không bị sửa. Hãy bật ghi trong tab này để thêm, áp dụng, sửa hoặc xóa provider.',
     'toolConfig.claude.confirmMessage': 'Sau khi bật, thao tác áp dụng trong tab Claude có thể ghi ~/.claude/settings.json và cấu hình Claude liên quan.',
     'toolConfig.opencode.title': 'Ghi cấu hình OpenCode',
-    'toolConfig.opencode.desc': 'Cấu hình OpenCode mặc định chỉ đọc; bật công tắc này trước khi ghi file cấu hình XDG OpenCode (ví dụ ~/.config/opencode/opencode.jsonc).',
-    'toolConfig.opencode.lockedTitle': 'Cấu hình OpenCode đang chỉ đọc',
-    'toolConfig.opencode.lockedDesc': 'Cấu hình OpenCode sẽ không bị sửa cho đến khi bật ghi trong tab này.',
+    'toolConfig.opencode.desc': 'Mặc định chỉ đọc; bật để ghi cấu hình OpenCode.',
+    'toolConfig.opencode.lockedTitle': 'Chỉ đọc',
+    'toolConfig.opencode.lockedDesc': 'Bật quyền ghi để lưu, nhập hoặc áp dụng cấu hình.',
     'toolConfig.opencode.confirmMessage': 'Sau khi bật, thao tác trong tab OpenCode có thể ghi file cấu hình XDG OpenCode (ví dụ ~/.config/opencode/opencode.jsonc) hoặc file do OPENCODE_CONFIG chỉ định.',
     'opencode.providerModel.title': 'Provider / model OpenCode',
     'opencode.writeAria': 'Quyền ghi OpenCode',
     'opencode.applySelection': 'Áp dụng vào OpenCode',
     'opencode.targetFile': 'Cấu hình OpenCode đang có hiệu lực: {path} · {status}',
-    'opencode.providerStoreFile': 'Kho provider của CodexMate: {path} (nhiều provider được lưu tại đây; chỉ provider đã chọn được ghi sang OpenCode)',
+    'opencode.providerStoreFile': 'Kho nháp provider: {path} (ghi vào OpenCode khi áp dụng)',
     'opencode.field.agent': 'Agent',
     'opencode.field.apiKeyKeep': 'API Key (để trống để giữ key hiện tại)',
     'opencode.field.maxTokens': 'maxTokens (tùy chọn)',
@@ -180,15 +181,15 @@ const vi = Object.freeze({
     'opencode.option.reasoningLow': 'low',
     'opencode.option.reasoningMedium': 'medium',
     'opencode.option.reasoningHigh': 'high',
-    'opencode.applyToCoreAgents': 'Áp dụng cho build / plan / general / title / summary / compaction',
+    'opencode.applyToCoreAgents': 'Áp dụng cho tất cả agent cốt lõi',
     'opencode.enableAutoCompaction': 'Bật compaction.auto',
     'opencode.disableProvider': 'Tắt provider này',
     'opencode.configFile.title': 'File cấu hình OpenCode',
     'opencode.importParse': 'Nhập / phân tích file',
     'opencode.saveConfig': 'Lưu cấu hình',
     'opencode.parsedFile': 'Đã phân tích: {file}',
-    'opencode.textarea.placeholder': 'Xem/sửa ~/.config/opencode/opencode.jsonc tại đây',
-    'opencode.configFile.hint': 'Đây là cấu hình OpenCode đang hoạt động. CodexMate lưu riêng nhiều bản nháp theo từng provider để tránh ghi đè hoặc làm thay đổi cấu hình OpenCode gốc.',
+    'opencode.textarea.placeholder': 'Chỉnh sửa cấu hình OpenCode',
+    'opencode.configFile.hint': 'Xem trước cấu hình đang hoạt động; bản nháp lưu trong kho Provider riêng.',
     'opencode.summary.title': 'Tóm tắt đã phân tích',
     'opencode.summary.noApiKey': 'Chưa cấu hình API Key',
     'opencode.summary.noModel': 'Chưa đặt model',