agent-loft 0.2.41 → 0.2.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -66,7 +66,7 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
66
66
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏「最近」上面的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选聊天 / 工作模式和目录),或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。
67
67
  - **技能(skills)**:设置 → 技能。技能就是 Claude Code / Codex 用的那种 SKILL.md(可以带脚本和资料),由 agent-loft 按人管理,两个 agent 都能用。**来源**:在页面上写、上传技能包(`.zip` / `.skill` / 单个 SKILL.md / 整个文件夹),或者在对话里让 agent「把刚才的做法存成技能」(agent 用 `create_skill` / `update_skill`,先弹授权卡)。每人管自己的,不做分享和技能广场(以前从别人那装过的照常能用,可以卸载)。**使用**:工作模式下 agent 遇到对得上的事自己用;在输入框或定时任务的「要做的事」里打 `@` 选技能,点名这次用哪个(聊天模式下会把技能内容直接附上);飞书里发 `/skills` 看能 @ 哪些。**变量**:技能可以声明要用的环境变量(接口地址、密钥),每个人填自己的值,只注入自己的会话;密钥再写上「只允许发往」的地址就成了**受保护的密钥**——不进环境变量,agent 看不到值,只能用 `skill_request` 工具让 agent-loft 代发请求(在地址、请求头、请求体里写 `{{变量名}}`),只发往你确认过的地址、不跟随跳转、响应里出现的值会被抹掉;作者后来改了地址,要你再确认一次才放行。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「设置 → 技能 → 本机技能」里能看到。
68
68
  - **远程控制**:侧栏「定时任务」下面的「远程控制」,直接操作这台机器的**桌面**和**终端**,上面一键切换;切回对话时连接留在后台(侧栏入口上亮个小绿点),再进来接着用。这台机器没有图形桌面(服务器、NAS)时只有终端。
