# 对 LemonBoss 现有架构的映射

> 99% 是在现有抽象上加薄薄一层。本页列出每一项能力的对照：REUSE（沿用）/ NEW（新增）/ PATCH（小改）。

## 能力映射总表

| 能力 | 新组件 | 对应现有模块 | 改动 |
| --- | --- | --- | --- |
| Agent 启动与会话复用 | — | `packages/acp-core/protocol/ClaudeCliProtocol.js` + `server/src/core/session-pool.js` | REUSE |
| 多 Agent 调用 facade | — | `server/src/core/agent-manager.js` · `master-session.js` | REUSE |
| 任务 → 步骤拆分 | — | `server/src/tools/orchestrate-tool.js` | REUSE |
| DAG 依赖解析 | — | `server/src/core/scheduler.js` (`getExecutionGroups`) | REUSE |
| Pipeline 描述结构 | — | `server/services/pipeline-service.js` | REUSE · units.json 复用 step 结构 |
| 重试 + 反思 | `retryWithReflection()` 写在 loop-controller.js 内 | 参考 `server/services/evolution-loop.js` (PRAE) 思路，但**不抽公共** | NEW · P5 再考虑合并 |
| ACP / Claude CLI 协议层 | — | `packages/acp-core/` | REUSE |
| Agent 模板注册 | 6 个新模板 | `system/agents/_registry.json` | NEW |
| 三层 Loop 编排 | `LoopController` | `server/src/core/loop-controller.js` | NEW |
| PRD/SDD 文档存储 | `DocStore` | `server/services/doc-store.js` | NEW |
| Unit 状态机 | `UnitRegistry` | `server/services/unit-registry.js` | NEW |
| HTTP / SSE 入口 | `/api/devloop/*` | `server/routes/devloop.js` → 挂在 `server/index.js` | NEW |
| Web 看板 | `DevLoopDashboard.vue` | 放在 `web/src/views/`，复用 `PipelineEditor` DAG 渲染 | NEW |
| 结果持久化根 | — | `data/companies/{cid}/projects/{pid}/` | REUSE · 沿用 company-scoped 文件根 |
| 进程沙箱 / 端口管理 | — | `server/src/engine/process-guard.js` | REUSE |
| WS 流式 | — | `server/routes/claude-chat-ws.js` | REUSE · DevLoop SSE 走 HTTP 复用同套帧 |

## 分层视图

三色块代表三种改动类型；越靠下越基础，越靠上越业务。

<!-- 图见原 HTML -->

> _红 新增 · 灰 复用 · 黄 补丁 · 黑 底层依赖_

## 为什么 P1~P4 不抽公共 retry 函数

EvolutionLoop 当前实现 PRAE (Perceive → Reason & Plan → Execute → Evaluate → Reflect)，里面有「失败 → 反思 → 重试」逻辑。直觉上 L1 可以共用，但**初版决定不抽**：

- **避免回归风险：**EvolutionLoop 跑的是 Skill 进化，目前在生产里运行。动它意味着要把 Skill 进化的回归一起做。
- **反思 prompt 差异大：**Skill 进化的反思是「Skill 评分低，怎么改 prompt」；L1 的反思是「单测失败，代码哪里错」。共用会让 prompt 模板变成「上帝模板」，反而难维护。
- **80 行不算多：**P2 在 loop-controller.js 内重写一份 retryWithReflection 也就 80 行，DRY 不必这么早追。

```js
// P2 直接在 server/src/core/loop-controller.js 写一份新的
async function retryWithReflection(unit, budget) {
  let failures = [];
  for (let i = 0; i < budget; i++) {
    await agentManager.callAgent('coder', { spec: unit.spec, history: failures });
    const r = await agentManager.callAgent('tester', { unit });
    if (r.ok) return { ok: true, retries: i };
    failures.push(r.failures);
  }
  return { ok: false, reason: "budget_exceeded" };
}
// P5 视实测情况再决定是否与 evolution-loop 合并到 packages/ 公共目录
```

> _这条改动同步影响 plan-migration.html 的 P2 阶段：retry 函数从「抽公共」改为「直接新写」。_

## 不动的边界

**本次改造绝不触碰：**

- ACP 协议本身（`packages/acp-core/`）
- Master / Orchestrator 已有行为（仅注册新的 6 个 Agent 模板）
- WebSocket 路由（`/ws/claude`）
- SkillsMarket / Arena 路径下任何文件
- 认证 / 用户系统（`routes/auth.js`, `routes/users.js`）