11-directory-structure.md 4.87 KB

11. 项目目录结构

lemonboss/
├── packages/
│   ├── acp-core/                # ACP 通讯协议核心(复用)
│   │   ├── protocols/
│   │   ├── transports/
│   │   └── launchers/
│   │
│   ├── agent-core/              # Agent 原子模型核心
│   │   ├── Agent.js             # Agent 基类
│   │   ├── SubAgent.js          # SubAgent 子类
│   │   ├── RoleAgent.js         # RoleAgent 子类
│   │   ├── BossAgent.js         # BossAgent 子类
│   │   ├── modules/
│   │   │   ├── PerceptionModule.js
│   │   │   ├── ReasoningModule.js
│   │   │   ├── ExecutionModule.js
│   │   │   ├── FeedbackModule.js
│   │   │   └── ReflectionModule.js   # v1.1: 含分层反思策略
│   │   ├── tools/                     # v1.1 新增
│   │   │   └── BossMetaTools.js       # BossAgent 元操作工具
│   │   └── index.js
│   │
│   ├── loop-engine/             # Agentic Loop 引擎
│   │   ├── LoopEngine.js        # 通用循环引擎
│   │   ├── BossLoop.js          # BossAgent 专用循环
│   │   ├── RoleLoop.js          # RoleAgent 专用循环
│   │   └── SubLoop.js           # SubAgent 专用循环
│   │
│   ├── memory/                  # 记忆系统
│   │   ├── ShortTermMemory.js
│   │   ├── LongTermMemory.js
│   │   ├── SessionMemory.js
│   │   └── MemoryManager.js
│   │
│   ├── gateway/                 # IM 网关
│   │   ├── GatewayAdapter.js    # 抽象接口
│   │   ├── FeishuGateway.js
│   │   ├── WhatsAppGateway.js
│   │   └── DingTalkGateway.js
│   │
│   └── knowledge/               # 知识库引擎
│       ├── DocumentStore.js
│       ├── FTSSearchEngine.js
│       └── VectorSearchEngine.js
│
├── server/
│   ├── index.js                 # Express 入口
│   ├── routes/
│   │   ├── agent.js             # Agent CRUD API
│   │   ├── boss.js              # BossAgent 管理 API
│   │   ├── loop.js              # Loop 状态 API
│   │   └── gateway.js           # Gateway Webhook 接收
│   ├── services/
│   │   ├── AgentService.js      # Agent 生命周期管理(v1.1: 含动态创建/销毁)
│   │   ├── LoopService.js       # Loop 引擎服务
│   │   ├── CronService.js       # 定时任务服务
│   │   ├── GoalTracker.js       # 目标追踪服务
│   │   └── PipelineRouter.js    # v1.1 新增: Pipeline 流转路由
│   └── src/core/
│       ├── AgentManager.js      # Agent 注册与调度
│       └── SandboxManager.js    # 沙盒进程管理(v1.1: 含 workspace + 资源隔离)
│
├── web/                         # 前端控制面板
│   └── src/views/
│       ├── Dashboard.vue        # 公司运营仪表盘
│       ├── AgentGraph.vue       # Agent 拓扑图
│       ├── GoalTracker.vue      # 目标进度面板
│       └── LogViewer.vue        # 日志查看器
│
├── data/
│   ├── agents/                  # Agent 实例数据 (完全自治微容器)
│   │   ├── innovator-001/       # 独立工作区沙盘实例
│   │   │   ├── agent.md         # 核心占位符身份标识
│   │   │   ├── config.json      # 运行配置
│   │   │   ├── identity.md      # 名称、emoji等基础信息
│   │   │   ├── conversations/   # 该独立Agent的所有历史记忆对话记录
│   │   │   │   └── {convId}/
│   │   │   │       ├── meta.json
│   │   │   │       └── messages.log
│   │   │   ├── logs/
│   │   │   ├── memory/
│   │   │   ├── soul.md
│   │   │   ├── tools.md
│   │   │   ├── workspace/
│   │   │   └── .claude/
│   │   │       └── skills/      # 专属本地工作技能池
│   │   │           ├── main_skill/   # 核心操作指南与流程控制 (SKILL.md)
│   │   │           └── meta_hunt/
│   │   └── master-001/
│   │
│   ├── goals/                   # 目标定义与进度
│   │   └── goal-{id}.json
│   │
│   └── trained_skills/          # 供存放零散任务脚本(非必须存在)
│
├── docs/
│   ├── LEMONBOSS-SYSTEM-DESIGN.md  # 主索引
│   └── system-design/              # 分章节子文档
│       ├── 01-vision.md
│       ├── 02-agent-architecture.md
│       ├── ...
│       └── 13-appendix.md
│
├── CLAUDE.md
├── package.json
└── pnpm-workspace.yaml