alink-cli 0.5.0 → 0.6.1

package/README.md

@@ -12,12 +12,20 @@ One command on your work machine links it to AgentLink so you can drive your loc
 npx alink-cli --token al1.xxxxxxxx
 ```
 
-首次成功连上后，凭证会存到 `~/.agentlink/credential`（权限 `0600`）。之后在同一台机器上**直接裸跑**即可，命令行 token 只需出现这一次：
+首次成功连上后，凭证会存到 `~/.agentlink/credential`（权限 `0600`）。之后在同一台机器上**直接裸跑**即可，命令行 token 只需出现这一次；裸跑会默认转入后台，日志在 `~/.agentlink/daemon.log`：
 
 ```bash
 npx alink-cli
 ```
 
+需要手动改凭证时：
+
+```bash
+npx alink-cli credential set al1.xxxxxxxx
+npx alink-cli credential show
+npx alink-cli credential clear
+```
+
 ## 参数 Options
 
 | 参数 | 说明 | 默认值 |
@@ -26,6 +34,9 @@ npx alink-cli
 | `--hub <wss://…>` | 要连接的 hub 地址。 | `wss://link.harmopath.com`（官方 hub） |
 | `--dir <path>` | 工作目录根，可重复给多次；运行时可用其下任意子目录，网页里以目录树浏览。 | 当前目录 `process.cwd()` |
 | `--tunnel` | 不连任何 hub：本地起一个 hub + 免费 Cloudflare 隧道，打印公网链接（需 `cloudflared`）。与 `--hub` 互斥。 | — |
+| `credential [status|path|show|set|clear]` | 查看路径、明文显示、手动覆盖或删除本机保存的凭证。 | `~/.agentlink/credential` |
+| `qr` | 在终端打印本机凭证二维码，同时输出整串凭证供手动粘贴。 | 读取已保存凭证 |
+| `status` / `logs -f` / `stop` / `restart` | 查看、跟随日志、停止或重启后台 daemon。 | — |
 | `--help`, `-h` | 显示用法。 | — |
 
 ## 自建 hub Self-hosting

package/bin/agentlink.js

@@ -22,7 +22,7 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-const OFFICIAL_HUB = "wss://link.harmopath.com";
+const OFFICIAL_HUB = process.env.AGENTLINK_DEFAULT_HUB || "wss://link.harmopath.com";
 
 // 凭证文件与 daemon 的状态目录同根（默认 ~/.agentlink，可用 AGENTLINK_STATE_DIR
 // 覆盖，测试用），文件名固定为 credential。
@@ -68,6 +68,51 @@ function persistCredential(token) {
   chmodSync(CREDENTIAL_FILE, 0o600);
 }
 
