agent-loft 0.2.21 → 0.2.23

package/README.md

@@ -2,7 +2,7 @@
 
 # agent-loft
 
-**多个 agent 的工作台。** 把本机的 **Claude Code**、**Codex**（以后还有更多）放到同一张台面上统一管理，在网页、飞书和 Mac 桌面端随时驱动它们，进展推送到飞书、iPhone 和 Mac。
+**多个 agent 的工作台。** 把本机的 **Claude Code**、**Codex**（以后还有更多）放到同一张台面上统一管理，在网页、飞书和桌面端（macOS / Windows / Linux）随时驱动它们，进展推送到飞书、iPhone 和 Mac。
 
 ![Web 工作台](docs/images/web-chat.png)
 
@@ -30,7 +30,7 @@ Logo 就是这个意思：一大两小几颗星（多个 agent）站在同一张
 | 🔗 | **飞书续接 Web 任务** | 飞书里发 `/web` 接上一条 Web 会话，或者在网页侧栏右键会话选「在飞书继续…」。之后回复、授权、提问都发到飞书，发 `/detach` 回来 |
 | 🖥️ | **完整的 Web 工作台** | 流式回复、附件、语音输入、模型和思考程度切换、上下文占用、从任意回复分叉、按项目分组的侧栏、全部设置，电脑和手机（PWA）都能用 |
 | 🔔 | **飞书 + 苹果系统推送** | 除了飞书消息，Web 会话还能推送到 iPhone、iPad 锁屏和 Mac 通知中心（标准 Web Push，不需要开发者账号），图标上显示未读数 |
-| 🗂️ | **桌面端同时接入多台设备** | macOS 桌面端同时连多台服务器，菜单栏一眼看完各台的额度、待处理和运行中的会话 |
+| 🗂️ | **桌面端同时接入多台设备** | 桌面端（macOS / Windows / Linux）同时连多台服务器，菜单栏 / 托盘一眼看完各台的额度、待处理和运行中的会话 |
 
 ## 能做什么
 
@@ -52,7 +52,8 @@ Logo 就是这个意思：一大两小几颗星（多个 agent）站在同一张
 - **系统通知**：Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑（设置 → 通知 → 「在此设备开启通知」，可以发测试通知）。飞书会话由飞书提醒，正在前台看着的会话不推。需要 HTTPS 访问，iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
 - **跨渠道同步**：飞书里的会话在 Web 上也能打开接着聊。同一个授权请求同时出现在飞书卡片和网页上，哪边先点算哪边，另一边自动变成「已处理」。
 - **授权**：允许一次 / 本会话全部允许 / 总是允许（按钮上写明放行范围）/ 拒绝。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问（Bash 仍询问）。超时一律按拒绝处理。
-- **设置都在网页上**：工作目录、会话闲置过期时间、局域网访问和端口、各 agent 的默认模型和思考程度、可选模型、Codex 沙箱、飞书机器人、配对批准、Claude 的「总是允许」名单、通知设备、登录设备管理、服务端升级。
+- **设置都在网页上**：工作目录、会话闲置过期时间、局域网访问和端口、各 agent 的默认模型和思考程度、可选模型、Codex 沙箱、飞书机器人、配对批准、Claude 的「总是允许」名单、通知设备、登录设备管理、用户管理、服务端升级。
+- **多用户**（信任型）：管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知，设置只有管理员能改，见下面「安全」。
 
 ## 安装
 
@@ -64,20 +65,26 @@ agent-loft start                  # 前台运行，日志里会打印首次登
 agent-loft service install        # 注册为开机自启服务（systemd / launchd），日志在 ~/.agent-loft/logs/
 ```
 
-打开 `http://<机器 IP>:8800`（本机用 `http://localhost:8800`）：第一次需要输入日志里的设置码，然后设一个登录密码。设置码找不到的话，直接运行 `agent-loft passwd` 设密码。
+打开 `http://<机器 IP>:8800`（本机用 `http://localhost:8800`）：第一次需要输入日志里的设置码，然后建一个管理员账号（用户名默认 `admin`）。设置码找不到的话，直接运行 `agent-loft passwd` 设密码。
 
