@lancetw/aiyu 0.3.2 → 0.4.0

package/README.md

@@ -0,0 +1,52 @@
+# @lancetw/aiyu
+
+Native-messaging **host installer** for the [aiyu](https://github.com/lancetw/aiyu) Chrome extension (*aiyu — AI 譯語*), which translates **YouTube subtitles** and **selected web text** into Traditional Chinese (Taiwan) using an AI CLI already on your own machine.
+
+This npm package is the **host half**. It registers a small local bridge so the aiyu browser extension can call your installed `claude` / `codex` / `agy` CLI. The extension itself is installed from the Chrome Web Store.
+
+## Install
+
+```sh
+npx @lancetw/aiyu
+```
+
+Then restart your browser, click the aiyu icon → **「測試 host 連線」** (Test host connection).
+
+By default the installer **lets you choose which browsers** to register (interactive checklist in a terminal). To skip the prompt:
+
+```sh
+npx @lancetw/aiyu --all                      # all detected browsers
+npx @lancetw/aiyu --browsers=chrome,brave    # only these
+```
+
+Valid ids: `chrome, canary, beta, dev, testing, chromium, edge, brave, arc`.
+
+## Requirements
+
+- **Node.js ≥ 20.12**
+- One of these AI CLIs installed **and signed in** (requires that service's account):
+  - `claude` — Anthropic Claude Code
+  - `codex` — OpenAI Codex
+  - `agy` — Google Antigravity
+- The **aiyu** extension installed from the Chrome Web Store
+
+> Without a CLI or without running this installer, the extension shows **「連線失敗」(connection failed)**. macOS / Linux are verified; Windows is experimental.
+
+## Uninstall
+
+```sh
+npx @lancetw/aiyu --uninstall                    # remove from all browsers
+npx @lancetw/aiyu --uninstall --browsers=chrome  # remove from one only
+```
+
+## What it does
+
+`npx @lancetw/aiyu` copies the host to a stable location, generates a launcher pinned to your Node binary (no reliance on a shebang), and registers the native-messaging manifest for the browsers you choose (interactive by default; or `--browsers=`/`--all`). The host trusts both the off-store (unpacked-dev) and Chrome Web Store extension IDs, so either build connects.
+
+## Privacy
+
+aiyu has **no developer server** and collects no data. The text you translate goes only — under your own account, via the CLI you installed — to that provider (Anthropic / OpenAI / Google); it never passes through the developer. See the [privacy policy](https://github.com/lancetw/aiyu/blob/master/PRIVACY.md).
+
+## License
+
+[MIT](https://github.com/lancetw/aiyu/blob/master/LICENSE) © lancetw

package/aiyu-host.js

@@ -1,14 +1,15 @@
-#!/Users/lancetw/.nvm/versions/node/v24.11.0/bin/node
+#!/usr/bin/env node
 // aiyu native messaging host
 // 從 stdin 讀 4-byte LE length + JSON，呼叫 claude -p 或 codex exec，回 JSON 結果。
 // 所有除錯訊息走 stderr，stdout 嚴格只能寫 framing message。
 
-"use strict";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
 
-const { spawn } = require("child_process");
-const path = require("path");
-const fs = require("fs");
-const os = require("os");
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 const HOST_VERSION = "0.3.2";
 // 單次 CLI 呼叫上限：全後端統一 300s。健康呼叫遠低於此（claude ~24s、codex ~15s），

package/install.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-"use strict";
 // aiyu 跨平台 native host 安裝器 —— 取代 install.sh / deploy.sh，並新增 Windows 支援。
 //
 // 做的事：
@@ -19,10 +18,11 @@
 //
 // 擴充 ID 是從 extension/manifest.json 的 key 推導出來的固定值（off-store 自有金鑰，永遠一致）。
 
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const { execFileSync } = require("child_process");
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const HOST_NAME = "com.lancetw.aiyu";
 // 擴充 ID。host 的 allowed_origins 同時信任兩者（dual-ID）：
@@ -36,15 +36,21 @@ const EXT_IDS = [DEV_EXT_ID, STORE_EXT_ID];
 
 const PLATFORM = process.platform; // 'darwin' | 'linux' | 'win32'
 const HOME = os.homedir();
-const SRC_DIR = __dirname; // host/
+const SRC_DIR = path.dirname(fileURLToPath(import.meta.url)); // host/
 const REPO_ROOT = path.join(SRC_DIR, "..");
 const EXT_DIR = path.join(REPO_ROOT, "extension");
 const HOST_JS_SRC = path.join(SRC_DIR, "aiyu-host.js");
 
-const argv = new Set(process.argv.slice(2));
+const argList = process.argv.slice(2);
+const argv = new Set(argList);
 const DRY = argv.has("--dry-run");
 const UNINSTALL = argv.has("--uninstall");
 const HELP = argv.has("--help") || argv.has("-h");
+const ALL = argv.has("--all");
+const BROWSERS_FLAG = (() => {
+  const p = argList.find((a) => a.startsWith("--browsers="));
+  return p ? p.slice("--browsers=".length) : null;
+})();
 
 function log(...a) { console.log(...a); }
 function step(s) { console.log((DRY ? "[dry-run] " : "") + s); }
@@ -56,30 +62,74 @@ function installDir() {
   return path.join(process.env.XDG_DATA_HOME || path.join(HOME, ".local/share"), "aiyu"); // linux
 }
 
-// unix：各瀏覽器 NativeMessagingHosts 目錄（parent 存在才算裝了該瀏覽器）
-function unixBrowserDirs() {
+// 單一真相來源：每個瀏覽器一筆。id = 使用者在 --browsers 用的短名；label 給選單顯示。
+// mac/linux 為 NativeMessagingHosts 之上層子路徑；win 為 HKCU 機碼基底（null = 該平台無此瀏覽器）。
+const BROWSERS = [
+  { id: "chrome",   label: "Google Chrome",             mac: "Google/Chrome",                 linux: "google-chrome",          win: "Software\\Google\\Chrome" },
+  { id: "canary",   label: "Google Chrome Canary",      mac: "Google/Chrome Canary",          linux: null,                     win: null },
+  { id: "beta",     label: "Google Chrome Beta",        mac: "Google/Chrome Beta",            linux: "google-chrome-beta",     win: null },
+  { id: "dev",      label: "Google Chrome Dev",         mac: "Google/Chrome Dev",             linux: "google-chrome-unstable", win: null },
+  { id: "testing",  label: "Google Chrome for Testing", mac: "Google/Chrome for Testing",     linux: null,                     win: null },
+  { id: "chromium", label: "Chromium",                  mac: "Chromium",                      linux: "chromium",               win: "Software\\Chromium" },
+  { id: "edge",     label: "Microsoft Edge",            mac: "Microsoft Edge",                linux: "microsoft-edge",         win: "Software\\Microsoft\\Edge" },
+  { id: "brave",    label: "Brave",                     mac: "BraveSoftware/Brave-Browser",   linux: "BraveSoftware/Brave-Browser", win: "Software\\BraveSoftware\\Brave-Browser" },
+  { id: "arc",      label: "Arc",                       mac: "Arc/User Data",                 linux: null,                     win: null },
+];
+
+// 該瀏覽器在本平台的 NativeMessagingHosts 目錄（不支援則回 null）
+function nmhDir(b) {
   const ASUP = path.join(HOME, "Library/Application Support");
   const CFG = process.env.XDG_CONFIG_HOME || path.join(HOME, ".config");
-  if (PLATFORM === "darwin")
-    return [
-      "Google/Chrome", "Google/Chrome Canary", "Google/Chrome Beta", "Google/Chrome Dev",
-      "Google/Chrome for Testing", "Chromium", "Microsoft Edge",
-      "BraveSoftware/Brave-Browser", "Arc/User Data"
-    ].map((b) => path.join(ASUP, b, "NativeMessagingHosts"));
-  return [
-    "google-chrome", "google-chrome-beta", "google-chrome-unstable", "chromium",
-    "microsoft-edge", "BraveSoftware/Brave-Browser"
-  ].map((b) => path.join(CFG, b, "NativeMessagingHosts"));
-}
-
-// windows：各瀏覽器登錄檔機碼（HKCU，免管理員）
-function winRegKeys() {
-  return [
-    "Software\\Google\\Chrome",
-    "Software\\Chromium",
-    "Software\\Microsoft\\Edge",
-    "Software\\BraveSoftware\\Brave-Browser"
-  ].map((b) => `HKCU\\${b}\\NativeMessagingHosts\\${HOST_NAME}`);
+  if (PLATFORM === "darwin") return b.mac ? path.join(ASUP, b.mac, "NativeMessagingHosts") : null;
+  return b.linux ? path.join(CFG, b.linux, "NativeMessagingHosts") : null; // linux
+}
+
+// 偵測：unix 上「NativeMessagingHosts 父目錄存在」視為已裝；win best-effort（無法可靠偵測）回傳所有有機碼者
+function detectedBrowsers() {
+  if (PLATFORM === "win32") return BROWSERS.filter((b) => b.win);
+  return BROWSERS.filter((b) => {
+    const d = nmhDir(b);
+    return d && fs.existsSync(path.dirname(d));
+  });
+}
+
+function winRegKey(b) {
+  return `HKCU\\${b.win}\\NativeMessagingHosts\\${HOST_NAME}`;
+}
+
+function parseBrowsersFlag(str) {
+  const ids = [...new Set(String(str).split(",").map((s) => s.trim().toLowerCase()).filter(Boolean))];
+  const valid = new Set(BROWSERS.map((b) => b.id));
+  return { known: ids.filter((id) => valid.has(id)), unknown: ids.filter((id) => !valid.has(id)) };
+}
+
+// 決定要裝到哪些。回傳 { mode:"list", ids } 或 { mode:"interactive" }
+function resolveSelection({ browsersFlag, all, isTTY, detectedIds }) {
+  if (browsersFlag) return { mode: "list", ids: parseBrowsersFlag(browsersFlag).known };
+  if (all) return { mode: "list", ids: detectedIds };
+  if (isTTY) return { mode: "interactive" };
+  return { mode: "list", ids: detectedIds }; // 非 TTY 退路：全裝（保護 auto-deploy）
+}
+
+// TTY 互動多選；只在此分支才動態載入 clack。未安裝則 fail-soft 退回全裝。
+async function pickInteractive(detected) {
+  let clack;
+  try {
+    clack = await import("@clack/prompts");
+  } catch {
+    console.error("⚠ 互動選單需要 @clack/prompts；未安裝，退回全裝。（在 host/ 跑 npm i 後即可使用選單）");
+    return detected.map((b) => b.id);
+  }
+  const picked = await clack.multiselect({
+    message: "要安裝 aiyu host 到哪些瀏覽器？（空白鍵勾選，Enter 確認）",
+    options: detected.map((b) => ({ value: b.id, label: b.label })),
+    initialValues: detected.map((b) => b.id), // 全選 → Enter = 全裝（向後相容）
+  });
+  if (clack.isCancel(picked)) {
+    clack.cancel("已取消，未變更任何瀏覽器。");
+    process.exit(0);
+  }
+  return picked;
 }
 
 function regExe() {
@@ -104,14 +154,15 @@ function writeFile(p, content, mode) {
   if (mode) fs.chmodSync(p, mode);
 }
 
-function doInstall() {
+async function doInstall() {
   if (!fs.existsSync(HOST_JS_SRC)) {
     console.error(`✗ 找不到 host：${HOST_JS_SRC}（請從 repo 根目錄附近執行）`);
     process.exit(1);
   }
 
   const dir = installDir();
-  const hostJsDst = path.join(dir, "aiyu-host.js");
+  // host 被複製到無 package.json 的目錄 → 必須用 .mjs 副檔名才會被當 ESM 跑
+  const hostJsDst = path.join(dir, "aiyu-host.mjs");
 
   // 1. 複製 host
   step(`複製 host → ${hostJsDst}`);
@@ -139,11 +190,31 @@ exec "${node}" "${hostJsDst}" "$@"
 
   // 3. 註冊 manifest
   const manifest = JSON.stringify(manifestObject(launcherPath), null, 2);
+  const detected = detectedBrowsers();
+  if (BROWSERS_FLAG) {
+    const { unknown } = parseBrowsersFlag(BROWSERS_FLAG);
+    if (unknown.length)
+      console.error(`⚠ 略過未知瀏覽器 id：${unknown.join(", ")}（合法：${BROWSERS.map((b) => b.id).join(", ")}）`);
+  }
+  const sel = resolveSelection({
+    browsersFlag: BROWSERS_FLAG,
+    all: ALL,
+    isTTY: process.stdout.isTTY,
+    detectedIds: detected.map((b) => b.id),
+  });
+  const chosenIds = sel.mode === "interactive" ? await pickInteractive(detected) : sel.ids;
+  const detectedIdSet = new Set(detected.map((b) => b.id));
+  const targets = BROWSERS.filter((b) => chosenIds.includes(b.id) && detectedIdSet.has(b.id));
+  if (BROWSERS_FLAG && targets.length === 0) {
+    console.error(`✗ --browsers 指定的瀏覽器都沒偵測到。偵測到的：${[...detectedIdSet].join(", ") || "（無）"}`);
+    process.exit(1);
+  }
   let registered = 0;
   if (PLATFORM === "win32") {
     const manifestPath = path.join(dir, `${HOST_NAME}.json`);
     writeFile(manifestPath, manifest);
-    for (const key of winRegKeys()) {
+    for (const b of targets) {
+      const key = winRegKey(b);
       step(`reg add ${key} → ${manifestPath}`);
       if (DRY) { registered++; continue; }
       try {
@@ -156,9 +227,8 @@ exec "${node}" "${hostJsDst}" "$@"
       }
     }
   } else {
-    for (const d of unixBrowserDirs()) {
-      if (!fs.existsSync(path.dirname(d))) continue; // 沒裝這個瀏覽器
-      writeFile(path.join(d, `${HOST_NAME}.json`), manifest);
+    for (const b of targets) {
+      writeFile(path.join(nmhDir(b), `${HOST_NAME}.json`), manifest);
       registered++;
     }
   }
@@ -192,21 +262,31 @@ function printExtensionSteps() {
 
 function doUninstall() {
   const dir = installDir();
+  const onlyIds = BROWSERS_FLAG ? parseBrowsersFlag(BROWSERS_FLAG).known : null;
+  const inScope = (b) => !onlyIds || onlyIds.includes(b.id);
   if (PLATFORM === "win32") {
-    for (const key of winRegKeys()) {
+    for (const b of BROWSERS) {
+      if (!inScope(b)) continue;
+      if (!b.win) continue;
+      const key = winRegKey(b);
       step(`reg delete ${key}`);
       if (!DRY) {
         try { execFileSync(regExe(), ["delete", key, "/f"], { stdio: "ignore" }); } catch { /* 沒這個機碼 */ }
       }
     }
   } else {
-    for (const d of unixBrowserDirs()) {
+    for (const b of BROWSERS) {
+      if (!inScope(b)) continue;
+      const d = nmhDir(b);
+      if (!d) continue;
       const out = path.join(d, `${HOST_NAME}.json`);
       if (fs.existsSync(out)) { step(`刪除 ${out}`); if (!DRY) fs.rmSync(out); }
     }
   }
-  step(`刪除安裝目錄 ${dir}`);
-  if (!DRY && fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
+  if (!onlyIds) {
+    step(`刪除安裝目錄 ${dir}`);
+    if (!DRY && fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
+  }
   log("\n✓ 已移除 host 註冊。擴充請到 chrome://extensions 自行移除。");
 }
 
@@ -214,16 +294,26 @@ function printHelp() {
   log(`aiyu 跨平台 native host 安裝器
 
 用法：
-  node install.js              安裝 host 並印出擴充安裝步驟
-  node install.js --dry-run    只印出會做什麼，不實際寫入
-  node install.js --uninstall  移除 host 註冊（manifest / 登錄檔）
+  node install.js                          安裝 host（TTY 下互動選擇瀏覽器）
+  node install.js --all                    安裝到所有偵測到的瀏覽器（跳過提問）
+  node install.js --browsers=chrome,brave  只安裝到指定瀏覽器
+  node install.js --dry-run                只印出會做什麼，不實際寫入
+  node install.js --uninstall              移除 host 註冊（可加 --browsers= 只移除部分）
 
+瀏覽器 id：${BROWSERS.map((b) => b.id).join(", ")}
 平台：${PLATFORM}　擴充 ID（dev／store）：${DEV_EXT_ID} ／ ${STORE_EXT_ID}`);
 }
 
-(function main() {
+async function main() {
   if (HELP) return printHelp();
   log(`aiyu installer　平台=${PLATFORM}　node=${process.version}${DRY ? "　(dry-run)" : ""}`);
   if (UNINSTALL) return doUninstall();
-  doInstall();
-})();
+  return doInstall();
+}
+
+export { parseBrowsersFlag, resolveSelection };
+
+// 直接執行才跑 main；被 import（測試）時不跑
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main().catch((e) => { console.error(e); process.exit(1); });
+}

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "@lancetw/aiyu",
-  "version": "0.3.2",
+  "version": "0.4.0",
+  "type": "module",
   "description": "Installs the native-messaging host for the aiyu Chrome extension, letting it call your local claude/codex/agy CLI to translate YouTube subtitles and selected text. Run: npx @lancetw/aiyu",
   "bin": {
     "aiyu": "install.js"
   },
+  "scripts": {
+    "test": "node --test"
+  },
   "files": [
     "aiyu-host.js",
     "install.js"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20.12.0"
   },
   "license": "MIT",
   "author": "lancetw",
@@ -32,5 +36,8 @@
     "chrome-extension",
     "claude",
     "codex"
-  ]
+  ],
+  "dependencies": {
+    "@clack/prompts": "1.4.0"
+  }
 }