+if (rawArgs[0] === "credential" || rawArgs[0] === "cred") {
+  ctlCredential(rawArgs.slice(1));
+  process.exit(0);
+}
+
+function ctlCredential(args) {
+  const cmd = args[0] || "status";
+  if (cmd === "path") {
+    console.log(CREDENTIAL_FILE);
+    return;
+  }
+  if (cmd === "status") {
+    console.log(`[agentlink] 凭证文件: ${CREDENTIAL_FILE}`);
+    console.log(readCredentialFile() ? "[agentlink] 已保存凭证。用 credential show 查看，credential set 修改。" : "[agentlink] 未保存凭证。用 credential set <凭证> 写入。");
+    return;
+  }
+  if (cmd === "show") {
+    const token = readCredentialFile();
+    if (!token) {
+      console.error("[agentlink] 还没有保存凭证。");
+      process.exit(1);
+    }
+    console.log(token);
+    return;
+  }
+  if (cmd === "set") {
+    const raw = args[1] === "-" ? readFileSync(0, "utf-8") : args[1];
+    const token = raw?.trim();
+    if (!token || /\s/.test(token)) {
+      console.error("[agentlink] 用法: alink-cli credential set <al1.…>  或  alink-cli credential set - < token.txt");
+      process.exit(1);
+    }
+    persistCredential(token);
+    console.log(`[agentlink] 凭证已保存到 ${CREDENTIAL_FILE}（0600）。`);
+    return;
+  }
+  if (cmd === "clear") {
+    rmSync(CREDENTIAL_FILE, { force: true });
+    console.log(`[agentlink] 已删除 ${CREDENTIAL_FILE}。`);
+    return;
+  }
+  console.error("[agentlink] 用法: alink-cli credential [status|path|show|set|clear]");
+  process.exit(1);
+}
+
 // `qr` 子命令：在终端打印本机凭证的二维码（含 E2EE 密钥段）+ 指纹——给新手机
 // 的「录入密钥」扫。凭证从 --token / AGENTLINK_TOKEN / 落盘文件取，不联网。
 if (rawArgs[0] === "qr") {
@@ -87,6 +132,9 @@ if (rawArgs[0] === "qr") {
   const fp = createHash("sha256").update(Buffer.from(enckey, "base64url")).digest("hex").slice(0, 8);
   console.log("用手机 AgentLink 的「录入密钥」扫下面的二维码：\n");
   renderQr(token);
+  console.log("\n凭证信息（无法扫码时可手动粘贴）：\n");
+  console.log(token);
+  console.log("");
   console.log(`密钥指纹 ${fp} —— 与手机上显示的一致即可放心保存。`);
   process.exit(0);
 }
@@ -95,7 +143,8 @@ if (rawArgs[0] === "qr") {
 // 后台管理子命令：start / stop / status / logs / restart。
 // `start` 把 daemon 挂到后台（detached，日志写 ~/.agentlink/daemon.log，进程
 // 元数据写 daemon.json），其余子命令围着这两个文件 + daemon 自己维护的
-// status.json 转。裸跑仍是前台——首次扫码配对必须能看见终端里的二维码。
+// status.json 转。首次无凭证裸跑仍是前台——扫码配对必须能看见终端里的二维码；
+// 已有凭证的裸跑默认转后台。
 
 const DAEMON_JSON = join(STATE_DIR, "daemon.json");
 const DAEMON_LOG = join(STATE_DIR, "daemon.log");
@@ -145,7 +194,7 @@ function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 
-async function ctlStart(args) {
+async function ctlStart(args, { alreadyOk = false } = {}) {
   if (hasFlag("tunnel", args)) {
     console.error("[agentlink] --tunnel 模式带着 cloudflared 子进程，请前台运行（不支持 start）。");
     process.exit(1);
@@ -156,7 +205,13 @@ async function ctlStart(args) {
   }
   const already = runningDaemon();
   if (already) {
-    console.error(`[agentlink] 已在后台运行 (pid ${already.pid})。要重启用 alink-cli restart。`);
+    const msg = `[agentlink] 已在后台运行 (pid ${already.pid})。要重启用 alink-cli restart。`;
+    if (alreadyOk) {
+      console.log(msg);
+      console.log(`[agentlink] 日志: ${DAEMON_LOG}`);
+      return;
+    }
+    console.error(msg);
     process.exit(1);
   }
   // 凭证前置检查：后台进程没法扫码配对（二维码只会写进日志文件），所以
@@ -175,7 +230,7 @@ async function ctlStart(args) {
   const child = spawn(process.execPath, [fileURLToPath(import.meta.url), ...args], {
     detached: true,
     stdio: ["ignore", logFd, logFd],
-    env: process.env,
+    env: { ...process.env, AGENTLINK_FOREGROUND: "1" },
   });
   child.unref();
   writeFileSync(DAEMON_JSON, JSON.stringify({ pid: child.pid, args, startedAt: Date.now() }));
@@ -308,11 +363,22 @@ async function ctlRestart(args) {
   await ctlStart(startArgs);
 }
 
-// --tunnel 模式下 daemon 会自起本地 hub，且与 --hub 互斥，所以此时绝不注入 --hub。
+if (rawArgs.length === 0 && !process.env.AGENTLINK_FOREGROUND && (process.env.AGENTLINK_TOKEN || readCredentialFile())) {
+  await ctlStart([], { alreadyOk: true });
+  process.exit(0);
+}
+
+// `local` 子命令 = 同机驾驶舱：本地起 single 模式 hub + daemon，自动开浏览器，
+// 不遥控。归一成 daemon 认的 --local flag（daemon 参数不收 positional）。既接受
+// `npx alink-cli local`，也接受 `npx alink-cli --local`。
+if (rawArgs[0] === "local") rawArgs[0] = "--local";
+
+// --tunnel / --local 模式下 daemon 会自起本地 hub，且与 --hub 互斥，此时绝不注入 --hub。
 const tunnelMode = hasFlag("tunnel");
+const localMode = hasFlag("local");
 
-// 1) 补 --hub 默认值：官方 hub。
-if (!hasFlag("hub") && !tunnelMode) {
+// 1) 补 --hub 默认值：官方 hub。本地模式（tunnel/local）自带 localhost hub，跳过。
+if (!hasFlag("hub") && !tunnelMode && !localMode) {
   rawArgs.push("--hub", OFFICIAL_HUB);
 }
 
@@ -330,6 +396,9 @@ if (hasFlag("pair")) {
   if (explicitToken !== readCredentialFile()) tokenToPersist = explicitToken;
 } else if (process.env.AGENTLINK_TOKEN) {
   // 环境变量已给——daemon 自己会读 AGENTLINK_TOKEN，这里什么都不用做。
+} else if (localMode) {
+  // --local：single 模式本地 hub，daemon 自己现生成一个 UUID token 并打印/开浏览器。
+  // 不复用落盘凭证（那多半是官方 al1. 多租户串，喂给本地 single hub 是错的），也不配对。
 } else {
   // 命令行和环境变量都没有——回落到落盘凭证（若有），塞进 AGENTLINK_TOKEN 供
   // daemon 读取。
@@ -379,14 +448,16 @@ function printHelp() {
   process.stdout.write(
     [
       `用法: npx ${self} [--hub <wss://…>] [--dir <目录>]…`,
+      `      npx ${self} local [--dir …]    # 同机驾驶舱：本地起 hub 并自动开浏览器，不遥控`,
       `      npx ${self} qr                 # 终端打印本机凭证二维码（给新手机录密钥）`,
+      `      npx ${self} credential set <凭证> # 手动写入 / 修改本机保存的凭证`,
       `      npx ${self} start [--dir …]    # 后台运行（先前台配对过一次）`,
       `      npx ${self} status|logs [-f]|stop|restart`,
       ``,
       `把当前这台工作机接入 AgentLink，随时随地遥控本机的编码 agent。`,
       `首次裸跑会进入扫码配对：加密密钥在这台电脑上生成，终端打出二维码，`,
       `用手机 AgentLink 的「添加机器」扫一下即绑定——密钥只走二维码，不经过服务器。`,
-      `绑定后可用 start 挂到后台（日志 ~/.agentlink/daemon.log），status 看连接`,
+      `绑定后裸跑会默认挂到后台（日志 ~/.agentlink/daemon.log），status 看连接`,
       `状态，logs -f 跟日志，stop/restart 停止或重启。`,
       ``,
       `参数:`,
@@ -394,10 +465,15 @@ function printHelp() {
       `  --token <token>  直接给机器凭证（al1.… 整串，如从别处迁移）。首次成功连上后`,
       `                   存到 ~/.agentlink/credential（0600），之后裸跑自动复用。`,
       `                   也可用环境变量 AGENTLINK_TOKEN 提供（--token 优先）。`,
+      `  credential       管理本机保存的凭证：status/path/show/set/clear。show 会明文打印`,
+      `                   凭证；set 直接覆盖 ~/.agentlink/credential。`,
       `  --hub <url>      hub 地址，缺省官方 hub ${OFFICIAL_HUB}。`,
       `  --dir <path>     工作目录根，可重复；缺省当前目录。运行时可用其下任意子目录。`,
       `  --tunnel         不连任何 hub：本地起 hub + 免费 Cloudflare 隧道并打印公网链接`,
       `                   （需已安装 cloudflared）。与 --hub 互斥。`,
+      `  local            同机场景：本地起 single 模式 hub + daemon，自动用浏览器打开`,
+      `                   控制台（localhost），把这台电脑上的多个 agent 统一管起来。`,
+      `                   不遥控、不联网、无需扫码。--port 可改本地 hub 端口（默认 8080）。`,
       `  --help, -h       显示本帮助。`,
       ``,
       `示例:`,