Cate连接编辑器实战把文件实时共享给终端与编程Agent的机制与冲突处理详解【免费下载链接】cateAn infinite zoomable canvas for coding. Editor, terminal, and browser panels in a spatial workspace.项目地址: https://gitcode.com/gh_mirrors/cate5/cate**Cate 连接编辑器Connected Editors**是 Cate 这款无限画布代码工作区中最实用的协作能力之一把编辑器面板连接到终端或编程 Agent 后你的文件改动会实时同步给 AgentAgent 写回磁盘的内容也会即时出现在编辑器里双方通过真实文件共享同一个工作副本并内置完整的冲突处理机制。本文带你从新手视角理解它的工作原理。一、什么是 Cate 的连接编辑器Cate 把编辑器、终端、浏览器、Agent 面板都做成画布上的面板用连线把它们组织成空间化的工作区当你把一个编辑器面板与终端或 T3编程 Agent面板连出去outgoing connection时这个编辑器就进入了连接编辑器状态。此时 Agent 不再需要专门的读取编辑器内容指令——它直接用平常的文件系统工具读写这个文件即可。官方文档对这一行为有明确约定Cate CLI 不提供编辑器内容命令Agent 读写的是与编辑器共享的普通工作文件。 —— docs/connected-editors.md连接类型use / context / verify / trigger在 src/shared/panelRelations.ts 中定义只有terminal和agent这类执行面板execution surface才会触发文件共享逻辑判断见 src/shared/panelRelations.ts。二、共享机制详解编辑器如何变成 Agent 的工作文件1. 未命名文档自动落地为持久化草稿如果你在未命名Untitled编辑器里输入内容连接时 Cate 会自动把它物化为项目中的持久化文件路径.cate/drafts/document-id.mdUUID 命名标题保持不变编辑器继续停留在源码模式草稿可跨会话恢复因为常规工作区文件监听会排除隐藏目录Cate 为草稿目录单独建立了监听器草稿路径规则定义在 src/shared/editorDraft.tse2e 测试 e2e/connected-editors.spec.ts 验证了未命名与已打开文件两种场景下共享真实文件的行为。2. 已打开文件原地共享不移动已打开的文本文件保持原路径不变编辑器与 Agent 直接共享该文件。3. 300ms 自动保存 Shared with agent 指示器连接状态下本地编辑在300ms 后自动保存到磁盘编辑器标题栏出现 Shared with agent 指示断开连接即停止自动保存图片、PDF、DOCX 等预览类文件被排除在自动保存之外自动保存由同步器驱动src/renderer/lib/editor/connectedEditors.ts 中的startConnectedEditorSync()会在每个窗口即使编辑器视图已卸载持续追踪处于连接中的文档并标记为 shared。4. 提交前强制 flush保证 Agent 看到最新内容终端提交可发送的提示词、T3 提交提示词之前都会先 flush 掉所有待保存的编辑若存在冲突或保存失败提交流程会被阻断直到用户在编辑器中解决后重试。入口见 src/renderer/lib/agent/panelRelationPrompt.ts 与 src/renderer/lib/editor/connectedEditors.ts。 连接的 Next / Always / Off 设置只控制提示词上下文的注入与文件同步互不影响——你可以只共享文件而不把面板内容塞进提示词。三、双向同步与冲突处理核心机制这是连接编辑器最见功力的部分。外部写入另一个编辑器、git checkout、或 Agent 写盘通过工作区文件监听到达打开的缓冲区时src/renderer/lib/editor/externalConflict.ts 按以下规则路由编辑器状态外部事件Cate 的处理干净无未保存编辑文件被修改静默重载磁盘内容实时刷新有未保存编辑文件被修改弹出冲突 UI两个版本都不丢弃任意状态文件被删除弹出删除冲突保存则重建文件关闭则真正丢弃即使你手动保存时也有一道覆盖守卫只有当磁盘版本相对基线确实变了且与缓冲区不同时才阻止写入避免误伤src/renderer/lib/editor/externalConflict.ts。冲突界面背后是一个无依赖的行级三向合并器以加载时的基线为共同祖先分别对比你的缓冲区与磁盘Agent版本——不同区域的修改自动合并保留双方编辑重叠区域的冲突以 git 风格冲突标记呈现、交由你手工裁决src/renderer/lib/editor/threeWayMerge.ts。典型协作流就是这样你写了一半 → Agent 同时改了同文件的另一处 → 三方合并把两处修改都保留下来只有真正撞车的那几行才需要你选边或改写任何一方的工作都不会被静默覆盖。四、草稿转正Save As 的讲究未命名草稿想转正使用Save As对草稿来说也是 Cmd/CtrlS选择正式位置面板的文件身份随之更新旧草稿文件保留作为恢复数据不会自动删除已经在用旧路径的 Agent 不会被重定向但后续开启的上下文会标注新路径五、边界连接编辑器不做什么为避免误解官方文档特别划清了边界docs/connected-editors.md❌ 不会替你执行连线代表的动作❌ 不会自动发送任务❌ 不会编排 Agent 的工作流——何时行动、何时使用cate agent send决定权始终在 Agent和你手里连接编辑器只做一件事让人和 Agent 的同一份文件永远保持可信同步。六、相关源码索引功能文档docs/connected-editors.md连接同步与 flushsrc/renderer/lib/editor/connectedEditors.ts编辑器文档生命周期src/renderer/lib/editor/editorDocuments.ts草稿路径规则src/shared/editorDraft.ts冲突路由与覆盖守卫src/renderer/lib/editor/externalConflict.ts行级三向合并src/renderer/lib/editor/threeWayMerge.ts提示词上下文注入src/renderer/lib/agent/panelRelationPrompt.ts总结Cate 连接编辑器的设计哲学可以概括为三点文件即接口Agent 用原生文件工具无需特殊命令、同步不阻塞300ms 自动保存 静默重载、冲突不丢失三向合并 双向保留。对于希望让编程 Agent 与人工编辑安全并行的新手来说理解这套机制比掌握任何命令都重要——它决定了你和 Agent 协作时到底谁的工作更可能被悄悄覆盖。【免费下载链接】cateAn infinite zoomable canvas for coding. Editor, terminal, and browser panels in a spatial workspace.项目地址: https://gitcode.com/gh_mirrors/cate5/cate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考