agent-loft 0.2.96 → 0.2.98

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
@@ -79,22 +79,23 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
79
79
  - **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 / 完全允许,定时任务也可以单独设,完全允许只给管理员。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问(Bash 仍询问)。超时一律按拒绝处理。
80
80
  - **设置都在网页上**,按用途分组:**我的**(账号、飞书和微信绑定、自己的登录设备、记忆、专家、技能、MCP、用量);**Agent**(运行环境置顶,各 agent 卡片分别配置默认模型、思考程度、可选模型、个人默认技能和 MCP,Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户标题旁添加用户,用户的「管理 → 登录设备」查看和下线各自设备;系统页管理服务端版本和升级、重启、局域网访问和端口,网络访问下方是系统通知;成员也可在系统页设置自己的通知)。账号页通过「修改名称」「修改密码」按需展开表单;飞书和微信绑定操作位于卡片右上角。设置、新建 / 编辑专家、重命名等编辑弹窗不会因点击外部或按 Esc 关闭;通过关闭、取消或保存 / 完成按钮退出。改了没保存就切页或关掉设置会先提醒。
81
81
  - **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知;个人设置各自管理,服务器设置由管理员修改,见下面「安全」。
82
- - **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → Agent」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择,其他人未配置时不加载技能或 MCP。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
82
+ - **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → Agent」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择;其他人没配置过时,沿用创建者选的里面自己能用的(自己装了的技能、创建者共享出来的 MCP),创建者私有的 MCP 和机器 MCP 不会带给别人。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
83
83
  - 头像(点头像区域的加号上传;未上传时,会话中用引擎的图标)、引擎(Claude / Codex,建好后不能换)、默认模型和思考程度(从模型列表里选);
84
84
  - 提示词:人设、规则、输出格式。agent-loft 在后面自动补上这个专家能做什么、今天的日期、记忆。Claude 专家默认只用这段提示词(一句话约 2 千 token),也可以选「追加在 Claude Code 原装提示词后面」(干活更稳,每轮多约 1.6 万);Codex 的基础指令改不了,专家的提示词附在第一条消息后面,约束力弱一些;
