orca-zh-tw-installer 1.2.3 → 1.2.5

package/README.md

@@ -65,16 +65,32 @@ npx orca-zh-tw-installer
 5. 注入 11,000 句繁體中文字典（ESM 給 Renderer、CJS 給 Main）。
 6. 驗證全部注入點後重新封裝。
 
-若想在不改動 Orca 的前提下先確認相容性（**可在 Orca 執行中安全使用**）：
+### 其他指令
+
+全部都用同一個入口，不需要 clone 這個專案：
 
 ```bash
-npm run dry-run
+npx orca-zh-tw-installer --dry-run   # 只檢查相容性，不改動 Orca（執行中也能安全跑）
+npx orca-zh-tw-installer --verify    # 檢查已安裝的 app.asar 是否含全部補丁與字典
+npx orca-zh-tw-installer --force     # 即使 Orca 執行中也強制套用（不建議）
+npx orca-zh-tw-installer --help      # 顯示說明
 ```
 
-安裝後可驗證實際封裝結果：
+`--dry-run` 適合在 Orca 更新後先跑，確認語系包是否仍與新版相容。
+
+### 出問題時
+
+若安裝後 Orca 顯示異常，先還原官方版本：
+
+```powershell
+# Windows
+Copy-Item "$env:LOCALAPPDATA\Programs\orca\resources\app.asar.bak" `
+          "$env:LOCALAPPDATA\Programs\orca\resources\app.asar" -Force
+```
 
 ```bash
-npm run verify
+# macOS
+cp /Applications/Orca.app/Contents/Resources/app.asar{.bak,}
 ```
 
 ---
@@ -123,6 +139,25 @@ npm start
 - `scripts/sweep-terms.js`：依術語鎖定表統一用詞，預設 dry-run。
 - `scripts/sweep-spacing.js`：中英之間補半形空格，預設 dry-run。
 - `scripts/verify-install.js`：驗證已安裝的 `app.asar` 是否含全部補丁與字典。
+- `scripts/extract-reference-locale.js`：從 asar 抽出 es/ja/ko 語系當原文對照。
+- `scripts/audit-identifiers.js`：三語對照找被誤譯的識別碼（`npm` 曾被譯成「新專案管理」）。
+- `scripts/audit-batch.js`：機械式複查——未翻譯、半形標點、截斷、同義重複、過長標籤。
+
+### 為什麼需要對照語言
+
+Orca **沒有 en 語系檔**（英文是內嵌的 fallback），所以無法直接取得原文。
+但 es/ja/ko 的 key 與中文完全相同，可用來反推原意：
+
+```bash
+node scripts/extract-reference-locale.js es > ref-es.json
+npm run audit:identifiers
+```
+
+判準是「三語的值完全相同 → 那幾乎確定是識別碼」——三個獨立譯者都選擇不翻，
+中文卻翻了，就是誤譯。這抓到過 `npm`→新專案管理、`osc52`→作業系統 52、
+`feat/mobile-page`→壯舉/手機頁面。
+
+對照語言只是**參考而非標準**：有些字（`idle`→空閒）中文譯法比其他語言保留原文更好。
 
 ### 改翻譯的流程
 

package/TRANSLATION-PLAN.md

@@ -19,7 +19,7 @@
 | **Tier 0c** 第二輪術語＋損壞修復 | ✅ 完成 | 328 處。由批次 #1 審查暴露 |
 | **Tier 1** 高曝光介面 | ✅ 完成 | 批次 #1–#12（3,502 句）|
 | **Tier 2** 功能牆／導覽 | ✅ 完成 | 批次 #13（310 句／2,730 字）|
-| **Tier 3** 設定頁 | ⬜ 未開始 | 批次 #14–#24（3,873 句）|
+| **Tier 3** 設定頁 | ✅ 完成 | 3,873 句（search 關鍵字 1,401 + UI 2,472）|
 | **Tier 4** 外部整合 | ⬜ 未開始 | 批次 #25–#31（1,960 句）|
 | **Tier 5** 長尾模組 | ⬜ 未開始 | 批次 #32–#34（1,152 句）|
 | **Tier 0** 手工精修區 | ⬜ 抽查即可 | 批次 #35（216 句），品質已達標 |
@@ -29,7 +29,7 @@
 
 ## 術語鎖定表
 
-單一真實來源：`~/.claude/skills/tw-translate/data/domains/lock.csv`（303 條）
+單一真實來源：`~/.claude/skills/tw-translate/data/domains/lock.csv`（321 條）
 
 欄位 `tier` 的意義：
 

package/index.js

@@ -29,6 +29,25 @@ const asar = require('@electron/asar');
 const DRY_RUN = process.argv.includes('--dry-run');
 // --force：略過「Orca 是否執行中」的檢查。不建議使用，見 countRunningOrca 的說明。
 const FORCE = process.argv.includes('--force');
+
+// --verify：檢查已安裝的 app.asar 是否含全部補丁與字典。
+// 透過 npx 安裝的人沒有專案目錄，無法用 npm run verify，故在此提供同一個入口。
+if (process.argv.includes('--verify')) {
+  require('./scripts/verify-install.js');   // 該腳本會自行輸出結果並設定結束碼
+  return;
+}
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`用法： npx orca-zh-tw-installer [選項]
+
+  （無選項）    套用繁體中文語系包。需先完全關閉 Orca。
+  --dry-run    只檢查相容性，不改動 Orca。可在 Orca 執行中安全使用。
+  --verify     檢查已安裝的 app.asar 是否含全部補丁與字典。
+  --force      即使 Orca 執行中也強制套用（不建議）。
+  --help       顯示這段說明。
+`);
+  return;
+}
 const workDir = path.join(os.tmpdir(), DRY_RUN ? 'orca-zh-tw-patcher-dry' : 'orca-zh-tw-patcher');
 const unpackedDir = path.join(workDir, 'app.asar.unpacked');