cofluxd 0.1.2 → 0.2.0

package/README.md

@@ -11,10 +11,11 @@ npm i -g cofluxd
 ## 用法
 
 ```sh
-cofluxd                 # 首次=交互式引导（问服务器/登记密钥/设备名），之后=看状态
+cofluxd                 # 首次=交互式引导（问登记密钥/设备名，不问服务器地址），之后=看状态
 cofluxd onboard         # 显式重新走交互式配置
-cofluxd up --enroll-key <KEY>   # 非交互（web「添加设备」给的命令）
-cofluxd status          # 服务器/登记/服务状态
+cofluxd up              # 零参数即可：起服务后打印浏览器授权链接，登录确认即完成登记
+cofluxd up --enroll-key <KEY>   # 走存量登记密钥流程（web「添加设备」给的命令）
+cofluxd status          # 服务器/登记（含"等待授权"）/服务状态
 cofluxd logs -f         # 看 daemon 日志
 cofluxd update          # 更新二进制并重启（worker 另可由 server 远程热升级）
 cofluxd reload          # 改了 settings.json 后重启生效
@@ -22,7 +23,9 @@ cofluxd down            # 停止
 cofluxd uninstall [--purge]   # 卸载（--purge 连二进制/配置/凭证一并删）
 ```
 
-默认连公共服务 `wss://api.coflux.dev/daemon`（自托管用 `--server` 改）。登记密钥从 web 控制台「添加设备」获取。
+默认连公共服务 `wss://api.coflux.dev/daemon`（自托管用 `--server` 改；已保存的地址继续生效，非默认时会有醒目提示）。
+
+不带 `--enroll-key` 时（推荐、默认）：`cofluxd up` 起服务后会打印一个一次性授权链接，在浏览器用已登录的账号打开确认即可，无需先去 web 控制台生成密钥。仍可用 `--enroll-key`（从 web 控制台「添加设备」获取）走无头/脚本化登记。
 
 ## 配置
 

package/cofluxd.mjs

@@ -11,7 +11,6 @@ import { spawnSync } from "node:child_process";
 
 // 默认中心服务（公共 SaaS）；自托管用 --server 覆盖。
 const DEFAULT_SERVER = "wss://api.coflux.dev/daemon";
-const DEFAULT_WEB = "https://app.coflux.dev";
 
 const REPO = "myWsq/coflux";
 const HOME = process.env.COFLUX_HOME || join(homedir(), ".coflux");
@@ -19,6 +18,7 @@ const BIN_DIR = join(HOME, "bin");
 const SETTINGS = join(HOME, "settings.json"); // 用户配置（含一次性登记密钥）→ daemon 直接读；含密钥故 600
 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 SUP_BIN = join(BIN_DIR, "coflux-supervisor");
 const WRK_BIN = join(BIN_DIR, "coflux-worker");
 const IS_MAC = platform() === "darwin";
@@ -40,6 +40,12 @@ function readSettings() {
   try { return JSON.parse(fs.readFileSync(SETTINGS, "utf8")); } catch { return {}; }
 }
 