85
85
  - 权限,勾选:联网搜索、读网页,以及文件权限(一级包含一级):都不勾就是**只能联网**(不碰本机文件、不弹授权,文本附件内容直接放进消息)/**能读文件**/**能改文件**/**能跑命令**(跑命令就等于能改任何文件,需要授权时弹卡)。Claude 按权限给工具;Codex 按权限开 shell、apply_patch,沙箱只读或 workspace-write;
86
86
  - 带不带个人记忆,默认工作目录,新对话页上的欢迎语和快捷提问;
87
87
  - 技能:只给选中的(Claude 用技能白名单,没选的调不了;没选技能就不挂 Skill 工具,省 token);
88
- - MCP:从「设置 → MCP」里勾(管理员还能勾机器上配的);
88
+ - MCP:从「设置 → MCP」里勾自己的或别人共享的(管理员还能勾机器上配的);
89
89
  - 子智能体(只有 Claude):别的 Claude 专家,主专家用 Agent 工具把子任务派给它。子智能体的权限不能超过主专家(运行时也封顶在主专家的权限)。
90
90
 
91
91
  只勾联网搜索、读网页的 Claude 专家就是以前聊天模式的效果。专家改了,用它的对话下一条消息起生效;专家删了,用它的对话还能看、不能再发消息,用它的定时任务暂停。以前的聊天模式取消了:升级后聊天模式的旧对话不再保留,聊天模式的定时任务暂停,选个专家再启用。
92
- - **MCP**:设置 → MCP,每人管自己的:本机进程(命令 + 参数 + 环境变量)或 HTTP 地址(+ 请求头),值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。自定义专家加载各自勾选的服务;内置专家在「设置 → Agent → 对应 Agent 卡片 → 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
92
+ - **MCP**:设置 → MCP,每人管自己的:HTTP 地址(+ 请求头),或者本机进程(命令 + 参数 + 环境变量,会在服务器上直接执行命令、不受专家权限约束,所以只有管理员能添加;成员以前建的不再启动)。值可以标成密钥(网页上不回显,只交给 MCP 进程或请求头,不进提示词)。可以设「调用前询问」,不设就直接用。**共享**:勾「共享给所有账号」后,别人能在专家和内置 Agent 里选它;共享的是命令、地址和普通的环境变量 / 请求头,标成密钥的项每人在「填写我的密钥」里填自己的值,作者的不会给出去;用别人共享的 MCP 时,调用工具前一律先弹授权卡;取消共享后别人填的值一起删掉。自定义专家加载各自勾选的服务;内置专家在「设置 → Agent → 对应 Agent 卡片 → 默认加载」里选择,支持个人 MCP、管理员可选的机器 MCP,也可全部取消;不指定时管理员沿用机器配置。
93
93
  - **记忆**:像 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 对话,以及绑定了飞书账号后和机器人的私聊;飞书群聊不用。别人(包括管理员)看不到你的记忆,管理员只能清空它;删用户时记忆一起删,不转给管理员。
94
94
  - **定时任务**:像 ChatGPT 的 Tasks,侧栏的「定时任务」。到点把一段提示词交给 agent,结果发回对话:一次 / 每天 / 工作日 / 每周 / 每月 / 每隔几小时 / 自定义 cron,按服务端时区,两次至少隔 15 分钟。**有需要才提醒**(默认):agent 自己判断这次有没有要告诉你的事(比如「有新版本才告诉我」),没有就在回复第一行写 `[[静默]]`,推送、飞书都不发,对话里折叠成一行;没写暗号一律照常提醒。结果发到**专用对话**(任务自己的一条对话,第一次运行时新建、之后续用,可选专家和目录;可以设成不携带上下文,每次运行都换新会话,之前的结果还留在对话里,只是 agent 看不到),在专用对话右上角的「更多」里可以直接编辑任务、立即运行,或者**原来的对话**。也能直接在对话里说「每天早上 9 点帮我……」:agent 用 `create_task` / `update_task` / `delete_task` / `list_tasks` 工具管理,新建、修改、删除都会先弹授权卡让你确认(只有暂停不用;没有「总是允许」),任务自己运行的那一轮里不能再建、改、删任务。按人隔离:每人只看得到、改得了自己的任务(最多 30 个),删用户时一起删;到点再核对一次对话还是不是他的,对话被删或换了主人就暂停任务。到点对话在忙(正在回复或挂着授权)就等它,最多 30 分钟;服务停着时错过 2 小时以内的启动后补跑一次。工具和记忆一样只给有主人的对话,飞书群聊里没有。结果可以发到专用对话,也可以发到正在聊的对话(新建和编辑时都能选,也能来回切换):发到正在聊的对话时,专家和目录跟随对话,权限就是对话自己的;选「不携带上下文」时任务在独立的临时会话里运行,跑完换回聊天的会话,结果照样显示在这条对话里,下一条消息会带给 agent。
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
+ - **技能(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 代发请求(在请求头或地址的查询参数里写 `{{变量名}}`;不能写进请求体和地址的主机、路径,免得借允许的服务本身发出去),只走 https(局域网、本机地址才允许 http)、不跟随跳转、响应里出现的值(含 URL 编码、base64 形式)会被抹掉。发往哪些地址**按技能分别确认**:在哪个技能的变量页里填值,就只同意这个技能(和你自己建的技能)声明的地址,别人技能声明的同名密钥地址要在各自页面另外确认;作者删掉的地址立即失效,新加的要你再确认。一个值按受保护密钥填过就一直受保护:声明它的技能停用、卸载了,别的技能声明同名的普通变量也拿不到明文,要当普通变量用得重新填。`skill_request` 只认当前会话挂着的技能声明过的变量。**机器上原有的技能**(`~/.claude/skills`、`~/.agents/skills`、插件市场和 claude.ai 同步的)只给管理员:成员的会话里看不到、调不了(Claude 用技能白名单,`/技能名` 也会被拦下;Codex 关掉它自己的技能清单),管理员在「设置 → 技能 → 本机技能」里能看到。
96
96
  - **工作区面板**:会话右上角「更多 → 文件」打开或折叠,菜单中用绿色新增行数、红色删除行数显示当前分支的改动,在对话旁边(手机上全屏)看和改这条会话工作目录里的文件。「文件」页签是一棵按需展开的文件树,图片、PDF、音视频、Markdown、网页、代码直接预览,CSV / TSV 显示成表格;文本文件(1 MB 以内、UTF-8)可以编辑,Ctrl / ⌘ + S 保存,Markdown 和 CSV 能预览没保存的内容。还能新建、重命名、上传(点按钮或拖到面板上)、删除。保存时如果文件在你编辑期间被 agent 或别人改过,不会覆盖,由你选覆盖还是重新加载;没保存的内容存在本机,换会话、刷新页面都不丢。「改动」页签是 Git 仓库的已暂存 / 未暂存 / 未跟踪文件,点开看 diff,宽度够时可以切并排;顶栏的分支标记显示当前分支和改动数,点面板里的分支行能查看和切换本地、远程分支,也能新建分支。文件行上可以暂存、取消暂存、丢弃改动,写好说明提交已暂存的内容(默认不运行 Git 钩子,要用的话勾上);「历史」页签看提交记录和每个提交的 diff。推送、拉取、合并、变基请交给 agent 或终端。一轮结束、切回窗口时自动刷新。
97
97
  - 管理员能用;成员要管理员在 设置 → 用户 里单独「开通工作区面板」。
98
+ - 分支栏下面可以获取、拉取、推送,用的是服务器上配置的 Git 凭据。拉取只做快进,推送从不强制。成员默认没有这个权限,要管理员再单独「开通 Git 远程操作」。
98
99
  - **资料库**:像 ChatGPT 的资料库,侧栏的「资料库」。对话里发过的附件、agent 回复里给出的、这一轮新写出来的图片 / 文档 / 音视频(复制一份收进来,之后原文件改了删了不影响)都汇总在这里:按图片 / 文档 / 音视频筛、按文件名搜,点开看大图或下载,「在新对话里用」,单个或批量删除(文件从磁盘上删掉)。从资料库拿到对话里的文件硬链接进那条对话的上传目录,不占双份空间,agent 照常能读。按人隔离,规则同对话:自己的;没主人的对话(飞书群聊等)的归管理员。上传了一直没发出去的一天后清掉;删除会话时立即清理该会话的上传文件和资料库记录,删除原件也会清理复用到其他会话的副本。agent 侧的会话记录仍保留,恢复会话不会恢复已删除的文件。
99
100
  - **远程控制**:侧栏「定时任务」下面的「远程控制」,直接操作这台机器的**桌面**和**终端**,上面一键切换;切回对话时连接留在后台(侧栏入口上亮个小绿点),再进来接着用。这台机器没有图形桌面(服务器、NAS)时只有终端。
100
101
  - 桌面:走 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 的用户名和登录密码(苹果认证,由服务端登录)。
@@ -193,6 +194,7 @@ agent-loft service install
193
194
  - 暴露到公网时,只通过 HTTPS 反向代理(比如 Lucky)或 Cloudflare Tunnel 访问,并把不在本机的反代 IP 加进 `web.trustedProxies`(只有从这些地址来的连接才采信 `X-Forwarded-*`)。不要直接把 8800 端口映射出去。局域网访问可以在 设置 → 系统 → 网络访问 里关掉。
194
195
  - 远程控制不经过授权卡:拿到终端就是拿到运行 agent-loft 的那个系统用户的 shell,拿到桌面就是坐在登录桌面的那个人面前。所以默认只给管理员,成员要管理员单独开通(开通时会再提醒一次);收回权限、停用或删除用户、在设置里关掉终端 / 桌面时,他开着的 shell 立刻结束、桌面立刻断开。终端和桌面的 WebSocket 和其他接口一样校验登录态和 Origin。shell 拿不到本服务自己的凭据(和 agent 子进程一样剔除环境变量)。共享桌面用的 x11vnc 只听本机、密码每次随机生成、经文件传过去(不出现在命令行里);用「已有的 VNC 服务」时,配置里的 VNC 密码会交给开通了远程控制的人的页面;填了 Mac 用户名走苹果认证时由服务端登录,登录密码不会发到页面(但和 VNC 密码一样明文存在 config.json 里)。
195
196
  - 工作区面板只能操作会话工作目录之内的东西:路径写法跳不出工作目录,符号链接解析后跳不出工作区根目录,敏感文件(私钥、`.env`、云凭据、agent-loft 自己的数据)和 `.git` 目录不显示,读写、新建、改名、删除都不行;有改动的敏感文件只标记,不给 diff 内容。diff 只接受当前改动列表里的文件。面板里的文件操作不经过授权卡,删除不能恢复(有二次确认);删除文件夹会连带里面看不到的隐藏文件、敏感文件和 `.git`。别的会话正在用的工作目录不能在这里删除或改名。因为成员能在工作区任意目录开对话,开通面板约等于能读写整个工作区,所以默认只给管理员。仓库里的配置不可信:调用 git 不经过 shell,并关掉 `core.fsmonitor`、`diff.external`、textconv、钩子和仓库自己定义的 filter,不会执行仓库配置里的程序(包括 `include` 进来的配置);git 子进程拿不到本服务自己的环境变量,也不连网,部分克隆缺的内容不会去懒加载,这种仓库里有些历史 diff 可能看不了;工作树(`core.worktree`)不在工作区之内的仓库不算数,也不会向上找到工作区之外的仓库。提交时只有勾选「运行 Git 钩子」才跑钩子;`.git/config` 里配了签名相关设置时这次提交不签名,只用全局配置的才签名。配了自定义 filter 的仓库(git-crypt 之类)不做快照,面板里也不能暂存、丢弃、提交、切分支,请在终端里操作:不跑 filter 的话,暂存就是把明文写进去。敏感文件不能在面板里暂存、丢弃、提交;嵌在仓库里的另一个仓库也不能在面板里暂存或丢弃。agent 正在这个仓库里干活时,不能丢弃、切分支、撤销一轮。
197
+ - 面板连 Git 远程时只放行 https、http、ssh 地址;仓库 `.git/config` 里有能运行程序或改变连接去向的配置(`credential.*`、`core.sshCommand`、`url.*`、`http.proxy` 等)就拒绝操作。用了 Git LFS 的仓库要勾选运行钩子才能推送,要推送的提交里有敏感文件也会拒绝。
196
198
  - 每轮改动的快照是写进这个仓库 `.git` 里的对象,留在 `refs/agent-loft/t/` 这些引用下,不碰你的工作区、暂存区和分支,也不会出现在 `git branch`、`git log --all` 里;默认的 `git push` 和 `git clone` 不带它们,但 `git push --mirror` 会。敏感文件、超过 20 MB 的文件不进快照;改动和未跟踪的文件超过 5000 个时这一轮不做快照。每个仓库只留最近 200 轮、60 天以内的,更早的记录只保留统计。没开通工作区面板的成员的对话不做快照。
197
199
  - 审批超时一律按拒绝处理。Codex 默认沙箱为 `workspace-write`,不会因为 `~/.codex/config.toml` 里配了 `never` 或 `danger-full-access` 就绕过审批。
198
200
  - agent 子进程拿不到本服务自己的凭据(`FEISHU_*`、`AGENT_LOFT_*` 等环境变量会被剔除)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-loft",
3
- "version": "0.2.96",
3
+ "version": "0.2.98",
4
4
  "type": "module",
5
5
  "description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
6
6
  "keywords": [
@@ -17,6 +17,7 @@ import {
17
17
  createUser,
18
18
  getUser,
19
19
  canUseFiles,
20
+ canUseGitRemote,
20
21
  isAdmin,
21
22
  legacyOwnerId,
22
23
  listUsers,
@@ -492,8 +493,8 @@ function adminOnly(p: string): boolean {
492
493
  );
493
494
  }
494
495
 
495
- function publicMe(user: Pick<User, "id" | "name" | "role" | "disabled" | "files">) {
496
- return { id: user.id, name: user.name, role: user.role, ...(canUseFiles(user) ? { files: true } : {}) };
496
+ function publicMe(user: Pick<User, "id" | "name" | "role" | "disabled" | "files" | "gitRemote">) {
497
+ return { id: user.id, name: user.name, role: user.role, ...(canUseFiles(user) ? { files: true } : {}), ...(canUseGitRemote(user) ? { gitRemote: true } : {}) };
497
498
  }
498
499
 
499
500
  /** users.ts 抛的是给人看的错误,转成 400 */
