进阶 jean.build 2026-10-18 10:33:18 · 25 阅读

第9章 项目链接:让 AI Agent 跨仓库共享上下文

项目链接 让关联仓库共享上下文,使 Agent 能够跨越项目边界读取信息,无需复制粘贴。 许多任务横跨多个仓库。 项目链接是 Jean 告诉 Agent 两个或多个项目同属一组的方式,从而实现上下文在它们之间的自动流动,无需手动配置。 链接的作用 当一个项目与其他项目建立链接时,该项目中的会话将获得: * 对每个链接项目目录的读取权限 * 一条注入的提示,要求检查每个链接项目中的 CLAUDE.md、AGENTS.md 或 docs/ * 在已保存上下文面板中专属的“链接项目上下文”板块

Agent 可以读取链接项目中的文件,但不能写入。写入操作仅限于当前工作树(worktree)。 默认双向 将项目 A 链接到项目 B 时,B 也会反向链接到 A。 Jean 保持这种关系的对称性,以免出现单向连接并导致状态悄悄漂移。 打开链接项目对话框 魔法菜单(Magic Menu)提供了入口: * 按 Cmd+M(或 Ctrl+M)打开魔法菜单 * 选择“链接项目”(快捷键 K)

在那里你可以搜索其他项目、建立链接或移除现有链接。 仅实际项目可被链接,文件夹不可链接。 后端机制 在底层,Jean 通过 --add-dir 参数将每个链接项目的目录传递给 Claude CLI。 它还注入了一小段系统提示片段,列出链接的目录,并提示模型检查其中的指令和文档。 这意味着跨项目读取是自动可用的,无需通过特殊命令触发。 何时链接 在以下情况请链接项目: * 应用及其文档位于不同的仓库 * 前端和后端就共享类型或契约进行协调 * 一个 monorepo 被拆分但仍作为单一产品运作 * 共享的 SDK 或库定义的類型在其他地方被消费

不要链接那些只是位置邻近但毫无交集的项目。链接的项目越多,Agent 在每次请求时需要过滤的上下文就越多。 跨链接的保存上下文 保存的上下文快照感知链接关系。 在聊天界面中,来自链接项目的上下文显示在“链接项目上下文”标题下,便于在将先前状态附加到新会话时轻松找到。 后续阅读 魔法命令 后端、模型和 MCP 项目、工作树和会话 后端、模型和 MCP Jean 如何选择后端、路由模型设置,以及将额外工具引入会话。 项目画布和聊天 在画布、会话标签页、终端、文件和快捷键之间切换,同时保持工作脉络的清晰。

评论 (0)