springbootAI 2.3.3__tar.gz → 2.3.5__tar.gz

{springbootai-2.3.3 → springbootai-2.3.5}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [2.3.5] - 2026-08-20
+
+### 文档与发布
+
+- 发布版本升级到 `2.3.5`，同步框架主包、扩展模块、PyMyBatis 内嵌版本、README 版本矩阵和打包元数据。
+- README 首页新增 SpringBootAI 在线考试认证与证书说明，提供认证入口、适用场景、备考流程和重点知识范围。
+- 认证平台入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)。
+
+## [2.3.4] - 2026-08-19
+
+### 新增与完善
+
+- 新增声明式 AI 注解：`@Prompt`、`@RAG`、`@StructuredOutput`、`@Agent`、`@Embedding`、`@VectorStore`、`@AiRetry`、`@AiCache`、`@TokenUsage`、`@ContentModeration`；复用 ChatClient、RAG、Agent、向量库和可观测性组件，并支持同步、异步与 Pydantic v1/v2。
+- 新增 AI 注解中文用例、实时功能目录和模块文档；未配置 AI Bean 或可选依赖时不影响普通应用启动。
+- 完善 Actuator Admin、Nacos 动态刷新、请求监控与文件上传能力，并补充对应文档与回归测试。
+- 修复 PyMyBatis 参数检测将 Python 源码中的普通 `#` 注释误判为 SQL 注入的问题；真实引号/分号后的 SQL 注释截断攻击仍会被拦截。
+
+### 兼容性
+
+- AI 自动配置同时支持 `springbootai.ai` 与 Spring 风格的 `spring.ai` 配置前缀，避免已有配置中的 API Key 被遗漏。
+
 ## [2.3.3] - 2026-08-18
 
 ### 测试补充与文档完善

