agent-loft 0.2.83 → 0.2.85

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
@@ -55,10 +55,10 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
55
55
  - 输入框里的小圆环显示上下文窗口占用;模型按钮显示实际的模型和思考程度(如「Opus 5.5 high」)。
56
56
  - 滚动和 ChatGPT 一样:发出的问题顶到最上面、下面留白,回复长到屏幕底部才跟着往下滚;回复过程中自己滚动了就不再自动滚,下次发消息再恢复。
57
57
  - 定时发送:右上角「更多」→「定时发送」,默认排在 5 小时额度重置后 5 分钟(弹窗里提示 5 小时 / 7 天额度的重置时间),由服务端到点发出,关掉页面也会发。适合额度用完、要等刷新才能接着干活的时候。
58
- - 侧栏直接显示各个文件夹,Web 会话按工作目录归类(目录可以拖动排序,右键可置顶;排好的顺序跟着账号走、各设备一致,新消息不会打乱),飞书会话按机器人分组,微信的当前与历史会话按账号分组,两者都能展开 / 折叠并记住状态,收起时仍显示运行中和待处理提示(飞书分组右键仍可看历史会话)。渠道分组行右侧平时显示飞书或微信图标,鼠标悬停时切成加号;点击加号在 Web 开新对话,沿用该分组最近会话的专家和工作目录。项目名、渠道分组名和有分叉的会话后面有个小三角,点一下折叠 / 展开(分叉折叠后显示「N 个嵌套会话」);分叉出来的会话缩进挂在原会话下面,用一条细线连着;标题放不下时尾巴淡出;Web 和飞书会话都先用首条消息命名,再同步 agent 自动生成的标题,旧飞书会话会从历史记录补名,双击可手动重命名;鼠标移到会话上,行尾显示对应的专家图标;定时任务的时钟图标始终放在最右侧。
58
+ - 侧栏直接显示各个文件夹,Web 会话按工作目录归类(目录可以拖动排序,右键可置顶;排好的顺序跟着账号走、各设备一致,新消息不会打乱),飞书会话按机器人分组,微信的当前与历史会话按账号分组,两者都能展开 / 折叠并记住状态,收起时仍显示运行中和待处理提示(飞书分组右键仍可看历史会话)。渠道分组行右侧始终显示飞书或微信的静态图标,Web 页面不提供这些分组的新建会话入口。项目名、渠道分组名和有分叉的会话后面有个小三角,点一下折叠 / 展开(分叉折叠后显示「N 个嵌套会话」);分叉出来的会话缩进挂在原会话下面,用一条细线连着;标题放不下时尾巴淡出;Web 和飞书会话都先用首条消息命名,再同步 agent 自动生成的标题,旧飞书会话会从历史记录补名,双击可手动重命名;鼠标移到会话上,行尾显示对应的专家图标;定时任务的时钟图标始终放在最右侧。
59
59
  - **搜索**:侧栏「搜索」弹窗,搜全部会话的标题、目录名和聊天内容(不开记忆也能搜),可以按专家筛;电脑和手机上弹窗都固定高度,结果在内部滚动,手机上从底部展开;↑↓ 选、回车打开。
60
60
  - **侧栏菜单**:项目上方的「更多」支持点击或鼠标悬停展开,设置入口也在这里。「编辑侧边栏」可勾选直接显示的菜单、拖动调整顺序,未勾选的收进「更多」;配置跟着账号走,电脑和手机共用。
61
- - 会话页顶部标题前是专家的头像,PC 端头像与会话名称字号一致(15px);鼠标停上去或点一下,看专家的说明、模型、能力和当前工作目录。
61
+ - 会话页顶部标题前是专家的头像,PC 端头像与会话名称字号一致(15px);鼠标停上去或点一下,看专家的说明、模型、能力、当前工作目录和本会话 Token 用量。
62
62
  - 附件可以直接拖到聊天区任意位置上传。
63
63
  - 回复过程中接着发的消息排队,标着「排队中」,隐藏底部的复制和回退按钮,上一条回复完自动接着处理;点「撤销并编辑」图标把排队消息放回输入框;点「打断并发送」停掉正在进行的回复、马上处理这条;点停止则连排着的一起取消(标「没有发出」)。
64
64
  - 用户消息的复制按钮后有「回退到此处」图标:把这条消息及附件放回输入框,并删除它及之后的聊天内容,重新发送时从之前的上下文继续。
@@ -67,16 +67,17 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
67
67
  - 侧栏按页加载:每个项目目录和飞书机器人分组先显示 5 条,点「展开显示」每次再拉 10 条。
68
68
  - 项目、飞书和微信分组可混合拖拽排序,渠道分组可以放在项目前面或项目之间;右键(触屏长按)可置顶、上移、下移或按最近活跃重排。顺序按账号保存,刷新、换设备后保留,新消息不会改变已排好的位置。
69
69
  - 侧栏底部显示 Claude / Codex 的订阅额度(5 小时 / 7 天窗口,以及多久后重置);关了额度查询就整块不显示。
