orca-zh-tw-installer 2.2.0 → 2.4.0

package/index.js

@@ -89,6 +89,7 @@ function createPatcher(label, filePath) {
   let code = fs.readFileSync(filePath, 'utf8');
   const ok = [];
   const failed = [];
+  const warned = [];
   return {
     label,
     /**
@@ -104,9 +105,25 @@ function createPatcher(label, filePath) {
       if (code === before || !done(code)) failed.push(name);
       else ok.push(name);
     },
+    /**
+     * 加值型修補：錨點找不到只警告，不讓整個安裝失敗。
+     *
+     * 語言切換與字典注入是核心，錨點壞了就必須中止——否則使用者會裝到一個
+     * 「看起來成功但沒效果」的語系包。但原生選單、快速鍵名稱、斜線命令說明
+     * 這些是額外的本地化，Orca 改了結構時頂多那部分維持英文，
+     * 不該連帶讓整包裝不起來。
+     */
+    patchOptional(name, done, find, repl) {
+      if (done(code)) { ok.push(`${name}（已存在）`); return; }
+      const before = code;
+      code = code.replace(find, repl);
+      if (code === before || !done(code)) warned.push(name);
+      else ok.push(name);
+    },
     save() { fs.writeFileSync(filePath, code); },
     get ok() { return ok; },
     get failed() { return failed; },
+    get warned() { return warned; },
   };
 }
 
