agent-loft 0.2.134 → 0.2.135

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.
Files changed (49) hide show
  1. package/README.md +30 -30
  2. package/package.json +1 -1
  3. package/src/agents/dsh/errors.ts +2 -2
  4. package/src/agents/pi/constants.ts +1 -1
  5. package/src/agents/pi/errors.ts +2 -2
  6. package/src/agents/workbuddy/errors.ts +2 -2
  7. package/src/agents/workbuddy/sdk.ts +1 -1
  8. package/src/channels/feishu/bot.ts +3 -3
  9. package/src/channels/feishu/cards.ts +2 -2
  10. package/src/channels/web/api.ts +3 -1
  11. package/src/channels/web/desktop.ts +1 -1
  12. package/src/channels/web/terminal.ts +1 -1
  13. package/src/channels/web/workspace-api.ts +2 -2
  14. package/src/channels/weixin/bot.ts +1 -1
  15. package/src/core/command-catalog.ts +1 -1
  16. package/src/core/commands.ts +1 -1
  17. package/src/core/feishu-links.ts +1 -1
  18. package/src/core/hub.ts +3 -3
  19. package/src/core/memory-curator.ts +1 -1
  20. package/src/core/ui-prefs.ts +11 -5
  21. package/src/mcp/memory-server.ts +1 -1
  22. package/web/css/mobile.css +15 -4
  23. package/web/css/settings.css +14 -6
  24. package/web/lib/overlay.js +15 -2
  25. package/web/lib/push.js +1 -1
  26. package/web/lib/shell.js +1 -1
  27. package/web/settings/agent-defaults.js +1 -0
  28. package/web/settings/agents.js +8 -9
  29. package/web/settings/commands.js +29 -25
  30. package/web/settings/experts.js +9 -8
  31. package/web/settings/feishu.js +3 -3
  32. package/web/settings/general.js +6 -4
  33. package/web/settings/index.js +152 -154
  34. package/web/settings/memory-sync.js +1 -1
  35. package/web/settings/memory.js +14 -39
  36. package/web/settings/notify.js +1 -1
  37. package/web/settings/security.js +8 -6
  38. package/web/settings/servers.js +3 -2
  39. package/web/settings/skills.js +4 -1
  40. package/web/settings/tabs.js +37 -31
  41. package/web/settings/usage.js +3 -3
  42. package/web/settings/users.js +22 -1
  43. package/web/settings/weixin.js +1 -1
  44. package/web/views/layout.js +2 -2
  45. package/web/views/memo-dialogs.js +1 -1
  46. package/web/views/sidebar-gestures.js +1 -1
  47. package/web/views/sidebar-nav.js +1 -2
  48. package/web/views/tasks.js +1 -1
  49. package/web/views/topbar.js +1 -1
package/README.md CHANGED
@@ -29,7 +29,7 @@ Logo 是白底的三向汇合:橘红、暖橙和珊瑚红三个单元,表达
29
29
  | 🧑‍🏫 | **专家** | 自己配专家:选引擎、写提示词,定它能做什么(只能联网 / 读文件 / 改文件 / 跑命令),挂哪些技能和 MCP,能把活派给哪些子智能体。新对话、定时任务都能选 |
30
30
  | 🔀 | **飞书机器人灵活绑定 agent** | 机器人数量不限,每个机器人可以直接勾选内置或共享专家,并选择默认专家(可在会话里切换)。网页上扫码就能创建,改完立即生效;由服务端主动连向飞书,家里没有公网 IP 也能在外面用 |
31
31
  | 🔗 | **飞书续接 Web 任务** | 飞书里发 `/web` 接上一条 Web 会话,或者在网页聊天右上角「更多」或侧栏会话右键菜单里选「在飞书继续」。之后回复、授权、提问都发到飞书,发 `/detach` 回来 |
32
- | 💬 | **微信 ClawBot** | 设置 → 账号绑定里用微信扫码,就能在微信里和 agent 聊天、回数字处理授权和提问,网页上是同一条对话。每个人连自己的微信。微信限制较多,适合发起任务和接收回复,详见下面的说明 |
32
+ | 💬 | **微信 ClawBot** | 设置 → 连接 → 微信里用微信扫码,就能在微信里和 agent 聊天、回数字处理授权和提问,网页上是同一条对话。每个人连自己的微信。微信限制较多,适合发起任务和接收回复,详见下面的说明 |
33
33
  | 🖥️ | **完整的 Web 工作台** | 流式回复、附件、语音输入、Codex 语音对话、模型和思考程度切换、上下文占用、从任意回复分叉、按项目分组的侧栏、搜索会话、全部设置,电脑和手机(PWA)都能用 |
34
34
  | 🔔 | **飞书 + 苹果系统推送** | 除了飞书消息,Web 会话还能推送到 iPhone、iPad 锁屏和 Mac 通知中心(标准 Web Push,不需要开发者账号),图标上显示未读数 |
35
35
  | 🗂️ | **桌面端同时接入多台设备** | 桌面端(macOS / Windows / Linux)同时连多台服务器,菜单栏 / 托盘一眼看完各台的额度、待处理和运行中的会话 |
@@ -37,10 +37,10 @@ Logo 是白底的三向汇合:橘红、暖橙和珊瑚红三个单元,表达
37
37
  ## 能做什么
38
38
 
39
39
  - **多个 agent**:Claude Code、Codex、WorkBuddy、pi、dsh。几个 agent 共用工作目录,能看到对方改过的文件,但聊天记录各自独立。
