orca-zh-tw-installer 1.2.1 → 1.2.2

package/README.md

@@ -51,6 +51,12 @@ npx orca-zh-tw-installer
 > 注意：套件名稱是 `orca-zh-tw-installer`。指令名稱雖然是 `orca-zh-tw`，
 > 但 `npx orca-zh-tw` 會被當成套件名去 registry 查詢而得到 404。
 
+**請先完全關閉 Orca**（系統匣圖示右鍵 → Quit，不是只關閉視窗）。
+安裝腳本會偵測 Orca 是否仍在執行並直接中止——因為在執行中替換
+`app.asar` 之後，那個 Orca 實例的 renderer 還握著舊的檔名，
+去載入時會拋出 `Unexpected token` 並讓側邊欄等面板顯示錯誤。
+那是一次性的、重啟即消失，但很容易被誤認為語系包壞了。
+
 腳本將自動執行以下流程：
 1. 自動定位作業系統對應的 Orca 安裝路徑並解包。
 2. 備份官方 `app.asar`（已含補丁時會保留原本的乾淨備份）。

package/index.js

@@ -27,11 +27,41 @@ const asar = require('@electron/asar');
 // --dry-run：解包、修補、驗證，但不備份也不重新打包。
 // 可在 Orca 執行中安全使用，用來確認 Orca 更新後錨點是否仍然有效。
 const DRY_RUN = process.argv.includes('--dry-run');
+// --force：略過「Orca 是否執行中」的檢查。不建議使用，見 countRunningOrca 的說明。
+const FORCE = process.argv.includes('--force');
 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');
 
 const MARK = 'UI_LANGUAGE_TRADITIONAL_CHINESE = "zh-TW"';
 