{springbootai-2.3.3/springbootAI.egg-info → springbootai-2.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.3.3
+Version: 2.3.5
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT
@@ -163,9 +163,41 @@ Dynamic: license-file
 # SpringBootAI
 
 <p align="center">
-  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+  <img src="https://raw.githubusercontent.com/YUCONGGEN/springbootAI/master/doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
 </p>
 
+## SpringBootAI 考试认证与证书
+
+SpringBootAI 已提供配套的在线考试认证平台，学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证适合以下场景：
+
+- **个人学习证明**：用于记录自己已经系统学习 SpringBootAI 的 Web、IoC、配置、数据访问、AOP、AI 扩展和生产治理等核心内容。
+- **团队能力评估**：团队引入 SpringBootAI 前，可以让成员通过统一考试确认基础概念、开发规范和常见问题处理能力。
+- **项目交付背书**：在培训、内部推广、项目验收或技术选型说明中，证书可作为使用者熟悉框架体系和最佳实践的辅助证明。
+- **持续学习路径**：认证内容覆盖从入门到进阶的关键知识点，适合结合 README、模块文档和示例工程逐步学习后再参加考试。
+
+建议的认证准备流程：
+
+1. 先按 README 中的“10 分钟跑通第一个接口”完成本地环境搭建，确认能够创建应用、启动服务并访问 Swagger。
+2. 阅读 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md)，理解 `@SpringBootApplication`、`@RestController`、`@Service`、`@Autowired`、配置文件和依赖注入的基本用法。
+3. 根据实际使用方向阅读模块文档，例如 Web MVC、ORM、事务、缓存、安全、配置绑定、测试切片、AI、LangChain、LangGraph、MCP 和 Cloud 微服务等。
+4. 运行示例或编写一个小型业务接口，至少覆盖 Controller、Service、配置读取、异常处理、Swagger 文档和数据访问中的若干能力。
+5. 访问认证平台参加考试，通过后按平台页面提示查看、下载或领取证书。证书信息、考试规则、题量、通过标准和有效期以认证平台展示为准。
+
+认证重点建议关注：
+
+| 方向 | 建议掌握内容 |
+|---|---|
+| 快速入门 | 安装方式、项目结构、启动入口、扫描包、`application.yml`、Swagger 访问 |
+| Web 与 IoC | 路由映射、参数绑定、Controller/Service 分层、Bean 注册、依赖注入、生命周期 |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务边界、回滚行为 |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断、测试切片 |
+| 安全能力 | JWT、密码加密、SQL 注入防护、CSRF、OAuth2、访问控制与常见错误处理 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph、MCP client/server |
+
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
 [![Python](https://img.shields.io/pypi/pyversions/springbootAI)](https://pypi.org/project/springbootAI/)
 [![CI](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml)
@@ -183,7 +215,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.3.2`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
+当前版本是 `2.3.5`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
 
 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | [全部文档](https://github.com/YUCONGGEN/springbootAI/tree/master/doc) | [变更日志](https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md) | [安全报告](https://github.com/YUCONGGEN/springbootAI/blob/master/SECURITY.md) | [发布检查](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/RELEASE_CHECKLIST.md)
 
@@ -364,10 +396,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `springbootai` 框架 API | 2.3.2 |
-| `springbootai.orm.pymybatis` | 2.3.2 |
-| `springbootai.ai` AI 模块 | 2.3.2 |
-| `springbootai.langchain` LangChain 模块 | 2.3.2 |
+| `springbootai` 框架 API | 2.3.5 |
+| `springbootai.orm.pymybatis` | 2.3.5 |
+| `springbootai.ai` AI 模块 | 2.3.5 |
+| `springbootai.langchain` LangChain 模块 | 2.3.5 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

{springbootai-2.3.3 → springbootai-2.3.5}/README.md

@@ -1,9 +1,41 @@
 # SpringBootAI
 
 <p align="center">
-  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+  <img src="https://raw.githubusercontent.com/YUCONGGEN/springbootAI/master/doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
 </p>
 
+## SpringBootAI 考试认证与证书
+
+SpringBootAI 已提供配套的在线考试认证平台，学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证适合以下场景：
+
+- **个人学习证明**：用于记录自己已经系统学习 SpringBootAI 的 Web、IoC、配置、数据访问、AOP、AI 扩展和生产治理等核心内容。
+- **团队能力评估**：团队引入 SpringBootAI 前，可以让成员通过统一考试确认基础概念、开发规范和常见问题处理能力。
+- **项目交付背书**：在培训、内部推广、项目验收或技术选型说明中，证书可作为使用者熟悉框架体系和最佳实践的辅助证明。
+- **持续学习路径**：认证内容覆盖从入门到进阶的关键知识点，适合结合 README、模块文档和示例工程逐步学习后再参加考试。
+
+建议的认证准备流程：
+
+1. 先按 README 中的“10 分钟跑通第一个接口”完成本地环境搭建，确认能够创建应用、启动服务并访问 Swagger。
+2. 阅读 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md)，理解 `@SpringBootApplication`、`@RestController`、`@Service`、`@Autowired`、配置文件和依赖注入的基本用法。
+3. 根据实际使用方向阅读模块文档，例如 Web MVC、ORM、事务、缓存、安全、配置绑定、测试切片、AI、LangChain、LangGraph、MCP 和 Cloud 微服务等。
+4. 运行示例或编写一个小型业务接口，至少覆盖 Controller、Service、配置读取、异常处理、Swagger 文档和数据访问中的若干能力。
+5. 访问认证平台参加考试，通过后按平台页面提示查看、下载或领取证书。证书信息、考试规则、题量、通过标准和有效期以认证平台展示为准。
+
+认证重点建议关注：
+
+| 方向 | 建议掌握内容 |
+|---|---|
+| 快速入门 | 安装方式、项目结构、启动入口、扫描包、`application.yml`、Swagger 访问 |
+| Web 与 IoC | 路由映射、参数绑定、Controller/Service 分层、Bean 注册、依赖注入、生命周期 |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务边界、回滚行为 |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断、测试切片 |
+| 安全能力 | JWT、密码加密、SQL 注入防护、CSRF、OAuth2、访问控制与常见错误处理 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph、MCP client/server |
+
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
 [![Python](https://img.shields.io/pypi/pyversions/springbootAI)](https://pypi.org/project/springbootAI/)
 [![CI](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml)
@@ -21,7 +53,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.3.2`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
+当前版本是 `2.3.5`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
 
 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | [全部文档](https://github.com/YUCONGGEN/springbootAI/tree/master/doc) | [变更日志](https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md) | [安全报告](https://github.com/YUCONGGEN/springbootAI/blob/master/SECURITY.md) | [发布检查](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/RELEASE_CHECKLIST.md)
 
@@ -202,10 +234,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `springbootai` 框架 API | 2.3.2 |
-| `springbootai.orm.pymybatis` | 2.3.2 |
-| `springbootai.ai` AI 模块 | 2.3.2 |
-| `springbootai.langchain` LangChain 模块 | 2.3.2 |
+| `springbootai` 框架 API | 2.3.5 |
+| `springbootai.orm.pymybatis` | 2.3.5 |
+| `springbootai.ai` AI 模块 | 2.3.5 |
+| `springbootai.langchain` LangChain 模块 | 2.3.5 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

{springbootai-2.3.3 → springbootai-2.3.5}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 [project]
 # Distribution name: springbootAI (pip install springbootAI); import package: springbootai.
 name = "springbootAI"
-version = "2.3.3"
+version = "2.3.5"
 description = "Spring-style Python framework with Web, ORM, Cloud and AI integrations"
 readme = "README.md"
 license = "MIT"

{springbootai-2.3.3 → springbootai-2.3.5/springbootAI.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.3.3
+Version: 2.3.5
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT
@@ -163,9 +163,41 @@ Dynamic: license-file
 # SpringBootAI
 
 <p align="center">
-  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+  <img src="https://raw.githubusercontent.com/YUCONGGEN/springbootAI/master/doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
 </p>
 
+## SpringBootAI 考试认证与证书
+
+SpringBootAI 已提供配套的在线考试认证平台，学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证适合以下场景：
+
+- **个人学习证明**：用于记录自己已经系统学习 SpringBootAI 的 Web、IoC、配置、数据访问、AOP、AI 扩展和生产治理等核心内容。
+- **团队能力评估**：团队引入 SpringBootAI 前，可以让成员通过统一考试确认基础概念、开发规范和常见问题处理能力。
+- **项目交付背书**：在培训、内部推广、项目验收或技术选型说明中，证书可作为使用者熟悉框架体系和最佳实践的辅助证明。
+- **持续学习路径**：认证内容覆盖从入门到进阶的关键知识点，适合结合 README、模块文档和示例工程逐步学习后再参加考试。
+
+建议的认证准备流程：
+
+1. 先按 README 中的“10 分钟跑通第一个接口”完成本地环境搭建，确认能够创建应用、启动服务并访问 Swagger。
+2. 阅读 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md)，理解 `@SpringBootApplication`、`@RestController`、`@Service`、`@Autowired`、配置文件和依赖注入的基本用法。
+3. 根据实际使用方向阅读模块文档，例如 Web MVC、ORM、事务、缓存、安全、配置绑定、测试切片、AI、LangChain、LangGraph、MCP 和 Cloud 微服务等。
+4. 运行示例或编写一个小型业务接口，至少覆盖 Controller、Service、配置读取、异常处理、Swagger 文档和数据访问中的若干能力。
+5. 访问认证平台参加考试，通过后按平台页面提示查看、下载或领取证书。证书信息、考试规则、题量、通过标准和有效期以认证平台展示为准。
+
+认证重点建议关注：
+
+| 方向 | 建议掌握内容 |
+|---|---|
+| 快速入门 | 安装方式、项目结构、启动入口、扫描包、`application.yml`、Swagger 访问 |
+| Web 与 IoC | 路由映射、参数绑定、Controller/Service 分层、Bean 注册、依赖注入、生命周期 |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务边界、回滚行为 |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断、测试切片 |
+| 安全能力 | JWT、密码加密、SQL 注入防护、CSRF、OAuth2、访问控制与常见错误处理 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph、MCP client/server |
+
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
 [![Python](https://img.shields.io/pypi/pyversions/springbootAI)](https://pypi.org/project/springbootAI/)
 [![CI](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/ci.yml)
@@ -183,7 +215,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.3.2`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
+当前版本是 `2.3.5`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 对接官方 TC + TCC 回调；`at` 模式通过 ORM 拦截器自动生成 undo_log 实现自动回滚。
 
 [新手指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | [全部文档](https://github.com/YUCONGGEN/springbootAI/tree/master/doc) | [变更日志](https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md) | [安全报告](https://github.com/YUCONGGEN/springbootAI/blob/master/SECURITY.md) | [发布检查](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/RELEASE_CHECKLIST.md)
 
@@ -364,10 +396,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `springbootai` 框架 API | 2.3.2 |
-| `springbootai.orm.pymybatis` | 2.3.2 |
-| `springbootai.ai` AI 模块 | 2.3.2 |
-| `springbootai.langchain` LangChain 模块 | 2.3.2 |
+| `springbootai` 框架 API | 2.3.5 |
+| `springbootai.orm.pymybatis` | 2.3.5 |
+| `springbootai.ai` AI 模块 | 2.3.5 |
+| `springbootai.langchain` LangChain 模块 | 2.3.5 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

{springbootai-2.3.3 → springbootai-2.3.5}/springbootAI.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ springbootai/devtools.py
 springbootai/main.py
 springbootai/ai/__init__.py
 springbootai/ai/advisors.py
+springbootai/ai/annotation_runtime.py
 springbootai/ai/annotations.py
 springbootai/ai/autoconfig.py
 springbootai/ai/core.py
@@ -75,6 +76,7 @@ springbootai/context/__init__.py
 springbootai/context/application_context.py
 springbootai/context/bean_definition.py
 springbootai/context/bean_factory.py
+springbootai/context/lifecycle.py
 springbootai/context/registry.py
 springbootai/context/scanner.py
 springbootai/core/__init__.py
@@ -260,12 +262,14 @@ springbootai/websocket/session.py
 sql/seata_undo_log.sql
 tests/test_actuator.py
 tests/test_actuator_prometheus_admin.py
+tests/test_ai_annotations.py
 tests/test_ai_comprehensive.py
 tests/test_ai_declarative_annotations.py
 tests/test_ai_module.py
 tests/test_annotation_combinations.py
 tests/test_annotations_contract.py
 tests/test_aop_annotations_full.py
+tests/test_aop_pointcut_enhancements.py
 tests/test_audit_time.py
 tests/test_batch.py
 tests/test_bean_utils.py
@@ -294,6 +298,7 @@ tests/test_di_config_event_full.py
 tests/test_excel_module.py
 tests/test_hateoas.py
 tests/test_i18n_module.py
+tests/test_ioc_lifecycle_enhancements.py
 tests/test_jpa_version_transient.py
 tests/test_kafka.py
 tests/test_langchain_comprehensive.py
@@ -316,6 +321,7 @@ tests/test_pymybatis_configuration_hardening.py
 tests/test_pymybatis_contract.py
 tests/test_request_metrics.py
 tests/test_retry.py
+tests/test_runtime_configuration_fixes.py
 tests/test_scaffold_hardening.py
 tests/test_scheduling.py
 tests/test_seata_at_proxy.py
@@ -333,6 +339,7 @@ tests/test_tracing.py
 tests/test_transactional_events.py
 tests/test_validation_module.py
 tests/test_web_annotations_full.py
+tests/test_web_file_upload.py
 tests/test_web_root_mapping.py
 tests/test_web_security_responses.py
 tests/test_web_static_files.py

{springbootai-2.3.3 → springbootai-2.3.5}/springbootai/__init__.py

@@ -1,12 +1,25 @@
 from .annotations import SpringBootApplication
 from .annotations import *
+from .ai.annotations import (
+    Agent,
+    AiCache,
+    AiRetry,
+    ContentModeration,
+    Embedding,
+    Prompt,
+    RAG,
+    StructuredOutput,
+    TokenUsage,
+    VectorStore,
+)
+from .ai.annotation_runtime import ContentModerationError
 from .context import *
 from .web import *
 from .config import *
 from .utils import *
 from .main import create_app, run, SpringApplication, run_cli
 
-__version__ = "2.3.3"
+__version__ = "2.3.5"
 __author__ = "yuconggen"
 __license__ = "MIT"
 
@@ -126,6 +139,17 @@ __all__ = [
     'Get',
     'Set',
     'ToString',
+    'Prompt',
+    'RAG',
+    'StructuredOutput',
+    'Agent',
+    'Embedding',
+    'VectorStore',
+    'AiRetry',
+    'AiCache',
+    'TokenUsage',
+    'ContentModeration',
+    'ContentModerationError',
     'EnableDiscoveryClient',
     'NacosValue',
     'RefreshScope',

{springbootai-2.3.3 → springbootai-2.3.5}/springbootai/ai/__init__.py

@@ -18,7 +18,13 @@ from springbootai.ai.core import (
     ChatResponse, EmbeddingModel, Generation, Message, MessageType,
     PromptSpec,
 )
-from springbootai.ai.annotations import AiAdvisor, AiClient, AiMemory, Tool
+from springbootai.ai.annotations import (
+    Agent, AiAdvisor, AiCache, AiClient, AiMemory, AiRetry, ContentModeration,
+    Embedding, Prompt, RAG, StructuredOutput, TokenUsage, Tool, VectorStore,
+)
+# ``VectorStore`` 在本模块历史上表示向量库接口；保留该公开名称，注解通过
+# ``springbootai.ai.annotations.VectorStore`` 或这个别名使用。
+VectorStoreAnnotation = VectorStore
 from springbootai.ai.advisors import (
     MessageChatMemoryAdvisor, QuestionAnswerAdvisor, SimpleLoggerAdvisor,
 )
@@ -46,8 +52,9 @@ from springbootai.ai.resilience import (
 )
 from springbootai.ai.observability import AIMetrics, ai_metrics
 from springbootai.ai.autoconfig import AIProperties, bind_ai_config, configure_ai
+from springbootai.ai.annotation_runtime import ContentModerationError
 
-__version__ = "2.3.3"
+__version__ = "2.3.5"
 
 __all__ = [
     # core
@@ -55,7 +62,11 @@ __all__ = [
     "ChatModel", "ChatResponse", "EmbeddingModel", "Generation", "Message",
     "MessageType", "PromptSpec",
     # annotations
-    "AiAdvisor", "AiClient", "AiMemory", "Tool",
+    "AiAdvisor", "AiClient", "AiMemory", "Tool", "Prompt", "RAG",
+    "StructuredOutput", "Agent", "Embedding", "VectorStore", "AiRetry",
+    "AiCache", "TokenUsage", "ContentModeration",
+    "VectorStoreAnnotation",
+    "ContentModerationError",
     # advisors
     "MessageChatMemoryAdvisor", "QuestionAnswerAdvisor", "SimpleLoggerAdvisor",
     # memory