@@ -182,7 +199,7 @@ const KEYBINDING_GROUP_SLUGS = {
 };
 
 function patchKeybindingTitles(p, translateFn) {
-  p.patch('快速鍵名稱與群組改走 i18n',
+  p.patchOptional('快速鍵名稱與群組改走 i18n',
     c => c.includes('keybindingGroup.'),
     // id 緊接 title、group、scope 是 keybinding 定義獨有的形狀。
     // 不能只比對 group:"…"——built-in／imported 等其他結構也有 group 欄位。
@@ -197,27 +214,91 @@ function patchKeybindingTitles(p, translateFn) {
     });
 }
 
+// ── 選項清單標籤本地化 ─────────────────────────────────────────────────
+// Orca 用 { id: "x", label: "English" } 描述選項清單，label 全是寫死的英文：
+//   DEFAULT_WORKSPACE_STATUSES   側邊欄／看板的狀態
+//   *_THINKING_LEVELS            推理強度與模型模式
+//
+// 只翻「通用形容詞」，模型與產品名一律保留英文（Claude、Sonnet、Cursor、
+// Kimi、GitHub Copilot、GPT-5 Mini、Antigravity、VS Code、Amp 的 Smart／
+// Rush、Cursor 的 Large／Deep 都不動）。
+//
+// 以 (id, label) 成對比對而非只看 id：同一個 id 在不同陣列裡可能是別的東西，
+// 成對比對才能確定是我們認得的那一個。
+const OPTION_LABELS = {
+  'todo|Todo': '待處理',
+  'in-progress|In progress': '進行中',
+  'in-review|In review': '待審查',
+  'completed|Done': '已完成',
+  'low|Low': '低',
+  'medium|Medium': '中',
+  'high|High': '高',
+  'xhigh|Extra High': '極高',
+  'max|Max': '最大',
+  'off|Off': '關',
+  'on|On': '開',
+  'auto|Auto': '自動',
+  'default|Config default': '設定檔預設',
+};
+
+function patchOptionLabels(p, translateFn) {
+  p.patchOptional('選項清單標籤改走 i18n',
+    c => c.includes('optionLabel.in-progress'),
+    /\{(\s*)id: "([a-z0-9-]+)",(\s*)label: "([^"]{1,40})"/g,
+    (m, s0, id, s1, label) => {
+      const en = OPTION_LABELS[`${id}|${label}`];
+      if (!en) return m;   // 不在白名單就整段不動
+      return `{${s0}id: ${JSON.stringify(id)},${s1}get label() { `
+        + `return ${translateFn}("optionLabel.${id}", ${JSON.stringify(label)}); }`;
+    });
+}
+
+// ── Agent 斜線命令說明本地化 ───────────────────────────────────────────
+// 在 Agent composer 輸入 / 時列出的命令清單，description 是 Orca 自己寫的
+// 說明文字，寫死在 COMMON_COMMANDS／CLAUDE_COMMANDS／CODEX_COMMANDS 裡。
+// name 是真的要送給 CLI 的命令，絕對不能動。
+//
+// 鍵用英文原文的 slug 而不是命令名：/clear、/compact、/init 在不同 agent
+// 有不同說明（Claude 的 /clear 是「Clear conversation history」，
+// Codex 的是「Clear the terminal and start a new chat」），
+// 用命令名當鍵會撞在一起。
+const slashKey = en => 'slashCommand.' + en
+  .replace(/[^A-Za-z0-9 ]/g, '')
+  .split(/\s+/)
+  .filter(Boolean)
+  .map((w, i) => i === 0 ? w.toLowerCase() : w[0].toUpperCase() + w.slice(1).toLowerCase())
+  .join('');
+
+function patchSlashCommands(p, translateFn) {
+  p.patchOptional('Agent 斜線命令說明改走 i18n',
+    c => c.includes('slashCommand.'),
+    /\{(\s*)name: "([a-z][a-z0-9:-]*)",(\s*)description: "((?:[^"\\]|\\.){2,80})"(\s*)\}/g,
+    (m, s0, name, s1, en, s2) =>
+      `{${s0}name: ${JSON.stringify(name)},${s1}get description() { `
+      + `return ${translateFn}(${JSON.stringify(slashKey(en))}, ${JSON.stringify(en)}); }${s2}}`);
+}
+
 function patchNativeMenus(p) {
-  p.patch('原生選單：為無 label 的 role 注入譯文',
+  p.patchOptional('原生選單：為無 label 的 role 注入譯文',
     c => c.includes('nativeMenu.selectAll'),
     /\{\s*role:\s*"([A-Za-z]+)"\s*\}/g,
     (m, role) => MENU_ROLE_LABELS[role]
       ? `{ role: "${role}", label: ${t(role, MENU_ROLE_LABELS[role])} }`
       : m);
 
-  p.patch('原生選單：Markdown 命令項改走 i18n',
+  p.patchOptional('原生選單：Markdown 命令項改走 i18n',
     c => c.includes('nativeMenu.addLink'),
     /markdownCommandItem\("([^"]+)"/g,
     (m, label) => MENU_MD_ITEMS[label]
       ? `markdownCommandItem(${t(MENU_MD_ITEMS[label], label)}`
       : m);
 
-  p.patch('原生選單：子選單標題改走 i18n',
+  p.patchOptional('原生選單：子選單標題改走 i18n',
     c => c.includes('nativeMenu.format'),
     /label:\s*"(Format|Paragraph|Insert)"/g,
     (m, label) => `label: ${t(MENU_SUBMENU_LABELS[label], label)}`);
 
-  p.patch('原生選單：貼上項改走 i18n',
+  p.patchOptional('原生選單：貼上項改走 i18n',
     c => c.includes('nativeMenu.pasteAsPlainText'),
     /editableContextPasteItem\("([^"]+)"/g,
     (m, label) => MENU_PASTE_ITEMS[label]
@@ -321,8 +402,27 @@ async function patch() {
     // 「設定 → 快速鍵」顯示的是 renderer 這份定義，所以只改這裡。
     // main process 也有一份，但那份不用於顯示，動它只增加風險。
     patchKeybindingTitles(rp, 'translate');
+    patchOptionLabels(rp, 'translate');
     rp.save();
 
+    // Agent 斜線命令的說明在另一個 chunk。檔名帶 hash（index-DlEnJ7xL.js），
+    // 每次 Orca 建置都會變，所以靠內容找而不是靠檔名。
+    // 那個 chunk 有 import { t as translate }，模組層可直接呼叫。
+    const slashFile = fs.readdirSync(assetsDir)
+      .filter(f => f.endsWith('.js'))
+      .map(f => path.join(assetsDir, f))
+      .find(f => {
+        try { return fs.readFileSync(f, 'utf8').includes('CODEX_COMMANDS'); } catch { return false; }
+      });
+    let sp = null;
+    if (slashFile) {
+      sp = createPatcher('slash commands', slashFile);
+      patchSlashCommands(sp, 'translate');
+      sp.save();
+    } else {
+      console.log('   ⚠️ 找不到含 CODEX_COMMANDS 的 chunk，斜線命令說明將維持英文。');
+    }
+
     console.log('📂 4/6 正在植入繁體中文字典 (ESM + CJS 兩種格式)...');
     const esmDict = path.join(__dirname, 'zh-TW-nested.js');
     const cjsDict = path.join(__dirname, 'zh-TW-nested.cjs.js');
@@ -334,13 +434,16 @@ async function patch() {
     fs.copyFileSync(cjsDict, path.join(chunksDir, 'zh-TW-nested.js'));
 
     console.log('🔎 5/6 正在驗證所有注入點...');
-    const allFailed = [
-      ...mp.failed.map(n => `[main] ${n}`),
-      ...rp.failed.map(n => `[renderer] ${n}`),
-    ];
-    for (const p of [mp, rp]) {
+    const patchers = sp ? [mp, rp, sp] : [mp, rp];
+    const allFailed = patchers.flatMap(p => p.failed.map(n => `[${p.label}] ${n}`));
+    const allWarned = patchers.flatMap(p => p.warned.map(n => `[${p.label}] ${n}`));
+    for (const p of patchers) {
       for (const n of p.ok) console.log(`   ✅ [${p.label}] ${n}`);
     }
+    // 加值型修補失敗只警告——那部分維持英文，但語言切換與字典照樣生效。
+    for (const n of allWarned) {
+      console.log(`   ⚠️ ${n}（錨點已變，該部分維持英文，其餘不受影響）`);
+    }
     if (allFailed.length) {
       for (const n of allFailed) console.error(`   ❌ ${n}`);
       throw new Error(
@@ -357,10 +460,12 @@ async function patch() {
     // node --check 會以 CommonJS 解析而誤判失敗。複製成 .mjs 再檢查。
     const probeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'orca-zh-tw-check-'));
     try {
-      for (const [label, file, ext] of [
+      const toCheck = [
         ['main process', mainFile, '.js'],
         ['renderer', rendererFile, '.mjs'],
-      ]) {
+      ];
+      if (slashFile) toCheck.push(['slash commands', slashFile, '.mjs']);
+      for (const [label, file, ext] of toCheck) {
         const probe = path.join(probeDir, 'probe' + ext);
         fs.copyFileSync(file, probe);
         try {

package/orca_zh_TW_translation.json

@@ -11289,5 +11289,67 @@
   "keybinding.terminal.closePane": "關閉使用中的窗格",
   "keybinding.terminal.splitRight": "向右分割終端機",
   "keybinding.terminal.splitDown": "向下分割終端機",
-  "keybinding.terminal.switchInputSource": "切換輸入來源／語言（原生）"
+  "keybinding.terminal.switchInputSource": "切換輸入來源／語言（原生）",
+  "optionLabel.todo": "待處理",
+  "optionLabel.in-progress": "進行中",
+  "optionLabel.in-review": "待審查",
+  "optionLabel.completed": "已完成",
+  "optionLabel.low": "低",
+  "optionLabel.medium": "中",
+  "optionLabel.high": "高",
+  "optionLabel.xhigh": "極高",
+  "optionLabel.max": "最大",
+  "optionLabel.off": "關",
+  "optionLabel.on": "開",
+  "optionLabel.auto": "自動",
+  "optionLabel.default": "設定檔預設",
+  "slashCommand.clearTheConversation": "清除對話",
+  "slashCommand.showAvailableCommands": "顯示可用命令",
+  "slashCommand.clearConversationHistory": "清除對話記錄",
+  "slashCommand.summarizeAndCompactTheConversation": "摘要並壓縮對話",
+  "slashCommand.initializeAClaudemd": "初始化 CLAUDE.md",
+  "slashCommand.reviewTheCurrentChanges": "審查目前的變更",
+  "slashCommand.chooseTheModelAndReasoningEffort": "選擇模型與推理強度",
+  "slashCommand.includeIdeContext": "納入 IDE 上下文",
+  "slashCommand.chooseWhatCodexIsAllowedToDo": "選擇 Codex 的權限範圍",
+  "slashCommand.remapTuiShortcuts": "重新對應 TUI 快速鍵",
+  "slashCommand.toggleVimMode": "切換 Vim 模式",
+  "slashCommand.toggleExperimentalFeatures": "切換實驗性功能",
+  "slashCommand.approveOneAutoreviewRetry": "核准一次自動審查重試",
+  "slashCommand.configureMemoryUse": "設定記憶體使用",
+  "slashCommand.manageAndUseSkills": "管理與使用技能",
+  "slashCommand.importSetupFromClaudeCode": "從 Claude Code 匯入設定",
+  "slashCommand.viewLifecycleHooks": "檢視生命週期掛鉤",
+  "slashCommand.renameTheCurrentThread": "重新命名目前的討論串",
+  "slashCommand.startANewChat": "開始新的聊天",
+  "slashCommand.archiveThisSessionAndExit": "封存此工作階段並結束",
+  "slashCommand.deleteThisSessionAndExit": "刪除此工作階段並結束",
+  "slashCommand.resumeASavedChat": "繼續已儲存的聊天",
+  "slashCommand.forkTheCurrentChat": "分支目前的聊天",
+  "slashCommand.continueInCodexDesktop": "在 Codex Desktop 中繼續",
+  "slashCommand.createAnAgentsmdFile": "建立 AGENTS.md 檔案",
+  "slashCommand.compactTheConversation": "壓縮對話",
+  "slashCommand.switchToPlanMode": "切換到計畫模式",
+  "slashCommand.setOrViewTheGoal": "設定或檢視目標",
+  "slashCommand.switchTheActiveAgentThread": "切換使用中的 Agent 討論串",
+  "slashCommand.startASideConversation": "開始側邊對話",
+  "slashCommand.copyTheLastResponseAsMarkdown": "以 Markdown 複製最後一則回應",
+  "slashCommand.toggleRawScrollbackMode": "切換原始回捲模式",
+  "slashCommand.showTheWorkingDiff": "顯示工作區差異",
+  "slashCommand.mentionAFile": "提及一個檔案",
+  "slashCommand.showSessionConfigurationAndUsage": "顯示工作階段設定與使用量",
+  "slashCommand.viewAccountUsage": "檢視帳號使用量",
+  "slashCommand.configureTheTerminalTitle": "設定終端機標題",
+  "slashCommand.configureTheStatusLine": "設定狀態列",
+  "slashCommand.chooseASyntaxHighlightingTheme": "選擇語法突顯主題",
+  "slashCommand.chooseOrHideTheTerminalPet": "選擇或隱藏終端機寵物",
+  "slashCommand.listConfiguredMcpTools": "列出已設定的 MCP 工具",
+  "slashCommand.browsePlugins": "瀏覽外掛",
+  "slashCommand.logOutOfCodex": "登出 Codex",
+  "slashCommand.exitCodex": "結束 Codex",
+  "slashCommand.sendLogsToMaintainers": "將記錄檔傳送給維護者",
+  "slashCommand.listBackgroundTerminals": "列出背景終端機",
+  "slashCommand.stopAllBackgroundTerminals": "停止所有背景終端機",
+  "slashCommand.clearTheTerminalAndStartANewChat": "清除終端機並開始新的聊天",
+  "slashCommand.chooseACommunicationStyle": "選擇溝通風格"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orca-zh-tw-installer",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Orca AI IDE 台灣繁體中文 (zh-TW) 一鍵安裝包",
   "main": "index.js",
   "bin": {

package/zh-TW-nested.cjs.js

@@ -14025,6 +14025,72 @@ const zhTW = {
       "splitDown": "向下分割終端機",
       "switchInputSource": "切換輸入來源／語言（原生）"
     }
+  },
+  "optionLabel": {
+    "todo": "待處理",
+    "in-progress": "進行中",
+    "in-review": "待審查",
+    "completed": "已完成",
+    "low": "低",
+    "medium": "中",
+    "high": "高",
+    "xhigh": "極高",
+    "max": "最大",
+    "off": "關",
+    "on": "開",
+    "auto": "自動",
+    "default": "設定檔預設"
+  },
+  "slashCommand": {
+    "clearTheConversation": "清除對話",
+    "showAvailableCommands": "顯示可用命令",
+    "clearConversationHistory": "清除對話記錄",
+    "summarizeAndCompactTheConversation": "摘要並壓縮對話",
+    "initializeAClaudemd": "初始化 CLAUDE.md",
+    "reviewTheCurrentChanges": "審查目前的變更",
+    "chooseTheModelAndReasoningEffort": "選擇模型與推理強度",
+    "includeIdeContext": "納入 IDE 上下文",
+    "chooseWhatCodexIsAllowedToDo": "選擇 Codex 的權限範圍",
+    "remapTuiShortcuts": "重新對應 TUI 快速鍵",
+    "toggleVimMode": "切換 Vim 模式",
+    "toggleExperimentalFeatures": "切換實驗性功能",
+    "approveOneAutoreviewRetry": "核准一次自動審查重試",
+    "configureMemoryUse": "設定記憶體使用",
+    "manageAndUseSkills": "管理與使用技能",
+    "importSetupFromClaudeCode": "從 Claude Code 匯入設定",
+    "viewLifecycleHooks": "檢視生命週期掛鉤",
+    "renameTheCurrentThread": "重新命名目前的討論串",
+    "startANewChat": "開始新的聊天",
+    "archiveThisSessionAndExit": "封存此工作階段並結束",
+    "deleteThisSessionAndExit": "刪除此工作階段並結束",
+    "resumeASavedChat": "繼續已儲存的聊天",
+    "forkTheCurrentChat": "分支目前的聊天",
+    "continueInCodexDesktop": "在 Codex Desktop 中繼續",
+    "createAnAgentsmdFile": "建立 AGENTS.md 檔案",
+    "compactTheConversation": "壓縮對話",
+    "switchToPlanMode": "切換到計畫模式",
+    "setOrViewTheGoal": "設定或檢視目標",
+    "switchTheActiveAgentThread": "切換使用中的 Agent 討論串",
+    "startASideConversation": "開始側邊對話",
+    "copyTheLastResponseAsMarkdown": "以 Markdown 複製最後一則回應",
+    "toggleRawScrollbackMode": "切換原始回捲模式",
+    "showTheWorkingDiff": "顯示工作區差異",
+    "mentionAFile": "提及一個檔案",
+    "showSessionConfigurationAndUsage": "顯示工作階段設定與使用量",
+    "viewAccountUsage": "檢視帳號使用量",
+    "configureTheTerminalTitle": "設定終端機標題",
+    "configureTheStatusLine": "設定狀態列",
+    "chooseASyntaxHighlightingTheme": "選擇語法突顯主題",
+    "chooseOrHideTheTerminalPet": "選擇或隱藏終端機寵物",
+    "listConfiguredMcpTools": "列出已設定的 MCP 工具",
+    "browsePlugins": "瀏覽外掛",
+    "logOutOfCodex": "登出 Codex",
+    "exitCodex": "結束 Codex",
+    "sendLogsToMaintainers": "將記錄檔傳送給維護者",
+    "listBackgroundTerminals": "列出背景終端機",
+    "stopAllBackgroundTerminals": "停止所有背景終端機",
+    "clearTheTerminalAndStartANewChat": "清除終端機並開始新的聊天",
+    "chooseACommunicationStyle": "選擇溝通風格"
   }
 };
 exports.default = zhTW;
@@ -14041,3 +14107,5 @@ exports.dashboard = zhTW.dashboard;
 exports.nativeMenu = zhTW.nativeMenu;
 exports.keybindingGroup = zhTW.keybindingGroup;
 exports.keybinding = zhTW.keybinding;
+exports.optionLabel = zhTW.optionLabel;
+exports.slashCommand = zhTW.slashCommand;

package/zh-TW-nested.js

@@ -14023,5 +14023,71 @@ export default {
       "splitDown": "向下分割終端機",
       "switchInputSource": "切換輸入來源／語言（原生）"
     }
+  },
+  "optionLabel": {
+    "todo": "待處理",
+    "in-progress": "進行中",
+    "in-review": "待審查",
+    "completed": "已完成",
+    "low": "低",
+    "medium": "中",
+    "high": "高",
+    "xhigh": "極高",
+    "max": "最大",
+    "off": "關",
+    "on": "開",
+    "auto": "自動",
+    "default": "設定檔預設"
+  },
+  "slashCommand": {
+    "clearTheConversation": "清除對話",
+    "showAvailableCommands": "顯示可用命令",
+    "clearConversationHistory": "清除對話記錄",
+    "summarizeAndCompactTheConversation": "摘要並壓縮對話",
+    "initializeAClaudemd": "初始化 CLAUDE.md",
+    "reviewTheCurrentChanges": "審查目前的變更",
+    "chooseTheModelAndReasoningEffort": "選擇模型與推理強度",
+    "includeIdeContext": "納入 IDE 上下文",
+    "chooseWhatCodexIsAllowedToDo": "選擇 Codex 的權限範圍",
+    "remapTuiShortcuts": "重新對應 TUI 快速鍵",
+    "toggleVimMode": "切換 Vim 模式",
+    "toggleExperimentalFeatures": "切換實驗性功能",
+    "approveOneAutoreviewRetry": "核准一次自動審查重試",
+    "configureMemoryUse": "設定記憶體使用",
+    "manageAndUseSkills": "管理與使用技能",
+    "importSetupFromClaudeCode": "從 Claude Code 匯入設定",
+    "viewLifecycleHooks": "檢視生命週期掛鉤",
+    "renameTheCurrentThread": "重新命名目前的討論串",
+    "startANewChat": "開始新的聊天",
+    "archiveThisSessionAndExit": "封存此工作階段並結束",
+    "deleteThisSessionAndExit": "刪除此工作階段並結束",
+    "resumeASavedChat": "繼續已儲存的聊天",
+    "forkTheCurrentChat": "分支目前的聊天",
+    "continueInCodexDesktop": "在 Codex Desktop 中繼續",
+    "createAnAgentsmdFile": "建立 AGENTS.md 檔案",
+    "compactTheConversation": "壓縮對話",
+    "switchToPlanMode": "切換到計畫模式",
+    "setOrViewTheGoal": "設定或檢視目標",
+    "switchTheActiveAgentThread": "切換使用中的 Agent 討論串",
+    "startASideConversation": "開始側邊對話",
+    "copyTheLastResponseAsMarkdown": "以 Markdown 複製最後一則回應",
+    "toggleRawScrollbackMode": "切換原始回捲模式",
+    "showTheWorkingDiff": "顯示工作區差異",
+    "mentionAFile": "提及一個檔案",
+    "showSessionConfigurationAndUsage": "顯示工作階段設定與使用量",
+    "viewAccountUsage": "檢視帳號使用量",
+    "configureTheTerminalTitle": "設定終端機標題",
+    "configureTheStatusLine": "設定狀態列",
+    "chooseASyntaxHighlightingTheme": "選擇語法突顯主題",
+    "chooseOrHideTheTerminalPet": "選擇或隱藏終端機寵物",
+    "listConfiguredMcpTools": "列出已設定的 MCP 工具",
+    "browsePlugins": "瀏覽外掛",
+    "logOutOfCodex": "登出 Codex",
+    "exitCodex": "結束 Codex",
+    "sendLogsToMaintainers": "將記錄檔傳送給維護者",
+    "listBackgroundTerminals": "列出背景終端機",
+    "stopAllBackgroundTerminals": "停止所有背景終端機",
+    "clearTheTerminalAndStartANewChat": "清除終端機並開始新的聊天",
+    "chooseACommunicationStyle": "選擇溝通風格"
   }
 };