# Dev Mesh

多个 Agent 共享一个 Git 工作区时使用的本地协调层，登记任务与写入范围，并处理范围争用和受管提交。

## Metadata

- HTML: https://glenzli.com/projects/dev-mesh/
- Markdown: https://glenzli.com/projects/dev-mesh.md
- Collection: Projects
- Language: zh-CN
- Published: 2026-08-17
- Updated: 2026-08-29
- Status: active
- Tags: multi-agent, coordination, git, shared-workspace, contention

## Content

Dev Mesh 用于多个 Agent 在同一个 Git 工作区内并行工作。Agent 在写入前登记任务和修改范围；范围重叠时，Dev Mesh 协调等待、交接或隔离处理；提交通过受管 Git 操作串行执行。

状态保存在工作区的 `.dev-mesh/` 中，不依赖远程服务。

  ![多个 Agent 在共享 Git 工作区中的协作关系](/images/projects/dev-mesh-banner.webp)

## 工作模型

    **Run**
    一个 Agent 任务在当前工作区中的执行身份。

    **Claim**
    该 Run 计划修改的路径和语义范围。

    **Work Result**
    工作实际产生修改时记录完成结果，并释放对应 Claim。

    **Contention**
    不同 Run 的 Claim 发生重叠，需要等待或明确处理。

```text
检查 -> 加入 Run -> 创建或复用 Claim -> 编辑 -> 验证
     -> 完成 Claim，或通过 Claim 受管提交 -> 离开 Run
```

没有跨 Run 重叠时，流程只包含一个 Run 和一个 Claim。发生重叠时，后到的 Claim 可以等待；交接、独占或短命分支只在需要时使用。

## Console

Observer 只读采集多个工作区的状态，保存到外部 SQLite catalog，并通过本机回环地址提供 Console。Console 展示当前 Run、Claim、争用、交接、恢复状态和跨项目关系。活动争用直接显示参与 Run、声明范围和请求路径；存在可用因果关系时，协作流默认展开。已结束争用和原始事件按需查看。

  ![使用虚拟数据的 Dev Mesh Console 争用工作台](/images/projects/dev-mesh-contention-workbench-zh.png)
  示例使用虚拟数据展示争用工作台和协作流，不是生产活动截图。

## 边界

消息发送和任务唤醒由宿主环境执行；Dev Mesh 可以记录已经发生的通信和交接。

当前写入合同是 `dev-mesh.coordination@20260823.1`。工作区当前状态决定权限；Events、Observer 和 Console 只用于诊断。Dev Mesh 通过 Glenzli Marketplace 作为 Codex 插件发布，包含协调与只读观察两个 Skills。