40
- - **WorkBuddy(腾讯)**:默认不启用。调用这台服务器上 **WorkBuddy 桌面版自带的 CLI**(官方 Agent SDK `@tencent-ai/agent-sdk` 驱动,账号站点 www.workbuddy.cn),也可以改用 CodeBuddy 国内版 / 国际版 / 腾讯 iOA 的账号(用 SDK 自带的 CLI,不用装桌面版)。到 设置 → 模型与运行环境 → WorkBuddy 勾上「启用」、选账号站点后保存,再在「运行环境」里点「登录 WorkBuddy」:在你自己的浏览器里打开登录页,**1 分钟内**登录完(CLI 只等这么久,超时重新点),整台服务器登一次就行,所有人共用。桌面版里登录过也要在这里再登一次(同一个账号):桌面版的登录由它自己保管,不交给单独跑的 CLI;这边的令牌存在 `data/workbuddy-auth.json`(0600),不碰桌面版的数据。也可以给服务设 `CODEBUDDY_API_KEY`。支持流式回复、授权卡(逐次询问 / 自动改文件 / 完全允许)、提问卡、计划模式、中途换模型、图片附件、`/sessions` 恢复以前的会话、记忆和定时任务工具、个人技能和 MCP;管理员的会话读机器上的 `~/.codebuddy` 配置,成员只读项目里的。暂不支持自定义专家、分叉 / 回退、思考程度和额度显示;令牌过期后要回设置页重新登录。
41
- - **pi**:默认不启用。开源编程 agent [pi](https://pi.dev),用官方 TypeScript SDK(`@earendil-works/pi-coding-agent`)在 agent-loft 进程里运行(需要 Node 22.19 以上)。按**模型服务商**配凭据,整台服务器共用:到 设置 → 模型与运行环境 → pi 勾上「启用」,在「模型服务商」里选一家(DeepSeek、智谱 Coding Plan、Kimi、通义 Token Plan、MiniMax、OpenRouter、Anthropic、OpenAI……)粘贴 API Key 保存;或者点「登录」用**订阅账号**(Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot、Kimi Code、xAI……),在你自己的浏览器里完成,设备码直接显示在页面上,浏览器登录完跳到打不开的 127.0.0.1 地址时把地址栏整个粘贴回来即可(订阅能否用在第三方工具里以各家条款为准);也可以给服务设对应的环境变量(如 `DEEPSEEK_API_KEY`)。本地模型和 OpenAI 兼容网关在「自定义服务商」里加(Ollama、LM Studio、vLLM、llama.cpp、one-api……,填地址、接口类型、Key,能「从服务读取模型列表」),写在 `data/pi/models.json`(0600,Key 按字面值保存,不会被当成环境变量或命令)。凭据、会话记录都存在 `data/pi/` 下(`auth.json` 0600、`sessions/`),不读也不写机器上的 `~/.pi`;项目里的 `.pi/` 扩展不加载。pi 自己没有权限系统,授权卡(逐次询问 / 自动改文件 / 完全允许)、计划模式、提问卡由 agent-loft 补上,「自动改文件」只放行工作目录和附件目录里的文件;跑命令(bash)没有沙箱。支持流式回复、中途换模型和思考程度、图片附件(模型支持时)、`/compact` 压缩上下文、`/sessions` 恢复、分叉 / 回退、费用显示、记忆和定时任务工具、个人技能和 MCP,记忆整理也可选 pi。可以建 pi 引擎的自定义专家(见下面「专家」)。
42
- - **dsh(DeepSeek Harness)**:默认不启用。DeepSeek 官方的编程 agent,先在服务器上 `npm install -g @deepseek-ai/dsh`(升级也是这条),再到 设置 → 模型与运行环境 → dsh 勾上「启用」。agent-loft 通过标准 ACP 协议(`dsh --profile acp`)接入,每个会话一个 dsh 进程(第一条消息要等 4~5 秒拉起,闲置后回收)。凭据和会话记录用 dsh 自己的 `~/.dsh`(DeepSeek API Key 在 `dsh web` 的网页里填,或给服务设 `DEEPSEEK_API_KEY`),dsh 网页里建的会话这里也能接着聊(用 DeepSeek 官方模型的)。权限走 dsh 的沙箱:逐次询问 = 只读、自动改文件 = 工作区可写、完全允许 = 不设沙箱,越界时弹授权卡,可「本会话全部允许」;计划模式用只读沙箱 + 提示词实现,方案写在回复里,关掉计划模式后再动手。支持中途换模型和思考程度(off / low / high / max)、恢复会话、任务清单、上下文占用和 token 用量、记忆和定时任务工具、个人技能和 MCP,记忆整理也可选 dsh。不支持自定义专家、分叉 / 回退、提问卡、逐字流式和图片直传(附件给路径让它自己读);设成「调用前询问」的 MCP 不会挂上(dsh 拦不住 MCP 调用)。ACP 模式默认只有官方 DeepSeek 模型,要接别家模型可以在设置里填一个「额外的 patch 文件」。
43
- - **多个飞书机器人**:设置 → 飞书机器人 →「可用专家」直接勾选内置或共享专家,并选择「默认专家」。只勾一个共享专家即可专用,不用再勾选底层 Agent;每个人绑定自己的账号后,直接私聊就是这个专家,使用各自的记忆和工具。机器人能在 Web 上扫码创建(Lark 国际版用「手动添加」),改完配置立即生效,不用重启。
40
+ - **WorkBuddy(腾讯)**:默认不启用。调用这台服务器上 **WorkBuddy 桌面版自带的 CLI**(官方 Agent SDK `@tencent-ai/agent-sdk` 驱动,账号站点 www.workbuddy.cn),也可以改用 CodeBuddy 国内版 / 国际版 / 腾讯 iOA 的账号(用 SDK 自带的 CLI,不用装桌面版)。到 设置 → 对话 → 引擎与模型 → WorkBuddy 勾上「启用」、选账号站点后保存,再在「运行环境」里点「登录 WorkBuddy」:在你自己的浏览器里打开登录页,**1 分钟内**登录完(CLI 只等这么久,超时重新点),整台服务器登一次就行,所有人共用。桌面版里登录过也要在这里再登一次(同一个账号):桌面版的登录由它自己保管,不交给单独跑的 CLI;这边的令牌存在 `data/workbuddy-auth.json`(0600),不碰桌面版的数据。也可以给服务设 `CODEBUDDY_API_KEY`。支持流式回复、授权卡(逐次询问 / 自动改文件 / 完全允许)、提问卡、计划模式、中途换模型、图片附件、`/sessions` 恢复以前的会话、记忆和定时任务工具、个人技能和 MCP;管理员的会话读机器上的 `~/.codebuddy` 配置,成员只读项目里的。暂不支持自定义专家、分叉 / 回退、思考程度和额度显示;令牌过期后要回设置页重新登录。
41
+ - **pi**:默认不启用。开源编程 agent [pi](https://pi.dev),用官方 TypeScript SDK(`@earendil-works/pi-coding-agent`)在 agent-loft 进程里运行(需要 Node 22.19 以上)。按**模型服务商**配凭据,整台服务器共用:到 设置 → 对话 → 引擎与模型 → pi 勾上「启用」,在「模型服务商」里选一家(DeepSeek、智谱 Coding Plan、Kimi、通义 Token Plan、MiniMax、OpenRouter、Anthropic、OpenAI……)粘贴 API Key 保存;或者点「登录」用**订阅账号**(Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot、Kimi Code、xAI……),在你自己的浏览器里完成,设备码直接显示在页面上,浏览器登录完跳到打不开的 127.0.0.1 地址时把地址栏整个粘贴回来即可(订阅能否用在第三方工具里以各家条款为准);也可以给服务设对应的环境变量(如 `DEEPSEEK_API_KEY`)。本地模型和 OpenAI 兼容网关在「自定义服务商」里加(Ollama、LM Studio、vLLM、llama.cpp、one-api……,填地址、接口类型、Key,能「从服务读取模型列表」),写在 `data/pi/models.json`(0600,Key 按字面值保存,不会被当成环境变量或命令)。凭据、会话记录都存在 `data/pi/` 下(`auth.json` 0600、`sessions/`),不读也不写机器上的 `~/.pi`;项目里的 `.pi/` 扩展不加载。pi 自己没有权限系统,授权卡(逐次询问 / 自动改文件 / 完全允许)、计划模式、提问卡由 agent-loft 补上,「自动改文件」只放行工作目录和附件目录里的文件;跑命令(bash)没有沙箱。支持流式回复、中途换模型和思考程度、图片附件(模型支持时)、`/compact` 压缩上下文、`/sessions` 恢复、分叉 / 回退、费用显示、记忆和定时任务工具、个人技能和 MCP,记忆整理也可选 pi。可以建 pi 引擎的自定义专家(见下面「专家」)。
42
+ - **dsh(DeepSeek Harness)**:默认不启用。DeepSeek 官方的编程 agent,先在服务器上 `npm install -g @deepseek-ai/dsh`(升级也是这条),再到 设置 → 对话 → 引擎与模型 → dsh 勾上「启用」。agent-loft 通过标准 ACP 协议(`dsh --profile acp`)接入,每个会话一个 dsh 进程(第一条消息要等 4~5 秒拉起,闲置后回收)。凭据和会话记录用 dsh 自己的 `~/.dsh`(DeepSeek API Key 在 `dsh web` 的网页里填,或给服务设 `DEEPSEEK_API_KEY`),dsh 网页里建的会话这里也能接着聊(用 DeepSeek 官方模型的)。权限走 dsh 的沙箱:逐次询问 = 只读、自动改文件 = 工作区可写、完全允许 = 不设沙箱,越界时弹授权卡,可「本会话全部允许」;计划模式用只读沙箱 + 提示词实现,方案写在回复里,关掉计划模式后再动手。支持中途换模型和思考程度(off / low / high / max)、恢复会话、任务清单、上下文占用和 token 用量、记忆和定时任务工具、个人技能和 MCP,记忆整理也可选 dsh。不支持自定义专家、分叉 / 回退、提问卡、逐字流式和图片直传(附件给路径让它自己读);设成「调用前询问」的 MCP 不会挂上(dsh 拦不住 MCP 调用)。ACP 模式默认只有官方 DeepSeek 模型,要接别家模型可以在设置里填一个「额外的 patch 文件」。
43
+ - **多个飞书机器人**:设置 → 连接 → 飞书 → 机器人管理 →「可用专家」直接勾选内置或共享专家,并选择「默认专家」。只勾一个共享专家即可专用,不用再勾选底层 Agent;每个人绑定自己的账号后,直接私聊就是这个专家,使用各自的记忆和工具。机器人能在 Web 上扫码创建(Lark 国际版用「手动添加」),改完配置立即生效,不用重启。
44
44
  - 群聊里要 @ 机器人;不同话题是各自独立的会话;支持文字、富文本、图片、文件、语音和视频。
45
45
  - 思考和工具调用显示在实时刷新的过程卡片里,最终回复是普通消息。
46
46
  - 陌生人发消息会拿到配对码,在设置页批准后才能使用;每个机器人单独授权。
@@ -61,7 +61,7 @@ Logo 是白底的三向汇合:橘红、暖橙和珊瑚红三个单元,表达
61
61
  - 定时发送:右上角「更多」→「定时发送」,默认排在 5 小时额度重置后 5 分钟(弹窗里提示 5 小时 / 7 天额度的重置时间),由服务端到点发出,关掉页面也会发。适合额度用完、要等刷新才能接着干活的时候。
62
62
  - 侧栏直接显示各个文件夹,Web 会话按工作目录归类(目录可以拖动排序,右键可置顶;排好的顺序跟着账号走、各设备一致,新消息不会打乱),飞书会话按机器人分组,微信的当前与历史会话按账号分组,两者都能展开 / 折叠并记住状态,收起时仍显示运行中和待处理提示,展开即可查看历史会话。渠道分组行右侧始终显示飞书或微信的静态图标,Web 页面不提供这些分组的新建会话入口。项目名、渠道分组名和有分叉的会话后面有个小三角,点一下折叠 / 展开(分叉折叠后显示「N 个嵌套会话」);分叉出来的会话缩进挂在原会话下面,用一条细线连着;标题放不下时尾巴淡出;Web 和飞书会话都先用首条消息命名,再同步 agent 自动生成的标题,旧飞书会话会从历史记录补名,双击可手动重命名;鼠标移到会话上,行尾显示对应的专家图标;定时任务的时钟图标始终放在最右侧。
63
63
  - **搜索**:侧栏「搜索」弹窗,搜全部会话的标题、目录名和聊天内容(不开记忆也能搜),可以按专家筛;电脑和手机上弹窗都固定高度,结果在内部滚动,手机上从底部展开;↑↓ 选、回车打开。
64
- - **侧栏菜单**:项目上方的「更多」支持点击或鼠标悬停展开,设置入口也在这里。「编辑侧边栏」可勾选直接显示的菜单、拖动调整顺序,未勾选的收进「更多」;配置跟着账号走,电脑和手机共用。
64
+ - **侧栏菜单**:项目上方的「更多」支持点击或鼠标悬停展开。「编辑侧边栏」可勾选直接显示的菜单、拖动调整顺序,未勾选的收进「更多」;配置跟着账号走,电脑和手机共用。
65
65
  - 会话页顶部标题前是专家的头像,PC 端头像与会话名称字号一致(15px);鼠标停上去或点一下,看专家的说明、模型、能力、当前工作目录和本会话 Token 用量。
66
66
  - 附件可以直接拖到聊天区任意位置上传。
67
67
  - 回复过程中接着发的消息排队,标着「排队中」,隐藏底部的复制和回退按钮,上一条回复完自动接着处理;点「撤销并编辑」图标把排队消息放回输入框;点「打断并发送」停掉正在进行的回复、马上处理这条;点停止则连排着的一起取消(标「没有发出」)。
@@ -72,54 +72,54 @@ Logo 是白底的三向汇合:橘红、暖橙和珊瑚红三个单元,表达
72
72
  - 侧栏按页加载:每个项目目录和飞书机器人分组先显示 5 条,点「展开显示」每次再拉 10 条。
73
73
  - 项目、飞书和微信分组可混合拖拽排序,渠道分组可以放在项目前面或项目之间;右键(触屏长按)可置顶、上移、下移或按最近活跃重排。顺序按账号保存,刷新、换设备后保留,新消息不会改变已排好的位置。
74
74
  - 侧栏底部显示 Claude / Codex 的订阅额度(5 小时 / 7 天窗口,以及多久后重置);关了额度查询就整块不显示。
75
- - 专家信息弹窗底部显示当前会话累计消耗的 Token 分布(输入 / 缓存写入 / 缓存读取 / 输出,Claude 还有按 API 价格估算的费用)。设置入口在侧栏的「更多」里。
76
- - 助手中心 → 用量:按日 / 月 / 年(默认按月)统计 token 和金额,有每天(每月)的柱状图,按 agent、模型、用户(管理员才有)分开看;成员只看到自己的。管理员还可查看服务端本机直接使用的 Claude Code、Codex 桌面端和 CLI 用量,和 Agent Loft 的用量分开显示、避免重复计算。金额都是按 API 价格算的参考值:Agent Loft 的 Claude 用它自己报的费用,Codex 和直接用的 Claude Code 按模型单价 × token 估算(OpenAI 单价来自 LiteLLM 公开价格表,内置快照、联网时每天更新)。Agent Loft 的账从 0.2.34 开始记录;本机直接使用的用量可回溯已有会话记录。
75
+ - 专家信息弹窗底部显示当前会话累计消耗的 Token 分布(输入 / 缓存写入 / 缓存读取 / 输出,Claude 还有按 API 价格估算的费用)。设置入口默认显示在侧栏。
76
+ - 设置 → 对话 → 用量:按日 / 月 / 年(默认按月)统计 token 和金额,有每天(每月)的柱状图,按 agent、模型、用户(管理员才有)分开看;成员只看到自己的。管理员还可查看服务端本机直接使用的 Claude Code、Codex 桌面端和 CLI 用量,和 Agent Loft 的用量分开显示、避免重复计算。金额都是按 API 价格算的参考值:Agent Loft 的 Claude 用它自己报的费用,Codex 和直接用的 Claude Code 按模型单价 × token 估算(OpenAI 单价来自 LiteLLM 公开价格表,内置快照、联网时每天更新)。Agent Loft 的账从 0.2.34 开始记录;本机直接使用的用量可回溯已有会话记录。
77
77
  - 「添加到主屏幕」后当 App 用;切到后台再回来会自动重连,补上错过的内容。
78
78
  - 前端资源按指纹长缓存:再次打开不用逐个向服务端确认,升级或改了文件后刷新页面自动换新。
79
79
  - 手机顶栏采用实色圆形按钮和「专家+更多」胶囊按钮组;从左边缘右滑展开侧栏,在侧栏或遮罩上左滑收起,短滑会回弹。消息底部操作栏与下一条消息之间留 4px。
80
- - **网页多服务器切换**:在 设置 → 多服务器 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角通过名称和紧随其后的箭头切换,不显示服务器图标,嵌入桌面端时隐藏此入口;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
81
- - **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 设备通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
80
+ - **网页多服务器切换**:在 设置 → 连接 → 服务器切换 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角通过名称和紧随其后的箭头切换,不显示服务器图标,嵌入桌面端时隐藏此入口;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
81
+ - **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 个人 → 通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
82
82
  - **跨渠道同步**:飞书里的会话在 Web 上也能打开接着聊。同一个授权请求同时出现在飞书卡片和网页上,哪边先点算哪边,另一边自动变成「已处理」。
83
- - **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 / 自动判断(仅 Claude Code,由 Claude 逐个判断安不安全)/ 完全允许,定时任务也可以单独设,自动判断和完全允许只给管理员;默认级别在 助手中心 → 专家 里按引擎设。同一个弹窗里还有**计划模式**开关(或 `/planmode on`):agent 先只读、出方案,你点「开始执行」后再按权限级别动手。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问(Bash 仍询问)。超时一律按拒绝处理。
84
- - **设置与助手中心**:侧栏的「助手中心」集中管理专家、技能、MCP、记忆和用量。「设置」按账号与偏好、对话与模型、连接与访问、实例管理分组,支持搜索具体操作。成员只看到有权限使用的项目。
85
- - **多用户**(信任型):管理员在 设置 → 用户与权限 里给别人建账号。每个人只看得到自己的对话、授权和通知;个人设置各自管理,服务器设置由管理员修改,见下面「安全」。
86
- - **专家**:助手中心 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex`、`/workbuddy`、`/pi`、`/dsh` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「助手中心 → 专家」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择;其他人没配置过时,沿用创建者选的里面自己能用的(自己装了的技能、创建者共享出来的 MCP),创建者私有的 MCP 和机器 MCP 不会带给别人。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
83
+ - **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 / 自动判断(仅 Claude Code,由 Claude 逐个判断安不安全)/ 完全允许,定时任务也可以单独设,自动判断和完全允许只给管理员;默认级别在 设置 → 助手 → 专家 里按引擎设。同一个弹窗里还有**计划模式**开关(或 `/planmode on`):agent 先只读、出方案,你点「开始执行」后再按权限级别动手。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问(Bash 仍询问)。超时一律按拒绝处理。
84
+ - **设置**:侧栏统一入口。手机顶部切换「个人、助手、对话、连接、管理」,组内项目使用圆角分段菜单。桌面使用左侧目录。支持搜索具体操作,按账号权限显示项目。
85
+ - **多用户**(信任型):管理员在 设置 → 管理 → 成员 里给别人建账号。每个人只看得到自己的对话、授权和通知;个人设置各自管理,服务器设置由管理员修改,见下面「安全」。
86
+ - **专家**:设置 → 助手 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex`、`/workbuddy`、`/pi`、`/dsh` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → 助手 → 专家」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择;其他人没配置过时,沿用创建者选的里面自己能用的(自己装了的技能、创建者共享出来的 MCP),创建者私有的 MCP 和机器 MCP 不会带给别人。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
87
87
  - 头像(点头像区域的加号上传;未上传时,会话中用引擎的图标)、引擎(Claude / Codex / pi,建好后不能换;pi 专家没有自带的联网搜索和读网页,要联网就给它挂搜索 MCP,也没有子智能体)、默认模型和思考程度(从模型列表里选);
88
88
  - 提示词:人设、规则、输出格式。agent-loft 在后面自动补上这个专家能做什么、今天的日期、记忆。Claude 专家默认只用这段提示词(一句话约 2 千 token),也可以选「追加在 Claude Code 原装提示词后面」(干活更稳,每轮多约 1.6 万);pi 专家同样默认只用这段,也可以追加在 pi 原装提示词后面(每轮多约 600 token);Codex 的基础指令改不了,专家的提示词附在第一条消息后面,约束力弱一些;
89
89
  - 权限,勾选:联网搜索、读网页,以及文件权限(一级包含一级):都不勾就是**只能联网**(不碰本机文件、不弹授权,文本附件内容直接放进消息)/**能读文件**/**能改文件**/**能跑命令**(跑命令就等于能改任何文件,需要授权时弹卡)。Claude 按权限给工具;Codex 按权限开 shell、apply_patch,沙箱只读或 workspace-write;
90
90
  - 带不带个人记忆,默认工作目录,新对话页上的欢迎语和快捷提问;
91
91
  - 技能:只给选中的(Claude 用技能白名单,没选的调不了;没选技能就不挂 Skill 工具,省 token);
92
- - MCP:从「助手中心 → MCP」里勾自己的或别人共享的(管理员还能勾机器上配的);
92
+ - MCP:从「设置 → 助手 → MCP」里勾自己的或别人共享的(管理员还能勾机器上配的);
93
93
  - 子智能体(只有 Claude):别的 Claude 专家,主专家用 Agent 工具把子任务派给它。子智能体的权限不能超过主专家(运行时也封顶在主专家的权限)。
94
94
  - Codex 扩展能力(只有 Codex):Codex 自带、专家默认关掉的能力(关着省 token),勾了才开:生图(图片显示在回复里,占 ChatGPT 订阅额度)、子智能体(Codex 自己的)、操作浏览器、操作桌面、插件和应用(Codex 登录的 ChatGPT 账号连接的应用)。后三项用的是这台机器上的浏览器、桌面和账号,只有管理员能勾,共享出去后别人用时也不开。内置的 Codex 专家不受这些限制,按 Codex 自己的配置来。
95
95
 
96
96
  只勾联网搜索、读网页的 Claude 专家就是以前聊天模式的效果。专家改了,用它的对话下一条消息起生效;专家删了,用它的对话还能看、不能再发消息,用它的定时任务暂停。以前的聊天模式取消了:升级后聊天模式的旧对话不再保留,聊天模式的定时任务暂停,选个专家再启用。
97
- - **MCP**:助手中心 → MCP,每人管自己的:HTTP 地址(+ 请求头),或者本机进程(命令 + 参数 + 环境变量,会在服务器上直接执行命令、不受专家权限约束,所以只有管理员能添加;成员以前建的不再启动)。值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。**共享**:勾「共享给所有账号」后,别人能在专家和内置 Agent 里选它;共享的是命令、地址和普通的环境变量 / 请求头,标成密钥的项每人在「填写我的密钥」里填自己的值,作者的不会给出去;用别人共享的 MCP 时,调用工具前一律先弹授权卡;取消共享后别人填的值一起删掉。自定义专家加载各自勾选的服务;内置专家在「设置 → 模型与运行环境 → 对应 Agent 卡片 → 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
98
- - **记忆**:像 ChatGPT 的记忆,设置 → 记忆偏好(默认关),按用很多年设计。「关于我」加上一条条记住的事;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),事情变了用 `update_memory`,记错了用 `forget`。**分三层**:长期(身份、家人、长期偏好,一直放进系统提示,不会被后来的挤掉,也可以自己置顶)、活跃(近期的事,按最近动过的时间放进系统提示,放不下的 agent 能用 `search_memory` 搜到)、归档(过时了、到期了、满了被挤出来的,不进系统提示,不删,能搜到能恢复)。**谁能动**:你加的、你在聊天里明确要求记的、你置顶的都受保护,自动整理不能改、不能删、满了也不会被挤,agent 要改得是你在当前对话里明确要求。明显的密钥(API key、`密码是……`)agent 和整理都记不进去。**不怕改错**:删除进回收站保留 30 天;每次改动都有记录(谁、什么时候、改之前是什么),在设置里能查能撤销,改之前的旧内容也搜得到;清空和彻底删除才是真删。**自动整理**:把上次整理之后新说的话连同日期交给模型(不留会话记录的一次性调用),补充、更新、归档过时的记忆。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。很长的对话切成几份整理,一句不漏;整理失败的对话不会丢,留着下次再试,连着全失败就退避(最长 6 小时),同一段一直失败的先搁置,点「现在整理」时再试。**摘要**:整理时顺带给每段对话写摘要(不多一次调用),月份过去后合成一份月度摘要(一个月一次调用),agent 回答「那段时间做了什么」「那件事的经过」时用 `memory_timeline` 看,还能按项目目录筛。只有整理范围内的对话才有摘要。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,能按日期筛,只有你自己的、没被删掉的对话),要看前后文用 `read_past_chat`。搜索走 SQLite FTS5 全文索引(中文按字索引,两个字的词也能搜),几十万句也在一秒内;设置页会显示近 30 天 agent 搜了多少次、多少次没搜到。聊天记录索引不开记忆也会记(侧栏的「搜索」也用它),升级后会把已有对话收录进来一次;没开记忆时记进来的不拿去整理。删对话时它的聊天记录索引和摘要一起删,提炼出来的记忆条目留着(记着来源)。**导出和备份**:记忆能导出成 JSON、导入到别的账号或服务器,聊天记录能导出成 JSONL;整个数据库每天自动备份到 `backups/db/`(校验后压缩,留最近 7 天、4 周、12 个月,`AGENT_LOFT_BACKUP_DIR` 可以换到别的盘)。每个用户一份,Claude 和 Codex、Web 和飞书共用;改了记忆(设置里改的、后台整理的、别的对话里记的),正在跑的会话空闲下来就换上新的。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
99
- - **跨实例记忆同步**。多台 agent-loft 可以在离线时分别记忆、聊天和搜索。到「助手中心 → 记忆 → 跨实例同步」,在选作中转的一台生成配对码,在另一台自己的账号输入中转的 HTTPS 地址和配对码。首次连接会交换双方已有的个人档案、记忆、摘要和可读取的问答正文;以后每 15 秒尝试增量同步。两台同时改同一条正文时,可在此处选用或编辑合并结果。已配对的实例持有本地副本,撤销凭据会停止它继续收发数据。
97
+ - **MCP**:设置 → 助手 → MCP,每人管自己的:HTTP 地址(+ 请求头),或者本机进程(命令 + 参数 + 环境变量,会在服务器上直接执行命令、不受专家权限约束,所以只有管理员能添加;成员以前建的不再启动)。值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。**共享**:勾「共享给所有账号」后,别人能在专家和内置 Agent 里选它;共享的是命令、地址和普通的环境变量 / 请求头,标成密钥的项每人在「填写我的密钥」里填自己的值,作者的不会给出去;用别人共享的 MCP 时,调用工具前一律先弹授权卡;取消共享后别人填的值一起删掉。自定义专家加载各自勾选的服务;内置专家在「设置 → 助手 → 专家 → 内置专家设置」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
98
+ - **记忆**:像 ChatGPT 的记忆,设置 → 个人 → 记忆 → 记忆偏好(默认关),按用很多年设计。「关于我」加上一条条记住的事;agent 在聊天里遇到长期有用的信息会自己用 `remember` 记一条(回复里会说),事情变了用 `update_memory`,记错了用 `forget`。**分三层**:长期(身份、家人、长期偏好,一直放进系统提示,不会被后来的挤掉,也可以自己置顶)、活跃(近期的事,按最近动过的时间放进系统提示,放不下的 agent 能用 `search_memory` 搜到)、归档(过时了、到期了、满了被挤出来的,不进系统提示,不删,能搜到能恢复)。**谁能动**:你加的、你在聊天里明确要求记的、你置顶的都受保护,自动整理不能改、不能删、满了也不会被挤,agent 要改得是你在当前对话里明确要求。明显的密钥(API key、`密码是……`)agent 和整理都记不进去。**不怕改错**:删除进回收站保留 30 天;每次改动都有记录(谁、什么时候、改之前是什么),在设置里能查能撤销,改之前的旧内容也搜得到;清空和彻底删除才是真删。**自动整理**:把上次整理之后新说的话连同日期交给模型(不留会话记录的一次性调用),补充、更新、归档过时的记忆。什么时候整理每个人自己定:每天一次(默认凌晨 2 点,把当天的对话合起来一次整理,最省)/每段对话聊完后(停多久可选,改了什么会在对话里说一声)/只在点「现在整理」时/不整理;整理哪些对话也能选:全部/只整理选中专家的对话;用哪个 agent 的哪个模型也能选,默认 Claude Haiku,没有 Claude 就用 Codex 的默认模型、思考程度 low。很长的对话切成几份整理,一句不漏;整理失败的对话不会丢,留着下次再试,连着全失败就退避(最长 6 小时),同一段一直失败的先搁置,点「现在整理」时再试。**摘要**:整理时顺带给每段对话写摘要(不多一次调用),月份过去后合成一份月度摘要(一个月一次调用),agent 回答「那段时间做了什么」「那件事的经过」时用 `memory_timeline` 看,还能按项目目录筛。只有整理范围内的对话才有摘要。**参考以前的聊天**:agent 遇到「上次说的那个……」会用 `search_past_chats` 搜你以前的对话(关键词搜索,能按日期筛,只有你自己的、没被删掉的对话),要看前后文用 `read_past_chat`。搜索走 SQLite FTS5 全文索引(中文按字索引,两个字的词也能搜),几十万句也在一秒内;设置页会显示近 30 天 agent 搜了多少次、多少次没搜到。聊天记录索引不开记忆也会记(侧栏的「搜索」也用它),升级后会把已有对话收录进来一次;没开记忆时记进来的不拿去整理。删对话时它的聊天记录索引和摘要一起删,提炼出来的记忆条目留着(记着来源)。**导出和备份**:记忆能导出成 JSON、导入到别的账号或服务器,聊天记录能导出成 JSONL;整个数据库每天自动备份到 `backups/db/`(校验后压缩,留最近 7 天、4 周、12 个月,`AGENT_LOFT_BACKUP_DIR` 可以换到别的盘)。每个用户一份,Claude 和 Codex、Web 和飞书共用;改了记忆(设置里改的、后台整理的、别的对话里记的),正在跑的会话空闲下来就换上新的。只用在有主人的对话里:你的 Web 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
99
+ - **跨实例记忆同步**。多台 agent-loft 可以在离线时分别记忆、聊天和搜索。到「设置 → 个人 → 记忆 → 跨实例同步」,在选作中转的一台生成配对码,在另一台自己的账号输入中转的 HTTPS 地址和配对码。首次连接会交换双方已有的个人档案、记忆、摘要和可读取的问答正文;以后每 15 秒尝试增量同步。两台同时改同一条正文时,可在此处选用或编辑合并结果。已配对的实例持有本地副本,撤销凭据会停止它继续收发数据。
100
100
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选专家和目录;可以设成不携带上下文,每次运行都换新会话,之前的结果还留在对话里,只是 agent 看不到),在专用对话右上角的「更多」里可以直接编辑任务、立即运行,或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。结果可以发到专用对话,也可以发到正在聊的对话(新建和编辑时都能选,也能来回切换):发到正在聊的对话时,专家和目录跟随对话,权限就是对话自己的;选「不携带上下文」时任务在独立的临时会话里运行,跑完换回聊天的会话,结果照样显示在这条对话里,下一条消息会带给 agent。
101
- - **技能(skills)**:助手中心 → 技能。技能就是 Claude Code / Codex 用的那种 SKILL.md(可以带脚本和资料),由 agent-loft 按人管理,两个 agent 都能用。**来源**:在页面上写、上传技能包(`.zip` / `.skill` / 单个 SKILL.md / 整个文件夹),或者在对话里让 agent「把刚才的做法存成技能」(agent 用 `create_skill` / `update_skill`,先弹授权卡)。**共享**:新建、编辑时选择「仅自己可见」「指定用户」或「所有人可见」,也可在自己技能的「更多 → 共享」里调整;默认仅自己可见。其他用户在「共享技能」中查看正文和附带文件、安装;安装后出现在「我的技能」,可停用、卸载或重新安装。安装的是作者的同一份技能;作者改了内容(说明、正文、附带文件、变量声明),安装的人要在技能页看过并「确认使用新版」后才会继续加载,确认前会话里没有它。作者撤回共享后,范围外用户不再可用。只有作者能编辑;管理员能查看、下架所有分享出来的技能(包括没指名给他的),但看不到别人私有的。共享不包含作者填写的变量和密钥,每人使用自己的配置。**使用**:内置专家默认使用你启用的全部技能,也可以在「设置 → 模型与运行环境」中分别指定 Claude Code / Codex 加载哪些技能;自定义专家只用它选中的;agent 遇到对得上的事自己用。**变量**:技能可以声明要用的环境变量(接口地址、密钥),每个人填自己的值,只注入自己的会话;密钥再写上「只允许发往」的地址就成了**受保护的密钥**——不进环境变量,agent 看不到值,只能用 `skill_request` 工具让 agent-loft 代发请求(在请求头或地址的查询参数里写 `{{变量名}}`;不能写进请求体和地址的主机、路径,免得借允许的服务本身发出去),只走 https(局域网、本机地址才允许 http)、不跟随跳转、响应里出现的值(含 URL 编码、base64 形式)会被抹掉。发往哪些地址**按技能分别确认**:在哪个技能的变量页里填值,就只同意这个技能(和你自己建的技能)声明的地址,别人技能声明的同名密钥地址要在各自页面另外确认;作者删掉的地址立即失效,新加的要你再确认。一个值按受保护密钥填过就一直受保护:声明它的技能停用、卸载了,别的技能声明同名的普通变量也拿不到明文,要当普通变量用得重新填。`skill_request` 只认当前会话挂着的技能声明过的变量。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「助手中心 → 技能 → 本机技能」里能看到。
101
+ - **技能(skills)**:设置 → 助手 → 技能。技能就是 Claude Code / Codex 用的那种 SKILL.md(可以带脚本和资料),由 agent-loft 按人管理,两个 agent 都能用。**来源**:在页面上写、上传技能包(`.zip` / `.skill` / 单个 SKILL.md / 整个文件夹),或者在对话里让 agent「把刚才的做法存成技能」(agent 用 `create_skill` / `update_skill`,先弹授权卡)。**共享**:新建、编辑时选择「仅自己可见」「指定用户」或「所有人可见」,也可在自己技能的「更多 → 共享」里调整;默认仅自己可见。其他用户在「共享技能」中查看正文和附带文件、安装;安装后出现在「我的技能」,可停用、卸载或重新安装。安装的是作者的同一份技能;作者改了内容(说明、正文、附带文件、变量声明),安装的人要在技能页看过并「确认使用新版」后才会继续加载,确认前会话里没有它。作者撤回共享后,范围外用户不再可用。只有作者能编辑;管理员能查看、下架所有分享出来的技能(包括没指名给他的),但看不到别人私有的。共享不包含作者填写的变量和密钥,每人使用自己的配置。**使用**:内置专家默认使用你启用的全部技能,也可以在「设置 → 对话 → 引擎与模型」中分别指定 Claude Code / Codex 加载哪些技能;自定义专家只用它选中的;agent 遇到对得上的事自己用。**变量**:技能可以声明要用的环境变量(接口地址、密钥),每个人填自己的值,只注入自己的会话;密钥再写上「只允许发往」的地址就成了**受保护的密钥**——不进环境变量,agent 看不到值,只能用 `skill_request` 工具让 agent-loft 代发请求(在请求头或地址的查询参数里写 `{{变量名}}`;不能写进请求体和地址的主机、路径,免得借允许的服务本身发出去),只走 https(局域网、本机地址才允许 http)、不跟随跳转、响应里出现的值(含 URL 编码、base64 形式)会被抹掉。发往哪些地址**按技能分别确认**:在哪个技能的变量页里填值,就只同意这个技能(和你自己建的技能)声明的地址,别人技能声明的同名密钥地址要在各自页面另外确认;作者删掉的地址立即失效,新加的要你再确认。一个值按受保护密钥填过就一直受保护:声明它的技能停用、卸载了,别的技能声明同名的普通变量也拿不到明文,要当普通变量用得重新填。`skill_request` 只认当前会话挂着的技能声明过的变量。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「设置 → 助手 → 技能 → 本机技能」里能看到。
102
102
  - **工作区面板**:会话右上角「更多 → 文件」打开或折叠,菜单中用绿色新增行数、红色删除行数显示当前分支的改动,在对话旁边(手机上全屏)看和改这条会话工作目录里的文件。「文件」页签是一棵按需展开的文件树,图片、PDF、音视频、Markdown、网页、代码直接预览,CSV / TSV 显示成表格;文本文件(1 MB 以内、UTF-8)可以编辑,Ctrl / ⌘ + S 保存,Markdown 和 CSV 能预览没保存的内容。还能新建、重命名、上传(点按钮或拖到面板上)、删除。保存时如果文件在你编辑期间被 agent 或别人改过,不会覆盖,由你选覆盖还是重新加载;没保存的内容存在本机,换会话、刷新页面都不丢。「改动」页签是 Git 仓库的已暂存 / 未暂存 / 未跟踪文件,点开看 diff,宽度够时可以切并排;顶栏的分支标记显示当前分支和改动数,点面板里的分支行能查看和切换本地、远程分支,也能新建分支。文件行上可以暂存、取消暂存、丢弃改动,写好说明提交已暂存的内容(默认不运行 Git 钩子,要用的话勾上);「历史」页签看提交记录和每个提交的 diff。推送、拉取、合并、变基请交给 agent 或终端。一轮结束、切回窗口时自动刷新。
103
- - 管理员能用;成员要管理员在 设置 → 用户与权限 里单独「开通工作区面板」。
103
+ - 管理员能用;成员要管理员在 设置 → 管理 → 成员 里单独「开通工作区面板」。
104
104
  - 分支栏下面可以获取、拉取、推送,用的是服务器上配置的 Git 凭据。拉取只做快进,推送从不强制。成员默认没有这个权限,要管理员再单独「开通 Git 远程操作」。
105
105
  - **备忘录**。从侧栏进入「备忘录 → 连接笔记库」,选择 WebDAV 目录,或填写 S3 存储桶、区域和可选前缀。可连接多个笔记库,按文件夹浏览、新建和编辑 Markdown、TXT、JSON、YAML、CSV 等 UTF-8 文本。编辑时粘贴图片会写入当前文件夹的 `assets/`,并插入相对链接。拥有读写权限的成员可以实时合写同一文件,阅读视图也会跟随更新。预览支持相对链接。「版本历史」可以查看并恢复这条连接下每份文本最近 50 个修改前的版本,保存在 Agent Loft 的本地数据库。浏览器通过 Agent Loft 的 HTTP 接口提交修改,用长轮询接收协作更新。Obsidian 等外部客户端直接写入存储时,重新打开文件会读取最新正文,写回冲突时可保留草稿并另存副本。文本上限 2 MB,每张图片上限 12 MB。连接凭据按账号保存在服务端,内网端点可用管理员账号连接。
106
106
  - **快速打开**。在文件树点放大镜,或按 `⌘/Ctrl + O`,按文件名或路径查找。空搜索显示此浏览器里的收藏和最近笔记。点「搜正文」可查看命中片段并跳转。已有全文索引时使用索引,其余库按需从存储读取,关闭面板可取消。
107
107
  - **清单和双链**。可写库支持在阅读模式直接勾选 Markdown 待办;支持 `[[笔记]]`、`[[笔记#章节]]`、`[[笔记|显示文字]]`。
108
108
  - **整理文件**。在目录右键或长按文件,可以修改名称、移动到已有目录,或移入库内的 `.agent-loft-trash`。整理面板会列出可能需要更新的引用。在「笔记库设置 → 回收站」选择文件可恢复原路径;目标重名时会提示冲突。
109
109
  - **共享给成员**。在「备忘录」选中自己的笔记库,点击「共享给成员」,为同一台 Agent Loft 上的账号选择「只读」或「读写」并保存。对方重新进入「备忘录」即可看到共享库,无需填写存储凭据。只读成员可以查看文件和版本历史,读写成员还可以编辑和新建文件。只有库主可以修改共享范围。把成员改为「关闭」即可撤回访问。成员的专家不会自动获得权限。
110
- - **让智能体查笔记或改笔记**。在「助手中心 → 专家」中新建或编辑专家,在「权限和能力 → 备忘录权限」为每个自己的笔记库选择「沿用笔记库默认」「关闭」「只读」或「读写」,随专家一起保存。内置专家在卡片的「设置」里配置,别人共享的专家在「我的工具」里配置。库的默认权限和全文索引仍在「备忘录 → 智能体访问」里管理。已有库沿用原设置,新库默认关闭。备忘录工具随个人对话自动接入,直接在聊天里说「帮我搜笔记」即可。授权后可在自己的对话里按文件名和正文搜索、浏览目录、读取笔记;读写库还支持新建、追加和精确替换一处原文。只有你表达了留存或更新笔记的意图,智能体才会写入。比如你说「把刚才的排查过程留着下次用」,智能体会根据对话整理正文,优先更新已有笔记,也可以自己起名新建,并在保存后告诉你位置。保存后,正在编辑的网页会收到更新,原文可在版本历史中查看。计划模式只读。
110
+ - **让智能体查笔记或改笔记**。在「设置 → 助手 → 专家」中新建或编辑专家,在「权限和能力 → 备忘录权限」为每个自己的笔记库选择「沿用笔记库默认」「关闭」「只读」或「读写」,随专家一起保存。内置专家在卡片的「设置」里配置,别人共享的专家在「我的工具」里配置。库的默认权限和全文索引仍在「备忘录 → 智能体访问」里管理。已有库沿用原设置,新库默认关闭。备忘录工具随个人对话自动接入,直接在聊天里说「帮我搜笔记」即可。授权后可在自己的对话里按文件名和正文搜索、浏览目录、读取笔记;读写库还支持新建、追加和精确替换一处原文。只有你表达了留存或更新笔记的意图,智能体才会写入。比如你说「把刚才的排查过程留着下次用」,智能体会根据对话整理正文,优先更新已有笔记,也可以自己起名新建,并在保存后告诉你位置。保存后,正在编辑的网页会收到更新,原文可在版本历史中查看。计划模式只读。
111
111
  - 授权后服务器在本地建立全文索引。网页和智能体保存后更新索引;外部修改每 10 分钟扫描一次,也可以在「智能体访问」里查看进度和最近成功时间,或立即刷新。首次扫描期间搜索只覆盖已收录内容。默认权限和所有专家权限都关闭后,或断开连接时,会清除该库的搜索索引。
112
112
  - **资料库**:像 ChatGPT 的资料库,侧栏的「资料库」。对话里发过的附件、agent 回复里给出的、这一轮新写出来的图片 / 文档 / 音视频(复制一份收进来,之后原文件改了删了不影响)都汇总在这里:按图片 / 文档 / 音视频筛、按文件名搜,点开看大图或下载,「在新对话里用」,单个或批量删除(文件从磁盘上删掉)。从资料库拿到对话里的文件硬链接进那条对话的上传目录,不占双份空间,agent 照常能读。按人隔离,规则同对话:自己的;没主人的对话(飞书群聊等)的归管理员。上传了一直没发出去的一天后清掉;删除会话时立即清理该会话的上传文件和资料库记录,删除原件也会清理复用到其他会话的副本。agent 侧的会话记录仍保留,恢复会话不会恢复已删除的文件。
113
113
  - **远程控制**:侧栏「定时任务」下面的「远程控制」,直接操作这台机器的**桌面**和**终端**,上面一键切换;切回对话时连接留在后台(侧栏入口上亮个小绿点),再进来接着用。这台机器没有图形桌面(服务器、NAS)时只有终端。
114
114
  - 桌面:走 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 的用户名和登录密码(苹果认证,由服务端登录)。
115
115
  - 终端:进入或刷新页面时不自动连接,点击「连接终端」后接上后台终端,没有现成的才新建;也可直接点击「新建终端」。新终端开在当前对话的工作目录里,可以开多个标签;`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 上软键盘弹出来时这排键会垫到键盘上面。
116
- - 管理员能用;成员要管理员在 设置 → 用户与权限 里单独「开通远程控制」。终端、桌面在 设置 → 远程控制 里各有总开关。
117
- - **微信 ClawBot**:设置 → 账号绑定 → 微信 →「扫码连接微信」,用手机微信扫码并确认(要求微信 8.0.70 以上,「设置 → 插件」里有 ClawBot;这个功能腾讯还在逐步放量)。每个人连自己的微信,会话归扫码的人,用他的记忆和工具,只认扫码的这个微信号;发送 `/new` 创建独立会话并保留旧记录,Web 微信分组里可以查看和续聊历史;服务端主动连向腾讯,不需要公网地址。微信里发文字或语音(要微信能转成文字),不发过程,只显示「正在输入」,结束后发结果;授权和提问是一条文字,回复数字处理(`1` 允许一次、`0` 拒绝,含义固定),网页上也能处理。`/new`、`/stop`、`/model`、`/expert` 等命令都能用。连接后可在同一设置页的「微信使用的专家」中选择专家并点击「切换专家」,也能在首次发微信消息前选好;已有聊天内容时,切换会创建独立会话并保留旧记录,和微信里的 `/expert` 共用同一份选择。
116
+ - 管理员能用;成员要管理员在 设置 → 管理 → 成员 里单独「开通远程控制」。终端、桌面在 设置 → 远程控制 里各有总开关。
117
+ - **微信 ClawBot**:设置 → 连接 → 微信 →「扫码连接微信」,用手机微信扫码并确认(要求微信 8.0.70 以上,「设置 → 插件」里有 ClawBot;这个功能腾讯还在逐步放量)。每个人连自己的微信,会话归扫码的人,用他的记忆和工具,只认扫码的这个微信号;发送 `/new` 创建独立会话并保留旧记录,Web 微信分组里可以查看和续聊历史;服务端主动连向腾讯,不需要公网地址。微信里发文字或语音(要微信能转成文字),不发过程,只显示「正在输入」,结束后发结果;授权和提问是一条文字,回复数字处理(`1` 允许一次、`0` 拒绝,含义固定),网页上也能处理。`/new`、`/stop`、`/model`、`/expert` 等命令都能用。连接后可在同一设置页的「微信使用的专家」中选择专家并点击「切换专家」,也能在首次发微信消息前选好;已有聊天内容时,切换会创建独立会话并保留旧记录,和微信里的 `/expert` 共用同一份选择。
118
118
 
119
119
  微信的限制(官方没公布具体数字,以下来自社区实测,agent-loft 按此处理):每条入站消息之后约能发 10 条,所以长回复每次发 3 段,回「继续」接着发,额度用完时在网页上说明;约 24 小时没在微信里说话后微信会拒绝发送,定时任务的结果可能发不过去,这时改走网页提示和系统推送。接口受理了但没给 `message_id` 时手机可能没收到(微信可能在静默限制账号),设置页和对话里会提示。Web 上说的话回复留在 Web,不花微信的额度。暂不支持群聊和收发图片、文件。
120
120
 
121
121
  消息会经过腾讯服务器,腾讯保留限制、拦截和终止服务的权利(《微信 ClawBot 功能使用条款》)。建议先用小号,不要反复重新扫码(有开发者反映会触发风控)。如果走了代理,让 `ilinkai.weixin.qq.com` 和 `*.cdn.weixin.qq.com` 直连。
122
- - **飞书账号绑定**:设置 → 账号绑定 → 飞书账号 →「生成绑定码」,再在飞书私聊机器人发 `/bind 绑定码`(10 分钟内有效,群里发不算)。绑定后这个私聊就是你的个人会话:用你的记忆,`/sessions` 只列你的会话,`/web` 只能接上你自己的 Web 会话,管理员在 Web 上也看不到它。必须本人在两边各操作一次,管理员不能替人绑定(只能解除),否则就能借飞书读到别人的记忆。
122
+ - **飞书账号绑定**:设置 → 连接 → 飞书账号 →「生成绑定码」,再在飞书私聊机器人发 `/bind 绑定码`(10 分钟内有效,群里发不算)。绑定后这个私聊就是你的个人会话:用你的记忆,`/sessions` 只列你的会话,`/web` 只能接上你自己的 Web 会话,管理员在 Web 上也看不到它。必须本人在两边各操作一次,管理员不能替人绑定(只能解除),否则就能借飞书读到别人的记忆。
123
123
 
124
124
  ## 安装
125
125
 
@@ -133,7 +133,7 @@ agent-loft service install # 注册为开机自启服务(systemd / laun
133
133
 
134
134
  打开 `http://<机器 IP>:8800`(本机用 `http://localhost:8800`):第一次需要输入日志里的设置码,然后建一个管理员账号(用户名默认 `admin`)。设置码找不到的话,直接运行 `agent-loft passwd` 设密码。
135
135
 
136
- 到 设置 → 模型与运行环境 检查 Claude Code、Codex 装好、登录了没有:Claude Code 随 agent-loft 一起安装,只需在服务端终端里登录;Codex 可以点「直接在服务器上安装」。设置 → 服务与更新 里能看到服务端版本,有新版本时点「升级」,服务会在独立目录下载并检查新版,期间旧版仍可使用。系统服务会自动重启,前台运行时需手动重启。新版启动并通过首页、JS、CSS 和 API 检查后生效,验证失败会自动回到原版本。网页显示实际运行版本,`npm ls -g` 显示全局启动入口的安装版本。
136
+ 到 设置 → 对话 → 引擎与模型 检查 Claude Code、Codex 装好、登录了没有:Claude Code 随 agent-loft 一起安装,只需在服务端终端里登录;Codex 可以点「直接在服务器上安装」。设置 → 管理 → 服务维护 里能看到服务端版本,有新版本时点「升级」,服务会在独立目录下载并检查新版,期间旧版仍可使用。系统服务会自动重启,前台运行时需手动重启。新版启动并通过首页、JS、CSS 和 API 检查后生效,验证失败会自动回到原版本。网页显示实际运行版本,`npm ls -g` 显示全局启动入口的安装版本。
137
137
 
138
138
  在外面只用飞书的话不需要任何网络配置(机器人由服务端主动连向飞书)。在外面用网页、系统推送和语音输入需要 HTTPS,见下面的「安全」和[产品介绍里的「从外网访问」](docs/产品介绍.md#从外网访问)。
139
139
 
@@ -152,7 +152,7 @@ agent-loft service install # 注册为开机自启服务(systemd / laun
152
152
  - 菜单栏图标可以换成额度条:Claude、Codex 各是一只像素小宠物,看样子就知道是谁,身子是 5 小时额度,下面一条是周额度。桌面端设置 → 额度显示 →「菜单栏显示额度」,选所有服务器合起来(取最高),或者按服务器分别选 Claude / Codex(图标上不写服务器名);都不选就只显示图标。「额度条显示」选实心表示剩余额度(默认,像电池)还是已用额度。只有 macOS 有,Windows / Linux 的托盘图标太小放不下。
153
153
  - 支持前面挡着 Cloudflare Access 的服务器:验证页直接在窗口里完成,过期会提醒;也可以配 Service Token 免验证。
154
154
  - 首次打开可以选「这台 Mac 也作为服务端」:一键在终端里安装 agent-loft(没有 Node.js 会先用 Homebrew 装)并开机自启,装好自动连上;设置里可以改成「只在桌面端运行时运行」(不开机自启,打开桌面端时启动、退出时停止)。Linux 上一样(需要先装好 Node.js 22.13+,开机自启用 systemd 用户服务);Windows 上服务端还没有开机自启,可以在 WSL 里装,桌面端会自动检测到 `127.0.0.1` 上的它。防休眠:本机有会话在跑时不休眠;另有永不休眠、定时休眠(设休眠时段,时段外不休眠,时段内本机没有会话在跑、屏幕锁上后让 Mac 睡下去)和合盖不休眠(macOS,第一次开关要输管理员密码,之后不用;开着时闲置也不睡,定时休眠到点会临时关掉它让 Mac 睡下去,醒来再打开)。
155
- - macOS 从系统菜单「显示 → 用量汇总」(`⌘⇧U`)打开汇总页,Windows / Linux 也可点顶栏服务器标签后面的用量按钮(柱状图图标):从所有已添加服务器拉取 token 和费用,包括各服务器本机直接使用的 Claude Code、Codex 桌面端和 CLI(仅管理员可见)。按日 / 月 / 年统计,和网页助手中心 → 用量一样有柱状图和按 agent、模型、用户的分项,另外多一栏按服务器来源。采集在各服务端完成:读取运行服务的系统用户下 `~/.claude/projects`、`~/.codex/sessions` 和 `archived_sessions`(支持 `CLAUDE_CONFIG_DIR` / `CODEX_HOME`),按服务器时区记日期,并跳过 Agent Loft 已记账的会话。桌面端不再扫描本机文件;这台电脑的直接用量也需要添加本机服务端才能统计。不在线、没登录或缺少用量接口的服务器不计入,页面上会注明;有旧版用量接口但不支持本机采集的,会提示升级。
155
+ - macOS 从系统菜单「显示 → 用量汇总」(`⌘⇧U`)打开汇总页,Windows / Linux 也可点顶栏服务器标签后面的用量按钮(柱状图图标):从所有已添加服务器拉取 token 和费用,包括各服务器本机直接使用的 Claude Code、Codex 桌面端和 CLI(仅管理员可见)。按日 / 月 / 年统计,和网页设置 → 对话 → 用量一样有柱状图和按 agent、模型、用户的分项,另外多一栏按服务器来源。采集在各服务端完成:读取运行服务的系统用户下 `~/.claude/projects`、`~/.codex/sessions` 和 `archived_sessions`(支持 `CLAUDE_CONFIG_DIR` / `CODEX_HOME`),按服务器时区记日期,并跳过 Agent Loft 已记账的会话。桌面端不再扫描本机文件;这台电脑的直接用量也需要添加本机服务端才能统计。不在线、没登录或缺少用量接口的服务器不计入,页面上会注明;有旧版用量接口但不支持本机采集的,会提示升级。
156
156
  - macOS 从系统菜单「Agent Loft → 设置…」(`⌘,`)打开桌面端设置,Windows / Linux 也可点顶栏设置按钮。在服务器列表里展开某台服务器,能看它的 Agent 环境和版本,有新版本时点「升级服务端」;桌面端自己的更新在同一页的「更新」里点「更新并重启」。
157
157
 
158
158
  桌面端只是个壳(代码在 `desktop/`),服务端照常用 npm 安装和升级。
@@ -185,22 +185,22 @@ agent-loft service install
185
185
  | `agent-loft import [--only claude\|codex] [--disabled] [--dry-run]` | 从旧桥接器导入 |
186
186
  | `agent-loft pair list \| approve <码> \| revoke <机器人id> <open_id>` | 配对管理(Web 设置页里也能做) |
187
187
  | `agent-loft passwd [新密码] [--user 用户名]` | 重置 Web 登录密码(默认是最早的管理员),他的设备全部下线 |
188
- | `agent-loft user list \| add <用户名> [--admin] \| passwd <用户名> \| role <用户名> admin\|member \| disable \| enable \| remove` | 管理 Web 登录用户(设置 → 用户与权限 里也能做) |
188
+ | `agent-loft user list \| add <用户名> [--admin] \| passwd <用户名> \| role <用户名> admin\|member \| disable \| enable \| remove` | 管理 Web 登录用户(设置 → 管理 → 成员 里也能做) |
189
189
  | `agent-loft service install \| uninstall \| restart \| status` | 开机自启 |
190
190
  | `agent-loft doctor` | 体检 |
191
191
 
192
192
  `aloft` 是 `agent-loft` 的简写。
193
193
 
194
- 聊天里的命令(飞书和 Web 通用;Web 打开页面时会预加载当前专家和目录的命令,输入框打 `/` 会弹出命令补全,飞书里打 `/` 会弹出机器人的指令面板(agent-loft 自动注册,约 5~8 分钟生效;只发一个 `/` 也会回一张可点击的命令卡片),顺序和显示项在 设置 → 快捷命令 里调整):`/new` `/fork` `/sessions [all]` `/resume <id>` `/model [名称]` `/effort <程度>` `/stop` `/cd <目录>` `/pwd` `/status` `/permission [ask|edit|auto|full|default]`、`/planmode [on|off]`、`/autoedit [on|off]` `/approve <id> allow-once|allow-always|allow-session|deny` `/help`;只在飞书里有的:`/expert [名称]`(或者直接发 `/claude`、`/codex`,换专家会开新会话)`/web` `/detach` `/bind <绑定码>`
194
+ 聊天里的命令(飞书和 Web 通用;Web 打开页面时会预加载当前专家和目录的命令,输入框打 `/` 会弹出命令补全,飞书里打 `/` 会弹出机器人的指令面板(agent-loft 自动注册,约 5~8 分钟生效;只发一个 `/` 也会回一张可点击的命令卡片),顺序和显示项在 设置 → 对话 → 斜杠命令 里调整):`/new` `/fork` `/sessions [all]` `/resume <id>` `/model [名称]` `/effort <程度>` `/stop` `/cd <目录>` `/pwd` `/status` `/permission [ask|edit|auto|full|default]`、`/planmode [on|off]`、`/autoedit [on|off]` `/approve <id> allow-once|allow-always|allow-session|deny` `/help`;只在飞书里有的:`/expert [名称]`(或者直接发 `/claude`、`/codex`,换专家会开新会话)`/web` `/detach` `/bind <绑定码>`
195
195
 
196
- 自定义命令:设置 → 快捷命令 → 「添加命令」,填命令名、说明和一段提示词,之后发 `/命令名 参数` 就会把这段提示词发给 agent(提示词里的 `$ARGUMENTS` 换成参数,没写就把参数接在后面)。按 agent 分开存,可以编辑、删除,也会同步到飞书指令面板。
196
+ 自定义命令:设置 → 对话 → 斜杠命令 → 「添加命令」,填命令名、说明和一段提示词,之后发 `/命令名 参数` 就会把这段提示词发给 agent(提示词里的 `$ARGUMENTS` 换成参数,没写就把参数接在后面)。按 agent 分开存,可以编辑、删除,也会同步到飞书指令面板。
197
197
 
198
198
  ## 安全
199
199
 
200
200
  这个服务能让 agent 在你的机器上执行命令,等于一个远程 shell。
201
201
 
202
202
  - Web 登录密码用 scrypt 哈希保存。首次建管理员必须用启动日志里的一次性设置码,防止「谁先打开页面谁就成了主人」。
203
- - 管理员在 设置 → 用户与权限 添加成员时,或点已有成员的「使用权限」,可以分别设置共享专家、内置 Agent、服务器切换为「全部允许(含以后新增)」或指定列表(可全部取消);旧账号沿用全部允许。共享专家和内置 Agent 分别授权,成员自己创建的专家仍可使用;收回权限后旧对话可查看,但不能继续调用,相关定时任务会暂停。服务器权限控制本机切换列表,当前服务器保持可用,各台服务器仍各自登录和管理账号。每个用户都可以在 设置 → 账号绑定 修改自己的账号名称(也是登录名),修改不影响原有对话和登录设备。
203
+ - 管理员在 设置 → 管理 → 成员 添加成员时,或点已有成员的「使用权限」,可以分别设置共享专家、内置 Agent、服务器切换为「全部允许(含以后新增)」或指定列表(可全部取消);旧账号沿用全部允许。共享专家和内置 Agent 分别授权,成员自己创建的专家仍可使用;收回权限后旧对话可查看,但不能继续调用,相关定时任务会暂停。服务器权限控制本机切换列表,当前服务器保持可用,各台服务器仍各自登录和管理账号。每个用户都可以在 设置 → 连接 → 飞书 修改自己的账号名称(也是登录名),修改不影响原有对话和登录设备。
204
204
  - 多用户只隔开**界面上**的东西:会话列表、授权 / 提问卡、通知、记忆、`/sessions` 能列出和恢复的 agent 会话;设置、飞书机器人和飞书会话只给管理员(绑定了账号的飞书私聊除外,它归绑定的人);会落盘、对所有人生效的「总是允许」(Claude 的总是允许名单、Codex 的 execpolicy)只有管理员能点。**它不是安全边界**:所有 agent 都以同一个系统用户运行,任何用户都能让 agent 读到这台机器上的文件(别人的对话记录、配置里的密钥),用的也是同一个 Claude / Codex 订阅。只给信任的人开账号;要真正隔离,就每人用自己的系统用户各跑一份 agent-loft。
205
205
  - 从老版本升级:原来的登录密码自动变成管理员 `admin`,已登录的设备不用重新登录。
206
206
  - 登录态通过 HttpOnly cookie 保存,服务端只存它的哈希。同一 IP 连续输错 5 次锁 15 分钟。所有写请求和 WebSocket 都校验 Origin。页面开启了严格的 CSP。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.134",
3
+ "version": "0.2.135",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -10,13 +10,13 @@ export function diagnose(err: unknown): Diagnosis {
10
10
  return {
11
11
  kind: "cli_missing",
12
12
  chatMessage: "这台服务器上没找到 dsh,我暂时无法工作。请机器主人安装:npm install -g @deepseek-ai/dsh",
13
- consoleHint: "找不到 dsh:npm install -g @deepseek-ai/dsh;以系统服务运行时 PATH 很短,在 设置 → 模型与运行环境 → dsh 里填绝对路径。",
13
+ consoleHint: "找不到 dsh:npm install -g @deepseek-ai/dsh;以系统服务运行时 PATH 很短,在 设置 → 对话 → 引擎与模型 → dsh 里填绝对路径。",
14
14
  };
15
15
  }
16
16
  if (text.includes("api key") || text.includes("api_key") || text.includes("401") || text.includes("unauthorized") || text.includes("authentication") || text.includes("credential")) {
17
17
  return {
18
18
  kind: "auth_missing",
19
- chatMessage: "dsh 还没配 DeepSeek 的 API Key(或 Key 失效了),我暂时无法工作。\n请机器主人到 设置 → 模型与运行环境 → dsh 查看怎么配。",
19
+ chatMessage: "dsh 还没配 DeepSeek 的 API Key(或 Key 失效了),我暂时无法工作。\n请机器主人到 设置 → 对话 → 引擎与模型 → dsh 查看怎么配。",
20
20
  consoleHint: `dsh 凭据有问题:${KEY_HINT}`,
21
21
  };
22
22
  }
@@ -1,2 +1,2 @@
1
1
  // 几处共用、又不想为此加载 SDK 的常量
2
- export const NO_PROVIDER = "pi 还没有能用的模型:先到 设置 → 模型与运行环境 → pi 填一家服务商的 API Key";
2
+ export const NO_PROVIDER = "pi 还没有能用的模型:先到 设置 → 对话 → 引擎与模型 → pi 填一家服务商的 API Key";
@@ -2,7 +2,7 @@
2
2
  import type { Diagnosis } from "../../core/types.js";
3
3
  import { NO_PROVIDER } from "./constants.js";
4
4
 
5
- const KEY_HINT = "到 设置 → 模型与运行环境 → pi 的「模型服务商」里填 API Key(凭据存在 agent-loft 的 data/pi/auth.json)。";
5
+ const KEY_HINT = "到 设置 → 对话 → 引擎与模型 → pi 的「模型服务商」里填 API Key(凭据存在 agent-loft 的 data/pi/auth.json)。";
6
6
 
7
7
  export function diagnose(err: unknown): Diagnosis {
8
8
  const raw = err instanceof Error ? err.message : String(err);
@@ -13,7 +13,7 @@ export function diagnose(err: unknown): Diagnosis {
13
13
  if (text.includes("401") || text.includes("unauthorized") || text.includes("invalid api key") || text.includes("invalid_api_key") || text.includes("authentication") || text.includes("incorrect api key")) {
14
14
  return {
15
15
  kind: "auth_missing",
16
- chatMessage: "pi 用的这家模型服务商不认这个 API Key(填错了或已失效)。\n请机器主人到 设置 → 模型与运行环境 → pi 重新填。",
16
+ chatMessage: "pi 用的这家模型服务商不认这个 API Key(填错了或已失效)。\n请机器主人到 设置 → 对话 → 引擎与模型 → pi 重新填。",
17
17
  consoleHint: `pi 服务商鉴权失败:${raw}。${KEY_HINT}`,
18
18
  };
19
19
  }
@@ -1,7 +1,7 @@
1
1
  // WorkBuddy 的报错翻译成人话(口径同 claude/errors.ts)
2
2
  import type { Diagnosis } from "../../core/types.js";
3
3
 
4
- const LOGIN_HINT = "到 设置 → 模型与运行环境 → WorkBuddy 点「登录 WorkBuddy」,在浏览器里登录;或者给服务设 CODEBUDDY_API_KEY 环境变量。";
4
+ const LOGIN_HINT = "到 设置 → 对话 → 引擎与模型 → WorkBuddy 点「登录 WorkBuddy」,在浏览器里登录;或者给服务设 CODEBUDDY_API_KEY 环境变量。";
5
5
 
6
6
  export function diagnose(err: unknown): Diagnosis {
7
7
  const raw = err instanceof Error ? err.message : String(err);
@@ -9,7 +9,7 @@ export function diagnose(err: unknown): Diagnosis {
9
9
  if (text.includes("authentication required") || text.includes("/login") || text.includes("unauthorized") || text.includes("invalid api key") || text.includes("token expired")) {
10
10
  return {
11
11
  kind: "auth_missing",
12
- chatMessage: "WorkBuddy 还没登录(或登录已过期),我暂时无法工作。\n请机器主人到 设置 → 模型与运行环境 → WorkBuddy 重新登录。",
12
+ chatMessage: "WorkBuddy 还没登录(或登录已过期),我暂时无法工作。\n请机器主人到 设置 → 对话 → 引擎与模型 → WorkBuddy 重新登录。",
13
13
  consoleHint: `WorkBuddy 未登录:${LOGIN_HINT}`,
14
14
  };
15
15
  }
@@ -70,7 +70,7 @@ export function desktopCli(): string | undefined {
70
70
  export function cliPath(): string | undefined {
71
71
  if (environment() !== "workbuddy") return undefined;
72
72
  const found = desktopCli();
73
- if (!found) throw new Error("找不到 WorkBuddy 桌面版的 CLI:先装好 WorkBuddy 桌面版,或者在 设置 → 模型与运行环境 → WorkBuddy 里填 CLI 路径");
73
+ if (!found) throw new Error("找不到 WorkBuddy 桌面版的 CLI:先装好 WorkBuddy 桌面版,或者在 设置 → 对话 → 引擎与模型 → WorkBuddy 里填 CLI 路径");
74
74
  return found;
75
75
  }
76
76
 
@@ -669,7 +669,7 @@ export class FeishuBot {
669
669
 
670
670
  const allowed = this.allowedAgents();
671
671
  if (allowed.length === 0 && feishuCommandOf(text)?.kind !== "bind") {
672
- await this.client.sendText(chatId, "这个机器人没有可用的专家。所选专家可能已取消共享、删除,或引擎已停用;请在设置 → 飞书机器人中重新选择。");
672
+ await this.client.sendText(chatId, "这个机器人没有可用的专家。所选专家可能已取消共享、删除,或引擎已停用;请在设置 → 连接 → 飞书 → 机器人管理中重新选择。");
673
673
  return;
674
674
  }
675
675
 
@@ -741,7 +741,7 @@ export class FeishuBot {
741
741
  }
742
742
 
743
743
  if (noExpert) {
744
- await this.client.sendText(chatId, p2p ? "这个机器人使用共享专家。请先在网页「设置 → 账号绑定 → 飞书账号」生成绑定码,再私聊发送 /bind 绑定码,即可使用你自己的记忆和工具。" : "这个机器人只选择了共享专家,请在私聊中绑定你自己的账号后使用。");
744
+ await this.client.sendText(chatId, p2p ? "这个机器人使用共享专家。请先在网页「设置 → 连接 → 飞书账号」生成绑定码,再私聊发送 /bind 绑定码,即可使用你自己的记忆和工具。" : "这个机器人只选择了共享专家,请在私聊中绑定你自己的账号后使用。");
745
745
  return;
746
746
  }
747
747
 
@@ -833,7 +833,7 @@ export class FeishuBot {
833
833
  "",
834
834
  "从现在起这个私聊是你的个人会话:用你的记忆,`/sessions` 只列你的会话,`/web` 只能接上你自己的 Web 会话。群聊不受影响。",
835
835
  "",
836
- "在 Web 的「设置 → 账号绑定」里可以随时解除绑定。",
836
+ "在 Web 的「设置 → 连接 → 飞书」里可以随时解除绑定。",
837
837
  ].join("\n");
838
838
  }
839
839
 
@@ -257,7 +257,7 @@ export function commandListCard(params: {
257
257
  const elements: unknown[] = [
258
258
  {
259
259
  tag: "markdown",
260
- content: `当前 agent:**${params.agentLabel}**。点「执行」直接运行;带 \`<参数>\` 的请手动输入。\n顺序和显示哪些可以在 Web 设置 → 快捷命令里调整。`,
260
+ content: `当前 agent:**${params.agentLabel}**。点「执行」直接运行;带 \`<参数>\` 的请手动输入。\n顺序和显示哪些可以在 Web 设置 → 对话 → 斜杠命令里调整。`,
261
261
  },
262
262
  { tag: "hr" },
263
263
  ];
@@ -297,7 +297,7 @@ export function agentPickerCard(params: {
297
297
  }) {
298
298
  return card(
299
299
  [
300
- { tag: "markdown", content: "换专家会开一条新会话,之前的对话不接着聊。自己的专家在网页「助手中心 → 专家」里建。" },
300
+ { tag: "markdown", content: "换专家会开一条新会话,之前的对话不接着聊。自己的专家在网页「设置 → 助手 → 专家」里建。" },
301
301
  buttonRow(
302
302
  params.agents.map((a) =>
303
303
  button(
@@ -1546,6 +1546,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1546
1546
  const cwd = conv?.cwd ?? (draftCwd ? resolveWorkspacePath(draftCwd) : undefined);
1547
1547
  if (draftCwd && !cwd) throw new HttpError(404, "工作目录不存在,或不在工作区之内");
1548
1548
  const commands = await hub.commandCatalog(m[1]!, {
1549
+ defaultOrder: admin && url.searchParams.get("defaults") === "1",
1549
1550
  ...(cwd ? { cwd } : {}),
1550
1551
  allowedAgents: hub.enabledAgents().map((d) => d.id),
1551
1552
  // 输入框(包括尚未创建的新对话)只列 Web 能用的;设置页仍列全部
@@ -1599,7 +1600,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1599
1600
  });
1600
1601
  return;
1601
1602
  }
1602
- if (p === "/api/account/memory/backup" && method === "POST") {
1603
+ if ((p === "/api/account/memory/backup" || p === "/api/system/backup") && method === "POST") {
1603
1604
  if (!isAdmin(user)) throw new HttpError(403, "只有管理员能备份");
1604
1605
  try {
1605
1606
  await backupNow();
@@ -2037,6 +2038,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
2037
2038
  uptimeMs: Date.now() - startedAt,
2038
2039
  pid: process.pid,
2039
2040
  underSystemd: !!process.env.INVOCATION_ID,
2041
+ backup: backupStatus(),
2040
2042
  });
2041
2043
  return;
2042
2044
  }
@@ -39,7 +39,7 @@ export async function handleDesktopApi(req: IncomingMessage, res: ServerResponse
39
39
  return true;
40
40
  }
41
41
  if (p === "/api/desktop/session" && method === "POST") {
42
- if (!canUseDesktop(user)) throw new HttpError(403, "你没有使用远程桌面的权限,找管理员在 设置 → 用户与权限 里开通");
42
+ if (!canUseDesktop(user)) throw new HttpError(403, "你没有使用远程桌面的权限,找管理员在 设置 → 管理 → 成员 里开通");
43
43
  let target;
44
44
  try {
45
45
  target = await desktopTarget();
@@ -42,7 +42,7 @@ export async function handleTerminalApi(req: IncomingMessage, res: ServerRespons
42
42
  sendJson(res, 200, { ...terminalStatus(user), terminals: canUseTerminal(user) ? listTerminals(user.id) : [] });
43
43
  return true;
44
44
  }
45
- if (!canUseTerminal(user)) throw new HttpError(403, "你没有使用终端的权限,找管理员在 设置 → 用户与权限 里开通");
45
+ if (!canUseTerminal(user)) throw new HttpError(403, "你没有使用终端的权限,找管理员在 设置 → 管理 → 成员 里开通");
46
46
  if (p === "/api/terminals" && method === "POST") {
47
47
  const body = await readJsonBody<{ cwd?: unknown; cols?: unknown; rows?: unknown }>(req);
48
48
  try {
@@ -133,7 +133,7 @@ async function gitAction(res: ServerResponse, op: () => Promise<unknown>): Promi
133
133
 
134
134
  export async function handleWorkspaceApi(req: IncomingMessage, res: ServerResponse, url: URL, sub: string, conv: Conversation, user: User): Promise<boolean> {
135
135
  if (ROUTES[sub] !== req.method) return false;
136
- if (!canUseFiles(user)) throw new HttpError(403, "你没有使用工作区面板的权限,找管理员在 设置 → 用户与权限 里开通");
136
+ if (!canUseFiles(user)) throw new HttpError(403, "你没有使用工作区面板的权限,找管理员在 设置 → 管理 → 成员 里开通");
137
137
  const cwd = workspaceDir(conv.cwd);
138
138
  if (!cwd) throw new HttpError(404, "工作目录不存在,或不在工作区之内");
139
139
  const requested = url.searchParams.get("path") ?? "";
@@ -213,7 +213,7 @@ export async function handleWorkspaceApi(req: IncomingMessage, res: ServerRespon
213
213
  }
214
214
  if (req.method === "POST") {
215
215
  if ((sub === "git-fetch" || sub === "git-pull" || sub === "git-push") && !canUseGitRemote(user)) {
216
- throw new HttpError(403, "你没有连接 Git 远程的权限,找管理员在 设置 → 用户与权限 里开通");
216
+ throw new HttpError(403, "你没有连接 Git 远程的权限,找管理员在 设置 → 管理 → 成员 里开通");
217
217
  }
218
218
  const body = await readJsonBody<{ paths?: unknown; message?: unknown; hooks?: unknown; branch?: unknown; name?: unknown; id?: unknown; direction?: unknown; force?: unknown }>(req);
219
219
  const root = repo.root;
@@ -214,7 +214,7 @@ export class WeixinBot {
214
214
  if (this.status.state === "expired") return;
215
215
  this.setStatus("expired", "微信登录已失效");
216
216
  console.error(`${this.tag} 微信登录已失效,需要重新扫码`);
217
- this.warnWeb("微信登录已失效,收不到微信消息了。请到「设置 → 账号绑定 → 微信」重新扫码。", true);
217
+ this.warnWeb("微信登录已失效,收不到微信消息了。请到「设置 → 连接 → 微信」重新扫码。", true);
218
218
  }
219
219
 
220
220
  private onInbound(msg: WeixinMessage): void {
@@ -42,7 +42,7 @@ export const BUILTIN_COMMANDS: BuiltinSpec[] = [
42
42
  { name: "dsh", description: "换成 dsh 专家(开新会话)", multiAgentOnly: true, chatOnly: true },
43
43
  { name: "web", description: "接上一条 Web 会话,在飞书里查看和回复", feishuOnly: true },
44
44
  { name: "detach", description: "不再接着 Web 会话,回到这个聊天自己的会话", feishuOnly: true },
45
- { name: "bind", args: "<绑定码>", description: "把这个飞书账号绑定到你的 agent-loft 用户(绑定码在 Web 的「设置 → 账号绑定」里生成)", feishuOnly: true },
45
+ { name: "bind", args: "<绑定码>", description: "把这个飞书账号绑定到你的 agent-loft 用户(绑定码在 Web 的「设置 → 连接 → 飞书」里生成)", feishuOnly: true },
46
46
  { name: "help", description: "显示帮助" },
47
47
  { name: "approve", args: "<请求ID> allow-once|allow-always|allow-session|deny", description: "审批兜底(卡片失效时用)" },
48
48
  ];
@@ -124,7 +124,7 @@ export function helpText(agents: string[], channel?: string): string {
124
124
  ? "Agent 要授权或提问时会发一条消息,回复里面的数字作答;提问的选项都不合适就直接发文字。"
125
125
  : "Agent 给选项时会发一张提问卡,点按钮作答;都不合适就直接发消息,那条消息会被当成你的回答。",
126
126
  "",
127
- "**命令**(需整条消息只有命令;只发一个 `/` 可以列出命令;agent 自己的命令默认不在列表里,可以在设置 → 快捷命令里勾选,没勾的照样可以直接发)",
127
+ "**命令**(需整条消息只有命令;只发一个 `/` 可以列出命令;agent 自己的命令默认不在列表里,可以在设置 → 对话 → 斜杠命令里勾选,没勾的照样可以直接发)",
128
128
  "",
129
129
  ...BUILTIN_COMMANDS.filter((c) => !c.multiAgentOnly || multi)
130
130
  .filter((c) => !c.feishuOnly || channel === "feishu")
@@ -100,7 +100,7 @@ export function redeemLinkCode(code: string, botId: string, openId: string): Use
100
100
  sweep();
101
101
  const key = code.trim().toUpperCase();
102
102
  const entry = codes.get(key);
103
- if (!entry) throw new Error("绑定码不对或已过期。请在 Web 上(设置 → 账号绑定)重新生成一个。");
103
+ if (!entry) throw new Error("绑定码不对或已过期。请在 Web 上(设置 → 连接 → 飞书)重新生成一个。");
104
104
  const user = getUser(entry.userId);
105
105
  if (!user || user.disabled) {
106
106
  codes.delete(key);
package/src/core/hub.ts CHANGED
@@ -1797,7 +1797,7 @@ class Hub extends EventEmitter<{
1797
1797
  "- `/permission edit`:自动改文件",
1798
1798
  ...(engineSupports(conv.agent, "auto") ? ["- `/permission auto`:自动判断(Claude 逐个判断安不安全,拿不准再问你)"] : []),
1799
1799
  "- `/permission full`:完全允许",
1800
- "- `/permission default`:恢复默认(助手中心 → 专家 → 内置 Agent 的「设置」里定的默认权限)",
1800
+ "- `/permission default`:恢复默认(设置 → 助手 → 专家 → 内置 Agent 的「设置」里定的默认权限)",
1801
1801
  "- `/planmode on` / `/planmode off`:开关计划模式(先出方案,你批准了再动手)",
1802
1802
  "",
1803
1803
  `这条对话最高能到「${PERMISSION_LABEL[this.permissionMax(conv)]}」。`,
@@ -2562,7 +2562,7 @@ class Hub extends EventEmitter<{
2562
2562
  */
2563
2563
  async commandCatalog(
2564
2564
  agent: string,
2565
- opts: { cwd?: string; allowedAgents: string[]; channel?: string; member?: boolean },
2565
+ opts: { cwd?: string; allowedAgents: string[]; channel?: string; member?: boolean; defaultOrder?: boolean },
2566
2566
  ): Promise<CommandEntry[]> {
2567
2567
  const driver = this.enabledAgents().find((d) => d.id === agent);
2568
2568
  let native: AgentCommand[] = [];
@@ -2575,7 +2575,7 @@ class Hub extends EventEmitter<{
2575
2575
  // 成员:机器上装的技能不列(用了也会被 blockedSlash 拦下)
2576
2576
  if (opts.member) native = native.filter((c) => !isMachineCommand(c.name, native, opts.cwd ?? config().workspaceRoot));
2577
2577
  const prefs = (config().commands as Record<string, CommandPrefs | undefined>)[agent];
2578
- return buildCatalog({ allowedAgents: opts.allowedAgents, native, prefs, ...(opts.channel ? { channel: opts.channel } : {}) });
2578
+ return buildCatalog({ allowedAgents: opts.allowedAgents, native, prefs: opts.defaultOrder ? undefined : prefs, ...(opts.channel ? { channel: opts.channel } : {}) });
2579
2579
  }
2580
2580
 
2581
2581
  async shutdown(): Promise<void> {
@@ -518,7 +518,7 @@ export function describeResult(r: CurateResult): string | undefined {
518
518
  ...r.updated.map((t) => `更新为「${clip(t)}」`),
519
519
  ...(r.removed.length ? [`移走了 ${r.removed.length} 条过时的`] : []),
520
520
  ];
521
- return parts.length ? `🧠 记忆已更新:${parts.join(";")}。(助手中心 → 记忆 里可以查看、修改和撤销)` : undefined;
521
+ return parts.length ? `🧠 记忆已更新:${parts.join(";")}。(设置 → 个人 → 记忆 里可以查看、修改和撤销)` : undefined;
522
522
  }
523
523
 
524
524
  /** 按用户的设置挑 agent。指定的那个用不了就是 undefined(不悄悄换成另一个,免得用到他没想用的额度) */