@@ -1715,11 +1716,11 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1715
1716
  }
1716
1717
  }
1717
1718
  if (p === "/api/users" && method === "POST") {
1718
- const body = await readJsonBody<{ name?: string; password?: string; role?: Role; remote?: boolean; files?: boolean; permissions?: unknown }>(req);
1719
+ const body = await readJsonBody<{ name?: string; password?: string; role?: Role; remote?: boolean; files?: boolean; gitRemote?: boolean; permissions?: unknown }>(req);
1719
1720
  sendJson(
1720
1721
  res,
1721
1722
  200,
1722
- userOp(() => createUser({ name: String(body.name ?? ""), password: String(body.password ?? ""), role: body.role === "admin" ? "admin" : "member", ...(typeof body.remote === "boolean" ? { remote: body.remote } : {}), ...(typeof body.files === "boolean" ? { files: body.files } : {}), ...(body.permissions !== undefined ? { permissions: body.permissions } : {}) })),
1723
+ userOp(() => createUser({ name: String(body.name ?? ""), password: String(body.password ?? ""), role: body.role === "admin" ? "admin" : "member", ...(typeof body.remote === "boolean" ? { remote: body.remote } : {}), ...(typeof body.files === "boolean" ? { files: body.files } : {}), ...(typeof body.gitRemote === "boolean" ? { gitRemote: body.gitRemote } : {}), ...(body.permissions !== undefined ? { permissions: body.permissions } : {}) })),
1723
1724
  );
1724
1725
  return;
1725
1726
  }
