orca-zh-tw-installer 1.0.10 → 1.2.0

package/README.md

@@ -30,8 +30,12 @@
 |------|------|
 | **一鍵跨平臺安裝** | 透過 `npx` 自動偵測作業系統並完成替換 |
 | **自動破解白名單** | 突破官方限制，將 `zh-TW` 寫入前端與核心白名單 |
-| **專業工程術語** | 翻譯精修，針對台灣開發者習慣用語（如 Worktree、終端機） |
-| **無痛備份機制** | 安裝前自動備份原始檔案（`app.asar.bak`），確保環境安全 |
+| **解除繁中強制降級** | 官方新版會把 `zh-TW`／`zh-HK`／`zh-Hant` 明確打回英文，本包一併解除 |
+| **原生選單也中文化** | 除了介面，系統匣、原生選單、系統對話框（main process）同樣套用繁中 |
+| **專業工程術語** | 對照 VS Code 官方 zh-TW 語系包精修，303 條術語鎖定表確保一詞一譯（如 存放庫、終端機、Worktree）|
+| **高曝光介面已逐句校對** | 側邊欄、原始碼控制、編輯器、狀態列、分頁等 3,502 句完成兩輪複查，修正約 2,500 處誤譯與不一致 |
+| **安裝後自動驗證** | 重新封裝前檢查全部注入點，任一失敗即中止且不改動 `app.asar`，不會「安裝成功卻沒效果」|
+| **無痛備份機制** | 首次安裝自動備份 `app.asar.bak`；重複執行會偵測既有補丁，不會用已修補版覆蓋乾淨備份 |
 | **自動追蹤更新** | npm 發布機制確保未來套用更新時始終取得最新版本 |
 
 ---
