agent-loft 0.2.84 → 0.2.86

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,29 +55,30 @@ 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
  - 用户消息的复制按钮后有「回退到此处」图标:把这条消息及附件放回输入框,并删除它及之后的聊天内容,重新发送时从之前的上下文继续。
65
65
  - 太长的消息先收起,点「展开显示」看全文;对话里有至少 3 条用户消息时,右侧显示快速定位尺,电脑上鼠标移入查看消息开头、点击跳转;手机上手动滚动时显示短轨道,按住拖动可预览问题和位置,松手跳转,停止操作约 1.6 秒后隐藏。
66
66
  - 回复底部的 token 数自动按大小显示为 K、M 等单位。
67
+ - 项目右键(触屏长按)可「删除项目…」:二次确认后删除文件夹及全部文件、子目录和关联会话,同时清理附件、资料库文件和定时发送;目录选择器里也可删除空文件夹。工作区根目录、包含其他用户会话的目录不能删除,Agent 自己保存的原始会话记录仍保留。
67
68
  - 侧栏按页加载:每个项目目录和飞书机器人分组先显示 5 条,点「展开显示」每次再拉 10 条。
68
69
  - 项目、飞书和微信分组可混合拖拽排序,渠道分组可以放在项目前面或项目之间;右键(触屏长按)可置顶、上移、下移或按最近活跃重排。顺序按账号保存,刷新、换设备后保留,新消息不会改变已排好的位置。
69
70
  - 侧栏底部显示 Claude / Codex 的订阅额度(5 小时 / 7 天窗口,以及多久后重置);关了额度查询就整块不显示。
70
- - 右上角「更多」最下面显示当前会话累计消耗的 token 分布(输入 / 缓存写入 / 缓存读取 / 输出,Claude 还有按 API 价格估算的费用)。设置也在「更多」里。
71
+ - 专家信息弹窗底部显示当前会话累计消耗的 Token 分布(输入 / 缓存写入 / 缓存读取 / 输出,Claude 还有按 API 价格估算的费用)。设置入口在侧栏的「更多」里。
71
72
  - 设置 → 用量:按日 / 月 / 年(默认按月)统计 token 和金额,有每天(每月)的柱状图,按 agent、模型、用户(管理员才有)分开看;成员只看到自己的。管理员还可查看服务端本机直接使用的 Claude Code、Codex 桌面端和 CLI 用量,和 Agent Loft 的用量分开显示、避免重复计算。金额都是按 API 价格算的参考值:Agent Loft 的 Claude 用它自己报的费用,Codex 和直接用的 Claude Code 按模型单价 × token 估算(OpenAI 单价来自 LiteLLM 公开价格表,内置快照、联网时每天更新)。Agent Loft 的账从 0.2.34 开始记录;本机直接使用的用量可回溯已有会话记录。
72
73
  - 「添加到主屏幕」后当 App 用;切到后台再回来会自动重连,补上错过的内容。
73
74
  - 前端资源按指纹长缓存:再次打开不用逐个向服务端确认,升级或改了文件后刷新页面自动换新。
74
75
  - 手机顶栏采用实色圆形按钮和「专家+更多」胶囊按钮组;从左边缘右滑展开侧栏,在侧栏或遮罩上左滑收起,短滑会回弹。消息底部操作栏与下一条消息之间留 4px。
75
- - **网页多服务器切换**:在 设置 → 服务器 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角就能切换;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
76
- - **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
76
+ - **网页多服务器切换**:在 设置 → 服务器 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角通过名称和紧随其后的箭头切换,不显示服务器图标,嵌入桌面端时隐藏此入口;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
77
+ - **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 系统 → 系统通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
77
78
  - **跨渠道同步**:飞书里的会话在 Web 上也能打开接着聊。同一个授权请求同时出现在飞书卡片和网页上,哪边先点算哪边,另一边自动变成「已处理」。
78
79
  - **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 / 完全允许,定时任务也可以单独设,完全允许只给管理员。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问(Bash 仍询问)。超时一律按拒绝处理。