+function readPendingAuth() {
+  try { return JSON.parse(fs.readFileSync(PENDING_AUTH, "utf8")); } catch { return null; }
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
 async function download(url, dest) {
   const res = await fetch(url, { redirect: "follow" });
   if (!res.ok) die(`下载失败 HTTP ${res.status}: ${url}\n（该版本/平台的 release 资产是否已发布？）`);
@@ -157,12 +163,44 @@ function stopService() {
 async function applyAndStart({ serverUrl, enrollKey, deviceName, shell, version, binDir, noStart }) {
   await ensureBinaries({ version, binDir });
   const settings = applyConfig({ serverUrl, enrollKey, deviceName, shell });
-  if (!settings.enrollKey && !fs.existsSync(CRED)) {
-    console.warn("⚠ 无登记密钥且未登记：从 web「添加设备」获取后重跑。");
+  // 非默认服务器醒目提示：保存值/--server 仍生效（不强制覆盖），但防止 staging 之类残留值静默错连。
+  if (serverUrl !== DEFAULT_SERVER) {
+    console.log(`⚠ 使用非默认服务器: ${serverUrl}`);
   }
   installService(!noStart);
   console.log(noStart ? "已安装（未启动）。" : `✓ daemon 已启动 → ${serverUrl}`);
-  cmdStatus();
+  if (!noStart && !settings.enrollKey && !fs.existsSync(CRED)) {
+    // 默认流程（零参数 up）：无登记密钥、未登记 → 走浏览器授权，轮询 daemon 落盘的链接/凭证文件。
+    await waitForAuthorization();
+  } else {
+    cmdStatus();
+  }
+}
+
+// 轮询 ~/.coflux/pending-auth.json（授权链接）与 credentials.json（登记成功）给出全程反馈。
+// CLI 保持零协议：只读文件，不连 WS；daemon 断线重连会自动重发 enrollRequest、换发新链接。
+async function waitForAuthorization() {
+  console.log("\n  等待设备授权 …\n");
+  const maxWaitMs = 11 * 60 * 1000; // 只是前台等待的上限；daemon 会持续自动续期授权链接，超时后用 status 看最新链接即可
+  const start = Date.now();
+  let printedUrl = null;
+  while (Date.now() - start < maxWaitMs) {
+    if (fs.existsSync(CRED)) {
+      console.log("✓ 设备已登记\n");
+      cmdStatus();
+      return;
+    }
+    const pending = readPendingAuth();
+    if (pending?.url && pending.url !== printedUrl) {
+      printedUrl = pending.url;
+      const mins = Number.isFinite(pending.expiresAt) ? Math.max(1, Math.round((pending.expiresAt - Date.now()) / 60000)) : null;
+      console.log(`  在浏览器打开以下链接，用已登录账号授权此设备${mins ? `（约 ${mins} 分钟内有效）` : ""}：\n`);
+      console.log(`    ${pending.url}\n`);
+    }
+    await sleep(1000);
+  }
+  // 链接会过期换新（daemon 自动续期），别引导用户用"上面的链接"——过期后那是死链
+  console.log("  仍未完成授权；daemon 已在后台运行并会自动更换过期的授权链接，用 `cofluxd status` 查看最新链接。\n");
 }
 
 /* ------------------------------ 命令 ------------------------------ */
@@ -180,13 +218,15 @@ async function cmdUp(v) {
 
 async function cmdOnboard(v) {
   const s = readSettings();
+  // 服务器地址不再交互询问（用户拍板 2026-07-04）：--server > 已保存值 > 默认公共服务；
+  // 优先级与 cmdUp 一致（见 packages/cli/cofluxd.mjs 里 applyAndStart 的非默认提示）。
+  const serverUrl = v.server || s.serverUrl || DEFAULT_SERVER;
   console.log("\n  欢迎使用 coflux —— 配置这台设备\n  ──────────────────────────────\n");
+  console.log(`  服务器: ${serverUrl}\n`);
+  console.log("  登记方式：留空走浏览器授权（推荐，起服务后打印链接，登录确认即可）；\n  已有登记密钥可直接粘贴。\n");
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
-    const serverUrl = (await rl.question(`服务器地址 [${s.serverUrl || DEFAULT_SERVER}]: `)).trim() || s.serverUrl || DEFAULT_SERVER;
-    const web = serverUrl === DEFAULT_SERVER ? DEFAULT_WEB : "你的 coflux web 控制台";
-    console.log(`\n  → 打开 ${web} 登录 →「添加设备」→ 复制登记密钥\n`);
-    const enrollKey = (await rl.question("登记密钥（已登记可留空）: ")).trim();
+    const enrollKey = (v["enroll-key"] ?? (await rl.question("登记密钥（可留空）: "))).trim();
     const deviceName = (await rl.question(`设备名 [${s.deviceName || hostname()}]: `)).trim() || s.deviceName || hostname();
     rl.close();
     console.log("");
@@ -216,7 +256,17 @@ function cmdStatus() {
   const s = readSettings();
   console.log(`服务器: ${s.serverUrl || "(未配置)"}`);
   console.log(`设备名: ${s.deviceName || "(默认)"}`);
-  console.log(`凭证:   ${fs.existsSync(CRED) ? "已登记" : "未登记"}`);
+  const registered = fs.existsSync(CRED);
+  const pending = !registered ? readPendingAuth() : null;
+  if (registered) {
+    console.log("凭证:   已登记");
+  } else if (pending?.url) {
+    const mins = Number.isFinite(pending.expiresAt) ? Math.max(0, Math.round((pending.expiresAt - Date.now()) / 60000)) : null;
+    console.log(`凭证:   等待授权${mins !== null ? `（约 ${mins} 分钟内有效）` : ""}`);
+    console.log(`        ${pending.url}`);
+  } else {
+    console.log("凭证:   未登记");
+  }
   let running = false, active = "未运行";
   if (IS_MAC) {
     running = run("launchctl", ["list", "com.coflux.daemon"]).status === 0;
@@ -253,15 +303,15 @@ const HELP = `cofluxd —— coflux daemon 管理
 
   cofluxd                 首次=交互式配置(onboard)，已配置=status
   cofluxd onboard         交互式配置并启用
-  cofluxd up [flags]      非交互装/起（web「添加设备」给的命令用这个）
+  cofluxd up [flags]      非交互装/起，零参数即可（不带 --enroll-key 时打印浏览器授权链接）
   cofluxd reload          按 ~/.coflux/settings.json 重载并重启
   cofluxd update          更新二进制并重启（worker 另可远程热升级）
-  cofluxd status          服务器/登记/服务状态
+  cofluxd status          服务器/登记（含"等待授权"）/服务状态
   cofluxd logs [-f]       看 daemon 日志
   cofluxd down            停止
   cofluxd uninstall [--purge]   卸载（--purge 连二进制/配置/凭证一并删）
 
-up flags: --server <ws://.../daemon>  --enroll-key <KEY>  --name <名>  --shell <路径>
+up flags: --server <ws://.../daemon>  --enroll-key <KEY>（留空则走浏览器授权）  --name <名>  --shell <路径>
 通用: --version <vX|latest>(默认 latest)  --bin-dir <dir>(用本地 cargo 产物)  --no-start
 配置都在 ~/.coflux/settings.json（serverUrl/enrollKey/deviceName/shell，含密钥故 600），daemon 直接读；改后 cofluxd reload 生效。`;
 

package/package.json

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