# LemonBoss — 企业运营 Agentic Loop 框架

## 系统设计文档 v1.2

> **One-liner**: 构建一个 "道-法-术-器" 四层虚拟公司多智能体运营系统。Master 对齐人类意图，CXO 制衡决策，Role 专业执行，Skill 原子产出。每层独立 Loop，四级联动形成飞轮。

---

## 架构全景

```
┌─────────────────────────────────────────────────────────────────────┐
│                          LemonBoss 框架层                            │
│   提供: Agent 生命周期 / Loop 引擎 / 四层调度 / 沙盒 / 通讯         │
│   不管: Agent 内部怎么实现业务逻辑                                   │
│                                                                     │
│          ┌──────────────┐                                           │
│          │    Master    │  ← 道: 御前 — 人机共识，意图对齐            │
│          └──────┬───────┘                                           │
│                 │                                                    │
│     ┌───────────┼───────────┐                                       │
│     │           │           │                                       │
│  ┌──▼───┐  ┌───▼───┐  ┌───▼───┐                                   │
│  │ CEO  │  │  CTO  │  │  COO  │  ← 法: 三省 — 战略决策，制衡审核    │
│  └──┬───┘  └───┬───┘  └───┬───┘                                   │
│     │          │          │                                        │
│  ┌──▼───┐  ┌──▼───┐  ┌──▼───┐                                     │
│  │编剧部│  │开发部 │  │运营部 │  ← 术: 六部 — 领域专业执行           │
│  └──┬───┘  └──┬───┘  └──┬───┘                                     │
│     │         │         │                                          │
│  ┌──▼──┐  ┌──▼──┐  ┌──▼──┐                                       │
│  │Skill│  │Skill│  │Skill│  ← 器: 吏治 — 原子执行，高度可复用       │
│  │ ws/ │  │ ws/ │  │ ws/ │                                        │
│  └─────┘  └─────┘  └─────┘                                       │
│                                                                     │
│  四层 Loop 各自闭环反馈 → 四级联动飞轮                               │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘
```

---

## 文档目录

> 每章为独立文档，位于 `docs/system-design/` 子目录。

### 核心架构

| # | 章节 | 文件 | 概要 |
|---|------|------|------|
| 1 | **系统愿景与核心概念** | [01-vision.md](./system-design/01-vision.md) | 道-法-术-器 哲学框架 + 核心概念 |
| 2 | **四层 Agent 架构** | [02-agent-architecture.md](./system-design/02-agent-architecture.md) | Master(御前) → CXO(三省) → Role(六部) → Skill(吏治) |
| 3 | **Agent 原子模型** | [03-agent-model.md](./system-design/03-agent-model.md) | 目录即实例: 6 大 Bootstrap Files + skills/ + memory/ + workspace/ |
| 4 | **Agentic Loop 循环引擎** | [04-agentic-loop.md](./system-design/04-agentic-loop.md) | 5 阶段循环 + 四层嵌套 |

### v1.2 核心升级

| # | 章节 | 文件 | 概要 |
|---|------|------|------|
| 5 | **分层元能力** | [05-boss-meta-capabilities.md](./system-design/05-boss-meta-capabilities.md) | Master→CXO→Role 逐层管理 + CXO 制衡产出 Pipeline |
| 6 | **Agent 沙盒自治** | [06-sandbox-autonomy.md](./system-design/06-sandbox-autonomy.md) | Workspace 目录 + 资源隔离 |
| 7 | **Agent 间通讯架构** | [07-task-handover.md](./system-design/07-task-handover.md) | 框架中转通讯 + 11 种消息类型 + 三种数据共享 |
| 8 | **自我迭代闭环** | [08-differentiated-reflection.md](./system-design/08-differentiated-reflection.md) | 出生训练(Hunt→Digest→Evolving) + 四级迭代(L1记忆/L2技能/L3上级/L4组织) |

### 实现规格

| # | 章节 | 文件 | 概要 |
|---|------|------|------|
| 9 | **使用流程** | [09-usage-flow.md](./system-design/09-usage-flow.md) | 初始化 + 运行时序 |
| 10 | **运行时架构与并发模型** | [10-runtime-architecture.md](./system-design/10-runtime-architecture.md) | 主进程 + N 子进程 + stdio pipe + ToolInterceptor |
| 11 | **目录结构** | [11-directory-structure.md](./system-design/11-directory-structure.md) | packages / server / web / data 全貌 |
| 12 | **数据模型** | [12-data-model.md](./system-design/12-data-model.md) | 5 张核心表（agent type: master/cxo/role/skill） |
| 13 | **API 设计** | [13-api-design.md](./system-design/13-api-design.md) | REST + SSE + WebSocket 端点 |
| 14 | **里程碑与附录** | [14-milestones.md](./system-design/14-milestones.md) | 迭代计划 + 决策表 + 术语表 |

---

## 版本历史

| 版本 | 日期 | 变更 |
|------|------|------|
| **v1.0** | 2026-03-21 | 初版：三层架构 (Sub/Role/Boss) + 5 阶段 Loop |
| **v1.1** | 2026-03-23 | 新增：元能力、沙盒自治、流转协议、分层反思 |
| **v1.2** | 2026-03-23 | **架构升级**：三层 → 四层 (Master/CXO/Role/Skill)。引入道-法-术-器哲学框架和三省六部治理逻辑。Master 对齐意图，CXO 制衡决策，Role 专业执行，Skill 原子复用。元能力分层分布。 |

---

> 📝 **文档版本**: v1.2
> 📅 **更新日期**: 2026-03-23
> ✍️ **维护者**: LemonBoss Team