# Beaver Backend

这是新的 `Beaver` 后端。

旧实现已保留在 [backend-old](/home/ivan/xuan/nano_project/app-instance/backend-old)，新目录用于按 [change.md](/home/ivan/xuan/nano_project/app-instance/backend/change.md) 的蓝图逐步重建后端。

当前已经落地的主线：

1. 以统一 `engine` 为核心，让主 agent 和 sub-agent 共享同一套运行内核。
2. 聊天入口支持 Main Agent 自动 Task 化、验证、反馈门控。
3. skills 已有版本化、receipt/effect 记录、学习候选门控，以及后台 assisted learning pipeline。
4. Agent Team v1 已支持内部 `sequence / parallel / dag` coordinator。
5. Task mode 已能通过 `TaskExecutionPlanner` 按需调用 sub-agent/team；team node 由 `TaskSkillResolver` 绑定 published skill，缺失时生成 ephemeral guidance，最终仍由主 Agent synthesis 生成用户回答。
6. Skill Learning 已支持后台 run-once/worker 自动生成 draft、safety report、eval report、人工审核发布和前端审核工作台；worker 不会自动 approve/publish。

## 当前结构

- `beaver/foundation`：底层公共设施
- `beaver/engine`：统一 agent 内核
- `beaver/coordinator`：多 agent 协调层
- `beaver/tools`：工具系统
- `beaver/skills`：技能系统
- `beaver/memory`：记忆与经验沉淀
- `beaver/permissions`：权限与治理
- `beaver/services`：应用服务层
- `beaver/interfaces`：CLI / Web / Gateway / Channels 薄入口
- `beaver/integrations`：外部系统与协议集成

## 说明

这个目录已经不是空骨架，但仍不等于完成迁移。

后续迁移原则：

1. 不再新增 `nanobot` 命名。
2. 不在新目录中保留 `third_party/`。
3. 所有 agent 最终都复用 `beaver.engine`。
4. 高级 team 策略先编译成 Beaver 自有 `ExecutionGraph`，不直接暴露 swarms runtime。