79
- - **设置都在网页上**,按用途分组:**我的**(账号和密码、飞书绑定、登录设备、通知、记忆、技能、用量,每个人都有);**Agent**(运行环境、各 agent 的默认模型和思考程度、可选模型、Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户、所有人的登录设备;服务端版本和升级、重启、局域网访问和端口)。设置、新建 / 编辑专家、重命名等编辑弹窗不会因点击外部或按 Esc 关闭;通过关闭、取消或保存 / 完成按钮退出。改了没保存就切页或关掉设置会先提醒。
80
- - **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知,设置只有管理员能改,见下面「安全」。
80
+ - **设置都在网页上**,按用途分组:**我的**(账号、飞书和微信绑定、自己的登录设备、记忆、专家、技能、MCP、用量);**Agent**(运行环境置顶,各 agent 卡片分别配置默认模型、思考程度、可选模型、个人默认技能和 MCP,Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户标题旁添加用户,用户的「管理 → 登录设备」查看和下线各自设备;系统页管理服务端版本和升级、重启、局域网访问和端口,网络访问下方是系统通知;成员也可在系统页设置自己的通知)。账号页通过「修改名称」「修改密码」按需展开表单;飞书和微信绑定操作位于卡片右上角。设置、新建 / 编辑专家、重命名等编辑弹窗不会因点击外部或按 Esc 关闭;通过关闭、取消或保存 / 完成按钮退出。改了没保存就切页或关掉设置会先提醒。
81
+ - **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知;个人设置各自管理,服务器设置由管理员修改,见下面「安全」。
81
82
  - **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → Agent」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择,其他人未配置时不加载技能或 MCP。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
82
83
  - 头像(点头像区域的加号上传;未上传时,会话中用引擎的图标)、引擎(Claude / Codex,建好后不能换)、默认模型和思考程度(从模型列表里选);
83
84
  - 提示词:人设、规则、输出格式。agent-loft 在后面自动补上这个专家能做什么、今天的日期、记忆。Claude 专家默认只用这段提示词(一句话约 2 千 token),也可以选「追加在 Claude Code 原装提示词后面」(干活更稳,每轮多约 1.6 万);Codex 的基础指令改不了,专家的提示词附在第一条消息后面,约束力弱一些;
@@ -88,14 +89,14 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
88
89
  - 子智能体(只有 Claude):别的 Claude 专家,主专家用 Agent 工具把子任务派给它。子智能体的权限不能超过主专家(运行时也封顶在主专家的权限)。
89
90
 
90
91
  只勾联网搜索、读网页的 Claude 专家就是以前聊天模式的效果。专家改了,用它的对话下一条消息起生效;专家删了,用它的对话还能看、不能再发消息,用它的定时任务暂停。以前的聊天模式取消了:升级后聊天模式的旧对话不再保留,聊天模式的定时任务暂停,选个专家再启用。
91
- - **MCP**:设置 → MCP,每人管自己的:本机进程(命令 + 参数 + 环境变量)或 HTTP 地址(+ 请求头),值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。自定义专家加载各自勾选的服务;内置专家在「设置 → Agent → 内置 Agent 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
92
+ - **MCP**:设置 → MCP,每人管自己的:本机进程(命令 + 参数 + 环境变量)或 HTTP 地址(+ 请求头),值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。自定义专家加载各自勾选的服务;内置专家在「设置 → Agent → 对应 Agent 卡片 → 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
92
93
  - **记忆**:像 ChatGPT 的记忆,设置 → 记忆(默认关)。「关于我」加上一条条记住的事,每次对话都带上;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),记错了用 `forget` 删。**自动整理**:把上次整理之后新说的话交给模型(不留会话记录的一次性调用),补充、更新或删掉过时的记忆,用户自己加的条目它不动。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,只有你自己的、没被删掉的对话)。聊天记录索引不开记忆也会记(侧栏的「搜索」也用它),升级后会把已有对话收录进来一次;没开记忆时记进来的不拿去整理。两项都能在设置里单独关。每个用户一份,Claude 和 Codex、Web 和飞书共用。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
93
94
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选专家和目录),或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。
94
95
  - **技能(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 关掉它自己的技能清单),管理员在「设置 → 技能 → 本机技能」里能看到。
