青山文档

1.1

软件介绍

了解青山解决什么问题,以及 Change、Evidence 和 Human Accept 如何组成一条可信的工作主线。

什么是青山

青山是一款 local-first 的 Change 执行工作台,服务于人和已经在使用的编程 Agent。它把改变的意图、隔离工作区、Agent Sessions、观察到的 Evidence 与人的决定留在同一个项目现场里。

产品的核心对象是 Change。一次 Change 从经过复核的 Draft 进入受控执行;只有人明确接受了准确的 Candidate,它才会成为 Done。

解决什么问题

  • 工作散落在对话里:对话结束或更换 Agent 后,很难恢复当时为什么这样做。
  • 并行执行互相踩踏:多个 Agent 可能在不知情时写入同一个源码目录。
  • 把“完成”误当成成立:Agent 的完成声明或一次检查通过,不等于准确结果已经有依据。
  • 人在错误的时机被打断:人的注意力应该留给授权和判断,而不是维持每一步执行。

核心能力

01

独立每一次 Change

青山在 .sdable/worktree/ 下分配受管理的独立 worktree。一次 Change 的工作不会与源码主目录或其他 Change 混在一起。

02

协调多个 Agent

多个 Session 可以并行读取和思考;受 fencing 保护的 WriterLease 决定谁可以写入当前工作区。

03

让 Evidence 对准结果

Evidence 绑定准确的 Requirement 与 Candidate basis。basis 一旦变化,旧观察不会被静默算到新结果上。

04

把接受留给人

Ready 表示 Candidate 与所需 Evidence 已可检查。Done 还需要显式 Human Accept 和受控集成成功。

当前边界

当前产品边界是 Local。

当前 construction slice 已有项目接入、可移除管理、Draft Change、受管理 worktree,以及 Core 和桌面端的接受与清理路径。Docker Sandboxes 是当前执行 Runtime。Provider transport、语义 delta 编辑与运行中应用的视觉验收仍是发布边界。

文档只陈述已经核对的产品边界;尚未发布的能力会明确标注。

最后更新:2026-08-12
下载