+/**
+ * 偵測 Orca 是否還在執行。
+ *
+ * 為什麼要擋：重新打包 app.asar 之後，仍在執行的 Orca 其 renderer 還握著
+ * 舊的 lazy chunk 檔名，去載入時檔案已被換掉，會拋出
+ * 「Unexpected token」並讓側邊欄等面板的 error boundary 接住。
+ * 那是一次性的、重啟即消失的錯誤，但很容易被誤認為語系包壞了。
+ *
+ * 回傳 process 數量；無法判斷時回傳 -1（不阻擋）。
+ */
+function countRunningOrca() {
+  const { execFileSync } = require('child_process');
+  const run = (cmd, args) => {
+    try {
+      return execFileSync(cmd, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+    } catch { return null; }
+  };
+  if (platform === 'win32') {
+    const out = run('tasklist', ['/FI', 'IMAGENAME eq Orca.exe', '/NH']);
+    if (out === null) return -1;
+    return out.split(/\r?\n/).filter(l => /Orca\.exe/i.test(l)).length;
+  }
+  // macOS / Linux：-x 只比對完全相符的程序名，避免抓到自己的 npx/node
+  const out = run('pgrep', ['-x', platform === 'darwin' ? 'Orca' : 'orca']);
+  if (out === null) return 0;   // pgrep 找不到時回傳非 0 退出碼，會落到 catch
+  return out.split('\n').filter(Boolean).length;
+}
+
 /**
  * 修補器：每個修補都要宣告「如何判斷已完成」。
  * 若錨點找不到且尚未完成，就記為失敗——絕不靜默略過。
@@ -84,6 +114,25 @@ function patchLocaleGate(p) {
 
 async function patch() {
   try {
+    // dry-run 不寫檔，Orca 執行中也能安全跑，故不檢查
+    if (!DRY_RUN && !FORCE) {
+      const n = countRunningOrca();
+      if (n > 0) {
+        console.error(`❌ Orca 仍在執行中（偵測到 ${n} 個程序），已中止。\n`);
+        console.error('   請先完全關閉 Orca：系統匣圖示右鍵 → Quit（不是只關閉視窗）。');
+        console.error('   若在修補後才關閉，重新啟動的 Orca 可能出現「Unexpected token」');
+        console.error('   造成側邊欄等面板顯示錯誤——那是舊 chunk 與新檔案不符所致。\n');
+        if (platform === 'win32') {
+          console.error('   確認是否關乾淨：');
+          console.error('     Get-Process Orca,orca-terminal-daemon -ErrorAction SilentlyContinue\n');
+        }
+        console.error('   想在 Orca 執行中檢查相容性，請改用：npm run dry-run');
+        console.error('   確定要強制繼續（不建議）：加上 --force');
+        process.exitCode = 1;
+        return;
+      }
+    }
+
     console.log('📦 1/6 正在解包 app.asar (這可能需要數十秒)...');
     if (fs.existsSync(workDir)) fs.rmSync(workDir, { recursive: true, force: true });
     fs.mkdirSync(workDir, { recursive: true });

package/package.json

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

package/scripts/build-nested.js

@@ -40,6 +40,28 @@ fs.writeFileSync(CJS_OUT,
   `${named}${EOL}`,
   'utf8');
 
+// 產生後立刻用真正的 JS parser 驗一次。字典是 lazy chunk，語法有問題時
+// Orca 只會拋「Unexpected token」並讓面板的 error boundary 接住，很難追。
+// 在這裡擋掉，比事後 verify 更早。
+{
+  const { execFileSync } = require('child_process');
+  const os = require('os');
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'orca-zh-tw-build-'));
+  for (const [src, name] of [[OUT, 'dict.mjs'], [CJS_OUT, 'dict.cjs']]) {
+    const probe = path.join(tmp, name);
+    fs.copyFileSync(src, probe);
+    try {
+      execFileSync(process.execPath, ['--check', probe], { stdio: ['ignore', 'ignore', 'pipe'] });
+    } catch (e) {
+      fs.rmSync(tmp, { recursive: true, force: true });
+      console.error(`❌ ${path.basename(src)} 語法無效，已中止：`);
+      console.error('   ' + String(e.stderr || e.message).split('\n').slice(0, 3).join('\n   '));
+      process.exit(1);
+    }
+  }
+  fs.rmSync(tmp, { recursive: true, force: true });
+}
+
 const n = Object.keys(flat).length;
-console.log(`✅ ${path.basename(OUT)}（ESM／renderer）已產生（${n} 條字串）`);
+console.log(`✅ ${path.basename(OUT)}（ESM／renderer）已產生（${n} 條字串，語法驗證通過）`);
 console.log(`✅ ${path.basename(CJS_OUT)}（CJS／main process）已產生`);

package/scripts/verify-install.js

@@ -85,6 +85,46 @@ if (files.includes(cjsPath)) {
   check('CJS 有 "use strict"', cjs.trimStart().startsWith('"use strict"'));
 }
 
+// ── 真正的 JS 語法驗證 ──
+// 字典是 lazy chunk，由 __vitePreload / require 動態載入。若語法有問題，
+// Orca 會拋「Unexpected token」並讓面板的 error boundary 接住。
+// JSON.parse 過不代表 JS parser 過：JSON 容許 U+2028/U+2029 等字元，
+// 舊版 JS 的字串字面值不容許。故用 node --check 實際跑一次 parser。
+console.log('\n=== JS 語法驗證（node --check）===');
+{
+  const { execFileSync } = require('child_process');
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'orca-zh-tw-syntax-'));
+  const cases = [
+    ['ESM（renderer）', esmPath, 'dict.mjs'],
+    ['CJS（main process）', cjsPath, 'dict.cjs'],
+  ];
+  for (const [label, inAsarPath, name] of cases) {
+    if (!files.includes(inAsarPath)) { check(`${label} 存在`, false); continue; }
+    const f = path.join(tmp, name);
+    fs.writeFileSync(f, get(inAsarPath), 'utf8');
+    let ok = true, err = '';
+    try {
+      execFileSync(process.execPath, ['--check', f], { stdio: ['ignore', 'ignore', 'pipe'] });
+    } catch (e) {
+      ok = false;
+      err = String(e.stderr || e.message).split('\n').find(l => /Error|Unexpected/.test(l)) || '';
+    }
+    check(`${label} 通過 node --check${ok ? '' : '  ← ' + err}`, ok);
+  }
+  // JSON 合法但 JS 可能出問題的字元
+  for (const [label, inAsarPath] of [['ESM', esmPath], ['CJS', cjsPath]]) {
+    if (!files.includes(inAsarPath)) continue;
+    const s = get(inAsarPath);
+    // U+2028/U+2029 必須用 \u 轉義。直接把字元寫進正則字面值，JS 會把它們當成
+    // 行終止符而切斷字面值——正是這裡要檢查的那類問題（本檔案踩過一次）。
+    const bad = (s.match(/[\u2028\u2029]/g) || []).length
+      + (s.match(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g) || []).length
+      + (s.match(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g) || []).length;
+    check(`${label} 無 U+2028/2029、孤立代理對、控制字元`, bad === 0);
+  }
+  fs.rmSync(tmp, { recursive: true, force: true });
+}
+
 console.log(fail === 0
   ? '\n🎉 全部通過！完全關閉並重啟 Orca，到 Settings → Appearance → Language 選「中文（繁體）」。\n'
   : `\n❌ 有 ${fail} 項未通過。可用備份還原：\n   Copy-Item "${orcaPath}.bak" "${orcaPath}" -Force\n`);