Zed 知识库
Zed 可以并行运行 Agent threads、用 Git worktree 隔离任务、逐个审核 edit hunk、恢复 checkpoint,并调用 MCP tools。Busabase 只承接必须跨越这些 thread 留下来的结果,把它们变成有证据、有负责人的已审核记录。
五个编辑器工作面
对话、恢复、代码审核、隔离与共享状态必须分开。
Zed 提供多个执行控制面。它们会在任务中协作,但保留周期与权威等级不同。
| 工作面 | 最适合处理 | 不能替代 |
|---|---|---|
| Agent thread | 推理与 tool trajectory | 持久团队记录 |
| Checkpoint | 回到某条消息之前的文件状态 | 已接受决定 |
| Change review | 保留或拒绝 edit hunk | 跨系统批准 |
| Git worktree | 隔离并发仓库任务 | 运营负责人 |
| Busabase record | 跨项目与系统的已审核状态 | 源码或 thread history |
并行 thread 拓扑
一个项目可以同时存在多条叙事,但同一结论只能有一个当前状态。
每个 Zed thread 都有独立 Agent、context window 与 conversation history。它们可以被摘要、压缩、归档、恢复或放入独立 worktree。只有在产出 thread 与仓库、外部证据对齐后,才提升稳定结论。
功能实现
worktree/feature-a
回归问题排查
worktree/debug
文档更新
main workspace
Edit review 是本地控制
接受一个 hunk 回答的是代码问题,不是组织决策。
Zed review surface 会列出文件与修改行,并允许逐个保留或拒绝 hunk。Checkpoint 可以把代码恢复到某条消息之前。保留这些证据,再单独审核发布就绪、客户影响、迁移状态或支持策略。
修改文件
接受或拒绝的 hunk
Checkpoint 边界
Repository revision
影响结论
证据引用
责任人
生效状态
两个独立门槛
Tool permission 决定动作能否执行,record review 决定结果能否被下游信任。
Zed 可以确认、允许或拒绝内置与 MCP tools,并提供逐 tool 规则和不可覆盖的终端保护。Tool call 成功之后,仍要补充证据与负责人才能修改 canonical state。
这条命令、编辑、fetch 或 MCP tool 可以执行吗?
这个结果可以成为可复用的运营事实吗?
三条 Agent 路径
Native Agent、External Agent 与 Terminal Thread 并不共享一套自动配置。
Zed Agent 直接使用 Zed 配置的 MCP servers;External Agents 可能通过 ACP 接收,也可能读取自身配置;Terminal Threads 使用对应 CLI/TUI 的配置。必须记录实际执行路径,不能假设 tools 与批准策略相同。
| 路径 | MCP / 配置归属 | 应保留证据 |
|---|---|---|
| Zed Agent | Zed settings 与 Agent Profile | Thread、profile、tool calls、revision |
| External Agent | ACP forwarding 与 Agent 原生配置 | Agent 身份、转发 tools、原生 session |
| Terminal Thread | CLI/TUI 配置 | Command、environment、repository revision |
决定封装
让审核者无需打开原始编辑器 session 也能判断结果。
记录把 Zed 执行工件连接到其他项目或 Agent 可以消费的状态。
state_key结论的稳定身份projectZed project 与 repositoryagent_pathZed Agent、External Agent 或 Terminal Threadthread_refThread 或导出 Markdown 引用worktree_revision准确代码状态tool_evidence命令、MCP 响应、测试和 diffproposed_state精简跨系统结果owner对接受负责的人decision接受、有条件接受、拒绝或已替代指令归属
Instructions 与 Skills 影响未来 Agent 行为,不应悄悄变成事实库。
Zed 用个人和项目 instruction files 提供始终生效的指导,用 Skills 保存可复用任务流程。编码规范和工作流留在那里;产品、运营或客户状态进入已审核记录。
AGENTS.md / 项目指令
始终生效的行为与项目指导
SKILL.md
按需加载的可复用任务流程
Busabase
已审核结论、决定与负责人
连接边界
连接指南负责 OAuth 与 context_servers,本页负责交接契约。
远程 MCP server 未配置 Authorization header 时,Zed 会触发标准 OAuth。设置以持续维护的指南为准,再在团队实际使用的 Agent path 与 profile 中测试一次读取和一次待审核提议。
实际问题
Zed 知识库常见问题
Busabase 会取代 Zed thread 吗?
不会。Thread 保存工作对话;Busabase 保存需要跨 thread、项目或 tool 存续的少量已审核结果。
Restore Checkpoint 是批准吗?
不是。它是文件的本地恢复边界,不会接受或拒绝运营结论。
接受所有 diff hunk 就能成为 canonical 吗?
不能。那只是在编辑器中接受修改,共享状态仍需独立证据与负责人。
所有 Zed Agent 路径共用 MCP 配置吗?
不共用。Zed Agent、ACP External Agents 与 Terminal Threads 有不同配置边界。
项目指令适合保存变化中的业务事实吗?
通常不适合。行为指导留在 instructions,变化中的共享事实进入已审核记录。
从一条跨 thread 结论开始
让 Zed 负责编辑体验,让共享状态进入可审核目的地。
选择一项必须超过原始 thread 生命周期的结果,关联 revision、tool evidence 与负责人,再让其他项目或 Agent 使用。

