alink-cli 0.6.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,6 +363,11 @@ async function ctlRestart(args) {
   await ctlStart(startArgs);
 }
 
+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`。
@@ -390,13 +450,14 @@ function printHelp() {
       `用法: 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 停止或重启。`,
       ``,
       `参数:`,
@@ -404,6 +465,8 @@ 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 隧道并打印公网链接`,

package/dist/daemon.js

@@ -23197,7 +23197,12 @@ function toolContentText(content) {
   }
   return parts.filter(Boolean).join("\n");
 }
-function routeUpdate(update, onEvent) {
+function cleanTitle(v) {
+  if (typeof v !== "string") return void 0;
+  const title = v.split("\n").find((line) => line.trim())?.trim();
+  return title ? title.slice(0, 200) : void 0;
+}
+function routeUpdate(update, onEvent, onTitle) {
   switch (update.sessionUpdate) {
     case "agent_message_chunk": {
       const t = textOf(update.content);
@@ -23222,6 +23227,11 @@ function routeUpdate(update, onEvent) {
       }
       return;
     }
+    case "session_info_update": {
+      const title = cleanTitle(update.title);
+      if (title) onTitle?.(title);
+      return;
+    }
     default:
       return;
   }
@@ -23254,7 +23264,7 @@ async function runAcp(o) {
     Readable.toWeb(child.stdout)
   );
   const app = client({ name: "agentlink" }).onNotification("session/update", async (ctx) => {
-    routeUpdate(ctx.params.update, o.onEvent);
+    routeUpdate(ctx.params.update, o.onEvent, o.onTitle);
   }).onRequest("session/request_permission", async (ctx) => handlePermission(ctx.params, o.requestPermission));
   const killChild = () => {
     try {
@@ -23802,7 +23812,8 @@ function parseClaudeArchive(text, opts) {
 function claudeArchiveMeta(headText, tailText) {
   let sessionId;
   let cwd;
-  let title = "";
+  let promptTitle = "";
+  let aiTitle = "";
   for (const raw of headText.split("\n")) {
     if (!raw.trim()) continue;
     let obj;
@@ -23813,28 +23824,35 @@ function claudeArchiveMeta(headText, tailText) {
     }
     if (typeof obj.sessionId === "string" && !sessionId) sessionId = obj.sessionId;
     if (typeof obj.cwd === "string" && !cwd) cwd = obj.cwd;
-    if (!title && obj.type === "user" && obj.message && typeof obj.message === "object") {
+    if (obj.type === "ai-title" && typeof obj.title === "string" && obj.title.trim()) {
+      aiTitle = firstLine(obj.title);
+    }
+    if (!promptTitle && obj.type === "user" && obj.message && typeof obj.message === "object") {
       const msg = obj.message;
-      if (isHumanPrompt(msg)) title = firstLine(userText(msg));
+      if (isHumanPrompt(msg)) promptTitle = firstLine(userText(msg));
     }
-    if (sessionId && cwd && title) break;
+    if (sessionId && cwd && aiTitle) break;
   }
   let lastLine = "";
+  let tailAiTitle = "";
   const tailLines = tailText.split("\n").filter((l) => l.trim());
-  for (let i = tailLines.length - 1; i >= 0 && !lastLine; i--) {
+  for (let i = tailLines.length - 1; i >= 0 && (!lastLine || !tailAiTitle); i--) {
     let obj;
     try {
       obj = JSON.parse(tailLines[i]);
     } catch {
       continue;
     }
+    if (!tailAiTitle && obj.type === "ai-title" && typeof obj.title === "string" && obj.title.trim()) {
+      tailAiTitle = firstLine(obj.title);
+    }
     if ((obj.type === "assistant" || obj.type === "user") && obj.message && typeof obj.message === "object") {
       const msg = obj.message;
       const text = obj.type === "assistant" ? assistantText(msg) : isHumanPrompt(msg) ? userText(msg) : "";
-      if (text.trim()) lastLine = firstLine(text);
+      if (!lastLine && text.trim()) lastLine = firstLine(text);
     }
   }
-  return { ...sessionId ? { sessionId } : {}, ...cwd ? { cwd } : {}, title, lastLine };
+  return { ...sessionId ? { sessionId } : {}, ...cwd ? { cwd } : {}, title: tailAiTitle || aiTitle || promptTitle, lastLine };
 }
 function assistantText(message) {
   const content = message.content;
@@ -24500,6 +24518,9 @@ function runAcpPath(ws, opts) {
     acpArgs: adapter.acp.args,
     env: spawnEnv(),
     onEvent: emitEvent,
+    onTitle: (title) => {
+      if (opts.conversationId) putConversation({ id: opts.conversationId, title });
+    },
     requestPermission,
     signal: controller.signal,
     onSpawn: (child) => void running.set(requestId, child)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alink-cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "一条命令把工作机接入 AgentLink，随时随地遥控本机的编码 agent。One command to link your machine to AgentLink and control your coding agents from anywhere.",
   "license": "MIT",
   "repository": {