V0.5 AI Native

本文档用于收口 V0.5 阶段。V0.5 的目标是把框架已有的文档、开放平台、任务、管道和生态能力继续向 AI Native 方向推进，让框架更适合 AI Agent、知识库、RAG、自建模型问答和付费开放接口场景。

版本号：0.5.0

发布状态：已发布。

GitHub Release：https://github.com/spring-open/spring-open/releases/tag/v0.5.0

发布目标

V0.5 应满足：

• Knowledge Base / RAG 能提供轻量第一阶段能力，优先服务框架自身文档和 AI Agent 项目知识检索。
• AI Task 能基于当前 Queue、Scheduler、Pipeline、Notification 和 Open Platform 底座形成可扩展任务边界。
• Open Platform 能继续推进计费、套餐、调用配额、账单记录和开发者接入体验。
• Agent Friendly API 能提供更清晰的能力索引、稳定的版本化接口和可复制调用样板。
• 文档能说明 AI Native 能力的边界、默认关闭项、配置方式和生产扩展路线。

当前状态

截至 2026-05-24，V0.5 已完成发布前验证并发布。

能力	状态	说明
Knowledge Base / RAG	第一阶段已完成	已新增 Knowledge starter，提供文件系统扫描、Markdown 切片、关键词搜索和 Ask 上下文
AI Task	第一阶段已完成	已新增 AI Task starter，提供任务模型、handler 注册、同步执行、失败结果转换，并补齐与 Queue、Scheduler、Pipeline、Knowledge 的协作边界
Open Platform 计量与商业化边界	第一阶段已完成	已基于调用日志提供只读统计入口，并明确 usage event、套餐、配额和账单的后续边界
Agent Friendly API	第一阶段已完成	已新增 AI Agent 接入文档，说明 OpenAPI 元数据、Open Platform 调用、scope、Result 和样板边界

V0.5 必须包含

能力	模块	验收标准
Knowledge Base / RAG MVP	spring-open-starter-knowledge	能扫描框架文档和 .ai 知识，提供文档加载、切片、搜索和问答上下文第一阶段
AI Task 边界	spring-open-starter-ai-task	能说明并落地任务模型、执行状态，以及与 Queue、Scheduler、Pipeline、Knowledge 和 Open Platform 的组合边界
Open Platform 计费规划落地	spring-open-module-open-platform	至少完成计量、配额或账单中的一个可用闭环
Docs	docs/	AI Native、Knowledge Base、Open Platform 计量和 Agent API 文档可读、可查、可复制

V0.5 不阻塞项

以下能力可以继续推进，但不作为 V0.5 发布阻塞项：

• Milvus、Qdrant、Elasticsearch 等外部向量库深度适配。
• 自建大模型推理服务。
• 完整开发者门户、在线购买套餐和自动扣费。
• 多租户 SaaS 商业化闭环。
• 复杂 Agent 工作流编排平台。

发布前检查清单

• [x] 工作区没有无关改动。
• [x] spring-open-application 测试通过。
• [x] Knowledge Base / RAG / AI Task / Open Platform 计量相关测试通过。
• [x] 文档站点构建通过。
• [x] git diff --check 通过。
• [x] V0.5 相关正式文档与当前代码一致。
• [x] .ai/progress.md、.ai/todo.md 和 .ai/plan.md 已记录最新状态。

V0.5 之后

V0.5 发布后，建议继续推进：

1. V0.6：检查并完善现有所有模块和文档，补齐模块代码缺口，收口正式上线所需的用户体系和管理后台功能。
2. V0.7：开发前端相关视图，包括后台管理界面、手机端界面和 uni-app 多端应用。
3. V0.8：前后端功能联调测试确认无误，全栈打通，补齐常规 App 应用必备基础模块和可选增强能力。
4. V1.0：稳定 API、兼容基线、Maven 发布、完整文档、完整样板和变更日志。