# LightBot Roadmap

> 轻量级现代化 Java AI Agent 平台
>
> 当前版本：**v2.1.0**（2026-07-23）

---

## 路线图总览

| 版本 | 状态 | 目标 |
| --- | --- | --- |
| v0.1 - v0.4 | 已完成 | 建立 Agent、RAG、Workflow、Eval 与可观测基础能力 |
| v2.0.0 | 已完成 | 强化会话可靠性、模型接入、API Key 与生产可用性 |
| v2.1.0 | 已完成 | 完成模块化落地，补齐协作运行时、工作流韧性和任务治理 |
| v2.2 | 规划中 | 完善运营、安全与部署交付能力 |
| v3.0 | 远期 | 在稳定模块边界基础上按需拆分服务 |

---

## v2.1.0：模块化与运行时治理 ✅

### 架构与工程

| 能力 | 状态 | 说明 |
| --- | --- | --- |
| Maven 多模块拆分 | ✅ | 形成 common → framework → platform → ai → knowledge → tool → workflow → agent → server 的依赖方向 |
| 领域能力归位 | ✅ | Agent、Workflow、Tool、Knowledge、AI、平台能力已迁入对应模块 |
| 前端设计系统 | ✅ | 统一 CSS 变量、暗色主题、滚动容器与详情页布局 |
| 契约与构建依赖治理 | ✅ | 模块间通过接口/Port 暴露能力，避免 server 承载业务实现 |

### Agent 与会话运行时

| 能力 | 状态 | 说明 |
| --- | --- | --- |
| SubAgent 批量并行委派 | ✅ | 支持批次、同步/并行模式、运行记录和实时状态展示 |
| 会话协作面板 | ✅ | 展示工具调用、SubAgent 状态、任务进度与运行时信息 |
| 长期记忆与资源提及 | ✅ | 支持用户长期记忆、会话内资源提及和快照展示 |
| 多模态附件与产物管理 | ✅ | 支持文件预览、下载、OCR 解析和沙盒产物预签名访问 |
| 对话安全与体验 | ✅ | 输入敏感词拦截、停止生成、搜索、收藏、反馈及错误分类 |

### Workflow

| 能力 | 状态 | 说明 |
| --- | --- | --- |
| 人工确认节点 | ✅ | 支持流程挂起、表单收集、继续执行与放弃 |
| 节点超时与重试 | ✅ | 支持节点级韧性配置、失败重试和默认分支校验 |
| 嵌套工作流与参数映射 | ✅ | 支持子工作流调用、输入输出映射与变量引用校验 |
| 调试与回放 | ✅ | 支持单节点测试、全流程测试、SSE 实时状态和测试运行历史 |
| 画布体验 | ✅ | 支持批量操作、只读查看、撤销提示与可调整侧栏 |

### 平台治理与可观测

| 能力 | 状态 | 说明 |
| --- | --- | --- |
| Redis Stream 任务队列 | ✅ | 支持消费者组、延迟重试、死信标记、取消和僵尸任务扫描 |
| 工具限流 | ✅ | 按用户与工具维度配置限流窗口和阈值 |
| RAG 反馈闭环 | ✅ | 汇聚消息反馈与引用信息，用于检索质量分析 |
| 查询性能优化 | ✅ | 增加 RAG 引用、请求 ID、消息反馈等索引，优化软删除唯一约束 |
| 权限与用量 | ✅ | 支持角色权限接口、API Key 作用域和用户 Token 用量统计 |

### 2.1 数据库基线

| 内容 | 说明 |
| --- | --- |
| 全量初始化 | `sql/2026-07-28-init.sql`（DDL）+ `sql/insert-sql.sql`（预制数据） |
| 存量升级 | 按文件名升序执行仓库中尚未应用的 `YYYY-MM-DD-NNN.sql` |
| 迁移说明 | 查看 [sql/README.md](sql/README.md)，区分全新部署与存量升级 |

---

## v2.2：交付、安全与运营（规划中）

> 目标：不改变单体优先策略，先补齐可部署、可运营、可审计的生产能力。

| 优先级 | 方向 | 计划内容 |
| --- | --- | --- |
| P0 | 发布交付 | 环境变量模板、健康检查、备份与恢复演练；容器编排按实际部署环境提供 |
| P0 | 安全治理 | 审计日志、敏感配置轮换、上传内容安全校验、管理员操作追踪 |
| P1 | 运维可观测 | 指标导出、告警规则、任务死信处理界面、容量与成本看板 |
| P1 | 开放能力 | 稳定的 OpenAPI 契约、API Key 统计、Webhook 事件通知 |
| P2 | 知识运营 | 文档质量报表、检索反馈闭环、批量重建与数据导出 |
| P2 | 体验完善 | 国际化、无障碍优化、更多内置工作流模板 |

---

## v3.0：按需分布式演进（远期）

只有在单体的容量、团队协作或独立发布需求有明确证据时启动拆分。

| 方向 | 前置条件 |
| --- | --- |
| 多租户与资源隔离 | 明确租户模型、计量口径和隔离级别 |
| 异步执行独立扩展 | 任务队列吞吐或长任务资源隔离成为瓶颈 |
| API 网关 | 存在多服务路由、统一认证或外部流量治理需求 |
| 服务拆分 | 模块边界稳定、调用契约可观测、具备独立部署收益 |

## 不在当前路线图内

- 自训练基础模型：平台聚焦模型接入、编排与治理。
- 为拆分而拆分的微服务化：当前优先保持单体部署和模块边界清晰。
- 无明确场景的区块链存证：按实际合规需求评估。

## 贡献方式

优先关注标记为 `P0` / `P1` 的事项；新增能力需同时补齐模块边界、迁移脚本、测试和发布文档。