@@ -45,11 +49,24 @@ npx orca-zh-tw
 ```
 
 腳本將自動執行以下流程：
-1. 自動定位作業系統對應的 Orca 安裝路徑。
-2. 備份官方 `app.asar`。
-3. 解包並破解主程式與渲染器（Renderer）語言限制。
-4. 注入 11,000 句繁體中文字典檔。
-5. 重新封裝。
+1. 自動定位作業系統對應的 Orca 安裝路徑並解包。
+2. 備份官方 `app.asar`（已含補丁時會保留原本的乾淨備份）。
+3. 破解主程式（Main）語言限制與 locale 解析。
+4. 破解渲染器（Renderer）語言限制、下拉選單與 locale 解析。
+5. 注入 11,000 句繁體中文字典（ESM 給 Renderer、CJS 給 Main）。
+6. 驗證全部注入點後重新封裝。
+
+若想在不改動 Orca 的前提下先確認相容性（**可在 Orca 執行中安全使用**）：
+
+```bash
+npm run dry-run
+```
+
+安裝後可驗證實際封裝結果：
+
+```bash
+npm run verify
+```
 
 ---
 
@@ -89,9 +106,27 @@ npm start
 
 ### 檔案結構
 
-- `index.js`: 核心安裝腳本，處理 asar 解包、修補與封裝。
-- `zh-TW-nested.js`: Orca 前端讀取的最終編譯檔。
-- `orca_zh_TW_translation.json`: 原始語系字典檔，若欲改善翻譯可直接編輯此檔案。
+- `index.js`：核心安裝腳本，處理 asar 解包、修補、驗證與封裝。支援 `--dry-run`。
+- `orca_zh_TW_translation.json`：**唯一的翻譯來源**（扁平點分鍵）。改翻譯只改這個檔。
+- `zh-TW-nested.js`：由來源檔產生的 ESM 字典，供 Renderer 載入。**請勿手動編輯。**
+- `zh-TW-nested.cjs.js`：由來源檔產生的 CJS 字典，供 Main process 載入。**請勿手動編輯。**
+- `scripts/build-nested.js`：由 JSON 產生上述兩個字典檔。
+- `scripts/sweep-terms.js`：依術語鎖定表統一用詞，預設 dry-run。
+- `scripts/sweep-spacing.js`：中英之間補半形空格，預設 dry-run。
+- `scripts/verify-install.js`：驗證已安裝的 `app.asar` 是否含全部補丁與字典。
+
+### 改翻譯的流程
+
+`zh-TW-nested.js` 與 `zh-TW-nested.cjs.js` 都是**產生物**，編輯 JSON 後必須重新建置，
+否則安裝時不會生效：
+
+```bash
+# 1. 編輯 orca_zh_TW_translation.json
+# 2. 重新產生字典檔（兩種格式）
+npm run build
+# 3. 套用
+npm start
+```
 
 ---
 

package/TRANSLATION-PLAN.md

@@ -0,0 +1,363 @@
+# 翻譯改善計畫
+
+> Orca zh-TW 語系包的分批修訂計畫。中斷後接手請從「進度」往下讀。
+
+## 為什麼需要這份文件
+
+`orca_zh_TW_translation.json` 的 11,020 條字串中，**10,804 條（98%）在 `auto.*` 命名空間**，是機器批次產出的；
+只有 216 條是手工精修。`auto.*` 那批的品質問題不是「翻錯」，而是**同一個詞在不同地方譯法不一致**，
+以及少數簡繁轉換的機械殘留。
+
+這類問題無法靠「再翻一次」解決——需要一份強制的術語表，加上按模組逐批對照畫面檢查。
+
+## 進度
+
+| 階段 | 狀態 | 說明 |
+|---|---|---|
+| **Tier 0a** 術語統一 | ✅ 完成 | 26 條規則 / 761 處 |
+| **Tier 0b** 格式（空格／標點）| ✅ 完成 | 654 句 / 949 個空格 |
+| **Tier 0c** 第二輪術語＋損壞修復 | ✅ 完成 | 328 處。由批次 #1 審查暴露 |
+| **Tier 1** 高曝光介面 | ✅ 完成 | 批次 #1–#12（3,502 句）|
+| **Tier 2** 長文案 | ⬜ 未開始 | 批次 #13–#18（317 句但 30,898 字）|
+| **Tier 3** 設定頁 | ⬜ 未開始 | 批次 #19–#29（3,873 句）|
+| **Tier 4** 外部整合 | ⬜ 未開始 | 批次 #30–#36（1,960 句）|
+| **Tier 5** 長尾模組 | ⬜ 未開始 | 批次 #37–#39（1,152 句）|
+| **Tier 0** 手工精修區 | ⬜ 抽查即可 | 批次 #40（216 句），品質已達標 |
+
+批號以「分批清單」一節為準（由 `scripts/plan-batches.js` 產生）。改動資料後重跑產生器，
+批號可能位移——別把批號寫進 commit message 以外的地方。
+
+## 術語鎖定表
+
+單一真實來源：`~/.claude/skills/tw-translate/data/domains/lock.csv`（303 條）
+
+欄位 `tier` 的意義：
+
+- **A**：確定性替換，可機械 sweep
+- **B**：需上下文判斷，**不可**機械替換（例：`應用` 可能是 apply→套用，也可能是 application→應用程式）
+- **C**：已裁決的產品風格決定
+
+`forbidden` 欄支援 `re:` 前綴的正則，用於損壞修復與需要前後文條件的規則
+（例如 `re:(?<!來)源分支`）。**注意 CSV 以逗號分隔，正則量詞不能寫 `{2,}`**，
+要改寫成 `別+` 這種等價形式。
+
+`glossary.csv` 是**建議**，`lock.csv` 是**強制**。目前的用詞不一致就是因為過去只有建議、沒有強制。
+
+### 已裁決的產品風格（勿再更動）
+
+| 詞 | 決定 | 理由 |
+|---|---|---|
+| permission | **權限** | 台灣開發者慣用，不採 MS 的「許可權」 |
+| pull request | **保留英文 Pull Request** | 與既有的 Agent / Issue / Worktree 保留策略一致 |
+| stash | **保留英文 stash** | vscode-loc 的「隱藏項目」語意差 |
+| worktree | **保留英文 Worktree** | 產品既有策略 |
+| theme | **主題** | 「終端機主題」較自然，不採 VS Code 的「佈景主題」 |
+
+### 刻意不鎖的詞（勿當成錯誤去「修正」）
+
+| 詞 | 出現數 | 為何不改 |
+|---|---:|---|
+| 選擇 | 251 | 「選擇一個 Agent」是台灣自然用法；只有 selection/selected 才用「選取」 |
+| 帳號 | 95 | 台灣自然用法，且**已經全檔一致**（帳戶 0 處） |
+| 提交 | 118 | vscode-loc 確認 commit→提交 正確 |
+| 暫存 | 25 | vscode-loc 確認 stage→暫存 正確 |
+| 跳過 | 20 | 台灣同樣自然，MS 慣例才用「略過」 |
+| 截圖 | 17 | MS 的「螢幕擷取畫面」過於冗長 |
+
+## 分批原則
+
+**雙上限：每批 400 句 / 6,000 字，取先到者。**
+
+不能只用句數切，因為各模組句長差距達 14 倍：
+
+| 模組 | 句數 | 字/句 |
+|---|---:|---:|
+| `components.tab` | 157 | 7 |
+| `components.feature` | 317 | **97** |
+
+`feature` 只有 317 句卻佔全檔 20% 的字數。純照句數切，某幾批的實際工作量會是別批的十倍。
+
+**批次邊界貼齊模組**，這樣可以在 Orca 裡把那個畫面打開對照著看——那才是真正的品質關卡，比讀 JSON 有效得多。
+
+## 每批的作業流程
+
+**每批做完要複查兩輪**，兩輪的目的不同，不能合成一輪。批次 #1 的經驗是：
+第一輪找到 9 處、第二輪又找到 41 處，而且第二輪找到的是第一輪的規則抓不到的類型。
+
+```bash
+# ── 主要處理 ──
+# 1. 取出這批的實際內容（key + 現有譯文）
+node scripts/plan-batches.js --batch 7
+
+# 2. 對照 lock.csv 逐句檢查；在 Orca 裡打開對應畫面比對
+# 3. 直接編輯 orca_zh_TW_translation.json
+
+# ── 複查第一輪：機械 ──
+node scripts/audit-batch.js auto.components.right.sidebar   # 命名空間前綴
+npm run lint:terms      # 術語違規（dry-run）
+npm run lint:spacing    # 空格與標點（dry-run）
+
+# ── 複查第二輪：語意 ──
+# 重新讀一次這批（見下方「第二輪要找什麼」）
+
+# ── 收尾 ──
+npm run build
+npm start && npm run verify
+```
+
+### 第一輪複查：機械（`audit-batch.js`）
+
+偵測未翻譯、標點半形化、疑似截斷、同命名空間重複譯文、過長標籤、
+全形英數字、人稱混用。這輪的產出多半是**規則不夠廣**：
+
+> 批次 #1 第一輪找到 `函式程式庫` 3 處——那是 `庫→程式庫` 損壞的另一種形式。
+> 上一輪的規則只寫了 `儲存函式程式庫`，漏了 `資料函式程式庫`（應為資料庫）。
+> **同一個壞規則會有多個受害詞，修一個不等於修完。**
+
+#### 方法一：列出全部含該詞的字串，再逐一分類
+
+找到一個損壞後，**不要只修眼前那個**。用損壞詞的「正確形式」去撈全檔，
+把結果全部列出來人工分類成「損壞」與「正當」，才知道真實範圍。
+
+```bash
+# 例：發現「群群組」後，改用正確形式「群組」撈全檔
+node -e "const j=require('./orca_zh_TW_translation.json');
+Object.entries(j).filter(([,v])=>typeof v==='string'&&/群組/.test(v))
+.forEach(([k,v])=>console.log(JSON.stringify(v.slice(0,54))+'  '+k))"
+```
+
+> 批次 #1 只修了 `群群組`（31 處）就以為修完了。批次 #2 用這個方法列出
+> 全部 100 多個含「群組」的字串，才發現同一條壞規則有 **8 個受害詞**：
+> `群組織`（組織）、`分群組`（分組）、`群組合`（組合）、`群組態`（組態）、
+> `一群組`、`模群組`、`每群組`、`群組成`。
+>
+> **只看單一受害詞會少修 32 處。** 分類時同時能確認正當用法沒被誤傷——
+> 那 35 處正當的「群組」都沒接上述字，規則才敢下。
+
+危險組合要用負向前瞻保護：`群組成員` 是正當詞，所以規則寫
+`re:群組成(?!員)` 而不是 `群組成`。
+
+### 第二輪複查：語意（人讀）
+
+#### 方法二：先讀短字串
+
+**≤4 字的字串是語意錯誤的高風險區。**缺乏上下文，機器最容易選錯義項。
+先把它們單獨列出來讀，密度遠高於通讀整批。
+
+```bash
+# 列出批次範圍內所有 ≤4 字的字串，去重並排序
+node -e "const j=require('./orca_zh_TW_translation.json');
+const E=Object.entries(j).filter(([k,v])=>typeof v==='string'
+  &&k.includes('auto.components.right.sidebar'));
+const m=new Map();
+for(const [k,v] of E) if(v.length<=4&&/[一-鿿]/.test(v)){
+  if(!m.has(v))m.set(v,[]); m.get(v).push(k.split('.').slice(-2).join('.')); }
+[...m.entries()].sort((a,b)=>a[0].localeCompare(b[0],'zh'))
+.forEach(([v,ks])=>console.log(v.padEnd(6)+(ks.length>1?'×'+ks.length:'   ')+'  '+ks[0]))"
+```
+
+> 批次 #2 這批誤譯**全都是短字串**：`樹`、`起源`（origin）、`醫學博士`（MD）、
+> `透過`（Passed）、`邊`（Side）、`更多的`、`待辦的`、`偵測劑`。
+>
+> 讀到可疑的短字串後，去看**同命名空間的鄰居**——選項通常成組出現，
+> 鄰居就是上下文。`邊` 的鄰居是 `活動欄位置` 與 `頂部`，
+> 一看就知道是 Top/Side 的位置選項，應為「側邊」。
+
+機械檢查抓不到的，依重要性排序：
+
+1. **正確的詞用錯地方** ← 最難抓，也最容易漏
+   > 批次 #1：`執行緒` 4 處全部誤譯。它本身是完全正確的台灣用語，
+   > 但這 4 處講的是 UI 討論串與 comment thread，不是 concurrency thread。
+   > 任何模式比對都抓不到，只能讀。
+
+2. **同一概念多種錯譯**：機器翻譯會把同一個原文在不同地方譯成不同的錯法
+   > 批次 #1：comment thread 被譯成 `執行緒` 和 `評論主題`；
+   > hosted review 被譯成 `託管評審`、`託管評論`、`託管審查` 三種。
+   > 修了其中一種，另外兩種還在——規則要涵蓋所有變體。
+
+3. **動詞被當形容詞（或反之）**
+   > `Clear notes` → `清晰的筆記`（應為「清除筆記」）
+
+4. **一詞多義選錯**
+   > `refs` → `參考文獻`（學術文獻）、`Publishing` → `出版`（出版書籍）、
+   > `Process` → `過程`、`Ahead` → `前面`、`Forward` → `向前`
+   > （port forwarding 與瀏覽器上下頁的 forward 是兩回事）、
+   > `MD` → `醫學博士`、`origin` → `起源`、`Passed` → `透過`、
+   > `Detecting…` → `偵測劑…`
+
+5. **識別碼與參數被翻譯**：不該進翻譯流程的東西進來了
+   > `create_pr` → `建立_pr`（動作識別碼）
+   > `--model sonnet` → `——模範十四行詩`（CLI 參數；模範=model、十四行詩=sonnet）
+   >
+   > 這類要靠**鄰近欄位**判斷。上例旁邊的欄位標籤是「CLI 引數」，
+   > 才確定那是參數範例而不是文案。
+
+6. **佔位符**：`{{value0}}`、`{{count}}` 數量必須與原文一致
+7. **長度**：按鈕、分頁標籤等寬度受限的元件，譯文別過長
+
+### 兩條硬規則
+
+- **改完一定要跑 `npm run lint:terms`。** 批次 #1 時我把 `過程` 改成 `程序`，
+  lint 立刻報違規——`程序` 是 program 的中國用語且已被鎖，process 在本表是 `行程`。
+- **加規則後看 dry-run 的疊字檢查。** `許可權→權限` 曾在詞界造出 `隱私權權限`
+  （`隱私權`+`許可權` 相接）。只看那條規則的 diff 看不出來。
+
+---
+## 分批清單
+
+> 本表由 `node scripts/plan-batches.js` 產生，資料變動後請重跑。
+> 上限：每批 400 句 / 6,000 字。
+> 全檔合計 **11020 句 / 152,301 字**，共 **40 批**。
+
+### Tier 1 — 高曝光介面
+
+共 14 個模組、3502 句、38,342 字
+
+| 批次 | 模組 | 句數 | 字數 |
+|---|---|---:|---:|
+| #1 | `components.right` (1/3) | ~336 | ~4,062 |
+| #2 | `components.right` (2/3) | ~336 | ~4,062 |
+| #3 | `components.right` (3/3) | ~336 | ~4,062 |
+| #4 | `components.sidebar` (1/3) | ~283 | ~3,293 |
+| #5 | `components.sidebar` (2/3) | ~283 | ~3,293 |
+| #6 | `components.sidebar` (3/3) | ~283 | ~3,293 |
+| #7 | `components.editor` (1/2) | ~233 | ~1,818 |
+| #8 | `components.editor` (2/2) | ~233 | ~1,818 |
+| #9 | `components.status` | 325 | 3,194 |
+| #10 | `components.onboarding`<br>`components.tab` | 327 | 3,428 |
+| #11 | `components.terminal`<br>`components.workspace`<br>`components.orca` | 361 | 4,224 |
+| #12 | `components.NewWorkspaceComposerCard`<br>`components.new`<br>`components.rightSidebar`<br>`lib.terminal`<br>`lib.workspace` | 171 | 1,800 |
+
+### Tier 2 — 長文案（導覽／功能牆）
+
+共 1 個模組、317 句、30,898 字
+
+| 批次 | 模組 | 句數 | 字數 |
+|---|---|---:|---:|
+| #13 | `components.feature` (1/6) | ~53 | ~5,150 |
+| #14 | `components.feature` (2/6) | ~53 | ~5,150 |
+| #15 | `components.feature` (3/6) | ~53 | ~5,150 |
+| #16 | `components.feature` (4/6) | ~53 | ~5,150 |
+| #17 | `components.feature` (5/6) | ~53 | ~5,150 |
+| #18 | `components.feature` (6/6) | ~53 | ~5,150 |
+
+### Tier 3 — 設定頁（量大、曝光低）
+
+共 176 個模組、3873 句、48,099 字
+
+| 批次 | 模組 | 句數 | 字數 |
+|---|---|---:|---:|
+| #19 | `settings.terminal`<br>`settings.general` | 382 | 3,106 |
+| #20 | `settings.appearance`<br>`settings.AccountsPane`<br>`settings.repository` | 375 | 4,952 |
+| #21 | `settings.TerminalPane`<br>`settings.mobile`<br>`settings.RepositoryHooksSection`<br>`settings.browser` | 358 | 4,336 |
+| #22 | `settings.IntegrationsPane`<br>`settings.Settings`<br>`settings.RuntimeEnvironmentsPane`<br>`settings.TerminalWindowSection`<br>`settings.RepositoryPane` | 354 | 4,753 |
+| #23 | `settings.experimental`<br>`settings.git`<br>`settings.AppearancePane`<br>`settings.agents`<br>`settings.accounts`<br>`settings.GitPane`<br>…等 7 個模組 | 371 | 3,911 |
+| #24 | `settings.TerminalAppearanceSection`<br>`settings.CommitMessageAiPane`<br>`settings.notifications`<br>`settings.developer`<br>`settings.ExperimentalPane`<br>`settings.integrations`<br>…等 10 個模組 | 370 | 4,857 |
+| #25 | `settings.token`<br>`settings.commit`<br>`settings.GeneralEditorSettingsSection`<br>`settings.VoicePane`<br>`settings.NotificationsPane`<br>`settings.SparsePresetSettingsSection`<br>…等 14 個模組 | 387 | 4,875 |
+| #26 | `settings.WarpThemeImportModal`<br>`settings.jira`<br>`settings.AutoRenameBranchFromWorkSetting`<br>`settings.BrowserPane`<br>`settings.voice`<br>`settings.task`<br>…等 19 個模組 | 396 | 5,092 |
+| #27 | `settings.advanced`<br>`settings.orchestration`<br>`settings.quick`<br>`settings.GrokAccountsSection`<br>`settings.SshTargetCard`<br>`settings.EphemeralVmsPane`<br>…等 28 個模組 | 396 | 4,937 |
+| #28 | `settings.ShortcutsPane`<br>`settings.TasksPane`<br>`settings.tasks`<br>`settings.linear`<br>`settings.MobileRelayStatusSection`<br>`settings.CliSkillRuntimeSetup`<br>…等 47 個模組 | 397 | 5,870 |
+| #29 | `settings.TerminalSettingsPreview`<br>`settings.PrivacyDiagnosticsRows`<br>`settings.MobileRelayBetaAvailability`<br>`settings.SkillUsageExampleDialog`<br>`settings.HiddenExperimentalGroup`<br>`settings.RecentTabOrderControl`<br>…等 37 個模組 | 87 | 1,410 |
+
+### Tier 4 — 外部整合
+
+共 16 個模組、1960 句、18,898 字
+
+| 批次 | 模組 | 句數 | 字數 |
+|---|---|---:|---:|
+| #30 | `components.TaskPage` | 317 | 3,242 |
+| #31 | `components.stats` | 259 | 2,095 |
+| #32 | `components.automations` | 248 | 1,960 |
+| #33 | `components.github` | 235 | 1,976 |
+| #34 | `components.GitHubItemDialog`<br>`components.PullRequestPage` | 368 | 3,433 |
+| #35 | `components.mobile`<br>`components.skills`<br>`components.GitLabItemDialog`<br>`components.linear` | 358 | 3,846 |
+| #36 | `components.emulator`<br>`components.JiraIssueWorkspace`<br>`components.LinearItemDrawer`<br>`components.jira`<br>`lib.linear`<br>`components.gitlab` | 175 | 2,346 |
+
+### Tier 5 — 長尾模組
+
+共 123 個模組、1152 句、13,541 字
+
+| 批次 | 模組 | 句數 | 字數 |
+|---|---|---:|---:|
+| #37 | `components.browser`<br>`store.slices`<br>`hooks.useSettingsNavigationMetadata`<br>`lib.agent`<br>`components.UpdateCard` | 374 | 4,624 |
+| #38 | `components.floating`<br>`components.WorktreeJumpPalette`<br>`components.LinearIssueWorkspace`<br>`components.cmd`<br>`components.repo`<br>`components.activity`<br>…等 15 個模組 | 400 | 4,638 |
+| #39 | `components.Terminal`<br>`components.sparse`<br>`components.StarNagCard`<br>`components.link`<br>`components.ui`<br>`components.diff`<br>…等 103 個模組 | 378 | 4,279 |
+
+### Tier 0 — 手工精修區（品質已達標，僅抽查）
+
+共 47 個模組、216 句、2,523 字
+
+| 批次 | 模組 | 句數 | 字數 |
+|---|---|---:|---:|
+| #40 | `components.native-chat`<br>`components.agentSessionContinuation`<br>`settings.appearance`<br>`browser.loadFailure`<br>`worktreeJumpPalette.matchLabel`<br>`dashboardPopout.card`<br>…等 47 個模組 | 216 | 2,523 |
+
+---
+
+## 已知待辦（不屬於任何單一批次）
+
+### 1. Tier B 逐句判斷項（11 條）
+
+`lock.csv` 中 `tier=B` 的詞不可機械替換，需在批次中逐句處理：
+
+| 詞 | 出現數 | 注意 |
+|---|---:|---|
+| `應用` → `套用` | 17 | 但 `應用程式`、`應用視窗` 不可改 |
+| `請求` / `要求` | 67 / 28 | request 兩者在台灣皆自然；需確認是 request 還是 require |
+| `依賴` → `相依性` | 3 | 「依賴項稽核」機械替換會變成「相依性項稽核」，需改寫整句 |
+| `instance` → `執行個體` | — | 「實例」在台灣亦通用 |
+| `release` → `發行` | — | 「發布」在台灣亦通用，視語境 |
+| `blame` | — | 多數情況建議保留英文 |
+
+### 2. 模擬器裝置名稱疑似整批誤譯
+
+以下譯文看不出對應的原文，像是 device list 被整批亂翻，需回查原始英文：
+
+```
+米4a          振盪器52        作業系統52
+M1 迷你·家     2 名兒童
+```
+
+### 3. 未翻譯項目中混有真漏翻
+
+全檔有 884 條不含中文字元。多數是品牌名（Cursor、Hermes、OpenClaw…）**應當保留英文**，
+但其中混了真正的漏翻，已確認的至少有：
+
+```
+"No live terminal — this agent's pane has closed."
+"Agent Dashboard"
+"Focus worktree"
+"Close"
+```
+
+建議做法：先把 884 條全部列出，人工標記「品牌名」與「漏翻」，再只處理後者。
+
+```bash
+node -e "const j=require('./orca_zh_TW_translation.json');
+Object.entries(j).filter(([,v])=>typeof v==='string'&&v.trim()&&!/[一-鿿]/.test(v))
+.forEach(([k,v])=>console.log(k+'\t'+v))" > untranslated.tsv
+```
+
+### 4. npm 套件內含不必要的 workflow 檔
+
+`orca-zh-tw-installer` 的 tarball 內含 `.github/workflows/npm-publish.yml`。
+無害（使用者不會執行）但沒必要，在 `package.json` 加 `files` 白名單即可，
+不值得為此單獨發版，下次發布時一起處理。
+
+## 相關檔案
+
+| 檔案 | 用途 |
+|---|---|
+| `orca_zh_TW_translation.json` | **唯一翻譯來源**，只改這個 |
+| `scripts/plan-batches.js` | 產生本文件的分批清單；`--batch N` 取出某批內容 |
+| `scripts/audit-batch.js` | 複查第一輪：對某命名空間做機械檢查 |
+| `scripts/audit-hash-conflicts.js` | 找出同 hash 卻有不同譯文的字串（同原文被譯兩次）|
+| `scripts/sweep-terms.js` | 依 lock.csv 統一術語，預設 dry-run，含事後疊字偵測 |
+| `scripts/sweep-spacing.js` | 空格與標點正規化，預設 dry-run |
+| `scripts/build-nested.js` | 產生 ESM + CJS 兩份字典 |
+| `scripts/verify-install.js` | 驗證已安裝的 app.asar |
+| `~/.claude/skills/tw-translate/data/domains/lock.csv` | 術語鎖定表 |
+
+## 重要提醒
+
+`zh-TW-nested.js` 與 `zh-TW-nested.cjs.js` 都是**產生物**。
+改完 JSON 一定要 `npm run build`，否則安裝時不會生效——這個坑先前踩過一次。