agent-loft 0.2.49 → 0.2.50

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
@@ -29,7 +29,7 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
29
29
  | 🧑‍🏫 | **专家** | 自己配专家:选引擎、写提示词,定它能做什么(只能联网 / 读文件 / 改文件 / 跑命令),挂哪些技能和 MCP,能把活派给哪些子智能体。新对话、定时任务都能选 |
30
30
  | 🔀 | **飞书机器人灵活绑定 agent** | 机器人数量不限,每个机器人可以只对应一个 agent,也可以对应多个(在会话里切换)。网页上扫码就能创建,改完立即生效;由服务端主动连向飞书,家里没有公网 IP 也能在外面用 |
31
31
  | 🔗 | **飞书续接 Web 任务** | 飞书里发 `/web` 接上一条 Web 会话,或者在网页侧栏右键会话选「在飞书继续…」。之后回复、授权、提问都发到飞书,发 `/detach` 回来 |
32
- | 🖥️ | **完整的 Web 工作台** | 流式回复、附件、语音输入、模型和思考程度切换、上下文占用、从任意回复分叉、按项目分组的侧栏、全部设置,电脑和手机(PWA)都能用 |
32
+ | 🖥️ | **完整的 Web 工作台** | 流式回复、附件、语音输入、模型和思考程度切换、上下文占用、从任意回复分叉、按项目分组的侧栏、搜索会话、全部设置,电脑和手机(PWA)都能用 |
33
33
  | 🔔 | **飞书 + 苹果系统推送** | 除了飞书消息,Web 会话还能推送到 iPhone、iPad 锁屏和 Mac 通知中心(标准 Web Push,不需要开发者账号),图标上显示未读数 |
34
34
  | 🗂️ | **桌面端同时接入多台设备** | 桌面端(macOS / Windows / Linux)同时连多台服务器,菜单栏 / 托盘一眼看完各台的额度、待处理和运行中的会话 |
35
35
 
@@ -51,7 +51,10 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
51
51
  - 输入框里的小圆环显示上下文窗口占用;模型按钮显示实际的模型和思考程度(如「Opus 5.5 high」)。
52
52
  - 滚动和 ChatGPT 一样:发出的问题顶到最上面、下面留白,回复长到屏幕底部才跟着往下滚;回复过程中自己滚动了就不再自动滚,下次发消息再恢复。
53
53
  - 定时发送:右上角「更多」→「定时发送」,默认排在 5 小时额度重置后 5 分钟(弹窗里提示 5 小时 / 7 天额度的重置时间),由服务端到点发出,关掉页面也会发。适合额度用完、要等刷新才能接着干活的时候。
54
- - 侧栏分「最近」和「项目」两组:Web 会话按工作目录归类(目录可以拖动排序,右键可置顶;排好的顺序跟着账号走、各设备一致,新消息不会打乱),飞书机器人各占一行(右键看历史会话);分叉出来的会话用虚线挂在原会话下面;会话标题由 agent 自动生成,双击重命名。
54
+ - 侧栏分「最近」和「项目」两组:Web 会话按工作目录归类(目录可以拖动排序,右键可置顶;排好的顺序跟着账号走、各设备一致,新消息不会打乱),飞书机器人各占一行(右键看历史会话);项目名、有分叉的会话后面有个小三角,点一下折叠 / 展开(折叠后显示「N 个嵌套会话」);分叉出来的会话缩进挂在原会话下面,用一条细线连着;标题放不下时尾巴淡出;会话标题由 agent 自动生成,双击重命名。
55
+ - **搜索**:侧栏「搜索」弹窗,搜全部会话的标题、目录名和聊天内容(不开记忆也能搜),可以按专家筛;↑↓ 选、回车打开。
56
+ - 会话页顶部标题前是专家的头像,鼠标停上去或点一下,看专家的说明、模型、能力和当前工作目录。
57
+ - 附件可以直接拖到聊天区任意位置上传。
55
58
  - 回复过程中接着发的消息排队,标着「排队中」,上一条回复完自动接着处理;点「打断并发送」停掉正在进行的回复、马上处理这条;点停止则连排着的一起取消(标「没有发出」)。
56
59
  - 太长的消息先收起,点「展开显示」看全文;对话里有 3 条以上消息时,右边有一列快速定位,鼠标移上去列出每条消息的开头,点一下跳过去。
