docs(project): 更新 RAG 与模型平台现状

README.md

@@ -3,8 +3,8 @@
 Common Agent 是一个规划中的通用 Agent 平台，技术路线基于 Java、Spring Boot 和 Spring AI。
 项目目标是建设一套完整的前后端系统，支持 Agent 编排、工具调用、会话管理、RAG 知识库和平台管理能力。
 
-当前项目已经完成基础工程、公共模块、RAG 元数据管理、文档上传、文档解析入口、前端知识库与知识文档管理页面。
-Agent 运行时、RAG 切片入库、向量化、检索问答和更多平台管理能力会在后续阶段逐步实现。
+当前项目已经完成基础工程、公共模块、RAG 元数据管理、文档上传、文档解析入口、解析快照、手动切片入口、前端知识库与知识文档管理页面。
+Agent 运行时、RAG 向量化、检索问答、模型服务商配置与更多平台管理能力会在后续阶段逐步实现。
 
 ## 项目愿景
 
@@ -146,11 +146,12 @@ npm run build
 
 | 页面 | 状态 |
 |------|------|
-| 工作台 | 占位 |
+| RAG 工作台 | 文档解析与切片概览 |
 | 系统枚举 | 完整 CRUD + 批量新增 |
 | 附件管理 | 占位 |
 | 知识库 | 完整 CRUD + 双栏详情 |
-| 知识文档 | 条件查询 + 批量上传 + 批量解析入口 + 编辑/启停用/删除 |
+| 知识文档 | 条件查询 + 批量上传 + 解析重试 + 批量切片 + 编辑/启停用/删除 |
+| 切片任务 | 解析成功/失败文档概览 + 切片入口 |
 
 当前 UI 规范：
 
@@ -170,19 +171,21 @@ npm run build
 
 ## RAG 当前能力边界
 
-当前 RAG 已经从元数据管理推进到"上传 + 解析入口"阶段：
+当前 RAG 已经从元数据管理推进到"上传 + 解析 + 手动切片"阶段：
 
 - 知识库：支持列表、条件查询、详情、总览、单库文档概览、新增、编辑、删除。
 - 知识文档：支持列表、条件查询、详情、新增/编辑、删除、批量上传。
-- 文档解析：基于 Apache Tika 支持 TXT/Markdown/LOG、PDF、Word、Excel 文本抽取，解析时更新 `parseStatus`。
-- 切片与向量表：`rag_chunk`、`rag_chunk_embedding` 实体、Mapper、Service 已有结构，但尚未实现切片生成、向量写入和检索召回。
-- 前端：知识库页和知识文档页已经接入当前接口，检索配置、最近任务、重建索引仍是后续能力。
+- 文档解析：基于 Apache Tika 支持 TXT/Markdown/LOG、PDF、Word、Excel 文本抽取，解析时更新 `parseStatus` 并保存解析快照。
+- 文档切片：支持按解析快照进行手动异步切片，已落地定长切片和分隔符切片，写入 `rag_chunk`。
+- 向量表：`rag_chunk_embedding` 实体、Mapper、Service 已有结构，向量写入、检索召回和重排序仍待接入。
+- 模型配置：已补充模型服务商配置与路由需求/设计文档，后续用于统一接入 Ollama、硅基流动、百炼等来源。
+- 前端：知识库页、知识文档页、RAG 工作台和切片任务页已经接入当前接口，检索配置、最近任务、重建索引仍是后续能力。
 
 ## 规划模块
 
 - `agent-core`：Agent 执行模型、工具注册、记忆和编排能力。
 - `rag-core`：文档导入、解析、切片、Embedding、检索和引用元数据。
-- `model-provider`：基于 Spring AI 的聊天模型、Embedding、重排序和模型配置层。
+- `model-provider`：模型服务商配置、模型路由、调用日志，以及基于 OpenAI-compatible / Spring AI 的聊天模型、Embedding、重排序适配层。
 - `platform-api`：面向前端和外部系统的 REST API。
 - `platform-admin`：平台管理前端。
 - `common-infra`：持久化、审计日志、安全、租户隔离和可观测性。
@@ -191,6 +194,8 @@ npm run build
 
 - [架构说明](docs/ARCHITECTURE.md)
 - [开发路线图](docs/ROADMAP.md)
+- [模型服务商配置与路由需求](docs/MODEL_PROVIDER_REQUIREMENTS.md)
+- [模型服务商配置与路由设计](docs/MODEL_PROVIDER_DESIGN.md)
 - [平台设计草案](AGENT.md)
 
 ## 参考资料