cofluxd 0.2.0 → 0.3.0

package/cofluxd.mjs

@@ -19,6 +19,7 @@ const SETTINGS = join(HOME, "settings.json"); // 用户配置（含一次性登
 const LOG_FILE = join(HOME, "daemon.log");
 const CRED = join(HOME, "credentials.json");
 const PENDING_AUTH = join(HOME, "pending-auth.json"); // worker 落盘的待授权链接（daemon.authorizePending）
+const FDA_STATUS = join(HOME, "fda-status"); // supervisor 启动时探测落盘（仅 macOS，见 crates/supervisor/src/fda.rs）
 const SUP_BIN = join(BIN_DIR, "coflux-supervisor");
 const WRK_BIN = join(BIN_DIR, "coflux-worker");
 const IS_MAC = platform() === "darwin";
@@ -44,6 +45,14 @@ function readPendingAuth() {
   try { return JSON.parse(fs.readFileSync(PENDING_AUTH, "utf8")); } catch { return null; }
 }
 
+// "granted" | "denied" | "unknown" | null（文件不存在——supervisor 还没起过/还没写）
+function readFdaStatus() {
+  try { return fs.readFileSync(FDA_STATUS, "utf8").trim(); } catch { return null; }
+}
+function fdaLabel(status) {
+  return status === "granted" ? "已授予" : status === "denied" ? "未授予" : "未知";
+}
+
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 
 async function download(url, dest) {
@@ -175,6 +184,10 @@ async function applyAndStart({ serverUrl, enrollKey, deviceName, shell, version,
   } else {
     cmdStatus();
   }
+  if (IS_MAC && !noStart && readFdaStatus() !== "granted") {
+    console.log("\n⚠ 完全磁盘访问权限尚未授予：PTY 里访问桌面/文稿/下载等目录时，系统弹窗可能因无人点击而卡住。");
+    console.log("  运行 `cofluxd fda` 完成一次性授权（授予后需重启服务生效）。");
+  }
 }
 
 // 轮询 ~/.coflux/pending-auth.json（授权链接）与 credentials.json（登记成功）给出全程反馈。
@@ -280,6 +293,11 @@ function cmdStatus() {
     try { pid = ` (worker pid ${fs.readFileSync(join(HOME, "worker.pid"), "utf8").trim()})`; } catch { /* */ }
   }
   console.log(`服务:   ${active}${pid}`);
+  if (IS_MAC) {
+    const fda = readFdaStatus();
+    const hint = fda === "granted" ? "" : "（`cofluxd fda` 引导授权，避免弹窗卡住 PTY 会话）";
+    console.log(`FDA:    ${fdaLabel(fda)}${hint}`);
+  }
 }
 
 function cmdLogs(v) {
@@ -291,6 +309,28 @@ function cmdLogs(v) {
   }
 }
 
+// 完全磁盘访问权限（FDA）引导：macOS 不允许程序自动弹出 FDA 授权窗（Apple 刻意设计），
+// 上限就是检测 + 跳转系统设置 + 引导手动添加。授权对象是 supervisor 二进制本身——worker/PTY/agent
+// 都是它的子进程，TCC 按 launchd 服务的 responsible process 归属，一次授权覆盖全树。
+async function cmdFda() {
+  if (!IS_MAC) die("此命令仅 macOS 可用（Linux 无 TCC/FDA 概念，无需授权）");
+  console.log("\n  完全磁盘访问权限（FDA）引导\n  ──────────────────────────\n");
+  console.log("  macOS 不支持程序自动弹出 FDA 授权窗，需手动在「系统设置」里添加。");
+  console.log("  请把下面这个二进制拖进「隐私与安全性 → 完全磁盘访问权限」列表并勾选：\n");
+  console.log(`    ${SUP_BIN}\n`);
+  console.log("  即将打开系统设置面板，并在 Finder 中定位该二进制……\n");
+  run("open", ["x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"]);
+  run("open", ["-R", SUP_BIN]);
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    await rl.question("  添加并勾选后按回车，重启服务使授权生效… ");
+  } finally {
+    rl.close();
+  }
+  restartService();
+  console.log("\n✓ 已重启服务（FDA 对已运行进程不生效，必须重启才能生效）。稍候用 `cofluxd status` 确认已授予。");
+}
+
 function cmdUninstall(v) {
   stopService();
   try { fs.rmSync(IS_MAC ? PLIST : UNIT); } catch { /* */ }
@@ -307,6 +347,7 @@ const HELP = `cofluxd —— coflux daemon 管理
   cofluxd reload          按 ~/.coflux/settings.json 重载并重启
   cofluxd update          更新二进制并重启（worker 另可远程热升级）
   cofluxd status          服务器/登记（含"等待授权"）/服务状态
+  cofluxd fda             [仅 macOS] 引导授予完全磁盘访问权限（避免 PTY 因 TCC 弹窗卡住）
   cofluxd logs [-f]       看 daemon 日志
   cofluxd down            停止
   cofluxd uninstall [--purge]   卸载（--purge 连二进制/配置/凭证一并删）
@@ -335,7 +376,7 @@ let cmd = positionals[0];
 if (values.help || cmd === "help") { console.log(HELP); process.exit(0); }
 if (!cmd) cmd = fs.existsSync(SETTINGS) ? "status" : "onboard"; // 首次裸跑 → 引导
 
-const handlers = { up: cmdUp, onboard: cmdOnboard, reload: cmdReload, update: cmdUpdate, down: cmdDown, status: cmdStatus, logs: cmdLogs, uninstall: cmdUninstall };
+const handlers = { up: cmdUp, onboard: cmdOnboard, reload: cmdReload, update: cmdUpdate, down: cmdDown, status: cmdStatus, fda: cmdFda, logs: cmdLogs, uninstall: cmdUninstall };
 const h = handlers[cmd];
 if (!h) die(`未知命令: ${cmd}\n\n${HELP}`);
 await h(values);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cofluxd",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "coflux daemon 管理 CLI：装/起/停/升级 Rust daemon（supervisor + worker）",
   "type": "module",
   "bin": {