alink-cli 0.10.1 → 0.11.0

package/README.md

@@ -1,55 +1,27 @@
-# alink-cli
+# AgentLink
 
-在手机或浏览器上，继续使用运行在你自己电脑上的 Claude Code、Codex、Gemini、Qwen、Kimi 等编码 agent。
+AgentLink 让你随时从手机或浏览器继续使用运行在自己电脑上的 Claude Code、Codex、Gemini、Qwen、Kimi 等编码 agent。
 
-> **Local-first：** agent 在你的电脑上运行，项目文件和任务记录保存在本机。AgentLink 只负责加密连接设备，Hub 不保存你的对话。
+**官网：[https://link.harmopath.com/marketing](https://link.harmopath.com/marketing)**
 
-## 三步开始
+## 本地运行，随时继续
 
-需要 Node.js 22.16 或更高版本。
-
-1. 安装 CLI
-
-   ```bash
-   npm install -g alink-cli
-   ```
-
-2. 启动 AgentLink，并按提示登录
-
-   ```bash
-   alink-cli
-   ```
-
-3. 在手机或浏览器打开 [AgentLink 控制台](https://link.harmopath.com/login)
-
-   登录同一个账号，你的电脑会自动出现。选择 agent 和工作目录，就可以开始任务或继续已有工作。
+- **Local-first：** agent、项目文件和任务记录都保存在你的电脑上。
+- **安全连接：** 设备之间端到端加密，Hub 不保存你的对话。
+- **跨设备继续：** 离开电脑后，仍可查看进度、回复消息和处理授权。
+- **一个账号：** 登录后自动发现自己的电脑，无需手动配置连接。
 
-关闭浏览器或锁屏后，任务仍会在你的电脑上继续运行。
+## 开始使用
 
-## Codex 会话衔接
-
-对于已经由 AgentLink 绑定的 Codex 原生会话，AgentLink 会先只读同步 Codex 中的终态消息。Codex 释放写入权后，从 AgentLink 发送的新消息会恢复同一个原生 thread，不会另建分叉会话。
-
-当前不会扫描或自动导入只在 Codex App 中新建、尚未绑定到 AgentLink 的会话；这类会话请先从 AgentLink 新建或绑定后再继续。
-
-## 为什么是 local-first
-
-- **本地运行：** agent 和命令都在你的电脑上执行。
-- **本地保存：** AgentLink 不会把你的项目复制到云端，任务记录保存在本机。
-- **安全连接：** 设备之间端到端加密；Hub 只转发连接，不保存对话内容。
-- **账号隔离：** 只有登录你账号的设备才能看到你的电脑。
-
-## 常用命令
+需要 Node.js 22.16 或更高版本。
 
 ```bash
-alink-cli           # 启动或管理连接
-alink-cli login     # 登录并添加这台电脑
-alink-cli status    # 查看连接状态
-alink-cli machines  # 查看账号下的电脑
-alink-cli logout    # 退出登录
+npm install -g alink-cli
+alink-cli
 ```
 
-## 了解更多
+按提示登录，然后在手机或浏览器打开 [AgentLink 控制台](https://link.harmopath.com/login)，即可开始任务或继续已有工作。
+
+`alink-cli login` 会打开浏览器，支持使用 GitHub 或已有 AgentLink 账号登录并添加当前电脑。
 
-- [完整文档](https://github.com/baichen99/agentlink)
-- [提交问题](https://github.com/baichen99/agentlink/issues)
+[GitHub](https://github.com/baichen99/agentlink) · [提交问题](https://github.com/baichen99/agentlink/issues)

package/bin/agentlink-account.js

@@ -140,6 +140,31 @@ export async function registerAgentLinkAccountMachine({
   }
 }
 
+export async function registerAgentLinkSessionMachine({
+  hub,
+  jwt,
+  machineName,
+  fetchFn = fetch,
+  randomBytesFn = randomBytes,
+}) {
+  const enckey = randomBytesFn(32).toString("base64url");
+  const response = await fetchFn(httpUrl(hub, "/api/machines/mint"), {
+    method: "POST",
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    headers: {
+      Authorization: `Bearer ${jwt}`,
+      "Content-Type": "application/json",
+      "X-Requested-With": "agentlink",
+    },
+    body: JSON.stringify({ name: machineName, enckey }),
+  });
+  const minted = await json(response);
+  if (!response.ok || typeof minted.authToken !== "string" || !minted.authToken.startsWith("al1.")) {
+    throw new Error(minted.error || "机器注册失败。");
+  }
+  return { credential: `${minted.authToken}.${enckey}`, machineId: minted.machineId, jwt };
+}
+
 export async function listAgentLinkAccountMachinesFromHub({ hub, jwt, fetchFn = fetch }) {
   if (!jwt) throw new Error("没有可用的登录会话，请先运行 alink-cli login。");
   const response = await fetchFn(httpUrl(hub, "/api/machines"), {

package/bin/agentlink.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
 import { randomBytes } from "node:crypto";
+import { createServer } from "node:http";
 import { existsSync } from "node:fs";
 import { chmodSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { hostname, homedir } from "node:os";
@@ -14,6 +15,7 @@ import {
   listAgentLinkAccountMachinesFromHub,
   loadAgentLinkAccountConfig,
   registerAgentLinkAccountMachine,
+  registerAgentLinkSessionMachine,
 } from "./agentlink-account.js";
 import { accountCredentials } from "./agentlink-prompts.js";
 
@@ -146,21 +148,75 @@ async function createSingleCredential(hub) {
 }
 
 async function loginAndCreateCredential(hub, config) {
-  console.log("[agentlink] 首次使用，请登录 AgentLink 账号。");
-  const { identifier, password } = await accountCredentials();
-  const result = await registerAgentLinkAccountMachine({
-    hub,
-    config,
-    identifier,
-    password,
-    machineName: hostname(),
-  });
+  const envLogin = process.env.AGENTLINK_ACCOUNT && process.env.AGENTLINK_PASSWORD;
+  const result = envLogin
+    ? await registerAgentLinkAccountMachine({
+        hub,
+        config,
+        ...(await accountCredentials()),
+        machineName: hostname(),
+      })
+    : await browserLogin(hub).then((jwt) =>
+        registerAgentLinkSessionMachine({ hub, jwt, machineName: hostname() }),
+      );
   saveCredential(result.credential, hub);
   if (result.jwt) saveSessionJwt(result.jwt, hub);
   console.log("[agentlink] 登录成功，这台电脑已加入账号。");
   return result.credential;
 }
 
+async function browserLogin(hub) {
+  const state = randomBytes(24).toString("base64url");
+  return new Promise((resolve, reject) => {
+    const server = createServer((req, res) => {
+      if (req.method !== "POST") {
+        res.writeHead(405).end();
+        return;
+      }
+      let body = "";
+      req.setEncoding("utf8");
+      req.on("data", (chunk) => {
+        body += chunk;
+        if (body.length > 16_384) req.destroy();
+      });
+      req.on("end", () => {
+        const value = new URLSearchParams(body);
+        const jwt = value.get("jwt");
+        if (value.get("state") !== state || !jwt) {
+          res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" }).end("登录请求无效。");
+          return;
+        }
+        res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" }).end("登录成功，可以关闭此页面。");
+        clearTimeout(timer);
+        server.close();
+        resolve(jwt);
+      });
+    });
+    const timer = setTimeout(() => {
+      server.close();
+      reject(new Error("浏览器登录超时，请重试。"));
+    }, 10 * 60_000);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        clearTimeout(timer);
+        server.close();
+        reject(new Error("无法启动本地登录回调。"));
+        return;
+      }
+      const url = httpUrl(hub, "/login");
+      url.searchParams.set("cli_callback", `http://127.0.0.1:${address.port}/callback`);
+      url.searchParams.set("cli_state", state);
+      console.log(`\n请在浏览器完成 GitHub 登录：\n${url}\n`);
+      const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+      const commandArgs = process.platform === "win32" ? ["/c", "start", "", url.toString()] : [url.toString()];
+      const opener = spawn(command, commandArgs, { detached: true, stdio: "ignore" });
+      opener.on("error", () => undefined);
+      opener.unref();
+    });
+  });
+}
+
 async function printQr(text) {
   const { renderQr } = await import(new URL("../dist/qr.js", import.meta.url));
   renderQr(text);

package/dist/bin.mjs

@@ -53573,8 +53573,9 @@ const runHubTunnel = (config) => gen(function* () {
 			}
 		}, { onOpen: logInfo("hub tunnel: connected to hub").pipe(tap(() => sync(() => void runFork(upload)))) }).pipe(tapDefect((cause) => logWarning$1("hub tunnel: hub socket defect", { cause: String(cause) })));
 		yield* logWarning$1("hub tunnel: hub connection closed");
+		return yield* fail(/* @__PURE__ */ new Error("hub tunnel closed"));
 	}).pipe(scoped, tapError((error) => logWarning$1("hub tunnel: connection error", { error }))), {
-		schedule: spaced("2 seconds"),
+		schedule: spaced("500 millis"),
 		while: (error) => !(SocketError.is(error) && error.reason._tag === "SocketCloseError" && (error.reason.code === 4401 || error.reason.code === 4403))
 	});
 }).pipe(tapDefect((cause) => logError("hub tunnel: worker defect", { cause: String(cause) })), catchCause((cause) => logError("hub tunnel: worker failed", { cause: String(cause) })));
@@ -89460,7 +89461,7 @@ const ProviderRuntimeIngestionLive = effect(ProviderRuntimeIngestionService, gen
 	});
 	const reconcileThread = (threadId, options) => withThreadLock(threadId, reconcileThreadUnlocked(threadId, options)).pipe(mapError((cause) => cause instanceof ProviderRuntimeReconciliationError ? cause : new ProviderRuntimeReconciliationError({
 		threadId,
-		detail: cause instanceof Error ? cause.message : "Provider snapshot sync failed.",
+		detail: cause instanceof Error && cause.message.toLowerCase().includes("active writer") ? "对话正在另一端运行，请等待另一端结束后再继续。" : cause instanceof Error ? cause.message : "Provider snapshot sync failed.",
 		cause
 	})));
 	const processDomainEvent = (_event) => void_$1;