LEMONBOSS-SYSTEM-DESIGN.md
8.62 KB
LemonBoss — 企业运营 Agentic Loop 框架
系统设计文档 v2.0
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 | 道-法-术-器 哲学框架 + 核心概念 |
| 2 | 四层 Agent 架构 | 02-agent-architecture.md | Master(御前) → CXO(三省) → Role(六部) → Skill(吏治) |
| 3 | Agent 原子模型 | 03-agent-model.md | 目录即实例: 6 大 Bootstrap Files + skills/ + memory/ + workspace/ |
| 4 | Agentic Loop 循环引擎 | 04-agentic-loop.md | 5 阶段循环 + 四层嵌套 |
v1.2 核心升级
| # | 章节 | 文件 | 概要 |
|---|---|---|---|
| 5 | 分层元能力 | 05-boss-meta-capabilities.md | Master→CXO→Role 逐层管理 + CXO 制衡产出 Pipeline |
| 6 | Agent 沙盒自治 | 06-sandbox-autonomy.md | Workspace 目录 + 资源隔离 |
| 7 | Agent 间通讯架构 | 07-task-handover.md | 框架中转通讯 + 11 种消息类型 + 三种数据共享 |
| 8 | 自我迭代闭环 | 08-differentiated-reflection.md | 出生训练(Hunt→Digest→Evolving) + 四级迭代(L1记忆/L2技能/L3上级/L4组织) |
实现规格
| # | 章节 | 文件 | 概要 |
|---|---|---|---|
| 9 | 使用流程 | 09-usage-flow.md | 初始化 + 运行时序 |
| 10 | 运行时架构与并发模型 | 10-runtime-architecture.md | 主进程 + N 子进程 + stdio pipe + ToolInterceptor |
| 11 | 目录结构 | 11-directory-structure.md | packages / server / web / data 全貌 |
| 12 | 数据模型 | 12-data-model.md | 5 张核心表（agent type: master/cxo/role/skill） |
| 13 | API 设计 | 13-api-design.md | Agent + Company + Goals + Innovator REST API |
| 14 | 里程碑与附录 | 14-milestones.md | 迭代计划 + 决策表 + 术语表（📦 已过时存档，见 docs/todo/future/） |
进阶架构
| # | 章节 | 文件 | 概要 |
|---|---|---|---|
| 15 | Innovator 元 Agent | 15-innovator-meta-agent.md | 第一个手动创建的 Agent，负责创建、训练、交付其他 Agent |
| 16 | Agent 对话架构 | 16-agent-conversation-architecture.md | 两层日志 + 多轮上下文恢复 |
| 17 | Skill 编排与并发 | 17-skill-orchestration-and-concurrency.md | 废除 SQLite 绑定，确立 Local File-System First |
| 18 | 本地文件系统优先 | 18-local-filesystem-first-agent-encapsulation.md | Agent 完全自治架构 v3.5 |
| 19 | 工具隔离机制 | 19-orchestrator-tool-isolation.md | CLI 启动参数层物理剥夺工具权限 |
| 20 | Agent 创建流程 | 20-scaffold-first-agent-creation.md | Scaffold-First 架构 |
| 21 | FDE 训练流水线 | 21-fde-pipeline-architecture.md | Hunt→Digest→Evolving 三层训练架构 (≥ 95 分) |
| 22 | Agent 记忆系统 | 22-agent-memory-system.md | 自动记忆读写 (E2E 27/27 通过) |
| 23 | 主动心跳系统 | 23-agent-active-heartbeat.md | Agent + 公司级心跳监控 (已实现) |
| 24 | 公司层架构 | 24-company-layer-architecture.md | Multi-Tenant 公司实例化 + 招聘系统 + Bootstrap (已实现) |
| 25 | Bootstrap 自举机制 | 25-bootstrap-mechanism.md | 公司创建时自动部署核心骨干团队 |
| 26 | 全自动招聘编排 | 26-automated-hiring-orchestration.md | Creator → Skills → Innovator 训练流水线 |
| 27 | Graph Agent 架构 | 27-graph-agent-architecture.md | Org Graph / Work Graph + System Agent 统一寻址，取代 Template 拷贝模型（⏳ 设计中，见 docs/todo/） |
版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0 | 2026-03-21 | 初版：三层架构 (Sub/Role/Boss) + 5 阶段 Loop |
| v1.1 | 2026-03-23 | 新增：元能力、沙箱自治、流转协议、分层反思 |
| v1.2 | 2026-03-23 | 架构升级：三层 → 四层 (Master/CXO/Role/Skill)。道-法-术-器哲学框架。 |
| v2.0 | 2026-03-26 | Multi-Tenant 重构：Company 层实例化、模板库 + 招聘系统、Bootstrap 自举、SOP Pipeline、心跳系统、前端 Dashboard。目录结构迁移到 system/ + data/{companyId}/。新增章节 15-24。 |
📝 文档版本: v2.0 📅 更新日期: 2026-03-26 ✍️ 维护者: LemonBoss Team