@@ -1728,7 +1729,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1728
1729
  const id = userMatch[1]!;
1729
1730
  if (!getUser(id)) throw new HttpError(404, "用户不存在");
1730
1731
  if (method === "PATCH") {
1731
- const body = await readJsonBody<{ name?: string; role?: Role; disabled?: boolean; password?: string; remote?: boolean; files?: boolean; permissions?: unknown }>(req);
1732
+ const body = await readJsonBody<{ name?: string; role?: Role; disabled?: boolean; password?: string; remote?: boolean; files?: boolean; gitRemote?: boolean; permissions?: unknown }>(req);
1732
1733
  if (id === user.id && (body.disabled === true || (body.role !== undefined && body.role !== "admin"))) {
1733
1734
  throw new HttpError(400, "不能停用自己,也不能取消自己的管理员");
1734
1735
  }
@@ -1741,6 +1742,7 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
1741
1742
  ...(typeof body.password === "string" ? { password: body.password } : {}),
1742
1743
  ...(typeof body.remote === "boolean" ? { remote: body.remote } : {}),
1743
1744
  ...(typeof body.files === "boolean" ? { files: body.files } : {}),
1745
+ ...(typeof body.gitRemote === "boolean" ? { gitRemote: body.gitRemote } : {}),
1744
1746
  ...(body.permissions !== undefined ? { permissions: body.permissions } : {}),
1745
1747
  }),
1746
1748
  );
@@ -23,9 +23,9 @@ import { builtinAgentDefaults, setBuiltinAgentDefaults } from "../../core/builti
23
23
  import { hub } from "../../core/hub.js";
24
24
  import { config } from "../../core/config.js";
25
25
  import { shellInfo } from "../../core/servers.js";
26
- import { claudeMachineMcp, createMcp, deleteMcp, getMcp, listMcp, MACHINE_PREFIX, MCP_LIMITS, mcpView, updateMcp, type McpInput } from "../../core/mcp.js";
26
+ import { canUseMcp, claudeMachineMcp, createMcp, deleteMcp, getMcp, listUsableMcp, MACHINE_PREFIX, MCP_LIMITS, mcpView, setMcpUserValues, updateMcp, type McpInput, type McpServer } from "../../core/mcp.js";
27
27
  import { activeSkills } from "../../core/skills.js";
28
- import { isAdmin, type User } from "../../core/users.js";
28
+ import { getUser, isAdmin, type User } from "../../core/users.js";
29
29
  import { HttpError, readJsonBody, sendJson } from "./http.js";
30
30
 
31
31
  const bad = (err: unknown) => (err instanceof HttpError ? err : new HttpError(400, err instanceof Error ? err.message : String(err)));
@@ -91,6 +91,17 @@ async function machineMcp(user: User): Promise<{ claude: string[]; codex: string
91
91
  return { claude: enabled.has("claude") ? Object.keys(claudeMachineMcp()) : [], codex };
92
92
  }
93
93
 
94
+ /** 选工具时列出的 MCP:自己的,加上别人共享的(说明里带上是谁共享的) */
95
+ function mcpChoices(user: User) {
96
+ return listUsableMcp(user.id).map((s: McpServer) => ({
97
+ id: s.id,
98
+ name: s.name,
99
+ description: s.owner === user.id ? s.description : `${getUser(s.owner)?.name ?? "别人"}共享${s.description ? ` · ${s.description}` : ""}`,
100
+ type: s.type,
101
+ ...(s.owner === user.id ? {} : { shared: true }),
102
+ }));
103
+ }
104
+
94
105
  /** 处理了就返回 true */