70
- - 右上角「更多」最下面显示当前会话累计消耗的 token 分布(输入 / 缓存写入 / 缓存读取 / 输出,Claude 还有按 API 价格估算的费用)。设置也在「更多」里。
70
+ - 专家信息弹窗底部显示当前会话累计消耗的 Token 分布(输入 / 缓存写入 / 缓存读取 / 输出,Claude 还有按 API 价格估算的费用)。设置入口在侧栏的「更多」里。
71
71
  - 设置 → 用量:按日 / 月 / 年(默认按月)统计 token 和金额,有每天(每月)的柱状图,按 agent、模型、用户(管理员才有)分开看;成员只看到自己的。管理员还可查看服务端本机直接使用的 Claude Code、Codex 桌面端和 CLI 用量,和 Agent Loft 的用量分开显示、避免重复计算。金额都是按 API 价格算的参考值:Agent Loft 的 Claude 用它自己报的费用,Codex 和直接用的 Claude Code 按模型单价 × token 估算(OpenAI 单价来自 LiteLLM 公开价格表,内置快照、联网时每天更新)。Agent Loft 的账从 0.2.34 开始记录;本机直接使用的用量可回溯已有会话记录。
72
72
  - 「添加到主屏幕」后当 App 用;切到后台再回来会自动重连,补上错过的内容。
73
+ - 前端资源按指纹长缓存:再次打开不用逐个向服务端确认,升级或改了文件后刷新页面自动换新。
73
74
  - 手机顶栏采用实色圆形按钮和「专家+更多」胶囊按钮组;从左边缘右滑展开侧栏,在侧栏或遮罩上左滑收起,短滑会回弹。消息底部操作栏与下一条消息之间留 4px。
74
- - **网页多服务器切换**:在 设置 → 服务器 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角就能切换;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
75
- - **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
75
+ - **网页多服务器切换**:在 设置 → 服务器 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角通过名称和紧随其后的箭头切换,不显示服务器图标,嵌入桌面端时隐藏此入口;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
76
+ - **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 系统 → 系统通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
76
77
  - **跨渠道同步**:飞书里的会话在 Web 上也能打开接着聊。同一个授权请求同时出现在飞书卡片和网页上,哪边先点算哪边,另一边自动变成「已处理」。
77
78
  - **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 / 完全允许,定时任务也可以单独设,完全允许只给管理员。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问(Bash 仍询问)。超时一律按拒绝处理。
78
- - **设置都在网页上**,按用途分组:**我的**(账号和密码、飞书绑定、登录设备、通知、记忆、技能、用量,每个人都有);**Agent**(运行环境、各 agent 的默认模型和思考程度、可选模型、Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户、所有人的登录设备;服务端版本和升级、重启、局域网访问和端口)。设置、新建 / 编辑专家、重命名等编辑弹窗不会因点击外部或按 Esc 关闭;通过关闭、取消或保存 / 完成按钮退出。改了没保存就切页或关掉设置会先提醒。
79
- - **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知,设置只有管理员能改,见下面「安全」。
79
+ - **设置都在网页上**,按用途分组:**我的**(账号、飞书和微信绑定、自己的登录设备、记忆、专家、技能、MCP、用量);**Agent**(运行环境置顶,各 agent 卡片分别配置默认模型、思考程度、可选模型、个人默认技能和 MCP,Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户标题旁添加用户,用户的「管理 → 登录设备」查看和下线各自设备;系统页管理服务端版本和升级、重启、局域网访问和端口,网络访问下方是系统通知;成员也可在系统页设置自己的通知)。账号页通过「修改名称」「修改密码」按需展开表单;飞书和微信绑定操作位于卡片右上角。设置、新建 / 编辑专家、重命名等编辑弹窗不会因点击外部或按 Esc 关闭;通过关闭、取消或保存 / 完成按钮退出。改了没保存就切页或关掉设置会先提醒。
80
+ - **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知;个人设置各自管理,服务器设置由管理员修改,见下面「安全」。
80
81
  - **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → Agent」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择,其他人未配置时不加载技能或 MCP。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
81
82
  - 头像(点头像区域的加号上传;未上传时,会话中用引擎的图标)、引擎(Claude / Codex,建好后不能换)、默认模型和思考程度(从模型列表里选);
82
83
  - 提示词:人设、规则、输出格式。agent-loft 在后面自动补上这个专家能做什么、今天的日期、记忆。Claude 专家默认只用这段提示词(一句话约 2 千 token),也可以选「追加在 Claude Code 原装提示词后面」(干活更稳,每轮多约 1.6 万);Codex 的基础指令改不了,专家的提示词附在第一条消息后面,约束力弱一些;
@@ -87,7 +88,7 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
87
88
  - 子智能体(只有 Claude):别的 Claude 专家,主专家用 Agent 工具把子任务派给它。子智能体的权限不能超过主专家(运行时也封顶在主专家的权限)。
88
89
 
89
90
  只勾联网搜索、读网页的 Claude 专家就是以前聊天模式的效果。专家改了,用它的对话下一条消息起生效;专家删了,用它的对话还能看、不能再发消息,用它的定时任务暂停。以前的聊天模式取消了:升级后聊天模式的旧对话不再保留,聊天模式的定时任务暂停,选个专家再启用。
