# 架构总览

## 定位

这是纯个人使用的开发助手与电脑管家。它支持 Project 和 Task 两种并列 Space，并通过 CLI、Web、Desktop 三个客户端访问同一个本地 Runtime。

## 分层

```text
Launcher / Supervisor
        ↓
本地 Runtime（微内核）
        ↓
Adapter / Tool / Hook / Behavior Package
        ↓
Project / Task / System Evolution Profile
        ↓
CLI / Web / Desktop
```

微内核只负责运行规则：本地状态、Run 生命周期、Tool 调用边界、Hook 调度和扩展接缝。它不预先承载具体模型、浏览器、Git、记忆或 Agent 协作策略。

## 扩展边界

- **Adapter**：可替换的底层实现，例如模型供应商、检索或浏览器驱动。
- **Tool**：Agent 主动调用的外部能力，例如文件、Shell、Git、浏览器。
- **Hook**：围绕生命周期做观察、限制或后续动作。
- **Behavior Package**：Agent 的思考、协作和完成方式。
- **Profile**：为 Project、Task、System Evolution 组合默认行为与能力。

## 演化原则

内核可以被修改。Agent 对自身的改动必须发生在隔离 worktree 中，经过测试和 Git 确认后再由 Supervisor 切换版本；失败时能够回退。