95
106
  export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse, p: string, user: User): Promise<boolean> {
96
107
  const method = req.method ?? "GET";
@@ -99,7 +110,7 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
99
110
  sendJson(res, 200, {
100
111
  agents: Object.fromEntries(Object.entries(builtinAgentDefaults(user.id)).filter(([id]) => canUseExpert(user.id, id))),
101
112
  skills: activeSkills(user.id).map((s) => ({ id: s.id, name: s.name, description: s.description })),
102
- mcp: listMcp(user.id).map((s) => ({ id: s.id, name: s.name, description: s.description })),
113
+ mcp: mcpChoices(user),
103
114
  ...(await machineMcp(user).then((m) => m ? { machineMcp: m, machinePrefix: MACHINE_PREFIX } : {})),
104
115
  });
105
116
  return true;
@@ -124,7 +135,7 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
124
135
  templates: EXPERT_TEMPLATES.map((t) => ({ id: t.id, label: t.label, expert: t.expert })),
125
136
  access: ACCESS_LEVELS.map((id) => ({ id, label: ACCESS_LABEL[id] })),
126
137
  skills: activeSkills(user.id).map((s) => ({ id: s.id, name: s.name, description: s.description })),
127
- mcp: listMcp(user.id).map((s) => ({ id: s.id, name: s.name, description: s.description, type: s.type })),
138
+ mcp: mcpChoices(user),
128
139
  ...(await machineMcp(user).then((m) => (m ? { machineMcp: m, machinePrefix: MACHINE_PREFIX } : {}))),
129
140
  limits: EXPERT_LIMITS,
130
141
  });
@@ -207,8 +218,10 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
207
218
  if (p === "/api/mcp" && method === "GET") {
208
219
  const experts = availableExperts(user.id);
209
220
  sendJson(res, 200, {
210
- servers: listMcp(user.id).map((s) => ({ ...mcpView(s), usedBy: experts.filter((e) => expertTools(user.id, e).mcp.includes(s.id)).map((e) => e.name) })),
221
+ servers: listUsableMcp(user.id).map((s) => ({ ...mcpView(s, user.id), usedBy: experts.filter((e) => expertTools(user.id, e).mcp.includes(s.id)).map((e) => e.name) })),
211
222
  limits: MCP_LIMITS,
223
+ // 成员不能添加 stdio(会在服务器上执行命令)
224
+ stdio: isAdmin(user),
212
225
  });
213
226
  return true;
214
227
  }
@@ -223,6 +236,20 @@ export async function handleExpertsApi(req: IncomingMessage, res: ServerResponse
223
236
  return true;
224
237
  }
225
238
 
239
+ const mv = /^\/api\/mcp\/(m_[a-f0-9]+)\/values$/.exec(p);
240
+ if (mv && method === "PUT") {
241
+ const server = getMcp(mv[1]!);
242
+ if (!server || server.owner === user.id || !canUseMcp(user.id, server)) throw new HttpError(404, "这个 MCP 不存在");
243
+ const body = await readJsonBody<{ values?: unknown }>(req);
244
+ try {
245
+ setMcpUserValues(user.id, server.id, body.values ?? {});
246
+ } catch (err) {
247
+ throw bad(err);
248
+ }
249
+ sendJson(res, 200, mcpView(server, user.id));
250
+ return true;
251
+ }
252
+
226
253
  const mm = /^\/api\/mcp\/(m_[a-f0-9]+)$/.exec(p);
