# 睿池 ReachAI 文档入口

本目录只保留当前系统的权威知识库。旧的升级计划、阶段验收清单和临时讨论稿已经被合并到下面几份主文档中；阅读时优先看当前能力、代码位置和未完成边界，不再按历史阶段编号追溯。

根目录 `README.md` 已按当前定位重写为对外入口；本目录继续作为更细的系统知识库和实现索引。

## 当前定位

睿池 ReachAI 是面向 Java 企业系统的 Agent 开发与治理中台。它把业务系统中的接口、领域能力、知识、模型、流程、权限和运行审计，沉淀成 Agent 可以理解、编排、调用、治理和开放的资产。

当前系统不是单纯的“扫描历史项目生成 Tool”，而是由以下主线组成：

- 项目与能力注册中心：业务系统可通过 `ai-spring-boot-starter` 主动注册项目、实例、能力和 SDK 图。
- 能力资产治理：`tool_definition` 统一承载 Tool 与粗粒度 Capability，扫描接入和 SDK 注册都进入同一资产目录。
- Agent Studio 与 Runtime：Agent 定义、GraphSpec、版本发布、评测、运行时选择和节点级调试都在平台中闭环。
- 运行治理与开放协议：RunOps、Trace、Tool ACL、Guard 决策、MCP、A2A 和 Gateway 共同承担生产运行边界。
- 企业资产底座：模型实例、知识库、业务索引、领域归属和市场资产为 Agent 提供可复用上下文。

## 阅读顺序

| 文档 | 适合回答的问题 |
| --- | --- |
| [01-平台定位与架构总览.md](./01-平台定位与架构总览.md) | 系统现在是什么、有哪些服务、管理端有哪些页面、统一 SQL 基线覆盖什么 |
| [02-项目注册与能力资产.md](./02-项目注册与能力资产.md) | 业务系统如何接入，扫描、SDK 注册、能力同步、Tool/Capability 资产如何落库 |
| [03-Agent-Studio与Runtime.md](./03-Agent-Studio与Runtime.md) | Agent Studio、GraphSpec、发布、评测、多 Runtime、变量映射如何工作 |
| [04-运行治理与开放协议.md](./04-运行治理与开放协议.md) | Trace、RunOps、ACL、Guard、MCP、A2A、Gateway 如何保护和开放能力 |
| [05-知识模型与企业资产.md](./05-知识模型与企业资产.md) | 模型实例、知识库、业务索引、领域、市场资产如何被 Agent 使用 |

## 当前已落地

- `docs` 根目录已经收敛为 6 份主文档，覆盖平台总览、注册与能力、Studio 与 Runtime、运行治理、企业资产。
- 旧的里程碑交付、临时规划说明和试点说明内容已经被吸收到主文档。
- `docs/系统截图/` 保持原路径，避免影响暂未重写的根目录 `README.md`。
- `docs/superpowers/plans/` 保持为执行计划产物，不纳入主知识库。

## 仍待补齐

- 根目录 `README.md` 已完成对外定位重写，后续应随这套知识结构持续同步。
- 主文档目前是架构和产品级知识，不替代逐页操作手册。
- 如果代码继续演进，应优先更新这 6 份主文档，而不是新增阶段型文档。

## 文档维护规则

- 新文档按产品能力组织，不再新增阶段型验收清单。
- 默认使用 `Capability / 能力`。当文档必须解释旧代码、表名或枚举时，才使用 `Skill`，并明确它是 legacy naming。
- 所有实现说明应指向真实代码模块、前端页面、接口路径或 SQL 表。
- 每份主文档都必须区分“当前已落地”和“仍待补齐”，避免规划与实现混在一起。
- `docs/superpowers/plans/` 是执行计划产物，不属于主知识库。