69
- - 桌面:走 VNC 协议,网页里用 noVNC 显示,鼠标、键盘、剪贴板都能用,进来时不自动连、点「连接桌面」才连,可以缩放到窗口或按原始大小看、全屏(手机上也能,iPhone 上是铺满页面)、「只看不控制」、发送 Ctrl+Alt+Del 之类的组合键。手机上有两种手势(右上角切换,「?」看说明):**触控板模式**(默认)屏幕上有个指针,单指滑动移动、轻点单击、双指轻点右键、长按后拖动是按住左键拖、双指滑动滚动;**触摸模式**点哪就点哪。两种模式都能双指捏合在本地放大画面(放大后小按钮也点得准,右下角「还原」),画面下面一排 Esc / Tab / Ctrl / Alt / Win / 方向键,Ctrl、Alt、Win 点一下会粘住,带给下一个按键或点击;键盘按钮弹出软键盘打字,中文输入法也能用。Linux 上 agent-loft 在有人连时用 x11vnc 共享当前的桌面(Xorg 会话;只听 127.0.0.1、随机端口、每次随机密码,需要 `sudo apt install x11vnc`),没人连着 30 分钟后停掉;macOS 上在 设置 → 远程控制 里改用「已有的 VNC 服务」,接系统自带的屏幕共享。
69
+ - 桌面:走 VNC 协议,网页里用 noVNC 显示,鼠标、键盘、剪贴板都能用,进来时不自动连、点「连接桌面」才连,工具栏上选画质:流畅 / 标准(默认)/ 高清由服务端把画面缩小到长边 1280 / 1920 / 2560、只把变了的地方压成 JPEG 发过来(macOS 屏幕共享只给无损的 ZRLE,5K 屏一整屏 30MB,原样转发隔着公网几秒一帧),原画是原样转发、只适合局域网;可以缩放到窗口或按原始大小看、全屏(手机上也能,iPhone 上是铺满页面)、「只看不控制」、发送 Ctrl+Alt+Del 之类的组合键。手机上有两种手势(右上角切换,「?」看说明):**触控板模式**(默认)屏幕上有个指针,单指滑动移动、轻点单击、双指轻点右键、长按后拖动是按住左键拖、双指滑动滚动;**触摸模式**点哪就点哪。两种模式都能双指捏合在本地放大画面(放大后小按钮也点得准,右下角「还原」),画面下面一排 Esc / Tab / Ctrl / Alt / Win / 方向键,Ctrl、Alt、Win 点一下会粘住,带给下一个按键或点击;键盘按钮弹出软键盘打字,中文输入法也能用。Linux 上 agent-loft 在有人连时用 x11vnc 共享当前的桌面(Xorg 会话;只听 127.0.0.1、随机端口、每次随机密码,需要 `sudo apt install x11vnc`),没人连着 30 分钟后停掉;macOS 上在 设置 → 远程控制 里改用「已有的 VNC 服务」,接系统自带的屏幕共享:填 VNC 密码,或者屏幕共享没开 VNC 密码时填 Mac 的用户名和登录密码(苹果认证,由服务端登录)。
70
70
  - 终端:新终端开在当前对话的工作目录里,可以开多个标签;`Ctrl+Shift+C` / `Ctrl+Shift+V` 复制粘贴。`` Ctrl+` `` 在对话下面拉出终端面板(高度可拖动),面板和远程控制里的是同一批终端。关掉页面、手机切到后台、断线都不结束 shell,重新打开时接着用、补上错过的输出,别的设备上也能接上;没有页面连着超过 30 分钟(设置里可改)才结束,点标签上的 × 立即结束。依赖可选的原生模块 `node-pty`:Linux 上安装时要现场编译(需要 `make`、`g++`、`python3`),没装好时终端用不了,其他功能照常。手机上单指上下滑翻看历史(在 less、vim 里是翻页),长按选中文字、接着拖动扩大选区,再点「复制」;终端下面多一排 Esc / Tab / Ctrl / Alt / 方向键 / Home / End / PgUp / PgDn / 粘贴。iOS 上软键盘弹出来时这排键会垫到键盘上面。
71
71
  - 管理员能用;成员要管理员在 设置 → 用户 里单独「开通远程控制」。终端、桌面在 设置 → 远程控制 里各有总开关。
72
72
  - **飞书账号绑定**:设置 → 账号 → 飞书账号 →「生成绑定码」,再在飞书私聊机器人发 `/bind 绑定码`(10 分钟内有效,群里发不算)。绑定后这个私聊就是你的个人会话:用你的记忆,`/sessions` 只列你的会话,`/web` 只能接上你自己的 Web 会话,管理员在 Web 上也看不到它。必须本人在两边各操作一次,管理员不能替人绑定(只能解除),否则就能借飞书读到别人的记忆。
@@ -154,7 +154,7 @@ agent-loft service install
154
154
  - 从老版本升级:原来的登录密码自动变成管理员 `admin`,已登录的设备不用重新登录。
155
155
  - 登录态通过 HttpOnly cookie 保存,服务端只存它的哈希。同一 IP 连续输错 5 次锁 15 分钟。所有写请求和 WebSocket 都校验 Origin。页面开启了严格的 CSP。
156
156
  - 暴露到公网时,只通过 HTTPS 反向代理(比如 Lucky)或 Cloudflare Tunnel 访问,并把不在本机的反代 IP 加进 `web.trustedProxies`(只有从这些地址来的连接才采信 `X-Forwarded-*`)。不要直接把 8800 端口映射出去。局域网访问可以在 设置 → 系统 → 网络访问 里关掉。
157
- - 远程控制不经过授权卡:拿到终端就是拿到运行 agent-loft 的那个系统用户的 shell,拿到桌面就是坐在登录桌面的那个人面前。所以默认只给管理员,成员要管理员单独开通(开通时会再提醒一次);收回权限、停用或删除用户、在设置里关掉终端 / 桌面时,他开着的 shell 立刻结束、桌面立刻断开。终端和桌面的 WebSocket 和其他接口一样校验登录态和 Origin。shell 拿不到本服务自己的凭据(和 agent 子进程一样剔除环境变量)。共享桌面用的 x11vnc 只听本机、密码每次随机生成、经文件传过去(不出现在命令行里);用「已有的 VNC 服务」时,配置里的 VNC 密码会交给开通了远程控制的人的页面。
157
+ - 远程控制不经过授权卡:拿到终端就是拿到运行 agent-loft 的那个系统用户的 shell,拿到桌面就是坐在登录桌面的那个人面前。所以默认只给管理员,成员要管理员单独开通(开通时会再提醒一次);收回权限、停用或删除用户、在设置里关掉终端 / 桌面时,他开着的 shell 立刻结束、桌面立刻断开。终端和桌面的 WebSocket 和其他接口一样校验登录态和 Origin。shell 拿不到本服务自己的凭据(和 agent 子进程一样剔除环境变量)。共享桌面用的 x11vnc 只听本机、密码每次随机生成、经文件传过去(不出现在命令行里);用「已有的 VNC 服务」时,配置里的 VNC 密码会交给开通了远程控制的人的页面;填了 Mac 用户名走苹果认证时由服务端登录,登录密码不会发到页面(但和 VNC 密码一样明文存在 config.json 里)。
158
158
  - 审批超时一律按拒绝处理。Codex 默认沙箱为 `workspace-write`,不会因为 `~/.codex/config.toml` 里配了 `never` 或 `danger-full-access` 就绕过审批。
159
159
  - agent 子进程拿不到本服务自己的凭据(`FEISHU_*`、`AGENT_LOFT_*` 等环境变量会被剔除)。
160
160
  - 技能存在 `data/skills/`:技能本体在 `files/<技能 id>/`,每个人装了哪些、变量的值在 `users/<用户 id>.json`(0600)。普通变量注入到会话环境里,agent 能读到;受保护的密钥 agent 看不到值,但和多用户一样不是安全边界——工作模式下 agent 能直接读这些文件。别人分享的技能会在你的会话里照着执行,装之前在技能页点开看一眼它要做什么、要哪些变量。
@@ -183,6 +183,8 @@ src/
183
183
  skills-bridge.ts 技能工具在主进程这头:建 / 改技能(弹授权卡)、skill_request 代发带密钥的请求
184
184
  terminals.ts 网页终端:用 node-pty 起 shell、留最近的输出给重连补发、没人连着到点结束、权限收回时结束
185
185
  desktop.ts 远程桌面:找这台机器的 X 桌面、按需起 x11vnc(或用已有的 VNC 服务)、没人连着到点停掉
186
+ vnc-auth.ts 由服务端登录 VNC(苹果认证、VNC 密码、不用认证),对页面装成不用认证的
187
+ vnc-transcode.ts 远程桌面转码:服务端当 VNC 客户端收全分辨率画面,缩小、只把变了的格子压成 JPEG 按 Tight 发给页面
186
188
  pairing.ts uploads.ts commands.ts …
187
189
  mcp/
188
190
  memory-server.ts 记忆工具(remember / forget / search_past_chats)的 stdio MCP 服务,两个 agent 共用
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.41",
3
+ "version": "0.2.43",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -53,6 +53,7 @@
53
53
  "dompurify": "^3.2.0",
54
54
  "marked": "^16.0.0",
55
55
  "qrcode": "^1.5.4",
56
+ "sharp": "^0.35.5",
56
57
  "tsx": "^4.20.6",
57
58
  "ws": "^8.18.0"
58
59
  },
@@ -245,6 +245,7 @@ function applyConfig(input: Partial<AppConfig>): void {
245
245
  if (typeof r.vncHost === "string" && r.vncHost.trim()) next.remote.vncHost = r.vncHost.trim();
246
246
  const port = Number(r.vncPort);
247
247
  if (r.vncPort !== undefined && Number.isInteger(port) && port >= 1 && port <= 65535) next.remote.vncPort = port;
248
+ if (typeof r.vncUsername === "string") next.remote.vncUsername = r.vncUsername.trim();
248
249
  // 回传的是打了码的旧值:不改
249
250
  if (typeof r.vncPassword === "string" && !r.vncPassword.startsWith(MASK)) next.remote.vncPassword = r.vncPassword;
250
251
  }
@@ -5,9 +5,11 @@ import net from "node:net";
5
5
  import type { IncomingMessage, ServerResponse } from "node:http";
6
6
  import type { Duplex } from "node:stream";
7
7
  import type { WebSocket, WebSocketServer } from "ws";
8
- import { canUseDesktop, desktopAvailability, desktopTarget, desktopViewer } from "../../core/desktop.js";
8
+ import { canUseDesktop, desktopAvailability, desktopTarget, desktopViewer, type DesktopTarget } from "../../core/desktop.js";
9
9
  import { canUseRemote, isAdmin, type User } from "../../core/users.js";
10
10
  import { config } from "../../core/config.js";
11
+ import { ByteReader, serveNoAuth, vncLogin } from "../../core/vnc-auth.js";
12
+ import { isDesktopQuality, loadSharp, transcode, type DesktopQuality } from "../../core/vnc-transcode.js";
11
13
  import { sessionUser } from "./auth.js";
12
14
  import { HttpError, sendJson } from "./http.js";
13
15
  import { terminalStatus } from "./terminal.js";
@@ -46,7 +48,8 @@ export async function handleDesktopApi(req: IncomingMessage, res: ServerResponse
46
48
  if (config().remote.desktopSource === "vnc" && !(await reachable(target.host, target.port))) {
47
49
  throw new HttpError(503, `连不上 VNC 服务 ${target.host}:${target.port},先确认它开着(macOS:系统设置 → 通用 → 共享 → 屏幕共享)`);
48
50
  }
49
- sendJson(res, 200, { password: target.password, source: config().remote.desktopSource });
51
+ // 苹果认证由服务端登录,Mac 的登录密码不给页面
52
+ sendJson(res, 200, { password: target.username ? "" : target.password, source: config().remote.desktopSource });
50
53
  return true;
51
54
  }
52
55
  return false;
@@ -95,8 +98,11 @@ function reject(socket: Duplex, status: string): void {
95
98
  socket.destroy();
96
99
  }
97
100
 
98
- /** /ws/desktop 的握手:user 已经由调用方核对过登录和 Origin */
99
- export function upgradeDesktop(wss: WebSocketServer, req: IncomingMessage, socket: Duplex, head: Buffer, user: User, token: string): void {
101
+ /**
102
+ * /ws/desktop 的握手:user 已经由调用方核对过登录和 Origin。
103
+ * ?q= 是画质:smooth / standard / high 由服务端缩小、压成 JPEG 再发(vnc-transcode.ts);original 或不带是原样转发
104
+ */
105
+ export function upgradeDesktop(wss: WebSocketServer, req: IncomingMessage, socket: Duplex, head: Buffer, user: User, token: string, url: URL): void {
100
106
  if (!canUseDesktop(user)) return reject(socket, "403 Forbidden");
101
107
  if (clients.size >= MAX_CLIENTS) return reject(socket, "429 Too Many Requests");
102
108
  // 下面要等 x11vnc 起来(最多 10 秒):这期间浏览器断开的话,socket 上没人接 error 会把进程带崩
@@ -112,7 +118,12 @@ export function upgradeDesktop(wss: WebSocketServer, req: IncomingMessage, socke
112
118
  tcp.once("connect", () => {
113
119
  if (socket.destroyed) return void tcp.destroy();
114
120
  socket.off("error", onError);
115
- wss.handleUpgrade(req, socket, head, (ws) => bridge(ws, tcp, token));
121
+ const q = url.searchParams.get("q");
122
+ wss.handleUpgrade(req, socket, head, (ws) => {
123
+ if (isDesktopQuality(q)) return void transcodeSession(ws, tcp, token, target, q);
124
+ if (!target.username) return bridge(ws, tcp, token);
125
+ void loginThenBridge(ws, tcp, token, target.username, target.password);
126
+ });
116
127
  });
117
128
  },
118
129
  (err) => {
@@ -122,7 +133,103 @@ export function upgradeDesktop(wss: WebSocketServer, req: IncomingMessage, socke
122
133
  );
123
134
  }
124
135
 
125
- function bridge(ws: WebSocket, tcp: net.Socket, token: string): void {
136
+ /** 握手最多等这么久(对方不回话) */
137
+ const LOGIN_TIMEOUT = 15_000;
138
+
139
+ /** 苹果认证:先由这里和 VNC 服务登录,对页面装成不用认证的,谈完了再原样转发 */
140
+ async function loginThenBridge(ws: WebSocket, tcp: net.Socket, token: string, username: string, password: string): Promise<void> {
141
+ // 握手前那个「回 502」的已经用不上了(socket 交给 WebSocket 了)
142
+ tcp.removeAllListeners("error");
143
+ const fromVnc = new ByteReader();
144
+ const fromPage = new ByteReader();
145
+ const onTcp = (d: Buffer) => fromVnc.push(d);
146
+ const onWs = (d: Buffer) => fromPage.push(d);
147
+ const onTcpEnd = () => fromVnc.fail(new Error("VNC 服务断开了连接"));
148
+ const onWsEnd = () => fromPage.fail(new Error("页面断开了"));
149
+ tcp.on("data", onTcp).on("close", onTcpEnd).on("error", onTcpEnd);
150
+ ws.on("message", onWs).on("close", onWsEnd);
151
+ const timer = setTimeout(() => {
152
+ const err = new Error("VNC 服务没有回应");
153
+ fromVnc.fail(err);
154
+ fromPage.fail(err);
155
+ }, LOGIN_TIMEOUT);
156
+ try {
157
+ const login = vncLogin(fromVnc, (b) => tcp.write(b), { username, password });
158
+ await serveNoAuth(fromPage, (b) => ws.readyState === ws.OPEN && ws.send(b, { binary: true }), login);
159
+ } catch (err) {
160
+ console.error("[桌面] 苹果认证失败:", err instanceof Error ? err.message : err);
161
+ tcp.destroy();
162
+ // 原因已经按认证失败告诉页面了:等它收到再关
163
+ if (ws.readyState === ws.OPEN) setTimeout(() => ws.close(4000, "认证失败"), 200);
164
+ return;
165
+ } finally {
166
+ clearTimeout(timer);
167
+ tcp.off("data", onTcp).off("close", onTcpEnd).off("error", onTcpEnd);
168
+ ws.off("message", onWs).off("close", onWsEnd);
169
+ }
170
+ if (ws.readyState !== ws.OPEN || tcp.destroyed) return void tcp.destroy();
171
+ bridge(ws, tcp, token, fromVnc.rest(), fromPage.rest());
172
+ }
173
+
174
+ function isLoopback(host: string): boolean {
175
+ const h = host.trim().toLowerCase().replace(/^\[|\]$/g, "");
176
+ return h === "localhost" || h === "::1" || /^127\./.test(h);
177
+ }
178
+
179
+ /** 转码:服务端连 VNC、缩小画面压成 JPEG 发给页面 */
180
+ async function transcodeSession(ws: WebSocket, tcp: net.Socket, token: string, target: DesktopTarget, quality: DesktopQuality): Promise<void> {
181
+ // 握手前那个「回 502」的已经用不上了(socket 交给 WebSocket 了)
182
+ tcp.removeAllListeners("error");
183
+ tcp.on("error", () => tcp.destroy());
184
+ // 压 JPEG 的 sharp 在这台机器上装不上:退回原样转发(原画),别让页面一直重连
185
+ try {
186
+ await loadSharp();
187
+ } catch (err) {
188
+ console.error("[桌面] 加载 sharp 失败,画质设置不起作用,按原画转发:", err instanceof Error ? err.message : err);
189
+ if (!target.username) return bridge(ws, tcp, token);
190
+ return loginThenBridge(ws, tcp, token, target.username, target.password);
191
+ }
192
+ tcp.removeAllListeners("error");
193
+ tcp.setNoDelay(true);
194
+ const client: DesktopClient = { ws, tcp, token, alive: true };
195
+ clients.add(client);
196
+ desktopViewer(1);
197
+ const fromVnc = new ByteReader();
198
+ const fromPage = new ByteReader();
199
+ tcp.on("data", (d: Buffer) => fromVnc.push(d));
200
+ tcp.on("close", () => fromVnc.fail(new Error("VNC 服务断开了连接")));
201
+ tcp.on("error", () => fromVnc.fail(new Error("VNC 服务断开了连接")));
202
+ ws.on("message", (d: Buffer) => fromPage.push(d));
203
+ ws.on("close", () => fromPage.fail(new Error("页面断开了")));
204
+ ws.on("error", () => fromPage.fail(new Error("页面断开了")));
205
+ ws.on("pong", () => (client.alive = true));
206
+ const timer = setTimeout(() => {
207
+ const err = new Error("VNC 服务没有回应");
208
+ fromVnc.fail(err);
209
+ fromPage.fail(err);
210
+ }, LOGIN_TIMEOUT);
211
+ try {
212
+ await transcode({
213
+ vnc: { reader: fromVnc, write: (b) => void (tcp.destroyed || tcp.write(b)) },
214
+ page: { reader: fromPage, write: (b) => void (ws.readyState === ws.OPEN && ws.send(b, { binary: true })), backlog: () => ws.bufferedAmount },
215
+ creds: { username: target.username, password: target.password },
216
+ quality,
217
+ local: isLoopback(target.host),
218
+ onReady: () => clearTimeout(timer),
219
+ });
220
+ } catch (err) {
221
+ const msg = err instanceof Error ? err.message : String(err);
222
+ if (!/页面断开了/.test(msg)) console.error("[桌面] 转码会话结束:", msg);
223
+ // 认证失败的原因已经告诉页面了:等它收到再关
224
+ if (ws.readyState === ws.OPEN) setTimeout(() => ws.close(4000, "桌面连接已断开"), 200);
225
+ } finally {
226
+ clearTimeout(timer);
227
+ drop(client);
228
+ }
229
+ }
230
+
231
+ /** pending:握手时多读进来、还没转发的字节 */
232
+ function bridge(ws: WebSocket, tcp: net.Socket, token: string, pendingVnc?: Buffer, pendingPage?: Buffer): void {
126
233
  const client: DesktopClient = { ws, tcp, token, alive: true };
127
234
  clients.add(client);
128
235
  desktopViewer(1);
@@ -153,6 +260,8 @@ function bridge(ws: WebSocket, tcp: net.Socket, token: string): void {
153
260
  ws.on("pong", () => (client.alive = true));
154
261
  // 页面 → VNC:按键、鼠标都在这里,逐条复查登录态太密了;登录态 / 权限变了由 recheckDesktopClients 统一断开
155
262
  ws.on("message", (data: Buffer) => tcp.write(data));
263
+ if (pendingVnc?.length) ws.send(pendingVnc, { binary: true });
264
+ if (pendingPage?.length) tcp.write(pendingPage);
156
265
  ws.on("close", () => drop(client));
157
266
  ws.on("error", () => drop(client));
158
267
  }
@@ -489,7 +489,7 @@ export async function startWeb(): Promise<void> {
489
489
  }
490
490
  const token = cookies(req)[COOKIE] ?? "";
491
491
  if (url.pathname === "/ws/term") return upgradeTerminal(wss!, req, socket, head, user, token, url);
492
- if (url.pathname === "/ws/desktop") return upgradeDesktop(wss!, req, socket, head, user, token);
492
+ if (url.pathname === "/ws/desktop") return upgradeDesktop(wss!, req, socket, head, user, token, url);
493
493
  wss!.handleUpgrade(req, socket, head, (ws) => {
494
494
  const client: Client = { ws, subs: new Set(), alive: true, token, user, visible: false, viewing: null, seen: Date.now() };
495
495
  clients.add(client);
@@ -87,6 +87,8 @@ export type AppConfig = {
87
87
  display: string;
88
88
  vncHost: string;
89
89
  vncPort: number;
90
+ /** 填了就用 Mac 的用户名 + 登录密码(vncPassword)走苹果认证,由服务端登录;空着就是普通的 VNC 密码 */
91
+ vncUsername: string;
90
92
  vncPassword: string;
91
93
  };
92
94
  feishu: {
@@ -125,6 +127,7 @@ export function defaultConfig(): AppConfig {
125
127
  display: "",
126
128
  vncHost: "127.0.0.1",
127
129
  vncPort: 5900,
130
+ vncUsername: "",
128
131
  vncPassword: "",
129
132
  },
130
133
  feishu: { watchdogMs: 10 * 60 * 1000, bots: [] },
@@ -214,14 +214,15 @@ async function startX11vnc(display: string): Promise<Vnc> {
214
214
  return v;
215
215
  }
216
216
 
217
- export type DesktopTarget = { host: string; port: number; password: string };
217
+ /** username:有就是苹果认证,由服务端登录(见 vnc-auth.ts),页面不用密码 */
218
+ export type DesktopTarget = { host: string; port: number; password: string; username?: string };
218
219
 
219
220
  /** 要连桌面了:拿到 VNC 服务的地址和密码,必要时先把 x11vnc 起来 */
220
221
  export async function desktopTarget(): Promise<DesktopTarget> {
221
222
  const status = desktopAvailability();
222
223
  if (!status.available) throw new Error(status.reason ?? "这台机器上没有可用的桌面");
223
224
  const cfg = config().remote;
224
- if (status.source === "vnc") return { host: cfg.vncHost, port: cfg.vncPort, password: cfg.vncPassword };
225
+ if (status.source === "vnc") return { host: cfg.vncHost, port: cfg.vncPort, password: cfg.vncPassword, ...(cfg.vncUsername ? { username: cfg.vncUsername } : {}) };
225
226
  // 换了显示(配置改了):旧的停掉
226
227
  if (vnc && vnc.display !== status.display) stopDesktop();
227
228
  const gen = generation;
@@ -0,0 +1,193 @@
1
+ // 由服务端登录 VNC 服务,再对页面(noVNC)装成一个不用认证的 VNC 服务。两种情况用得上:
2
+ // - macOS 屏幕共享的苹果认证(Apple Remote Desktop,RFB 安全类型 30):用 Mac 的用户名和登录密码登录。
3
+ // 屏幕共享没开「VNC 显示程序可以使用密码控制屏幕」时只给苹果自己的几种认证,普通 VNC 密码那种没有。
4
+ // 登录密码不用发到浏览器;noVNC 自己做这种认证要用 crypto.subtle,用 http://IP 访问时没有。
5
+ // - 转码(vnc-transcode.ts):服务端自己当 VNC 客户端,普通 VNC 密码、不用认证的也都由这里登录。
6
+ //
7
+ // 苹果认证:服务端给 DH 的生成元、素数和它的公钥;双方算出共享密钥,MD5 一下当 AES-128 的钥匙,
8
+ // 把「用户名 \0 … | 密码 \0 …」各 64 字节(空的地方填随机数)用 AES-ECB 加密,连同自己的公钥发回去。
9
+ import crypto from "node:crypto";
10
+ import { createRequire } from "node:module";
11
+ import path from "node:path";
12
+ import { pathToFileURL } from "node:url";
13
+
14
+ /** 按需读字节:数据一段段进来(TCP 的 data、WebSocket 的 message),要多少等多少 */
15
+ export class ByteReader {
16
+ /** 收到还没读的:一段段排着,读的时候才拼(一帧几十 MB 时每来一段就整个拼一遍会慢得要命) */
17
+ private chunks: Buffer[] = [];
18
+ /** 第一段里已经读掉的字节数 */
19
+ private offset = 0;
20
+ private length = 0;
21
+ private waiting: { n: number; resolve: (b: Buffer) => void; reject: (e: Error) => void } | null = null;
22
+ private error: Error | null = null;
23
+
24
+ push(chunk: Buffer): void {
25
+ if (!chunk.length) return;
26
+ this.chunks.push(chunk);
27
+ this.length += chunk.length;
28
+ this.flush();
29
+ }
30
+
31
+ /** 那头断了:在等的和以后要读的都报这个错 */
32
+ fail(err: Error): void {
33
+ this.error ??= err;
34
+ const w = this.waiting;
35
+ this.waiting = null;
36
+ w?.reject(this.error);
37
+ }
38
+
39
+ read(n: number): Promise<Buffer> {
40
+ if (this.waiting) return Promise.reject(new Error("上一次读还没完"));
41
+ return new Promise((resolve, reject) => {
42
+ this.waiting = { n, resolve, reject };
43
+ this.flush();
44
+ if (this.waiting && this.error) this.fail(this.error);
45
+ });
46
+ }
47
+
48
+ /** 握手完了:多读进来的那点交给后面原样转发 */
49
+ rest(): Buffer {
50
+ return this.take(this.length);
51
+ }
52
+
53
+ private take(n: number): Buffer {
54
+ const out = Buffer.allocUnsafe(n);
55
+ let filled = 0;
56
+ while (filled < n) {
57
+ const c = this.chunks[0]!;
58
+ const k = Math.min(n - filled, c.length - this.offset);
59
+ c.copy(out, filled, this.offset, this.offset + k);
60
+ filled += k;
61
+ this.offset += k;
62
+ if (this.offset === c.length) {
63
+ this.chunks.shift();
64
+ this.offset = 0;
65
+ }
66
+ }
67
+ this.length -= n;
68
+ return out;
69
+ }
70
+
71
+ private flush(): void {
72
+ const w = this.waiting;
73
+ if (!w || this.length < w.n) return;
74
+ this.waiting = null;
75
+ w.resolve(this.take(w.n));
76
+ }
77
+ }
78
+
79
+ /** 认证没过(用户名密码不对、服务不支持):message 原样给页面看 */
80
+ export class VncAuthError extends Error {}
81
+
82
+ const TYPE_NONE = 1;
83
+ const TYPE_VNC = 2;
84
+ const TYPE_ARD = 30;
85
+
86
+ /** 左边补 0 到 len 字节(DH 的数可能比素数短) */
87
+ function pad(b: Buffer, len: number): Buffer {
88
+ return b.length >= len ? b.subarray(b.length - len) : Buffer.concat([Buffer.alloc(len - b.length), b]);
89
+ }
90
+
91
+ /** 按苹果认证算出要发回去的:加密后的 128 字节凭据 + 自己的公钥 */
92
+ export function ardResponse(generator: Buffer, prime: Buffer, serverKey: Buffer, username: string, password: string): Buffer {
93
+ const dh = crypto.createDiffieHellman(prime, generator);
94
+ const publicKey = pad(dh.generateKeys(), prime.length);
95
+ const shared = pad(dh.computeSecret(serverKey), prime.length);
96
+ const creds = crypto.randomBytes(128);
97
+ // 各最多 63 字节,后面跟一个 \0(和 noVNC、苹果自己的客户端一样)
98
+ const user = Buffer.from(username, "utf8").subarray(0, 63);
99
+ const pass = Buffer.from(password, "utf8").subarray(0, 63);
100
+ user.copy(creds, 0);
101
+ creds[user.length] = 0;
102
+ pass.copy(creds, 64);
103
+ creds[64 + pass.length] = 0;
104
+ const cipher = crypto.createCipheriv("aes-128-ecb", crypto.createHash("md5").update(shared).digest(), null);
105
+ cipher.setAutoPadding(false);
106
+ return Buffer.concat([cipher.update(creds), cipher.final(), publicKey]);
107
+ }
108
+
109
+ /** 普通 VNC 密码认证:用密码(最多 8 位)当 DES 钥匙加密服务端给的 16 字节。Node 的 OpenSSL 3 默认没有 DES,借 noVNC 的 */
110
+ async function vncAuthResponse(password: string, challenge: Buffer): Promise<Buffer> {
111
+ const require = createRequire(import.meta.url);
112
+ const file = path.join(path.dirname(require.resolve("@novnc/novnc")), "crypto", "des.js");
113
+ const { DESECBCipher } = (await import(pathToFileURL(file).href)) as {
114
+ DESECBCipher: { importKey(key: number[]): { encrypt(alg: unknown, data: Uint8Array): Uint8Array } };
115
+ };
116
+ // 和 noVNC 的 RFB.genDES 一样:密码按字符码当钥匙
117
+ const key = password.split("").map((c) => c.charCodeAt(0) & 0xff);
118
+ return Buffer.from(DESECBCipher.importKey(key).encrypt(null, new Uint8Array(challenge)));
119
+ }
120
+
121
+ export type VncCreds = { username?: string; password: string };
122
+
123
+ /**
124
+ * 作为客户端和 VNC 服务走完版本协商和认证,停在 ClientInit 之前。
125
+ * 填了用户名就用苹果认证;否则有 VNC 密码认证就用它,再不然不用认证的。
126
+ * 失败抛 VncAuthError(认证的问题)或普通 Error(连接断了)
127
+ */
128
+ export async function vncLogin(r: ByteReader, write: (b: Buffer) => void, creds: VncCreds): Promise<void> {
129
+ const version = (await r.read(12)).toString("latin1");
130
+ const m = /^RFB (\d{3})\.(\d{3})\n$/.exec(version);
131
+ if (!m) throw new VncAuthError("对方不是 VNC 服务");
132
+ // 3.3 的服务端不给安全类型列表,现在基本没有了
133
+ if (Number(m[1]) < 3 || (Number(m[1]) === 3 && Number(m[2]) < 7)) throw new VncAuthError(`VNC 服务的协议太老(${version.trim()})`);
134
+ // 苹果的是 003.889,按 3.8 谈就行
135
+ write(Buffer.from("RFB 003.008\n", "latin1"));
136
+ const count = (await r.read(1))[0]!;
137
+ if (count === 0) {
138
+ const len = (await r.read(4)).readUInt32BE(0);
139
+ throw new VncAuthError(`VNC 服务拒绝连接:${(await r.read(len)).toString("utf8")}`);
140
+ }
141
+ const types = [...(await r.read(count))];
142
+ if (creds.username) {
143
+ if (!types.includes(TYPE_ARD)) throw new VncAuthError("这个 VNC 服务不支持用 Mac 用户名登录:把设置里的用户名留空,只填 VNC 密码");
144
+ write(Buffer.from([TYPE_ARD]));
145
+ const head = await r.read(4);
146
+ const generator = head.subarray(0, 2);
147
+ const keyLength = head.readUInt16BE(2);
148
+ const prime = await r.read(keyLength);
149
+ const serverKey = await r.read(keyLength);
150
+ write(ardResponse(generator, prime, serverKey, creds.username, creds.password));
151
+ if ((await r.read(4)).readUInt32BE(0) !== 0) throw new VncAuthError("Mac 的用户名或密码不对");
152
+ return;
153
+ }
154
+ if (types.includes(TYPE_VNC)) {
155
+ write(Buffer.from([TYPE_VNC]));
156
+ const challenge = await r.read(16);
157
+ write(await vncAuthResponse(creds.password, challenge));
158
+ if ((await r.read(4)).readUInt32BE(0) !== 0) throw new VncAuthError("VNC 密码不对");
159
+ return;
160
+ }
161
+ if (types.includes(TYPE_NONE)) {
162
+ write(Buffer.from([TYPE_NONE]));
163
+ if ((await r.read(4)).readUInt32BE(0) !== 0) throw new VncAuthError("VNC 服务拒绝连接");
164
+ return;
165
+ }
166
+ if (types.includes(TYPE_ARD)) {
167
+ throw new VncAuthError("这个 VNC 服务要用户名登录(macOS 屏幕共享没开 VNC 密码):在 设置 → 远程控制 里填上 Mac 的用户名和登录密码");
168
+ }
169
+ throw new VncAuthError(`VNC 服务要的认证方式都不支持(${types.join("、")})`);
170
+ }
171
+
172
+ /**
173
+ * 对页面那头装成不用认证的 VNC 服务(3.8,只给安全类型 None)。
174
+ * login 是和真正的 VNC 服务认证的过程:它失败时把原因当作认证失败告诉页面
175
+ */
176
+ export async function serveNoAuth(r: ByteReader, write: (b: Buffer) => void, login: Promise<void>): Promise<void> {
177
+ // 页面那头还没谈完 login 就失败了:先接住,下面 await 时再处理(不然算没人接的 rejection,进程会退出)
178
+ login.catch(() => {});
179
+ write(Buffer.from("RFB 003.008\n", "latin1"));
180
+ await r.read(12);
181
+ write(Buffer.from([1, 1]));
182
+ await r.read(1);
183
+ try {
184
+ await login;
185
+ } catch (err) {
186
+ const reason = Buffer.from(err instanceof VncAuthError ? err.message : `连不上 VNC 服务:${err instanceof Error ? err.message : err}`, "utf8");
187
+ const len = Buffer.alloc(4);
188
+ len.writeUInt32BE(reason.length);
189
+ write(Buffer.concat([Buffer.from([0, 0, 0, 1]), len, reason]));
190
+ throw err;
191
+ }
192
+ write(Buffer.from([0, 0, 0, 0]));
193
+ }