227
254
  if (mm) {
228
255
  const server = getMcp(mm[1]!);
@@ -1,27 +1,32 @@
1
1
  // 技能页面的接口:/api/skills。看得到的技能(自己的、公开的、指名给自己的)、安装 / 停用、变量、上传。
2
- // 只有作者能改;管理员能删别人公开或分享出来的(下架),但看不到、删不了别人私有的。
2
+ // 只有作者能改;管理员能查看、下架别人公开或分享出来的(包括没指名给他的),但看不到、删不了别人私有的。
3
3
  import fs from "node:fs";
4
4
  import path from "node:path";
5
5
  import type { IncomingMessage, ServerResponse } from "node:http";
6
6
  import { machineSkills } from "../../core/skill-runtime.js";
7
7
  import {
8
+ acceptSkillUpdate,
9
+ allowedHosts,
8
10
  canDelete,
9
11
  canSee,
12
+ canView,
10
13
  createSkill,
11
- declaredHosts,
12
14
  deleteSkill,
15
+ guardedNames,
13
16
  getSkill,
14
17
  installCount,
15
18
  installSkill,
16
19
  listAllSkills,
17
20
  listFiles,
18
21
  parseSkillMd,
22
+ pendingHosts,
19
23
  prepareUpload,
20
24
  readSkillFile,
21
25
  readSkillMd,
22
26
  setSkillEnabled,
23
27
  setSkillVars,
24
28
  SKILL_LIMITS,
29
+ updatePending,
25
30
  updateSkill,
26
31
  userPrefs,
27
32
  type Skill,
@@ -34,6 +39,15 @@ import { HttpError, readJsonBody, sendJson } from "./http.js";
34
39
  function view(s: Skill, user: User) {
35
40
  const prefs = userPrefs(user.id);
36
41
  const mine = s.owner === user.id;
42
+ const installed = mine || prefs.installed.includes(s.id);
43
+ // 受保护的密钥:这个技能能发往哪些地址(用户确认过、技能还声明着的),哪些是作者新加、还没确认的
44
+ const hosts: Record<string, { allowed: string[]; pending: string[] }> = {};
45
+ if (installed) {
46
+ for (const v of s.vars) {
47
+ if (!v.secret || !v.hosts?.length) continue;
48
+ hosts[v.name] = { allowed: allowedHosts(prefs, [s], v.name), pending: pendingHosts(prefs, s, v.name) };
49
+ }
50
+ }
37
51
  return {
38
52
  id: s.id,
39
53
  name: s.name,
@@ -45,38 +59,30 @@ function view(s: Skill, user: User) {
45
59
  // 分享给了谁只有作者看得到
46
60
  ...(mine ? { sharedWith: s.sharedWith, installs: installCount(s.id) } : {}),
47
61
  vars: s.vars,
62
+ hosts,
48
63
  source: s.source,
49
64
  createdAt: s.createdAt,
50
65
  updatedAt: s.updatedAt,
51
- installed: mine || prefs.installed.includes(s.id),
66
+ installed,
67
+ // 管理员能看到没指名给他的分享(为了审查、下架),但装不了
68
+ canInstall: !mine && canSee(user, s),
69
+ // 作者改了内容,确认新版之前不加载
70
+ updatePending: updatePending(user.id, s, prefs),
52
71
  enabled: !prefs.disabled.includes(s.id),
53
72
  canDelete: canDelete({ id: user.id, role: user.role }, s),
54
73
  };
55
74
  }
56
75
 
57
76
  /**
58
- * 变量:值按名字存;密钥(任何一个看得到的技能把它标成密钥)不回显,只说填没填。
59
- * 受保护的密钥再带上确认过的地址(hosts),作者后来加了没确认过的地址就列在 pending 里。
77
+ * 变量:值按名字存;密钥(任何一个看得到的技能把它标成密钥,或者按受保护密钥填的)不回显,只说填没填。
78
+ * 受保护的密钥能发往哪些地址按技能分开,在各技能的 hosts 里。
60
79
  */
61
80
  function varsView(user: User, skills: Skill[]) {
62
- const secret = new Set(skills.flatMap((s) => s.vars.filter((v) => v.secret).map((v) => v.name)));
81
+ const secret = new Set([...skills.flatMap((s) => s.vars.filter((v) => v.secret).map((v) => v.name)), ...guardedNames(user.id)]);
82
+ const guarded = guardedNames(user.id);
63
83
  const prefs = userPrefs(user.id);
64
- const mineOrInstalled = skills.filter((s) => s.owner === user.id || prefs.installed.includes(s.id));
65
84
  return Object.fromEntries(
66
- Object.entries(prefs.vars).map(([k, v]) => {
67
- const declared = declaredHosts(mineOrInstalled, k);
68
- const approved = prefs.approved[k] ?? [];
69
- const pending = declared.filter((h) => !approved.includes(h));
70
- return [
71
- k,
72
- {
73
- set: true,
74
- ...(secret.has(k) ? {} : { value: v }),
75
- ...(declared.length ? { hosts: approved } : {}),
76
- ...(pending.length ? { pending } : {}),
77
- },
78
- ];
79
- }),
85
+ Object.entries(prefs.vars).map(([k, v]) => [k, { set: true, ...(secret.has(k) ? {} : { value: v }), ...(guarded.has(k) ? { guarded: true } : {}) }]),
80
86
  );
81
87
  }
82
88
 
@@ -105,7 +111,7 @@ export async function handleSkillsApi(req: IncomingMessage, res: ServerResponse,
105
111
  const viewer = { id: user.id, role: user.role };
106
112
 
107
113
  if (p === "/api/skills" && method === "GET") {
108
- const visible = listAllSkills().filter((s) => canSee(viewer, s));
114
+ const visible = listAllSkills().filter((s) => canView(viewer, s));
109
115
  sendJson(res, 200, {
110
116
  skills: visible.map((s) => view(s, user)),
111
117
  vars: varsView(user, visible),
@@ -135,13 +141,13 @@ export async function handleSkillsApi(req: IncomingMessage, res: ServerResponse,
135
141
  }
136
142
 
137
143
  if (p === "/api/skills/vars" && method === "PUT") {
138
- const body = await readJsonBody<{ values?: Record<string, unknown>; approve?: unknown }>(req);
144
+ const body = await readJsonBody<{ values?: Record<string, unknown>; approve?: unknown; skill?: unknown }>(req);
139
145
  try {
140
- setSkillVars(user.id, body.values ?? {}, Array.isArray(body.approve) ? body.approve.map(String) : []);
146
+ setSkillVars(user.id, body.values ?? {}, Array.isArray(body.approve) ? body.approve.map(String) : [], typeof body.skill === "string" ? body.skill : undefined);
141
147
  } catch (err) {
142
148
  throw bad(err);
143
149
  }
144
- sendJson(res, 200, { vars: varsView(user, listAllSkills().filter((s) => canSee(viewer, s))) });
150
+ sendJson(res, 200, { vars: varsView(user, listAllSkills().filter((s) => canView(viewer, s))) });
145
151
  return true;
146
152
  }
147
153
 
@@ -159,10 +165,10 @@ export async function handleSkillsApi(req: IncomingMessage, res: ServerResponse,
159
165
  return true;
160
166
  }
161
167
 
162
- const m = /^\/api\/skills\/(s_[a-f0-9]+)(?:\/(install|enable|file))?$/.exec(p);
168
+ const m = /^\/api\/skills\/(s_[a-f0-9]+)(?:\/(install|enable|file|accept))?$/.exec(p);
163
169
  if (!m) return false;
164
170
  const skill = getSkill(m[1]!);
165
- if (!skill || !canSee(viewer, skill)) throw new HttpError(404, "这个技能不存在");
171
+ if (!skill || !canView(viewer, skill)) throw new HttpError(404, "这个技能不存在");
166
172
 
167
173
  if (!m[2] && method === "GET") {
168
174
  const md = parseSkillMd(readSkillMd(skill.id));
@@ -187,6 +193,15 @@ export async function handleSkillsApi(req: IncomingMessage, res: ServerResponse,
187
193
  sendJson(res, 200, view(skill, user));
188
194
  return true;
189
195
  }
196
+ if (m[2] === "accept" && method === "POST") {
197
+ try {
198
+ acceptSkillUpdate(user.id, skill.id);
199
+ } catch (err) {
200
+ throw bad(err);
201
+ }
202
+ sendJson(res, 200, view(skill, user));
203
+ return true;
204
+ }
190
205
  if (m[2] === "enable" && method === "POST") {
191
206
  const body = await readJsonBody<{ on?: boolean }>(req);
192
207
  setSkillEnabled(user.id, skill.id, body.on !== false);
@@ -14,6 +14,9 @@ import {
14
14
  gitCreateBranch,
15
15
  gitDiff,
16
16
  gitDiscard,
17
+ gitFetch,
18
+ gitPull,
19
+ gitPush,
17
20
  GitError,
18
21
  gitLog,
19
22
  gitStage,
@@ -24,7 +27,7 @@ import {
24
27
  import { hub } from "../../core/hub.js";
25
28
  import { revertTurn, turnFileDiff, turnState } from "../../core/turn-changes.js";
26
29
  import { listConversations, type Conversation } from "../../core/store.js";
27
- import { canUseFiles, type User } from "../../core/users.js";
30
+ import { canUseFiles, canUseGitRemote, type User } from "../../core/users.js";
28
31
  import {
29
32
  createWorkspaceEntry,
30
33
  deleteWorkspaceEntry,
@@ -62,6 +65,9 @@ const ROUTES: Record<string, string> = {
62
65
  "git-commit": "POST",
63
66
  "git-switch": "POST",
64
67
  "git-branch-new": "POST",
68
+ "git-fetch": "POST",
69
+ "git-pull": "POST",
70
+ "git-push": "POST",
65
71
  "git-turn-revert": "POST",
66
72
  "workspace-save": "POST",
67
73
  "workspace-new": "POST",
@@ -203,13 +209,20 @@ export async function handleWorkspaceApi(req: IncomingMessage, res: ServerRespon
203
209
  return true;
204
210
  }
205
211
  if (req.method === "POST") {
212
+ if ((sub === "git-fetch" || sub === "git-pull" || sub === "git-push") && !canUseGitRemote(user)) {
213
+ throw new HttpError(403, "你没有连接 Git 远程的权限,找管理员在 设置 → 用户 里开通");
214
+ }
206
215
  const body = await readJsonBody<{ paths?: unknown; message?: unknown; hooks?: unknown; branch?: unknown; name?: unknown; id?: unknown; direction?: unknown; force?: unknown }>(req);
207
216
  const root = repo.root;
208
217
  await gitAction(res, async () => {
209
218
  if (sub === "git-stage") return gitStage(root, body.paths);
210
219
  if (sub === "git-unstage") return gitUnstage(root, body.paths);
211
220
  if (sub === "git-commit") return gitCommit(root, body.message, { hooks: body.hooks === true });
221
+ // 获取和推送不动工作区,agent 干活时也能做
222
+ if (sub === "git-fetch") return gitFetch(root);
223
+ if (sub === "git-push") return gitPush(root, { hooks: body.hooks === true });
212
224
  assertIdle(root);
225
+ if (sub === "git-pull") return gitPull(root);
213
226
  if (sub === "git-discard") return gitDiscard(root, body.paths);
214
227
  if (sub === "git-switch") return gitSwitch(root, body.branch);
215
228
  if (sub === "git-branch-new") return gitCreateBranch(root, body.name);
@@ -3,7 +3,7 @@ import path from "node:path";
3
3
  import { EventEmitter } from "node:events";
4
4
  import { dataDir, readJson, writeJsonAtomic } from "../home.js";
5
5
  import { ENGINES, resolveMcp, type Engine } from "./experts.js";
6
- import { getMcp, isMachineId, machineName } from "./mcp.js";
6
+ import { canUseMcp, getMcp, isMachineId, machineName } from "./mcp.js";
7
7
  import { activeSkills } from "./skills.js";
8
8
  import { sessionSkills } from "./skill-runtime.js";
9
9
  import { getUser } from "./users.js";
@@ -64,7 +64,7 @@ export function setBuiltinAgentDefaults(owner: string, patch: unknown): Defaults
64
64
  for (const id of ids ?? []) {
65
65
  const server = getMcp(id);
66
66
  const name = isMachineId(id) ? machineName(id) : server?.name;
67
- if (isMachineId(id) ? user.role !== "admin" || !name || !/^[A-Za-z0-9_-]{1,100}$/.test(name) : !server || server.owner !== owner) throw new Error("只能选择自己的 MCP(机器 MCP 仅管理员可选)");
67
+ if (isMachineId(id) ? user.role !== "admin" || !name || !/^[A-Za-z0-9_-]{1,100}$/.test(name) : !canUseMcp(owner, server)) throw new Error("只能选择自己的或别人共享的 MCP(机器 MCP 仅管理员可选)");
68
68
  if (names.has(name!)) throw new Error(`MCP 服务名重复:${name}`);
69
69
  names.add(name!);
70
70
  }
@@ -12,7 +12,7 @@ import fs from "node:fs";
12
12
  import path from "node:path";
13
13
  import { dataDir, readJson, writeJsonAtomic } from "../home.js";
14
14
  import { resolveWorkspacePath } from "./config.js";
15
- import { claudeMachineMcp, getMcp, isMachineId, machineName, specOf, type McpSpec } from "./mcp.js";
15
+ import { canUseMcp, claudeMachineMcp, getMcp, isMachineId, machineName, specOf, type McpSpec } from "./mcp.js";
16
16
  import { activeSkills, canSee, getSkill } from "./skills.js";
17
17
  import { canUseResource, getUser } from "./users.js";
18
18
 
@@ -205,11 +205,18 @@ export function canUseExpert(owner: string | undefined, id: string): boolean {
205
205
  return e.shared === true && !!creator && !creator.disabled && canUseResource(user, "experts", id);
206
206
  }
207
207
 
208
- /** 发布者沿用专家原有的工具选择;其他人未配置时不加载技能和 MCP。 */
208
+ /**
209
+ * 发布者沿用专家原有的工具选择。其他人自己配过就用自己的;没配过就沿用发布者选的里面他也能用的:
210
+ * 他自己启用着的技能(装了发布者共享的技能才算),发布者共享出来的 MCP(调用前会问,密钥用他自己的)。
211
+ * 发布者私有的 MCP、机器上的 MCP 不会带给别人。
212
+ */
209
213
  export function expertTools(owner: string, expert: Expert): ExpertTools {
210
214
  if (!canUseExpert(owner, expert.id)) throw new Error("这个专家不存在或已取消共享");
211
215
  if (expert.owner === owner) return { skills: expert.skills, mcp: expert.mcp };
212
- return readJson<PersonalTools>(toolsPath, {})[owner]?.[expert.id] ?? { skills: [], mcp: [] };
216
+ const own = readJson<PersonalTools>(toolsPath, {})[owner]?.[expert.id];
217
+ if (own) return own;
218
+ const active = new Set(activeSkills(owner).map((s) => s.id));
219
+ return { skills: expert.skills.filter((id) => active.has(id)), mcp: expert.mcp.filter((id) => !isMachineId(id) && canUseMcp(owner, id)) };
213
220
  }
214
221
 
215
222
  export function setExpertTools(owner: string, id: string, input: unknown): ExpertTools {
@@ -229,7 +236,7 @@ export function setExpertTools(owner: string, id: string, input: unknown): Exper
229
236
  for (const id of next.mcp) {
230
237
  const server = getMcp(id);
231
238
  const name = isMachineId(id) ? machineName(id) : server?.name;
232
- if (isMachineId(id) ? !admin || !name || !/^[A-Za-z0-9_-]{1,100}$/.test(name) : !server || server.owner !== owner) throw new Error("只能选择自己的 MCP(机器 MCP 仅管理员可选)");
239
+ if (isMachineId(id) ? !admin || !name || !/^[A-Za-z0-9_-]{1,100}$/.test(name) : !canUseMcp(owner, server)) throw new Error("只能选择自己的或别人共享的 MCP(机器 MCP 仅管理员可选)");
233
240
  if (names.has(name!)) throw new Error(`MCP 服务名重复:${name}`);
234
241
  names.add(name!);
235
242
  }
@@ -309,8 +316,8 @@ function validate(owner: string, input: ExpertInput, prev?: Expert, selfId?: str
309
316
  return !!s && canSee({ id: owner }, s);
310
317
  });
311
318
 
312
- // MCP:自己的;机器上的只有管理员能选
313
- const mcp = ids(pick("mcp")).filter((id) => (isMachineId(id) ? admin && machineName(id).length > 0 : getMcp(id)?.owner === owner));
319
+ // MCP:自己的和别人共享的;机器上的只有管理员能选
320
+ const mcp = ids(pick("mcp")).filter((id) => (isMachineId(id) ? admin && machineName(id).length > 0 : canUseMcp(owner, id)));
314
321
 
315
322
  // 子智能体:自己的 Claude 专家,权限不能比自己高,不能是自己
316
323
  const subRaw = engine === "claude" ? ids(pick("subagents")) : [];
@@ -473,10 +480,12 @@ export function resolveMcp(expert: Pick<Expert, "owner" | "engine" | "mcp">, adm
473
480
  else if (claudeMachine[name]) mcp[name] = claudeMachine[name]!;
474
481
  continue;
475
482
  }
483
+ // expert.owner 在这里是用这个专家的人(见 expertRuntime)
476
484
  const s = getMcp(id);
477
- if (!s || s.owner !== expert.owner) continue;
478
- mcp[s.name] = specOf(s);
479
- if (s.ask) ask.push(s.name);
485
+ if (!s || !canUseMcp(expert.owner, s)) continue;
486
+ mcp[s.name] = specOf(s, expert.owner);
487
+ // 别人共享的:调用前一律先问
488
+ if (s.ask || s.owner !== expert.owner) ask.push(s.name);
480
489
  }
481
490
  return { mcp, ask, machine };
482
491
  }