90
- - **MCP**:设置 → MCP,每人管自己的:本机进程(命令 + 参数 + 环境变量)或 HTTP 地址(+ 请求头),值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。自定义专家加载各自勾选的服务;内置专家在「设置 → Agent → 内置 Agent 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
91
+ - **MCP**:设置 → MCP,每人管自己的:本机进程(命令 + 参数 + 环境变量)或 HTTP 地址(+ 请求头),值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。自定义专家加载各自勾选的服务;内置专家在「设置 → Agent → 对应 Agent 卡片 → 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
91
92
  - **记忆**:像 ChatGPT 的记忆,设置 → 记忆(默认关)。「关于我」加上一条条记住的事,每次对话都带上;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),记错了用 `forget` 删。**自动整理**:把上次整理之后新说的话交给模型(不留会话记录的一次性调用),补充、更新或删掉过时的记忆,用户自己加的条目它不动。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,只有你自己的、没被删掉的对话)。聊天记录索引不开记忆也会记(侧栏的「搜索」也用它),升级后会把已有对话收录进来一次;没开记忆时记进来的不拿去整理。两项都能在设置里单独关。每个用户一份,Claude 和 Codex、Web 和飞书共用。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
92
93
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选专家和目录),或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。
93
94
  - **技能(skills)**:设置 → 技能。技能就是 Claude Code / Codex 用的那种 SKILL.md(可以带脚本和资料),由 agent-loft 按人管理,两个 agent 都能用。**来源**:在页面上写、上传技能包(`.zip` / `.skill` / 单个 SKILL.md / 整个文件夹),或者在对话里让 agent「把刚才的做法存成技能」(agent 用 `create_skill` / `update_skill`,先弹授权卡)。**共享**:新建、编辑时选择「仅自己可见」「指定用户」或「所有人可见」,也可在自己技能的「更多 → 共享」里调整;默认仅自己可见。其他用户在「共享技能」中查看正文和附带文件、安装;安装后出现在「我的技能」,可停用、卸载或重新安装。安装的是作者的同一份技能,更新自动跟随;作者撤回共享后,范围外用户不再可用。只有作者能编辑,管理员可下架自己看得到的共享技能。共享不包含作者填写的变量和密钥,每人使用自己的配置。**使用**:内置专家默认使用你启用的全部技能,也可以在「设置 → Agent」中分别指定 Claude Code / Codex 加载哪些技能;自定义专家只用它选中的;agent 遇到对得上的事自己用。**变量**:技能可以声明要用的环境变量(接口地址、密钥),每个人填自己的值,只注入自己的会话;密钥再写上「只允许发往」的地址就成了**受保护的密钥**——不进环境变量,agent 看不到值,只能用 `skill_request` 工具让 agent-loft 代发请求(在地址、请求头、请求体里写 `{{变量名}}`),只发往你确认过的地址、不跟随跳转、响应里出现的值会被抹掉;作者后来改了地址,要你再确认一次才放行。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「设置 → 技能 → 本机技能」里能看到。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.83",
3
+ "version": "0.2.85",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -74,7 +74,7 @@ import {
74
74
  } from "./auth.js";
75
75
  import { canSeeConv, pushOwnedBy, sessionVisibleTo } from "./access.js";
76
76
  import { clampLimit, dirsOf, inDir, inRecent, pageOf, parseCursor, searchConvs } from "./conv-pages.js";
77
- import { clientIp, cookies, HttpError, isHttps, readBody, readJsonBody, SECURITY_HEADERS, sendJson } from "./http.js";
77
+ import { clientIp, cookies, HttpError, isHttps, readBody, readJsonBody, SECURITY_HEADERS, sendJson, setServerTiming } from "./http.js";
78
78
  import { handleTasksApi } from "./tasks-api.js";
79
79
  import { handleLibraryApi } from "./library-api.js";
80
80
  import { attachToConversation, canSeeFile, deleteConversationFiles, getLibraryFile } from "../../core/library.js";
@@ -658,6 +658,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
658
658
  if (p === "/api/bootstrap" && method === "GET") {
659
659
  // 会话只给侧栏第一屏要的(见 conv-pages.ts):「最近」的前 recent 棵树、展开着的目录各自的前几棵,
660
660
  // 每个 IM 分组最近的一条(微信另含当前会话),再加上正在跑的、等你处理的。其余展开后分页拉取。
661
+ const startedAt = performance.now();
661
662
  const all = hub.list(visible).filter((c) => !c.hidden);
662
663
  const pending = interactions.listPending().filter((i) => visible(getConversation(i.convKey)));
663
664
  const recent = pageOf(all.filter(inRecent), null, clampLimit(url.searchParams.get("recent"), 10));
@@ -702,6 +703,9 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
702
703
  const parent = c.forkOf ? byKey.get(c.forkOf) : undefined;
703
704
  if (parent) keep.set(parent.key, parent);
704
705
  }
