# echobot 项目文档（架构与实现）

本目录聚焦三个目标：
1. 给出项目整体架构（分层、数据流、运行拓扑）。
2. 说明关键功能的实现方式（Gateway、Agent、WebUI、Cron、Heartbeat）。
3. 逐模块解释实现方式（职责、核心文件、调用关系、扩展点）。

## 文档索引

- `docs/project/01-架构与实现总览.md`
  - 总体分层架构
  - 关键运行流程
  - 数据与状态持久化
  - 设计取舍与边界
- `docs/project/02-模块实现说明.md`
  - 每个模块的职责与实现方式
  - 关键类/函数与调用链
  - 扩展点与注意事项
- `docs/project/03-关键流程与调用链.md`
  - Gateway、Agent、WebUI、Cron、Heartbeat 的关键调用链
  - 统一故障处理策略
  - 技术债与演进方向
- `docs/project/04-企业多场景角色系统草案.md`
  - 企业多场景角色分层
  - 总入口与专家角色协同策略
  - 两周落地计划与验收标准

## 适用版本

- 仓库路径：`echobot`
- 文档生成日期：2026-02-10

## 本次重点更新（2026-02-10）

1. 新增自动记忆写入：可将用户偏好句式写入 `memory/MEMORY.md`。
2. 新增 Cron 工具模块并接入 Agent，支持创建/列出/删除定时任务。
3. Gateway 新增 `--restart`，并增强 `--stop` 对 WebUI 子进程的停止能力。
4. Cron 支持按任务时区计算下一次执行时间。
5. 默认角色补齐 `exec` 与 `cron` 工具权限。
6. 新增企业多场景角色系统落地草案文档。