-到 设置 → Agent 检查 Claude Code、Codex 装好、登录了没有：Claude Code 随 agent-loft 一起安装，只需在服务端终端里登录；Codex 可以点「直接在服务器上安装」。设置 → 通用 里能看到服务端版本，有新版本时点「升级」即可（`npm install -g agent-loft@latest`，以系统服务运行时会自动重启，打开的页面会自动刷新）。
+到 设置 → Agent 检查 Claude Code、Codex 装好、登录了没有：Claude Code 随 agent-loft 一起安装，只需在服务端终端里登录；Codex 可以点「直接在服务器上安装」。设置 → 系统 里能看到服务端版本，有新版本时点「升级」即可（`npm install -g agent-loft@latest`，以系统服务运行时会自动重启，打开的页面会自动刷新）。
 
 在外面只用飞书的话不需要任何网络配置（机器人由服务端主动连向飞书）。在外面用网页、系统推送和语音输入需要 HTTPS，见下面的「安全」和[产品介绍里的「从外网访问」](docs/产品介绍.md#从外网访问)。
 
-### macOS 桌面端
+### 桌面端（macOS / Windows / Linux）
 
-到 [Releases](https://github.com/qijieinnet/agent-loft/releases) 下载 `desktop-v*` 里对应芯片的 DMG（Apple 芯片选 arm64，Intel 选 x64），拖进「应用程序」。还没有 Apple 开发者签名，第一次打开如果提示无法验证，到 系统设置 → 隐私与安全性 里点「仍要打开」。
+到 [Releases](https://github.com/qijieinnet/agent-loft/releases) 下载 `desktop-v*` 里对应的安装包：
+
+- **macOS**：对应芯片的 DMG（Apple 芯片选 arm64，Intel 选 x64），拖进「应用程序」。还没有 Apple 开发者签名，第一次打开如果提示无法验证，到 系统设置 → 隐私与安全性 里点「仍要打开」。
+- **Windows**：`Agent-Loft-Setup-*-x64.exe`，装在用户目录里，不用管理员权限。没有代码签名，SmartScreen 拦的话点「更多信息 → 仍要运行」。
+- **Linux**：Debian / Ubuntu 用 deb（`sudo apt install ./agent-loft-desktop_*_amd64.deb`），其他发行版用 AppImage（需要 libfuse2）；ARM 选 arm64。App 内一键更新只支持 AppImage。GNOME 要装 AppIndicator 扩展才看得到托盘图标。
+
+下面以 macOS 为例，Windows / Linux 上「菜单栏」是托盘、`⌘` 是 `Ctrl`：
 
 - 同时连多台服务器，顶部标签栏切换、拖动排序；每台各自登录，切走了也在后台连着，回复完成、需要授权时弹系统通知，程序坞图标显示未读数。
-- 菜单栏图标：悬停看各服务器的 Claude / Codex 额度、待处理和运行中的会话；双击打开主窗口。同一个账号的额度只查一次。
+- 菜单栏图标：悬停看各服务器的 Claude / Codex 额度、待处理和运行中的会话；双击打开主窗口。同一个账号的额度只查一次。（Windows 上点托盘图标弹出；Linux 上在托盘菜单里点「额度和待处理」。）
 - 支持前面挡着 Cloudflare Access 的服务器：验证页直接在窗口里完成，过期会提醒；也可以配 Service Token 免验证。
-- 首次打开可以选「这台 Mac 也作为服务端」：一键在终端里安装 agent-loft（没有 Node.js 会先用 Homebrew 装）并开机自启，装好自动连上。可选开启「本机有会话在跑时不休眠」。
+- 首次打开可以选「这台 Mac 也作为服务端」：一键在终端里安装 agent-loft（没有 Node.js 会先用 Homebrew 装）并开机自启，装好自动连上。Linux 上一样（需要先装好 Node.js 22+，开机自启用 systemd 用户服务）；Windows 上服务端还没有开机自启，可以在 WSL 里装，桌面端会自动检测到 `127.0.0.1` 上的它。可选开启「本机有会话在跑时不休眠」。
 - 设置（`⌘,`）的服务器列表里展开某台服务器，能看它的 Agent 环境和版本，有新版本时点「升级服务端」；桌面端自己的更新在同一页的「更新」里点「更新并重启」。
 
 桌面端只是个壳（代码在 `desktop/`），服务端照常用 npm 安装和升级。
@@ -100,7 +107,8 @@ agent-loft service install
 | `agent-loft start` | 启动 |
 | `agent-loft import [--only claude\|codex] [--disabled] [--dry-run]` | 从旧桥接器导入 |
 | `agent-loft pair list \| approve <码> \| revoke <机器人id> <open_id>` | 配对管理（Web 设置页里也能做） |
-| `agent-loft passwd [新密码]` | 重置 Web 登录密码，所有设备下线 |
+| `agent-loft passwd [新密码] [--user 用户名]` | 重置 Web 登录密码（默认是最早的管理员），他的设备全部下线 |
+| `agent-loft user list \| add <用户名> [--admin] \| passwd <用户名> \| role <用户名> admin\|member \| disable \| enable \| remove` | 管理 Web 登录用户（设置 → 用户 里也能做） |
 | `agent-loft service install \| uninstall \| restart \| status` | 开机自启 |
 | `agent-loft doctor` | 体检 |
 
@@ -114,9 +122,11 @@ agent-loft service install
 
 这个服务能让 agent 在你的机器上执行命令，等于一个远程 shell。
 
-- Web 登录密码用 scrypt 哈希保存。首次设置必须用启动日志里的一次性设置码，防止「谁先打开页面谁就成了主人」。
+- Web 登录密码用 scrypt 哈希保存。首次建管理员必须用启动日志里的一次性设置码，防止「谁先打开页面谁就成了主人」。
+- 多用户只隔开**界面上**的东西：会话列表、授权 / 提问卡、通知、`/sessions` 能列出和恢复的 agent 会话；设置、飞书机器人和飞书会话只给管理员；会落盘、对所有人生效的「总是允许」（Claude 的总是允许名单、Codex 的 execpolicy）只有管理员能点。**它不是安全边界**：所有 agent 都以同一个系统用户运行，任何用户都能让 agent 读到这台机器上的文件（别人的对话记录、配置里的密钥），用的也是同一个 Claude / Codex 订阅。只给信任的人开账号；要真正隔离，就每人用自己的系统用户各跑一份 agent-loft。
+- 从老版本升级：原来的登录密码自动变成管理员 `admin`，已登录的设备不用重新登录。
 - 登录态通过 HttpOnly cookie 保存，服务端只存它的哈希。同一 IP 连续输错 5 次锁 15 分钟。所有写请求和 WebSocket 都校验 Origin。页面开启了严格的 CSP。
-- 暴露到公网时，只通过 HTTPS 反向代理（比如 Lucky）或 Cloudflare Tunnel 访问，并把不在本机的反代 IP 加进 `web.trustedProxies`（只有从这些地址来的连接才采信 `X-Forwarded-*`）。不要直接把 8800 端口映射出去。局域网访问可以在 设置 → 通用 → 网络访问 里关掉。
+- 暴露到公网时，只通过 HTTPS 反向代理（比如 Lucky）或 Cloudflare Tunnel 访问，并把不在本机的反代 IP 加进 `web.trustedProxies`（只有从这些地址来的连接才采信 `X-Forwarded-*`）。不要直接把 8800 端口映射出去。局域网访问可以在 设置 → 系统 → 网络访问 里关掉。
 - 审批超时一律按拒绝处理。Codex 默认沙箱为 `workspace-write`，不会因为 `~/.codex/config.toml` 里配了 `never` 或 `danger-full-access` 就绕过审批。
 - agent 子进程拿不到本服务自己的凭据（`FEISHU_*`、`AGENT_LOFT_*` 等环境变量会被剔除）。
 
@@ -129,6 +139,7 @@ src/
     interactions.ts 审批与提问：一个请求，多个渠道都能处理
     store.ts       会话持久化（每个 agent 的会话 id 各自保存）
     config.ts      配置（Web 可改，改完热加载）
+    users.ts       Web 登录用户和归属规则（谁能看到哪条会话）
     pairing.ts uploads.ts commands.ts …
   agents/
     claude/        Claude Agent SDK 驱动
@@ -137,7 +148,7 @@ src/
     feishu/        飞书：一个 FeishuBot 对应一个机器人，支持多个
     web/           HTTP + WebSocket + 鉴权
 web/               前端（原生 JS，不需要构建）
-desktop/           macOS 桌面端（Electron 外壳）
+desktop/           桌面端（Electron 外壳，macOS / Windows / Linux）
 docs/              产品介绍和截图
 ```
 

package/bin/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// 统一入口：agent-loft <start|import|pair|passwd|service|doctor>
+// 统一入口：agent-loft <start|import|pair|passwd|user|service|doctor>
 //
 // 源码是 TypeScript，用 tsx 的 ESM loader 直接加载，装完即可运行，不需要先 build。
 import { register } from "tsx/esm/api";
@@ -9,6 +9,7 @@ const COMMANDS = {
   import: "../src/cli/import.ts",
   pair: "../src/cli/pair.ts",
   passwd: "../src/cli/passwd.ts",
+  user: "../src/cli/user.ts",
   service: "../src/cli/service.ts",
   doctor: "../src/cli/doctor.ts",
 };
@@ -19,7 +20,8 @@ const USAGE = `agent-loft —— 用飞书 / Web 驱动本机的 Claude Code 和
   agent-loft start            启动（默认命令）
   agent-loft import           从旧的 feishu-claude-bridge / feishu-codex-bridge 导入配置和会话
   agent-loft pair ...         配对管理：list | approve <配对码> | revoke <机器人id> <open_id>
-  agent-loft passwd           重置 Web 登录密码
+  agent-loft passwd           重置 Web 登录密码（--user 名字 指定用户，默认是管理员）
+  agent-loft user ...         Web 登录用户：list | add <名字> [--admin] | passwd | role | disable | enable | remove
   agent-loft service ...      开机自启：install | uninstall | restart | status
   agent-loft doctor           体检：配置 / agent / 飞书连通性
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loft",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "type": "module",
   "description": "多个 agent 的工作台：把本机 Claude Code / Codex 放到一处统一管理，用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
   "keywords": [

package/src/agents/claude/session.ts

@@ -309,7 +309,7 @@ export class ClaudeSession implements AgentSession {
       kind: "approval",
       title: `需要授权：${toolName}`,
       detail: describeToolCall(toolName, input),
-      ...(isRememberableSignature(toolName, signature) ? { alwaysLabel: alwaysLabelOf(toolName, signature) } : {}),
+      ...(isRememberableSignature(toolName, signature) ? { alwaysLabel: alwaysLabelOf(toolName, signature), alwaysGlobal: true } : {}),
       ...(sessionable ? { allowSession: true } : {}),
     });
     if (outcome.settlement === "allow-always" && isRememberableSignature(toolName, signature)) rememberAlways(signature);

package/src/agents/codex/session.ts

@@ -508,6 +508,7 @@ export class CodexSession implements AgentSession {
           detail: describeCommand(req),
           // 「总是允许」到底记多宽取决于 Codex 有没有给 execpolicy 补丁，差别很大，得写在按钮上
           alwaysLabel: amendment ? "以后同类不再问" : "本会话内不再问",
+          ...(amendment ? { alwaysGlobal: true } : {}),
         });
         const s = outcome.settlement;
         if (s === "allow-once") return { decision: "accept" };

package/src/channels/feishu/bot.ts

@@ -13,7 +13,8 @@ import { interactions, type Interaction } from "../../core/interactions.js";
 import { parseCommand } from "../../core/commands.js";
 import { Dedup } from "../../core/dedup.js";
 import { isPaired, requestPairing } from "../../core/pairing.js";
-import { getConversation, listConversations, updateConversation } from "../../core/store.js";
+import { getConversation, listConversations, sessionOwner, updateConversation } from "../../core/store.js";
+import { adminVisible, hasMembers } from "../../core/users.js";
 import { adoptFile, KIND_LABEL } from "../../core/uploads.js";
 import type { SavedAttachment } from "../../core/types.js";
 import { FeishuClient } from "./client.js";
@@ -140,14 +141,20 @@ export class FeishuBot {
     const target = attachedTarget(feishuKey);
     if (!target) return undefined;
     const conv = getConversation(target);
-    return conv && !conv.hidden ? target : undefined;
+    // 主人后来被降成了普通成员：这条会话不再是飞书能碰的，当它没了（下条消息时自动退回来）
+    return conv && !conv.hidden && adminVisible(conv.owner) ? target : undefined;
+  }
+
+  /** 挂在 Web 会话 key 上的本机器人聊天。会话已经不归管理员了就一个都不算 */
+  private watchers(key: string): string[] {
+    return adminVisible(getConversation(key)?.owner) ? watchersOf(key, this.prefix) : [];
   }
 
   /** 这条会话的事件该画到哪些飞书聊天里：自己的那个聊天，加上挂着它的聊天 */
   chatsOf(key: string): string[] {
     const out = new Set<string>();
     if (this.mine(key)) out.add(this.chatIdOf(key));
-    for (const k of watchersOf(key, this.prefix)) out.add(this.chatIdOf(k));
+    for (const k of this.watchers(key)) out.add(this.chatIdOf(k));
     return [...out];
   }
 
@@ -155,7 +162,7 @@ export class FeishuBot {
   private controls(key: string, chatId: string | undefined): boolean {
     if (!chatId) return false;
     if (this.mine(key)) return this.chatIdOf(key) === chatId;
-    return watchersOf(key, this.prefix).some((k) => this.chatIdOf(k) === chatId);
+    return this.watchers(key).some((k) => this.chatIdOf(k) === chatId);
   }
 
   private webEntry(key: string): WebConvEntry | undefined {
@@ -206,7 +213,8 @@ export class FeishuBot {
    */
   async attachTo(feishuKey: string, webKey: string, operatorOpenId?: string): Promise<string> {
     const conv = getConversation(webKey);
-    if (!conv || conv.channel !== "web" || conv.hidden) throw new Error("这条 Web 会话已不存在");
+    // 飞书是管理员的地盘：普通成员的 Web 会话不能被接到飞书上
+    if (!conv || conv.channel !== "web" || conv.hidden || !adminVisible(conv.owner)) throw new Error("这条 Web 会话已不存在");
     const chatId = this.chatIdOf(feishuKey);
     // 本聊天自己的会话也得有：之后 /detach 回来、侧栏里显示机器人都要它
     const allowed = this.allowedAgents();
@@ -253,8 +261,7 @@ export class FeishuBot {
   private async sendWebList(feishuKey: string, chatId: string): Promise<void> {
     const current = this.attachedWeb(feishuKey);
     const convs = hub
-      .list()
-      .filter((c) => c.channel === "web" && !c.hidden)
+      .list((c) => c.channel === "web" && !c.hidden && adminVisible(c.owner))
       .slice(0, 10)
       .map((c) => this.webEntry(c.key)!)
       .filter(Boolean);
@@ -613,7 +620,14 @@ export class FeishuBot {
     const command = attachments.length > 0 ? ({ kind: "chat", text } as const) : parseCommand(text);
     if (command.kind !== "chat") {
       try {
-        const reply = await hub.command(key, command, { allowedAgents: this.allowedFor(key), by: "飞书命令", channel: "feishu" });
+        const reply = await hub.command(key, command, {
+          allowedAgents: this.allowedFor(key),
+          by: "飞书命令",
+          channel: "feishu",
+          // 普通成员在 Web 上开的 agent 会话、挂着的请求，飞书里都碰不到
+          ...(hasMembers() ? { sessionVisible: (id: string) => adminVisible(sessionOwner(id)) } : {}),
+          convVisible: (k) => adminVisible(getConversation(k)?.owner),
+        });
         await this.renderReply(key, chatId, reply);
       } catch (err) {
         await this.client.sendText(chatId, `出错了：${err instanceof Error ? err.message : String(err)}`);

package/src/channels/web/access.ts

@@ -0,0 +1,26 @@
+// Web 上「这个用户能碰哪些东西」。规则本身在 core/users.ts 的 ownedBy。
+import { getConversation, sessionOwner, type Conversation } from "../../core/store.js";
+import { legacyOwnerId, listUsers, ownedBy, type User } from "../../core/users.js";
+import type { OwnerFilter } from "./push.js";
+
+export function canSeeConv(user: User, conv: Conversation | undefined): conv is Conversation {
+  return !!conv && ownedBy(user, conv.owner);
+}
+
+export function canSeeKey(user: User, key: string): boolean {
+  return canSeeConv(user, getConversation(key));
+}
+
+/**
+ * 这个用户能看到、能恢复哪些 agent 会话。
+ * 只有他一个用户时什么都不会被滤掉，返回 undefined —— 列会话时就不用为了过滤多读一大批
+ */
+export function sessionVisibleTo(user: User): ((sessionId: string) => boolean) | undefined {
+  if (listUsers().every((u) => u.id === user.id)) return undefined;
+  return (sessionId) => ownedBy(user, sessionOwner(sessionId));
+}
+
+/** 推送订阅是不是这个用户的。升级前的订阅没记主人，算迁移出来的那个管理员的 */
+export function pushOwnedBy(userId: string): OwnerFilter {
+  return (owner) => (owner ?? legacyOwnerId()) === userId;
+}