706
+ const titlesAt = performance.now();
707
+ const conversations = await hub.backfillFeishuTitles([...keep.values()]);
708
+ setServerTiming(res, { titles: performance.now() - titlesAt, total: performance.now() - startedAt });
705
709
  sendJson(res, 200, {
706
710
  agents: [...AGENT_IDS].map((id) => {
707
711
  const d = hub.driver(id);
@@ -724,7 +728,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
724
728
  workspaceRoot: config().workspaceRoot,
725
729
  quotaRefreshMin: config().web.quotaRefreshMin,
726
730
  quotaEnabled: config().web.quotaEnabled,
727
- conversations: await hub.backfillFeishuTitles([...keep.values()]),
731
+ conversations,
728
732
  sidebar: {
729
733
  recent: { next: recent.next },
730
734
  // 展开着的目录带上翻页游标(没带 next 的目录前端还没拉过)
@@ -1012,13 +1016,17 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1012
1016
  // b) 读之前和读之后是同一轮还在进行(快照里缺的部分由 live 事件补上)。
1013
1017
  // 其余情况(读的过程中有一轮结束了、或者开始了新的一轮)都重读。
1014
1018
  const turnStartSeq = () => hub.liveTurn(key)[0]?.seq ?? 0;
1019
+ const startedAt = performance.now();
1020
+ let readMs = 0;
1015
1021
  let messages: Awaited<ReturnType<typeof hub.history>> = [];
1016
1022
  let consistent = false;
1017
1023
  for (let i = 0; i < 5 && !consistent; i++) {
1018
1024
  if (i > 0) await new Promise((r) => setTimeout(r, 200));
1019
1025
  const before = hub.currentSeq();
1020
1026
  const startBefore = turnStartSeq();
1027
+ const readAt = performance.now();
1021
1028
  messages = await hub.history(key);
1029
+ readMs += performance.now() - readAt;
1022
1030
  const changed = (hub.eventsSince(key, before) ?? [null]).length > 0;
1023
1031
  const startAfter = turnStartSeq();
1024
1032
  consistent = !changed || (startBefore !== 0 && startBefore === startAfter);
@@ -1041,6 +1049,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1041
1049
  messages = messages.slice(0, lastUser);
1042
1050
  }
1043
1051
  }
1052
+ setServerTiming(res, { read: readMs, total: performance.now() - startedAt });
1044
1053
  sendJson(res, 200, {
1045
1054
  info: hub.info(key),
1046
1055
  messages,
@@ -0,0 +1,50 @@
1
+ // 前端静态资源的版本前缀:/v/<指纹>/app.js。
2
+ //
3
+ // 没有构建步骤,文件名里没有内容哈希。以前全部 no-cache,每次打开都要把六十来个文件逐个确认一遍。
4
+ // 现在页面(每次都重新拿)把资源地址写成带指纹的,这些地址可以放心长缓存:
5
+ // - 模块之间都是相对路径 import,入口带上前缀,整棵依赖树自然都带上;
6
+ // - 文件一变指纹就变,刷新页面拿到的是新地址;
7
+ // - 指纹跟最新的不一致(升级后还开着的旧页面懒加载):照样给当前的文件,但不让长缓存。
8
+ // 不带前缀的老地址继续能用,还是 no-cache。
9
+ import { createHash } from "node:crypto";
10
+ import fs from "node:fs/promises";
11
+ import path from "node:path";
12
+
13
+ const VERSIONED = /^\/v\/([0-9a-f]{12})(\/.*)$/;
14
+
15
+ /** /v/<指纹>/xxx → 指纹和真正的路径;不是这个形式就 undefined */
16
+ export function parseVersioned(pathname: string): { token: string; pathname: string } | undefined {
17
+ const m = VERSIONED.exec(pathname);
18
+ return m ? { token: m[1]!, pathname: m[2]! } : undefined;
19
+ }
20
+
21
+ /** 页面里的样式和入口脚本写成带指纹的地址。图标、manifest、sw.js 地址要稳定,不动 */
22
+ export function stampIndex(html: string, token: string): string {
23
+ return html.replace(/\b(href|src)="\/(css\/|vendor\/|app\.js)/g, `$1="/v/${token}/$2`);
24
+ }
25
+
26
+ async function listFiles(dir: string): Promise<string[]> {
27
+ const entries = await fs.readdir(dir, { withFileTypes: true });
28
+ const nested = await Promise.all(
29
+ entries.map((e) => {
30
+ const full = path.join(dir, e.name);
31
+ return e.isDirectory() ? listFiles(full) : Promise.resolve(e.isFile() ? [full] : []);
32
+ }),
33
+ );
34
+ return nested.flat();
35
+ }
36
+
37
+ /**
38
+ * 指纹:程序版本 + 前端目录和 extra 里每个文件的路径、大小、修改时间。
39
+ * 只 stat 不读内容,打开页面时算一次也不费事;开发时改了前端文件,不重启、刷新就能拿到新的。
40
+ */
41
+ export async function assetToken(version: string, webRoot: string, extra: string[]): Promise<string> {
42
+ const files = [...(await listFiles(webRoot)), ...extra].sort();
43
+ const stats = await Promise.all(
44
+ files.map(async (file) => {
45
+ const stat = await fs.stat(file).catch(() => null);
46
+ return stat ? `${file}:${stat.size}:${stat.mtimeMs}` : `${file}:-`;
47
+ }),
48
+ );
49
+ return createHash("sha256").update(version).update("\0").update(stats.join("\0")).digest("hex").slice(0, 12);
50
+ }
@@ -124,6 +124,11 @@ export function sendJson(res: ServerResponse, status: number, body: unknown): vo
124
124
  );
125
125
  }
126
126
 
127
+ /** 接口各段耗时(毫秒):浏览器开发者工具的 Timing 里能看到,要在 sendJson 之前调用 */
128
+ export function setServerTiming(res: ServerResponse, parts: Record<string, number>): void {
129
+ res.setHeader("Server-Timing", Object.entries(parts).map(([name, ms]) => `${name};dur=${ms.toFixed(1)}`).join(", "));
130
+ }
131
+
127
132
  export const SECURITY_HEADERS: Record<string, string> = {
128
133
  "X-Content-Type-Options": "nosniff",
129
134
  "X-Frame-Options": "DENY",
@@ -25,6 +25,7 @@ import { currentUser, handleApi, takeUploads } from "./api.js";
25
25
  import { authEvents, ensureSetupToken, sessionUser } from "./auth.js";
26
26
  import { canSeeKey, sessionVisibleTo } from "./access.js";
27
27
  import { cookies } from "./http.js";
28
+ import { assetToken, parseVersioned, stampIndex } from "./assets.js";
28
29
  import { compressedFile, compressibleExt, MIN_SIZE, pickEncoding } from "./compress.js";
29
30
  import { COOKIE } from "./api.js";
30
31
  import { HttpError, pageHeaders, sameOrigin, SECURITY_HEADERS, sendJson } from "./http.js";
@@ -79,10 +80,11 @@ const MIME: Record<string, string> = {
79
80
  };
80
81
 
81
82
  /**
82
- * 静态文件一律 no-cache + Last-Modified:每次都向服务端确认一下,没变就回 304。
83
+ * 不带指纹的地址 no-cache + Last-Modified:每次都向服务端确认一下,没变就回 304。
83
84
  * 升级后前端的 js、css 和 vendor 都会变,但地址不变,带 max-age 的话刷新页面还会拿到旧的。
85
+ * 带最新指纹的地址(见 assets.ts)内容不会再变,immutable:下次打开不用再问。
84
86
  */
85
- function serveFile(req: http.IncomingMessage, res: http.ServerResponse, file: string): void {
87
+ function serveFile(req: http.IncomingMessage, res: http.ServerResponse, file: string, immutable = false): void {
86
88
  fs.stat(file, (err, stat) => {
87
89
  if (err || !stat.isFile()) {
88
90
  res.writeHead(404, SECURITY_HEADERS);
@@ -93,10 +95,11 @@ function serveFile(req: http.IncomingMessage, res: http.ServerResponse, file: st
93
95
  const since = Date.parse(req.headers["if-modified-since"] ?? "");
94
96
  const headers = {
95
97
  ...pageHeaders(),
96
- "Cache-Control": "no-cache",
98
+ "Cache-Control": immutable ? "max-age=31536000, immutable" : "no-cache",
97
99
  "Last-Modified": lastModified.toUTCString(),
98
100
  };
99
- // 页面本身不回 304:它的 CSP(允许谁嵌、能嵌谁)跟着设置变,304 带回的新头浏览器不一定换上
101
+ // 页面本身不回 304:它的 CSP(允许谁嵌、能嵌谁)跟着设置变,304 带回的新头浏览器不一定换上。
102
+ // 平时页面走 serveIndex,这里的判断留给它出错时的退路
100
103
  if (!Number.isNaN(since) && lastModified.getTime() <= since && path.extname(file) !== ".html") {
101
104
  res.writeHead(304, headers);
102
105
  res.end();
@@ -131,18 +134,93 @@ function novncFile(pathname: string): string | undefined {
131
134
  return path.join(pkgDir("@novnc/novnc"), rel);
132
135
  }
133
136
 
137
+ /** 指纹要盖住的 vendor 文件。noVNC 是一整个目录,看它的 package.json 就够了 */
138
+ function vendorFiles(): string[] {
139
+ const files: string[] = [];
140
+ for (const resolve of [...Object.values(VENDOR), () => pkgFile("@novnc/novnc", "package.json")]) {
141
+ try {
142
+ files.push(resolve());
143
+ } catch {
144
+ // 没装上的包:请求它时本来就是 404
145
+ }
146
+ }
147
+ return files;
148
+ }
149
+
150
+ /** 最近一次算出的指纹。每次打开页面都重算;带指纹的请求只跟它比,不用每个文件都扫一遍目录 */
151
+ let latestToken: Promise<string> | undefined;
152
+
153
+ function refreshToken(): Promise<string> {
154
+ const job = assetToken(RUNNING_VERSION, webRoot, vendorFiles());
155
+ latestToken = job;
156
+ job.catch(() => {
157
+ if (latestToken === job) latestToken = undefined;
158
+ });
159
+ return job;
160
+ }
161
+
162
+ /**
163
+ * 页面本身:资源地址写成带指纹的。每次都重新给,不回 304(它的 CSP 跟着设置变,见 serveFile)。
164
+ * 指纹算失败了就退回原样的页面:地址不带指纹,慢一点但能用。
165
+ */
166
+ function serveIndex(req: http.IncomingMessage, res: http.ServerResponse, file: string): void {
167
+ void (async () => {
168
+ const [token, stat] = await Promise.all([refreshToken(), fs.promises.stat(file)]);
169
+ const read = async () => Buffer.from(stampIndex(await fs.promises.readFile(file, "utf8"), token));
170
+ const encoding = stat.size >= MIN_SIZE ? pickEncoding(req.headers) : undefined;
171
+ const body = encoding ? await compressedFile(`${file}#${token}`, stat.mtimeMs, stat.size, encoding, read) : await read();
172
+ if (res.headersSent || res.destroyed) return;
173
+ res.writeHead(200, {
174
+ ...pageHeaders(),
175
+ "Cache-Control": "no-cache",
176
+ "Content-Type": MIME[".html"]!,
177
+ "Content-Length": body.length,
178
+ Vary: "Accept-Encoding",
179
+ ...(encoding ? { "Content-Encoding": encoding } : {}),
180
+ });
181
+ res.end(body);
182
+ })().catch(() => {
183
+ if (!res.headersSent && !res.destroyed) serveFile(req, res, file);
184
+ });
185
+ }
186
+
134
187
  function serveStatic(req: http.IncomingMessage, res: http.ServerResponse, url: URL): void {
135
- if (url.pathname.startsWith("/vendor/novnc/")) {
136
- const file = novncFile(url.pathname);
137
- if (file) return serveFile(req, res, file);
188
+ const versioned = parseVersioned(url.pathname);
189
+ if (versioned) {
190
+ // 带指纹的只给资源。没有扩展名的地址不回退到页面:这种请求不会是用户打开页面
191
+ if (!path.extname(versioned.pathname) || path.extname(versioned.pathname) === ".html") {
192
+ res.writeHead(404, SECURITY_HEADERS);
193
+ res.end();
194
+ return;
195
+ }
196
+ void (latestToken ?? refreshToken())
197
+ .catch(() => undefined)
198
+ .then((token) => {
199
+ try {
200
+ servePath(req, res, versioned.pathname, token === versioned.token);
201
+ } catch (err) {
202
+ console.error("[web] 静态文件出错:", err);
203
+ if (!res.headersSent) res.writeHead(500);
204
+ res.end();
205
+ }
206
+ });
207
+ return;
208
+ }
209
+ servePath(req, res, url.pathname, false);
210
+ }
211
+
212
+ function servePath(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, immutable: boolean): void {
213
+ if (pathname.startsWith("/vendor/novnc/")) {
214
+ const file = novncFile(pathname);
215
+ if (file) return serveFile(req, res, file, immutable);
138
216
  res.writeHead(404, SECURITY_HEADERS);
139
217
  res.end();
140
218
  return;
141
219
  }
142
- const vendor = VENDOR[url.pathname];
220
+ const vendor = VENDOR[pathname];
143
221
  if (vendor) {
144
222
  try {
145
- serveFile(req, res, vendor());
223
+ serveFile(req, res, vendor(), immutable);
146
224
  } catch {
147
225
  res.writeHead(404);
148
226
  res.end();
@@ -151,7 +229,7 @@ function serveStatic(req: http.IncomingMessage, res: http.ServerResponse, url: U
151
229
  }
152
230
  let rel: string;
153
231
  try {
154
- rel = decodeURIComponent(url.pathname);
232
+ rel = decodeURIComponent(pathname);
155
233
  } catch {
156
234
  res.writeHead(400, SECURITY_HEADERS);
157
235
  res.end("bad request");
@@ -169,7 +247,8 @@ function serveStatic(req: http.IncomingMessage, res: http.ServerResponse, url: U
169
247
  res.end();
170
248
  return;
171
249
  }
172
- serveFile(req, res, file);
250
+ if (file === path.join(webRoot, "index.html")) return serveIndex(req, res, file);
251
+ serveFile(req, res, file, immutable);
173
252
  }
174
253
 
175
254
  // ---------- WebSocket ----------
@@ -16,6 +16,29 @@
16
16
  }
17
17
 
18
18
  /* 勾选列表:技能、MCP、子智能体、记忆整理选专家 */
19
+ .experts-page {
20
+ display: flex;
21
+ flex-direction: column;
22
+ gap: 14px;
23
+ min-width: 0;
24
+ }
25
+
26
+ .tool-check-item > input {
27
+ flex-shrink: 0;
28
+ }
29
+
30
+ .tool-check-item > span {
31
+ flex: 0 0 auto;
32
+ max-width: calc(100% - 28px);
33
+ white-space: nowrap;
34
+ overflow: hidden;
35
+ text-overflow: ellipsis;
36
+ }
37
+
38
+ .tool-check-item > small {
39
+ flex: 1;
40
+ }
41
+
19
42
  .check-list {
20
43
  display: flex;
21
44
  flex-direction: column;
@@ -56,8 +56,8 @@
56
56
  scale: 0.96;
57
57
  }
58
58
 
59
- .top-actions :is(.top-more, .conv-expert-icon):active {
60
- background: var(--bg-hover);
59
+ .top-actions :is(.top-more, .conv-expert-icon):is(:hover, :active, :focus) {
60
+ background: transparent;
61
61
  }
62
62
 
63
63
  .topbar :is(.menu-btn, .top-more, .conv-expert-icon):focus-visible {
@@ -4,6 +4,12 @@
4
4
  padding: 10px 10px 0;
5
5
  }
6
6
 
7
+ .server-switcher {
8
+ display: flex;
9
+ align-items: center;
10
+ gap: 8px;
11
+ }
12
+
7
13
  .side-switch[hidden],
8
14
  .auth-switch[hidden],
9
15
  .srv-pill[hidden] {
@@ -11,10 +17,11 @@
11
17
  }
12
18
 
13
19
  .server-switch {
14
- display: flex;
20
+ display: inline-flex;
15
21
  align-items: center;
16
- gap: 8px;
17
- width: 100%;
22
+ gap: 6px;
23
+ width: fit-content;
24
+ max-width: 100%;
18
25
  min-width: 0;
19
26
  padding: 6px 8px;
20
27
  border-radius: 10px;
@@ -27,35 +34,29 @@
27
34
  background: var(--bg-hover);
28
35
  }
29
36
 
30
- .srv-icon {
31
- width: 24px;
32
- height: 24px;
33
- flex-shrink: 0;
34
- display: inline-grid;
35
- place-items: center;
36
- border-radius: 7px;
37
- font-size: 16px;
38
- line-height: 1;
39
- }
40
-
41
- .srv-icon.letter {
42
- background: var(--accent);
43
- color: var(--accent-fg);
44
- font-size: 12px;
45
- font-weight: 600;
46
- }
47
-
48
37
  .srv-name,
49
38
  .srv-item-name {
50
- flex: 1;
51
39
  min-width: 0;
52
40
  overflow: hidden;
53
41
  text-overflow: ellipsis;
54
42
  white-space: nowrap;
55
43
  }
56
44
 
45
+ .srv-name {
46
+ flex: 0 1 auto;
47
+ }
48
+
49
+ .srv-item-name {
50
+ flex: 1;
51
+ }
52
+
53
+ .server-switcher > .srv-badge {
54
+ flex-shrink: 0;
55
+ }
56
+
57
57
  .srv-chev {
58
58
  display: inline-grid;
59
+ flex-shrink: 0;
59
60
  opacity: 0.55;
60
61
  }
61
62
 
@@ -46,6 +46,7 @@
46
46
 
47
47
  .settings-body {
48
48
  flex: 1;
49
+ min-width: 0;
49
50
  overflow-y: auto;
50
51
  padding: 16px;
51
52
  }
@@ -56,9 +57,35 @@
56
57
  display: flex;
57
58
  flex-direction: column;
58
59
  gap: 14px;
60
+ min-width: 0;
61
+ }
62
+
63
+ .account-actions {
64
+ justify-content: flex-end;
65
+ }
66
+
67
+ .account-edit {
68
+ display: flex;
69
+ flex-direction: column;
70
+ gap: 12px;
71
+ }
72
+
73
+ .row.weixin-expert-row {
74
+ align-items: stretch;
75
+ flex-wrap: nowrap;
59
76
  }
60
77
 
61
- .settings-page [hidden] {
78
+ .weixin-expert-row > select {
79
+ width: 0;
80
+ }
81
+
82
+ .weixin-expert-row > .btn {
83
+ flex-shrink: 0;
84
+ }
85
+
86
+ .settings-page [hidden],
87
+ .modal-body [hidden],
88
+ .account-edit[hidden] {
62
89
  display: none !important;
63
90
  }
64
91
 
@@ -626,8 +653,15 @@
626
653
  grid-template-columns: 1fr 1fr;
627
654
  }
628
655
  }
629
- .builtin-agent-defaults + .builtin-agent-defaults {
656
+ .agent-config,
657
+ .builtin-agent-defaults {
658
+ display: flex;
659
+ flex-direction: column;
660
+ gap: 12px;
661
+ min-width: 0;
662
+ }
663
+
664
+ .agent-config + .builtin-agent-defaults {
630
665
  border-top: 1px solid var(--border);
631
- padding-top: 16px;
632
- margin-top: 16px;
666
+ padding-top: 14px;
633
667
  }
@@ -256,42 +256,29 @@ button.conv-group:hover {
256
256
  display: grid;
257
257
  }
258
258
 
259
- /* IM 分组常驻渠道图标,桌面悬停或键盘聚焦时显示新建加号。 */
259
+ /* IM 分组的渠道图标仅作标识,不提供新建操作。 */
260
260
  .bot-row .conv-item.proj {
261
261
  padding-right: 36px;
262
262
  }
263
263
 
264
- .bot-new {
264
+ .bot-channel {
265
+ position: absolute;
266
+ right: 4px;
267
+ top: 50%;
268
+ transform: translateY(-50%);
269
+ width: 28px;
270
+ height: 28px;
265
271
  display: grid;
272
+ place-items: center;
273
+ color: var(--fg-soft);
266
274
  }
267
275
 
268
- .bot-new .channel-mark,
269
- .bot-new .bot-plus {
270
- grid-area: 1 / 1;
271
- }
272
-
273
- .bot-new .channel-mark,
274
- .bot-new .channel-mark svg {
276
+ .bot-channel .channel-mark,
277
+ .bot-channel .channel-mark svg {
275
278
  width: 14px;
276
279
  height: 14px;
277
280
  }
278
281
 
279
- .bot-new .bot-plus {
280
- visibility: hidden;
281
- }
282
-
283
- @media (hover: hover) and (pointer: fine) {
284
- .bot-row:hover .bot-new .channel-mark,
285
- .bot-row:focus-within .bot-new .channel-mark {
286
- visibility: hidden;
287
- }
288
-
289
- .bot-row:hover .bot-new .bot-plus,
290
- .bot-row:focus-within .bot-new .bot-plus {
291
- visibility: visible;
292
- }
293
- }
294
-
295
282
  /* 鼠标挪到右边的加号上时,整行的 hover 底色还留着 */
296
283
  .proj-row:hover .conv-item.proj {
297
284
  padding-right: 36px;
@@ -226,6 +226,11 @@
226
226
  gap: 10px;
227
227
  }
228
228
 
229
+ .expert-card .usage {
230
+ border-top: 1px solid var(--border);
231
+ padding: 10px 0 0;
232
+ }
233
+
229
234
  .ec-head {
230
235
  display: flex;
231
236
  align-items: center;
@@ -370,7 +375,7 @@
370
375
  -webkit-app-region: no-drag;
371
376
  }
372
377
 
373
- /* ---- 右上角「更多」:菜单项 + 当前会话的 token 用量 ---- */
378
+ /* ---- 右上角「更多」:会话操作菜单 ---- */
374
379
  .top-menu {
375
380
  min-width: 248px;
376
381
  }
package/web/index.html CHANGED
@@ -15,26 +15,26 @@
15
15
  <link rel="stylesheet" href="/vendor/hljs-light.css" media="(prefers-color-scheme: light)" />
16
16
  <link rel="stylesheet" href="/vendor/hljs-dark.css" media="(prefers-color-scheme: dark)" />
17
17
  <!-- 顺序就是层叠顺序,不要随意调换 -->
18
- <link rel="stylesheet" href="/css/base.css?v=2" />
18
+ <link rel="stylesheet" href="/css/base.css" />
19
19
  <link rel="stylesheet" href="/css/sidebar.css" />
20
- <link rel="stylesheet" href="/css/topbar.css?v=2" />
21
- <link rel="stylesheet" href="/css/messages.css?v=3" />
20
+ <link rel="stylesheet" href="/css/topbar.css" />
21
+ <link rel="stylesheet" href="/css/messages.css" />
22
22
  <link rel="stylesheet" href="/css/albums.css" />
23
23
  <link rel="stylesheet" href="/css/loader.css" />
24
24
  <link rel="stylesheet" href="/css/composer.css" />
25
- <link rel="stylesheet" href="/css/overlay.css?v=2" />
25
+ <link rel="stylesheet" href="/css/overlay.css" />
26
26
  <link rel="stylesheet" href="/css/search.css" />
27
27
  <link rel="stylesheet" href="/css/settings.css" />
28
28
  <link rel="stylesheet" href="/css/schedule.css" />
29
29
  <link rel="stylesheet" href="/css/todos.css" />
30
- <link rel="stylesheet" href="/css/tasks.css?v=3" />
30
+ <link rel="stylesheet" href="/css/tasks.css" />
31
31
  <link rel="stylesheet" href="/css/library.css" />
32
32
  <link rel="stylesheet" href="/css/skills.css" />
33
33
  <link rel="stylesheet" href="/css/experts.css" />
34
34
  <link rel="stylesheet" href="/css/terminal.css" />
35
35
  <link rel="stylesheet" href="/css/remote.css" />
36
36
  <link rel="stylesheet" href="/css/servers.css" />
37
- <link rel="stylesheet" href="/css/mobile.css?v=6" />
37
+ <link rel="stylesheet" href="/css/mobile.css" />
38
38
  </head>
39
39
  <body>
40
40
  <div id="app"><div class="boot"><span class="loft-loader xl" role="img" aria-label="加载中"><svg viewBox="96 56 320 388" aria-hidden="true"><defs><linearGradient id="boot-g" gradientUnits="userSpaceOnUse" x1="104" y1="104" x2="408" y2="408"><stop offset="0" stop-color="#3b82f6"/><stop offset="1" stop-color="#06b6d4"/></linearGradient></defs><path class="ll-shadow" d="M256 296L404 364L256 432L108 364Z" fill="url(#boot-g)"/><path class="ll-plate" d="M256 252L404 320L256 388L108 320Z" fill="url(#boot-g)"/><path class="ll-star ll-l" d="M152 186C158.46 217.54 158.46 217.54 190 224C158.46 230.46 158.46 230.46 152 262C145.54 230.46 145.54 230.46 114 224C145.54 217.54 145.54 217.54 152 186Z" fill="url(#boot-g)"/><path class="ll-star ll-c" d="M256 82C268.92 145.08 268.92 145.08 332 158C268.92 170.92 268.92 170.92 256 234C243.08 170.92 243.08 170.92 180 158C243.08 145.08 243.08 145.08 256 82Z" fill="url(#boot-g)"/><path class="ll-star ll-r" d="M360 186C366.46 217.54 366.46 217.54 398 224C366.46 230.46 366.46 230.46 360 262C353.54 230.46 353.54 230.46 322 224C353.54 217.54 353.54 217.54 360 186Z" fill="url(#boot-g)"/></svg></span></div></div>