57
60
  - 侧栏按页加载:「最近」先显示 10 条、每个项目目录先显示 5 条,点「展开显示」每次再拉 10 条。
@@ -66,17 +69,17 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
66
69
  - **设置都在网页上**,按用途分组:**我的**(账号和密码、飞书绑定、登录设备、通知、记忆、技能、用量,每个人都有);**Agent**(运行环境、各 agent 的默认模型和思考程度、可选模型、Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户、所有人的登录设备;服务端版本和升级、重启、局域网访问和端口)。改了没保存就切页或关掉设置会先提醒。
67
70
  - **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知,设置只有管理员能改,见下面「安全」。
68
71
  - **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex` 换专家会开新会话)。**内置专家**:Claude Code、Codex,就是 agent 原装的样子(原装提示词、机器上的技能和 MCP、所有工具)。**自定义专家**每人管自己的,可以配:
69
- - 引擎(Claude / Codex,建好后不能换)、默认模型和思考程度;
72
+ - 头像(自己上传,没传就用引擎的图标)、引擎(Claude / Codex,建好后不能换)、默认模型和思考程度(从模型列表里选);
70
73
  - 提示词:人设、规则、输出格式。agent-loft 在后面自动补上这个专家能做什么、今天的日期、记忆。Claude 专家默认只用这段提示词(一句话约 2 千 token),也可以选「追加在 Claude Code 原装提示词后面」(干活更稳,每轮多约 1.6 万);Codex 的基础指令改不了,专家的提示词附在第一条消息后面,约束力弱一些;
71
- - 权限,一级包含一级:**只能联网**(不碰本机文件、不弹授权,文本附件内容直接放进消息)/**能读文件**/**能改文件**/**能跑命令**(跑命令就等于能改任何文件,需要授权时弹卡)。Claude 按权限给工具;Codex 按权限开 shell、apply_patch,沙箱只读或 workspace-write;
72
- - 联网搜索、读网页的开关,带不带个人记忆,默认工作目录,新对话页上的欢迎语和快捷提问;
74
+ - 权限,勾选:联网搜索、读网页,以及文件权限(一级包含一级):都不勾就是**只能联网**(不碰本机文件、不弹授权,文本附件内容直接放进消息)/**能读文件**/**能改文件**/**能跑命令**(跑命令就等于能改任何文件,需要授权时弹卡)。Claude 按权限给工具;Codex 按权限开 shell、apply_patch,沙箱只读或 workspace-write;
75
+ - 带不带个人记忆,默认工作目录,新对话页上的欢迎语和快捷提问;
73
76
  - 技能:只给选中的(Claude 用技能白名单,没选的调不了;没选技能就不挂 Skill 工具,省 token);
74
77
  - MCP:从「设置 → MCP」里勾(管理员还能勾机器上配的);
75
78
  - 子智能体(只有 Claude):别的 Claude 专家,主专家用 Agent 工具把子任务派给它。子智能体的权限不能超过主专家(运行时也封顶在主专家的权限)。
76
79
 
77
- 「新建 → 从模板:聊天助手」就是以前聊天模式的效果。专家改了,用它的对话下一条消息起生效;专家删了,用它的对话还能看、不能再发消息,用它的定时任务暂停。以前的聊天模式取消了:升级后聊天模式的旧对话不再保留,聊天模式的定时任务暂停,选个专家再启用。
80
+ 只勾联网搜索、读网页的 Claude 专家就是以前聊天模式的效果。专家改了,用它的对话下一条消息起生效;专家删了,用它的对话还能看、不能再发消息,用它的定时任务暂停。以前的聊天模式取消了:升级后聊天模式的旧对话不再保留,聊天模式的定时任务暂停,选个专家再启用。
78
81
  - **MCP**:设置 → MCP,每人管自己的:本机进程(命令 + 参数 + 环境变量)或 HTTP 地址(+ 请求头),值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。只给自定义专家用,内置专家照旧用机器上配的。
79
- - **记忆**:像 ChatGPT 的记忆,设置 → 记忆(默认关)。「关于我」加上一条条记住的事,每次对话都带上;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),记错了用 `forget` 删。**自动整理**:把上次整理之后新说的话交给模型(不留会话记录的一次性调用),补充、更新或删掉过时的记忆,用户自己加的条目它不动。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,只有你自己的、没被删掉的对话;第一次用时会把已有对话收录进来)。两项都能在设置里单独关。每个用户一份,Claude 和 Codex、Web 和飞书共用。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
82
+ - **记忆**:像 ChatGPT 的记忆,设置 → 记忆(默认关)。「关于我」加上一条条记住的事,每次对话都带上;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),记错了用 `forget` 删。**自动整理**:把上次整理之后新说的话交给模型(不留会话记录的一次性调用),补充、更新或删掉过时的记忆,用户自己加的条目它不动。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,只有你自己的、没被删掉的对话)。聊天记录索引不开记忆也会记(侧栏的「搜索」也用它),升级后会把已有对话收录进来一次;没开记忆时记进来的不拿去整理。两项都能在设置里单独关。每个用户一份,Claude 和 Codex、Web 和飞书共用。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
80
83
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏「最近」上面的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选专家和目录),或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。
81
84
  - **技能(skills)**:设置 → 技能。技能就是 Claude Code / Codex 用的那种 SKILL.md(可以带脚本和资料),由 agent-loft 按人管理,两个 agent 都能用。**来源**:在页面上写、上传技能包(`.zip` / `.skill` / 单个 SKILL.md / 整个文件夹),或者在对话里让 agent「把刚才的做法存成技能」(agent 用 `create_skill` / `update_skill`,先弹授权卡)。每人管自己的,不做分享和技能广场(以前从别人那装过的照常能用,可以卸载)。**使用**:内置专家能用你启用的全部技能,自定义专家只用它选中的;agent 遇到对得上的事自己用。**变量**:技能可以声明要用的环境变量(接口地址、密钥),每个人填自己的值,只注入自己的会话;密钥再写上「只允许发往」的地址就成了**受保护的密钥**——不进环境变量,agent 看不到值,只能用 `skill_request` 工具让 agent-loft 代发请求(在地址、请求头、请求体里写 `{{变量名}}`),只发往你确认过的地址、不跟随跳转、响应里出现的值会被抹掉;作者后来改了地址,要你再确认一次才放行。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「设置 → 技能 → 本机技能」里能看到。
82
85
  - **远程控制**:侧栏「定时任务」下面的「远程控制」,直接操作这台机器的**桌面**和**终端**,上面一键切换;切回对话时连接留在后台(侧栏入口上亮个小绿点),再进来接着用。这台机器没有图形桌面(服务器、NAS)时只有终端。
@@ -116,7 +119,7 @@ agent-loft service install # 注册为开机自启服务(systemd / laun
116
119
  - 菜单栏图标可以换成额度条:Claude、Codex 各是一只像素小宠物,看样子就知道是谁,身子是 5 小时额度,下面一条是周额度。桌面端设置 → 额度显示 →「菜单栏显示额度」,选所有服务器合起来(取最高),或者按服务器分别选 Claude / Codex(图标上不写服务器名);都不选就只显示图标。「额度条显示」选实心表示剩余额度(默认,像电池)还是已用额度。只有 macOS 有,Windows / Linux 的托盘图标太小放不下。
117
120
  - 支持前面挡着 Cloudflare Access 的服务器:验证页直接在窗口里完成,过期会提醒;也可以配 Service Token 免验证。
118
121
  - 首次打开可以选「这台 Mac 也作为服务端」:一键在终端里安装 agent-loft(没有 Node.js 会先用 Homebrew 装)并开机自启,装好自动连上;设置里可以改成「只在桌面端运行时运行」(不开机自启,打开桌面端时启动、退出时停止)。Linux 上一样(需要先装好 Node.js 22+,开机自启用 systemd 用户服务);Windows 上服务端还没有开机自启,可以在 WSL 里装,桌面端会自动检测到 `127.0.0.1` 上的它。防休眠:本机有会话在跑时不休眠;另有永不休眠、定时休眠(设休眠时段,时段外不休眠,时段内本机没有会话在跑、屏幕锁上后让 Mac 睡下去)和合盖不休眠(macOS,第一次开关要输管理员密码,之后不用;开着时闲置也不睡,定时休眠到点会临时关掉它让 Mac 睡下去,醒来再打开)。
119
- - 顶栏「更多」→「总量汇总」:把所有已添加服务器的用量加在一起看,按日 / 月 / 年统计 token 和金额,和网页设置 → 用量一样有柱状图和按 agent、模型、用户的分项,另外多一栏按服务器。不在线、没登录或服务端太旧的服务器不计入,页面上会注明。
122
+ - 顶栏「更多」→「用量汇总」:把所有已添加服务器的用量,加上这台电脑上直接用的 Claude Code、Codex(桌面端和 CLI,读它们自己的会话记录),合在一起看。按日 / 月 / 年统计 token 和金额,和网页设置 → 用量一样有柱状图和按 agent、模型、用户的分项,另外多一栏按来源。本机直接用的金额按模型单价估算;Agent Loft 自己跑的会话只算在服务器里,不重复算。不在线、没登录或服务端太旧的服务器不计入,页面上会注明。
120
123
  - 设置(`⌘,`)的服务器列表里展开某台服务器,能看它的 Agent 环境和版本,有新版本时点「升级服务端」;桌面端自己的更新在同一页的「更新」里点「更新并重启」。
121
124
 
122
125
  桌面端只是个壳(代码在 `desktop/`),服务端照常用 npm 安装和升级。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.49",
3
+ "version": "0.2.50",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -42,7 +42,7 @@ import {
42
42
  } from "../../core/memory.js";
43
43
  import { createLinkCode, listLinks, unlink, unlinkUser } from "../../core/feishu-links.js";
44
44
  import { purgeUserData } from "../../core/personal.js";
45
- import { purgeHistory, readMeta, readRecords, writeMeta } from "../../core/chat-history.js";
45
+ import { purgeHistory, readMeta, readRecords, searchHistory, writeMeta } from "../../core/chat-history.js";
46
46
  import { curateNow, pendingCount } from "../../core/memory-curator.js";
47
47
  import { listAllowlist, setAllowlist } from "../../agents/claude/permissions.js";
48
48
  import { agentAvailability, agentHealth, invalidateHealth } from "../../agents/health.js";
@@ -67,7 +67,7 @@ import {
67
67
  takeAttempt,
68
68
  } from "./auth.js";
69
69
  import { canSeeConv, pushOwnedBy, sessionVisibleTo } from "./access.js";
70
- import { clampLimit, dirsOf, inDir, inRecent, pageOf, parseCursor } from "./conv-pages.js";
70
+ import { clampLimit, dirsOf, inDir, inRecent, pageOf, parseCursor, searchConvs } from "./conv-pages.js";
71
71
  import { clientIp, cookies, HttpError, isHttps, readBody, readJsonBody, SECURITY_HEADERS, sendJson } from "./http.js";
72
72
  import { handleTasksApi } from "./tasks-api.js";
73
73
  import { handleSkillsApi } from "./skills-api.js";
@@ -759,6 +759,29 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
759
759
  sendJson(res, 200, pageOf(list, before, clampLimit(url.searchParams.get("limit"), 10)));
760
760
  return;
761
761
  }
762
+ // 搜索会话(侧栏「搜索」弹窗):标题、目录名,再搜聊天内容(聊天记录索引,见 chat-history.ts)。
763
+ // expert:只看这个专家的对话(内置的就是 claude / codex)
764
+ if (p === "/api/conversations/search" && method === "GET") {
765
+ const q = (url.searchParams.get("q") ?? "").slice(0, 200);
766
+ const expert = url.searchParams.get("expert");
767
+ const all = hub.list(visible).filter((c) => !c.hidden && (!expert || c.expert.id === expert));
768
+ const keys = new Set(all.map((c) => c.key));
769
+ let content: { key: string; text: string }[] = [];
770
+ if (q.trim()) {
771
+ try {
772
+ // 一条对话可能命中很多句,多要一些,保证别的对话也排得上
773
+ content = searchHistory(user.id, q, { limit: 300, skip: (k) => !keys.has(k) }).map((hit) => {
774
+ const lower = q.trim().toLowerCase();
775
+ const text = [hit.user, hit.assistant].find((t) => t?.toLowerCase().includes(lower)) ?? hit.user ?? hit.assistant ?? "";
776
+ return { key: hit.key, text };
777
+ });
778
+ } catch {
779
+ // 没有索引、读不了:只按标题搜
780
+ }
781
+ }
782
+ sendJson(res, 200, { results: searchConvs(all, q, content) });
783
+ return;
784
+ }
762
785
  if (p === "/api/conversations" && method === "GET") {
763
786
  sendJson(res, 200, hub.list(visible));
764
787
  return;
@@ -66,3 +66,40 @@ export const clampLimit = (v: unknown, def: number): number => {
66
66
  const n = Math.floor(Number(v));
67
67
  return Number.isFinite(n) && n > 0 ? Math.min(n, 200) : def;
68
68
  };
69
+
70
+ export type SearchResult = { conv: ConversationInfo; snippet?: string };
71
+
72
+ /**
73
+ * 搜索会话:标题(和工作目录名)里每个词都出现的排前面,整句出现的更靠前,同样的按活跃时间;
74
+ * 再接上聊天内容里搜到的(contentHits,按相关程度排好的,同一条对话只取第一句)。
75
+ * 没输入查询:给最近活跃的。
76
+ */
77
+ export function searchConvs(
78
+ list: ConversationInfo[],
79
+ query: string,
80
+ contentHits: { key: string; text: string }[] = [],
81
+ limit = 50,
82
+ ): SearchResult[] {
83
+ const q = query.trim().toLowerCase();
84
+ if (!q) return [...list].sort((a, b) => b.activeAt - a.activeAt).slice(0, limit).map((conv) => ({ conv }));
85
+ const words = q.split(/\s+/);
86
+ const byTitle = list
87
+ .map((c) => {
88
+ const title = (c.title ?? "").toLowerCase();
89
+ const hay = `${title} ${c.cwd.split(/[\\/]/).filter(Boolean).pop() ?? ""}`.toLowerCase();
90
+ if (!words.every((w) => hay.includes(w))) return null;
91
+ return { c, rank: title.includes(q) ? 2 : 1 };
92
+ })
93
+ .filter((x) => x !== null)
94
+ .sort((a, b) => b.rank - a.rank || b.c.activeAt - a.c.activeAt);
95
+ const out: SearchResult[] = byTitle.map((x) => ({ conv: x.c }));
96
+ const seen = new Set(out.map((r) => r.conv.key));
97
+ const byKey = new Map(list.map((c) => [c.key, c]));
98
+ for (const hit of contentHits) {
99
+ const conv = byKey.get(hit.key);
100
+ if (!conv || seen.has(hit.key)) continue;
101
+ seen.add(hit.key);
102
+ out.push({ conv, snippet: hit.text });
103
+ }
104
+ return out.slice(0, limit);
105
+ }
@@ -4,6 +4,8 @@ import { userMcpServers } from "../../agents/codex/session.js";
4
4
  import {
5
5
  ACCESS_LABEL,
6
6
  ACCESS_LEVELS,
7
+ avatarImage,
8
+ avatarUrl,
7
9
  createExpert,
8
10
  deleteExpert,
9
11
  EXPERT_LIMITS,
@@ -28,6 +30,7 @@ function expertView(e: Expert) {
28
30
  name: e.name,
29
31
  description: e.description,
30
32
  icon: e.icon,
33
+ avatar: avatarUrl(e),
31
34
  color: e.color,
32
35
  welcome: e.welcome,
33
36
  quickPrompts: e.quickPrompts,
@@ -55,9 +58,13 @@ export function expertBrief(e: Expert) {
55
58
  name: e.name,
56
59
  description: e.description,
57
60
  icon: e.icon,
61
+ avatar: avatarUrl(e),
58
62
  color: e.color,
59
63
  engine: e.engine,
60
64
  access: e.access,
65
+ webSearch: e.webSearch,
66
+ webFetch: e.webFetch,
67
+ memory: e.memory,
61
68
  cwd: e.cwd ?? "",
62
69
  model: e.model ?? "",
63
70
  effort: e.effort ?? "",
@@ -100,7 +107,7 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
100
107
  }
101
108
 
102
109
  if (p === "/api/experts" && method === "POST") {
103
- const body = await readJsonBody<ExpertInput>(req, 256 * 1024);
110
+ const body = await readJsonBody<ExpertInput>(req, 1024 * 1024);
104
111
  try {
105
112
  sendJson(res, 200, expertView(createExpert(user.id, body)));
106
113
  } catch (err) {
@@ -109,6 +116,17 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
109
116
  return true;
110
117
  }
111
118
 
119
+ // 头像:登录了就能看(管理员看别人的对话时也要显示)。地址带版本号,可以长期缓存
120
+ const am = /^\/api\/experts\/(e_[a-f0-9]+)\/avatar$/.exec(p);
121
+ if (am && method === "GET") {
122
+ const expert = getExpert(am[1]!);
123
+ const img = expert && avatarImage(expert);
124
+ if (!img) throw new HttpError(404, "没有头像");
125
+ res.writeHead(200, { "Content-Type": img.type, "Content-Length": img.data.length, "Cache-Control": "private, max-age=31536000, immutable" });
126
+ res.end(img.data);
127
+ return true;
128
+ }
129
+
112
130
  const em = /^\/api\/experts\/(e_[a-f0-9]+)$/.exec(p);
113
131
  if (em) {
114
132
  const expert = getExpert(em[1]!);
@@ -118,7 +136,7 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
118
136
  return true;
119
137
  }
120
138
  if (method === "PATCH") {
121
- const body = await readJsonBody<ExpertInput>(req, 256 * 1024);
139
+ const body = await readJsonBody<ExpertInput>(req, 1024 * 1024);
122
140
  try {
123
141
  sendJson(res, 200, expertView(updateExpert(user.id, expert.id, body)));
124
142
  } catch (err) {
@@ -35,8 +35,10 @@ export type Expert = {
35
35
  owner: string;
36
36
  name: string;
37
37
  description: string;
38
- /** emoji */
38
+ /** emoji(以前的图标;有头像时用头像) */
39
39
  icon: string;
40
+ /** 头像:用户上传的图片,前端缩成小图后的 data URL(data:image/...;base64,...)。空 = 没有 */
41
+ avatar?: string;
40
42
  color: string;
41
43
  welcome: string;
42
44
  quickPrompts: QuickPrompt[];
@@ -80,8 +82,19 @@ export const EXPERT_LIMITS = {
80
82
  quickPrompts: 8,
81
83
  quickTitle: 40,
82
84
  quickPrompt: 2000,
85
+ /** 头像 data URL 的长度(前端缩到 128px,正常几 KB 到几十 KB) */
86
+ avatar: 300_000,
83
87
  };
84
88
 
89
+ /** 头像的地址(给前端用;带版本号,换了头像就是新地址) */
90
+ export const avatarUrl = (e: Pick<Expert, "id" | "rev" | "avatar">): string => (e.avatar ? `/api/experts/${e.id}/avatar?v=${e.rev}` : "");
91
+
92
+ /** 头像 data URL 拆成类型和内容 */
93
+ export function avatarImage(e: Pick<Expert, "avatar">): { type: string; data: Buffer } | undefined {
94
+ const m = e.avatar ? /^data:(image\/(?:png|jpeg|webp|gif));base64,([A-Za-z0-9+/=]+)$/.exec(e.avatar) : null;
95
+ return m ? { type: m[1]!, data: Buffer.from(m[2]!, "base64") } : undefined;
96
+ }
97
+
85
98
  const storePath = path.join(dataDir, "experts.json");
86
99
 
87
100
  /** 专家改了 / 删了。owner:谁的。用着它的会话空闲下来要换上新的 */
@@ -191,12 +204,21 @@ function validate(owner: string, input: ExpertInput, prev?: Expert, selfId?: str
191
204
  subagents.push(id);
192
205
  }
193
206
 
207
+ // 头像:没传就沿用;传空字符串就是去掉
208
+ const avatarRaw = pick("avatar");
209
+ const avatar = typeof avatarRaw === "string" ? avatarRaw.trim() : "";
210
+ if (avatar) {
211
+ if (avatar.length > EXPERT_LIMITS.avatar) throw new Error("头像图片太大");
212
+ if (!avatarImage({ avatar })) throw new Error("头像只能是 PNG、JPEG、WebP 或 GIF 图片");
213
+ }
214
+
194
215
  const model = text(pick("model"), 100, "模型");
195
216
  const effort = text(pick("effort"), 20, "思考程度");
196
217
  return {
197
218
  name,
198
219
  description: text(pick("description"), EXPERT_LIMITS.description, "说明"),
199
220
  icon: text(pick("icon"), 16, "图标"),
221
+ ...(avatar ? { avatar } : {}),
200
222
  color,
201
223
  welcome: text(pick("welcome"), EXPERT_LIMITS.welcome, "欢迎语"),
202
224
  quickPrompts,
package/src/core/hub.ts CHANGED
@@ -49,7 +49,7 @@ import { buildCatalog, expandCustomCommand, type AgentCommand, type CommandEntry
49
49
  import { helpText, type ParsedCommand } from "./commands.js";
50
50
  import { listScheduled } from "./scheduled.js";
51
51
  import { expertSystemPrompt, searchLabel, stripContext } from "./expert-prompt.js";
52
- import { expertEvents, expertRuntime, getExpert, isBuiltin, listExperts, type ExpertRuntime } from "./experts.js";
52
+ import { avatarUrl, expertEvents, expertRuntime, getExpert, isBuiltin, listExperts, type ExpertRuntime } from "./experts.js";
53
53
  import { mcpEvents } from "./mcp.js";
54
54
  import { isMachineCommand, sessionSkills } from "./skill-runtime.js";
55
55
  import { skillEvents } from "./skills.js";
@@ -181,6 +181,8 @@ export type ExpertBadge = {
181
181
  id: string;
182
182
  name: string;
183
183
  icon?: string;
184
+ /** 头像地址(/api/experts/<id>/avatar?v=...) */
185
+ avatar?: string;
184
186
  color?: string;
185
187
  builtin?: true;
186
188
  /** 自定义专家的权限(只能联网的不显示工作目录) */
@@ -400,6 +402,7 @@ class Hub extends EventEmitter<{ event: [EventEnvelope]; task: [TaskTurnEnd] }>
400
402
  name: e.name,
401
403
  access: e.access,
402
404
  ...(e.icon ? { icon: e.icon } : {}),
405
+ ...(e.avatar ? { avatar: avatarUrl(e) } : {}),
403
406
  ...(e.color ? { color: e.color } : {}),
404
407
  ...(e.welcome ? { welcome: e.welcome } : {}),
405
408
  ...(e.quickPrompts.length ? { quickPrompts: e.quickPrompts } : {}),
@@ -2,7 +2,8 @@
2
2
  //
3
3
  // 三件事:
4
4
  // 1. 录入(startHistoryCapture):hub 的事件流里,有主人的对话的每句话(用户说的、agent 的最终回复)
5
- // 记进主人的聊天记录索引(chat-history.ts)。主人关了记忆就不记。
5
+ // 记进主人的聊天记录索引(chat-history.ts)。不管开没开记忆都记:侧栏的「搜索」要搜聊天内容。
6
+ // 没开记忆(或者关了整理)时记进来的话随即标成整理过了,之后再打开记忆也不会一下子整理一大堆旧的。
6
7
  // 2. 回填(backfill):第一次用时,把已有对话从 agent 的记录里读一遍进索引,每人只做一次。
7
8
  // 回填进来的只供搜索,不拿去整理 —— 一次整理几百段旧对话太费额度。
8
9
  // 3. 整理:把上次整理之后新说的话交给模型(用户在记忆设置里选 agent 和模型,默认最省的),
@@ -51,11 +52,6 @@ const MAX_CHANGES = 5;
51
52
 
52
53
  let capturing = false;
53
54
 
54
- /** 记不记这个用户的聊天:开着记忆,并且整理和「参考以前的聊天」至少开了一个 */
55
- function wants(memory: UserMemory): boolean {
56
- return memory.enabled && (memory.curate.when !== "off" || memory.chatHistory);
57
- }
58
-
59
55
  export function startHistoryCapture(): void {
60
56
  if (capturing) return;
61
57
  capturing = true;
@@ -66,7 +62,7 @@ export function startHistoryCapture(): void {
66
62
  const conv = hub.conversation(env.key);
67
63
  if (!conv || conv.hidden) return;
68
64
  const owner = memoryOwnerOf(conv);
69
- if (!owner || !wants(readMemory(owner))) return;
65
+ if (!owner) return;
70
66
  const text =
71
67
  ev.type === "user"
72
68
  ? [ev.text, ev.attachments.length ? `(附件:${ev.attachments.join("、")})` : ""].filter(Boolean).join("\n")
@@ -396,11 +392,11 @@ export function sweepOnce(opts: { now?: number } = {}): Promise<void> {
396
392
  const now = opts.now ?? Date.now();
397
393
  for (const user of activeUsers()) {
398
394
  try {
395
+ // 回填不看记忆开关:侧栏搜索也要搜以前的聊天
396
+ if (!readMeta(user.id).backfilled) await backfill(user.id);
399
397
  const memory = readMemory(user.id);
400
- if (!memory.enabled) continue;
401
- if (memory.chatHistory && !readMeta(user.id).backfilled) await backfill(user.id);
402
398
  const c = memory.curate;
403
- if (c.when === "off") {
399
+ if (!memory.enabled || c.when === "off") {
404
400
  // 不整理:聊过的不攒着,之后再打开也不会一下子整理一大堆旧的
405
401
  for (const p of pendingConversations(user.id, 0, now)) markExtracted(user.id, p.key, p.last);
406
402
  } else if (c.when === "idle") {
@@ -101,3 +101,125 @@
101
101
  .field-group {
102
102
  display: contents;
103
103
  }
104
+
105
+ /* ---- 专家头像 ---- */
106
+
107
+ /* 头像在哪儿都是圆的,默认和引擎图标一样大(18px),各处再按需要调 */
108
+ .expert-avatar {
109
+ display: inline-grid;
110
+ place-items: center;
111
+ flex-shrink: 0;
112
+ }
113
+
114
+ .expert-avatar img {
115
+ display: block;
116
+ width: 18px;
117
+ height: 18px;
118
+ border-radius: 50%;
119
+ object-fit: cover;
120
+ }
121
+
122
+ .hero-logo.expert-avatar img {
123
+ width: 64px;
124
+ height: 64px;
125
+ }
126
+
127
+ .ctx-item .expert-avatar img,
128
+ .top-title .expert-avatar img,
129
+ .hit-icon .expert-avatar img {
130
+ width: 16px;
131
+ height: 16px;
132
+ }
133
+
134
+ .search-chip .expert-avatar img,
135
+ .dialog-sub .expert-avatar img {
136
+ width: 14px;
137
+ height: 14px;
138
+ }
139
+
140
+ .conv-item .expert-mark img {
141
+ display: block;
142
+ width: 14px;
143
+ height: 14px;
144
+ border-radius: 50%;
145
+ object-fit: cover;
146
+ }
147
+
148
+ @media (max-width: 768px) {
149
+ .hero-logo.expert-avatar img {
150
+ width: 52px;
151
+ height: 52px;
152
+ }
153
+ }
154
+
155
+ /* 设置页卡片标题前的图标 */
156
+ .expert-card-icon {
157
+ display: inline-grid;
158
+ vertical-align: -3px;
159
+ margin-right: 8px;
160
+ }
161
+
162
+ .expert-card-icon svg,
163
+ .expert-card-icon img {
164
+ width: 18px;
165
+ height: 18px;
166
+ }
167
+
168
+ .expert-card-icon.expert-emoji {
169
+ font-size: 15px;
170
+ width: auto;
171
+ }
172
+
173
+ /* 编辑器里的头像:圆形预览,点一下上传 */
174
+ .expert-form .avatar-row > .field:first-child {
175
+ flex: 0 0 auto;
176
+ }
177
+
178
+ .avatar-field {
179
+ display: flex;
180
+ align-items: center;
181
+ gap: 10px;
182
+ }
183
+
184
+ .avatar-preview {
185
+ width: 56px;
186
+ height: 56px;
187
+ border-radius: 50%;
188
+ border: 1px dashed var(--border);
189
+ background: var(--bg-soft);
190
+ display: grid;
191
+ place-items: center;
192
+ overflow: hidden;
193
+ flex-shrink: 0;
194
+ color: var(--fg-soft);
195
+ }
196
+
197
+ .avatar-preview:hover {
198
+ border-color: var(--fg-faint);
199
+ }
200
+
201
+ .avatar-preview img {
202
+ width: 100%;
203
+ height: 100%;
204
+ object-fit: cover;
205
+ }
206
+
207
+ .avatar-preview svg {
208
+ width: 28px;
209
+ height: 28px;
210
+ }
211
+
212
+ .avatar-emoji {
213
+ font-size: 28px;
214
+ line-height: 1;
215
+ }
216
+
217
+ .avatar-btns {
218
+ display: flex;
219
+ flex-direction: column;
220
+ gap: 6px;
221
+ }
222
+
223
+ .avatar-btns .btn[hidden] {
224
+ display: none;
225
+ }