Skip to content

architecture.md

Latest commit

 

History

History
73 lines (53 loc) · 2.15 KB

architecture.md

File metadata and controls

73 lines (53 loc) · 2.15 KB
Raw

架构与数据流

1. 分层架构

分层架构：User/IDE → Orchestration → Harness → Model → Environment

2. 单次 Turn 的数据流

sequenceDiagram
    participant U as User
    participant H as Harness
    participant M as Model
    participant E as Environment

    U->>H: 消息 + 附件 + @上下文
    H->>H: Rules/Skills/Memory/RAG 组装
    H->>M: messages + tool schemas
    M->>H: 文本 或 tool_calls
    alt 需要工具
        H->>E: 执行 CLI/MCP/内置工具
        E->>H: 结果
        H->>M: tool result 消息
    end
    M->>H: 最终回复
    H->>U: 展示 + 可选 hooks
Loading

3. 各层职责边界

组件 输入 输出 不应做
Model messages 文本 / tool_calls JSON 直接改磁盘（无 Harness）
Context Eng. 全量信息源 裁剪后的 messages 替代业务逻辑执行
RAG 查询 文档片段 保证 100% 正确（需验证）
Tools/MCP 调用参数 结构化结果 无界访问生产（需 Sandbox）
Orchestration 大任务 子任务 + 汇总 隐藏失败原因

4. Harness 组合模式

4.1 管道式（Retrieve → Reason → Act）

检索与规则先注入上下文 → Model 规划 → 工具执行 → 结果写回。

4.2 循环式（ReAct）

Reason 与 Act 交替，直到停止条件；Harness 负责工具超时、重试、日志。

4.3 扇出式（Orchestration）

主 Agent 分解任务，子 Agent 各带精简 Harness（只读探索、shell 专精等）。

5. 失败模式与归属

现象 优先怀疑层
答非所问 Context / Prompt
幻觉事实 RAG 未接入或检索失败
不遵守格式 Rules / Prompt
命令执行失败 CLI / Sandbox 权限
外部 API 错误 MCP / Tools 契约
子任务丢失 Orchestration

6. 演进路径

  1. MVP：Prompt + CLI + 基础 Tools
  2. 团队化：Rules + Skills + MCP
  3. 规模化：RAG + Memory + Orchestration + Evaluation
  4. 生产化：Sandbox 策略 + Hooks 审计 + 回归基准

返回：README