开源架构 Agent Chronos Arch 迭代笔记(三):全局接口层与类的引入

Agent Chronos Arch Agent Harness 开源 架构
开源架构 Agent Chronos Arch 迭代笔记(三):全局接口层与类的引入

仓库地址:repo

0. 什么是这次升级的核心

MVP 0.4 的关键升级是:在 JSON PRD 与树分解之间增加一层全局接口层。目标很明确:统一全局状态操作口径,切断叶子节点无约束直接改状态的路径。

1. 原问题:状态操作语义分裂

在 MVP 0.3.x 中,叶子节点虽然声明了状态操作,但运行时仍出现两类严重问题:

  • 不同节点对同一数据源结构理解不一致
  • 节点通过 global 直接修改状态,入口分散且不可治理

这会在代码拼接后触发运行时冲突,破坏树结构边界。

2. 方案:全局接口层前置治理

全局接口层在树分解前完成三件事:

  1. 全局数据源技术选型与结构定型
  2. 统一读写接口定义与固化
  3. 将授权接口按需下发给叶子节点

同时在验证阶段增加规则:出现 global 直接拒绝,强制重生成为接口调用式实现。

全局接口层

3. 三个关键收益

3.1 状态治理口径统一

所有叶子节点只能走统一接口,避免同源多义和硬编码分叉。

3.2 外部 API 治理纳入同一抽象

外部 API 可以等价抽象为“远程数据源”,同样纳入统一接口与授权治理。

API 抽象为数据源

3.3 类与领域模型开始落地

引入接口层后,状态承载可以更自然地和类模型结合,领域概念不再只能停留在函数拼装层。

类与状态融合

4. 仍待解决的问题

  • 当前接口类型偏基础,复杂业务能力不足
  • 分解中后期新发现需求可能冲击前置定型结构

后续方向是:在统一治理前提下,让接口能力从分解过程自然生长,而不是一次性静态写死。