95
96
  - **资料库**:像 ChatGPT 的资料库,侧栏的「资料库」。对话里发过的附件、agent 回复里给出的、这一轮新写出来的图片 / 文档 / 音视频(复制一份收进来,之后原文件改了删了不影响)都汇总在这里:按图片 / 文档 / 音视频筛、按文件名搜,点开看大图或下载,「在新对话里用」,单个或批量删除(文件从磁盘上删掉)。从资料库拿到对话里的文件硬链接进那条对话的上传目录,不占双份空间,agent 照常能读。按人隔离,规则同对话:自己的;没主人的对话(飞书群聊等)的归管理员。上传了一直没发出去的一天后清掉;删除会话时立即清理该会话的上传文件和资料库记录,删除原件也会清理复用到其他会话的副本。agent 侧的会话记录仍保留,恢复会话不会恢复已删除的文件。
96
97
  - **远程控制**:侧栏「定时任务」下面的「远程控制」,直接操作这台机器的**桌面**和**终端**,上面一键切换;切回对话时连接留在后台(侧栏入口上亮个小绿点),再进来接着用。这台机器没有图形桌面(服务器、NAS)时只有终端。
97
98
  - 桌面:走 VNC 协议,网页里用 noVNC 显示,鼠标、键盘、剪贴板都能用,进来时不自动连、点「连接桌面」才连,工具栏上选画质:流畅 / 标准(默认)/ 高清由服务端把画面缩小到长边 1280 / 1920 / 2560、只把变了的地方压成 JPEG 发过来(macOS 屏幕共享只给无损的 ZRLE,5K 屏一整屏 30MB,原样转发隔着公网几秒一帧),原画是原样转发、只适合局域网;远程那边接了几块屏时可以只看其中一块(按系统里的显示器名称选,服务端只截那块再缩,比几块屏拼在一起缩小清楚得多;macOS 的各块屏位置要从屏幕共享发来的画面里学,第一次连上要几秒,原画下不能选);可以缩放到窗口或按原始大小看、全屏(手机上也能,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 的用户名和登录密码(苹果认证,由服务端登录)。
98
- - 终端:新终端开在当前对话的工作目录里,可以开多个标签;`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 上软键盘弹出来时这排键会垫到键盘上面。
99
+ - 终端:进入或刷新页面时不自动连接,点击「连接终端」后接上后台终端,没有现成的才新建;也可直接点击「新建终端」。新终端开在当前对话的工作目录里,可以开多个标签;`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 上软键盘弹出来时这排键会垫到键盘上面。
99
100
  - 管理员能用;成员要管理员在 设置 → 用户 里单独「开通远程控制」。终端、桌面在 设置 → 远程控制 里各有总开关。
100
101
  - **微信 ClawBot**:设置 → 账号 → 微信 →「扫码连接微信」,用手机微信扫码并确认(要求微信 8.0.70 以上,「设置 → 插件」里有 ClawBot;这个功能腾讯还在逐步放量)。每个人连自己的微信,会话归扫码的人,用他的记忆和工具,只认扫码的这个微信号;发送 `/new` 创建独立会话并保留旧记录,Web 微信分组里可以查看和续聊历史;服务端主动连向腾讯,不需要公网地址。微信里发文字或语音(要微信能转成文字),不发过程,只显示「正在输入」,结束后发结果;授权和提问是一条文字,回复数字处理(`1` 允许一次、`0` 拒绝,含义固定),网页上也能处理。`/new`、`/stop`、`/model`、`/expert` 等命令都能用。连接后可在同一设置页的「微信使用的专家」中选择专家并点击「切换专家」,也能在首次发微信消息前选好;已有聊天内容时,切换会创建独立会话并保留旧记录,和微信里的 `/expert` 共用同一份选择。
101
102
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.84",
3
+ "version": "0.2.86",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -104,6 +104,15 @@ const startedAt = Date.now();
104
104
  /** 上传后先存着,发消息时用 id 认领。一小时没人认领就作废 */
105
105
  const uploads = new Map<string, { key: string; attachment: SavedAttachment; at: number }>();
106
106
 
107
+ /** 单条删除和项目批量删除共用清理规则,保留 agent 自己的文字记录。 */
108
+ function hideConversation(key: string): void {
109
+ updateConversation(key, { hidden: true });
110
+ deleteConversationFiles(key);
111
+ for (const [id, entry] of uploads) if (entry.key === key) uploads.delete(id);
112
+ clearScheduled(key);
113
+ hub.emitEvent(key, { type: "meta" });
114
+ }
115
+
107
116
  /**
108
117
  * 认领上传的附件。有任何一个已失效(id 不认识、不属于这条会话、文件已被删 —— 比如
109
118
  * 另一个浏览器在这期间开了新会话、清掉了上传目录)就整条拒绝,让前端提示重新上传,
@@ -817,7 +826,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
817
826
  if (p.startsWith("/api/terminals") && (await handleTerminalApi(req, res, p, user))) return;
818
827
  if ((p === "/api/remote" || p.startsWith("/api/desktop/")) && (await handleDesktopApi(req, res, p, user))) return;
819
828
 
820
- // ----- 目录选择器:列出或新建工作区内的子目录 -----
829
+ // ----- 工作区目录 -----
821
830
  if (p === "/api/dirs" && method === "GET") {
822
831
  const listing = listWorkspaceDirs(url.searchParams.get("path") ?? "");
823
832
  if (!listing) throw new HttpError(404, `目录不存在,或不在 ${config().workspaceRoot} 之内`);
@@ -845,9 +854,51 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
845
854
  sendJson(res, 201, { path: target });
846
855
  return;
847
856
  }
857
+ if (p === "/api/dirs" && method === "DELETE") {
858
+ const body = await readJsonBody<{ path?: unknown }>(req);
859
+ if (typeof body.path !== "string" || !body.path.trim()) throw new HttpError(400, "请指定要删除的项目目录");
860
+ const target = resolveWorkspacePath(body.path);
861
+ if (!target) throw new HttpError(404, "目录不存在,或不在工作区之内");
862
+ if (target === path.resolve(config().workspaceRoot)) throw new HttpError(403, "不能删除工作区根目录");
863
+ // 不把「删除链接」变成删除它指向的整个项目;工作区根目录本身可以是链接。
864
+ if (target !== path.resolve(config().workspaceRoot, body.path)) throw new HttpError(400, "请从实际项目目录删除,不能通过符号链接删除项目");
865
+ const within = (dir: string) => dir === target || dir.startsWith(target + path.sep);
866
+ const affected = () => listConversations().filter((c) => within(resolveWorkspacePath(c.cwd) ?? c.cwd));
867
+ const convs = affected();
868
+ if (convs.some((c) => !visible(c))) throw new HttpError(403, "此目录下有其他用户的会话,不能删除项目");
869
+ const realTarget = fs.realpathSync(target);
870
+ const identity = fs.statSync(target);
871
+ const keys = convs.map((c) => c.key);
872
+ const keySet = new Set(keys);
873
+ const activity = new Map(convs.map((c) => [c.key, c.activeAt]));
874
+ await Promise.all(convs.map((c) => hub.drop(c.key, "项目已删除")));
875
+ // 等待运行中的会话退出后,再核对目录和会话,避免删除等待期间新建的会话。
876
+ const current = affected();
877
+ const changed = current.length !== convs.length || current.some((c) =>
878
+ !keySet.has(c.key) || !visible(c) || c.activeAt !== activity.get(c.key) || hub.liveSessionId(c.key) !== undefined,
879
+ );
880
+ if (resolveWorkspacePath(body.path) !== target || fs.realpathSync(target) !== realTarget || changed) {
881
+ throw new HttpError(409, "项目内容已变化,请重新确认后删除");
882
+ }
883
+ const now = fs.statSync(target);
884
+ if (identity.dev !== now.dev || identity.ino !== now.ino) {
885
+ throw new HttpError(409, "项目内容已变化,请重新确认后删除");
886
+ }
887
+ try {
888
+ fs.rmSync(target, { recursive: true });
889
+ } catch (err) {
890
+ const code = (err as NodeJS.ErrnoException).code;
891
+ throw new HttpError(code === "EACCES" || code === "EPERM" ? 403 : 400, "无法删除项目文件夹,请检查目录权限后重试");
892
+ }
893
+ for (const c of convs) hideConversation(c.key);
894
+ const dirOrder = setDirOrder(user.id, (getDirOrder(user.id) ?? []).filter((dir) => !within(dir)));
895
+ hub.emit("project-deleted", { owner: user.id, path: target, keys });
896
+ sendJson(res, 200, { path: target, keys, dirOrder });
897
+ return;
898
+ }
848
899
 
849
900
  // ----- 会话 -----
850
- // 侧栏按页拉:recent / dir / bot / weixin 按树分页;bot 不传 limit 时保留历史弹窗的平铺列表。
901
+ // 侧栏按页拉:recent / dir / bot / weixin 按树分页。
851
902
  if (p === "/api/conversations/page" && method === "GET") {
852
903
  const all = hub.list(visible).filter((c) => !c.hidden);
853
904
  const scope = url.searchParams.get("scope");
@@ -862,9 +913,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
862
913
  const bot = url.searchParams.get("bot") ?? "";
863
914
  const list = all.filter((c) => c.channel === "feishu" && c.channelId === bot);
864
915
  const before = parseCursor(url.searchParams.get("at"), url.searchParams.get("key"));
865
- const page = url.searchParams.has("limit")
866
- ? pageOf(list, before, clampLimit(url.searchParams.get("limit"), 5))
867
- : { conversations: list.slice(0, 200), next: null };
916
+ const page = pageOf(list, before, clampLimit(url.searchParams.get("limit"), 5));
868
917
  page.conversations = await hub.backfillFeishuTitles(page.conversations);
869
918
  sendJson(res, 200, page);
870
919
  return;
@@ -977,11 +1026,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
977
1026
  if (!sub && method === "DELETE") {
978
1027
  // agent 侧的文字记录保留;托管附件和资料库文件立即清理,恢复会话也不会恢复文件。
979
1028
  await hub.drop(key, "会话已删除");
980
- updateConversation(key, { hidden: true });
981
- deleteConversationFiles(key);
982
- for (const [id, entry] of uploads) if (entry.key === key) uploads.delete(id);
983
- clearScheduled(key);
984
- hub.emitEvent(key, { type: "meta" });
1029
+ hideConversation(key);
985
1030
  sendJson(res, 200, { ok: true });
986
1031
  return;
987
1032
  }
@@ -312,6 +312,10 @@ function broadcastTasks(owner: string): void {
312
312
  for (const client of clients) if (client.user.id === owner) send(client, { t: "tasks" });
313
313
  }
314
314
 
315
+ function broadcastProjectDeleted(project: { owner: string; path: string; keys: string[] }): void {
316
+ for (const client of clients) if (client.user.id === project.owner) send(client, { t: "project-deleted", path: project.path, keys: project.keys });
317
+ }
318
+
315
319
  /** 某人的终端开了 / 结束了:他开着的页面重新拉终端列表(别的设备上开的也能接上) */
316
320
  function broadcastTerminals(owner: string): void {
317
321
  for (const client of clients) if (client.user.id === owner) send(client, { t: "remote" });
@@ -659,6 +663,7 @@ export async function startWeb(): Promise<void> {
659
663
  heartbeat.unref();
660
664
 
661
665
  hub.on("event", broadcastEvent);
666
+ hub.on("project-deleted", broadcastProjectDeleted);
662
667
  hub.on("event", pushEvent);
663
668
  interactions.on("created", broadcastInteraction);
664
669
  interactions.on("created", pushInteraction);
@@ -710,6 +715,7 @@ function onRevoked(): void {
710
715
  export async function stopWeb(): Promise<void> {
711
716
  authEvents.off("revoked", onRevoked);
712
717
  hub.off("event", broadcastEvent);
718
+ hub.off("project-deleted", broadcastProjectDeleted);
713
719
  hub.off("event", pushEvent);
714
720
  interactions.off("created", broadcastInteraction);
715
721
  interactions.off("created", pushInteraction);
package/src/core/hub.ts CHANGED
@@ -226,7 +226,7 @@ function withTimeout<T>(p: Promise<T>, what: string, ms = QUERY_TIMEOUT_MS): Pro
226
226
 
227
227
  type Live = { id: number; agent: string; cwd: string; session: AgentSession };
228
228
 
229
- class Hub extends EventEmitter<{ event: [EventEnvelope]; task: [TaskTurnEnd] }> {
229
+ class Hub extends EventEmitter<{ event: [EventEnvelope]; task: [TaskTurnEnd]; "project-deleted": [{ owner: string; path: string; keys: string[] }] }> {
230
230
  private drivers = new Map<string, AgentDriver>();
231
231
  private live = new Map<string, Live>();
232
232
  /**
@@ -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/lib/shell.js CHANGED
@@ -56,6 +56,7 @@ const emit = (name, detail) => document.dispatchEvent(new CustomEvent(name, { de
56
56
  const mounted = new Map();
57
57
 
58
58
  export function mountSwitcher(name, el) {
59
+ el.classList.add("server-switcher");
59
60
  mounted.set(name, el);
60
61
  renderSwitcher(el);
61
62
  return el;
@@ -70,31 +71,23 @@ function rerender() {
70
71
 
71
72
  const currentId = () => (SH.role === "guest" ? SH.self : SH.current);
72
73
 
73
- function srvIcon(s, cls = "srv-icon") {
74
- if (s.icon) return h("span", { class: cls }, s.icon);
75
- // 没设图标:名字的第一个字
76
- return h("span", { class: `${cls} letter` }, [...(s.name || "?")][0].toUpperCase());
77
- }
78
-
79
74
  function renderSwitcher(el) {
80
75
  const cur = SH.servers.find((s) => s.id === currentId());
81
- el.hidden = !SH.role || SH.servers.length < 2 || !cur;
76
+ el.hidden = !!desktop || !SH.role || SH.servers.length < 2 || !cur;
82
77
  if (el.hidden) return fill(el);
83
- // 别的服务器上有等你处理的:按钮上也标出来,不用点开才知道
78
+ // 别的服务器上有等你处理的:在按钮旁标出来,不用点开才知道
84
79
  const ask = SH.servers.filter((s) => s !== cur).reduce((n, s) => n + (s.pending || 0), 0);
85
80
  const btn = h(
86
81
  "button",
87
82
  { class: "server-switch", title: "切换服务器", "aria-haspopup": "menu" },
88
- srvIcon(cur),
89
83
  h("span", { class: "srv-name" }, cur.name),
90
- ask ? h("span", { class: "srv-badge", title: `别的服务器上有 ${ask} 项等你处理` }, ask) : null,
91
84
  h("span", { class: "srv-chev" }, icon("down")),
92
85
  );
93
86
  btn.onclick = () => {
94
87
  if (ui.menu?.anchor === btn) return closeMenu();
95
88
  openSwitchMenu(btn);
96
89
  };
97
- fill(el, btn);
90
+ fill(el, btn, ask ? h("span", { class: "srv-badge", title: `别的服务器上有 ${ask} 项等你处理` }, ask) : null);
98
91
  }
99
92
 
100
93
  function openSwitchMenu(btn) {
@@ -102,7 +95,6 @@ function openSwitchMenu(btn) {
102
95
  const items = SH.servers.map((s) => ({
103
96
  class: `srv-item${s.id === cur ? " on" : ""}`,
104
97
  label: [
105
- srvIcon(s),
106
98
  h("span", { class: "srv-item-name" }, s.name),
107
99
  s.pending
108
100
  ? h("span", { class: "srv-badge", title: `${s.pending} 项等你处理` }, s.pending)
package/web/lib/ws.js CHANGED
@@ -2,7 +2,7 @@ import { h } from "./dom.js";
2
2
  import { api } from "./api.js";
3
3
  import { desktop, framed, S, ui } from "../state.js";
4
4
  import { showAuth } from "../views/auth.js";
5
- import { applyBootstrap, bootstrapQuery, renderSidebar, scheduleSidebar } from "../views/sidebar.js";
5
+ import { applyBootstrap, bootstrapQuery, forgetProject, renderSidebar, scheduleSidebar } from "../views/sidebar.js";
6
6
  import { scheduleQuota } from "../views/quota.js";
7
7
  import { renderTopbar } from "../views/topbar.js";
8
8
  import { applyEvent, openConversation, renderIdleNotice } from "../views/messages.js";
@@ -261,6 +261,9 @@ function onWsMessage(msg) {
261
261
  for (const ix of msg.pending) upsertInteraction(ix);
262
262
  setBusy(msg.busy);
263
263
  return;
264
+ case "project-deleted":
265
+ forgetProject(msg.path, msg.keys);
266
+ return;
264
267
  case "conv":
265
268
  if (S.convs.get(msg.info.key)?.busy && !msg.info.busy) scheduleQuota();
266
269
  S.convs.set(msg.info.key, msg.info);