springbootAI 2.2.5__tar.gz → 2.3.0__tar.gz

{springbootai-2.2.5 → springbootai-2.3.0}/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog
 
+## [2.3.0] - 2026-08-15
+
+### 新增
+
+- **企业级注解驱动**：新增 10 个注解，将 16 项企业级功能改造为注解驱动模式。标记在 `@SpringBootApplication` 主类上即可启用，注解参数优先于配置文件。
+  - `@EnableOAuth2` — 启用 OAuth2 资源服务器（支持 HS256/RS256、issuer/audience/scope 校验）
+  - `@EnableCsrf` — 启用 CSRF 防护（Double Submit Cookie 模式）
+  - `@EnableDevTools` — 启用开发环境热重载（文件变更自动重启）
+  - `@EnableConfigServer` — 启用 Spring Cloud Config 配置中心客户端
+  - `@EnableBus` — 启用 Spring Cloud Bus 事件总线
+  - `@EnableBatchProcessing` — 启用 Spring Batch 批处理
+  - `@EnableDataRest` — 启用 Spring Data REST（自动暴露 Repository 为 CRUD API）
+  - `@BatchJob` / `@BatchStep` — 标记批处理作业和步骤
+  - `@RepositoryRestResource` — 标记 Repository 为 REST 资源
+- **OAuth2 资源服务器**：新增 `spring/security/oauth2.py`，支持 JWT Access Token 验证，HS256 对称密钥和 RS256 公钥（JWKS）两种算法。
+- **CSRF 防护**：新增 `spring/web/csrf.py`，实现 Double Submit Cookie 模式中间件。
+- **Kafka 支持**：新增 `spring/messaging/kafka.py`，提供 `KafkaClient`（生产者+消费者管理）和 `@KafkaListener`/`KafkaTemplate` 注解。
+- **DevTools 热重载**：新增 `spring/devtools.py`，提供 `FileWatcher`（轮询文件变更）和 `RestartTrigger`（静默期防抖）。
+- **数据库迁移完善**：新增 Undo 回滚迁移（U{version}__{desc}.sql）、迁移锁（MySQL/PostgreSQL/SQLite）、变量替换（${var}）、validate 校验方法。
+- **Actuator /heapdump 端点**：返回 tracemalloc 内存分配快照 + GC 统计（JSON 格式），对齐 Spring Boot /actuator/heapdump。
+- **配置元数据**：新增 `spring/config/spring-configuration-metadata.json`，IDE 可读取提供配置自动补全。
+- **项目脚手架**：新增 `spring/cli/scaffold.py`，支持 `springbootai init` 命令创建新项目。
+- **Spring CLI**：新增 `spring/cli/main.py`，提供 `springbootai` 统一命令入口（version/info/list/init/run/docs）。
+- **Starter 机制**：pyproject.toml 新增 `web`/`cloud`/`all` 组合 Starter extras。
+- **Spring Cloud Config**：新增 `spring/cloud/config_center.py`，支持 HTTP 和本地文件后端。
+- **Spring Cloud Bus**：新增 `spring/cloud/bus.py`，支持进程内和 MQ 后端事件总线。
+- **Spring Batch**：新增 `spring/batch/`，支持 Job/Step/Reader/Processor/Writer 组件。
+- **Spring Data REST**：新增 `spring/data/rest.py`，自动生成 Repository CRUD REST 端点。
+- **Spring HATEOAS**：新增 `spring/web/hateoas.py`，包含 Link/EntityModel/CollectionModel/PagedModel。
+- **Sphinx API 文档**：新增 `docs/conf.py` 和 `docs/index.rst`。
+
+### 测试
+
+- 新增 7 个测试文件，共 198 个测试用例：
+  - `test_kafka.py`（75）、`test_migration.py`（44）、`test_oauth2.py`（21）、`test_csrf.py`（19）、`test_devtools.py`（16）、`test_starter.py`（13）、`test_metadata.py`（10）
+- 新增 `test_new_annotations.py`（37 个注解测试）
+- 完整测试套件 **2821 passed, 11 skipped, 0 failed**
+
+### 文档
+
+- 新增 `doc/ENTERPRISE_ANNOTATIONS.md` — 10 个企业级注解完整教程
+- 新增 `doc/MIGRATION_MODULE.md` — 数据库迁移模块文档（10 章节）
+- 新增 `doc/STARTER_MODULE.md` — Starter 机制文档（8 章节）
+- 新增 `doc/CLI_MODULE.md` — CLI 和脚手架文档（10 章节）
+- `doc/MESSAGING_MODULE.md` 追加 Kafka 章节
+- `doc/WEB_MODULE.md` 追加 HATEOAS 章节
+- `doc/CONFIG_BINDING_MODULE.md` 追加配置元数据章节
+- 35 个文件版本号从 2.2.6 更新到 2.3.0
+
+## [2.2.6] - 2026-08-15
+
+### 新增
+
+- **Seata AT 数据源代理**：新增 `spring/cloud/seata_at_proxy.py`（500 行），在 ORM 拦截器层自动记录 SQL 的 before/after image，生成 undo_log，全局事务回滚时自动反向恢复数据。支持 MySQL(`%s`) 和 SQLite(`?`) 占位符自动适配。Seata 模式从三模式（local/http/distributed）扩展为四模式（新增 `at`）。
+- **AT 代理测试**：新增 `tests/test_seata_at_proxy.py`（18 项全通过），覆盖 SQL 解析、undo_log CRUD、undo 反向恢复（INSERT→DELETE / UPDATE→UPDATE before / DELETE→INSERT before）、AT 拦截器记录、提交删除 undo_log。
+
+### 重构
+
+- **目录整合**：`example_all`、`example_langchain`、`example_langgraph`、`example_mcp`、`test_cloud_app` 五个散落目录合并到 `examples/` 下；`tests_integration`、`tests_performance`、`tests_runtime` 合并到 `tests/integration/`、`tests/performance/`、`tests/runtime/`。`pyproject.toml` 的 `pythonpath` 增加 `examples`，5 个入口脚本修复 `sys.path`。
+- **文档整理**：`REPOSITORY_MODULE.md` 合并到 `ORM_MODULE.md`（减少文档碎片），更新 README 导航表和 3 处引用。
+- **路径引用同步**：CI 4 个 workflow、11 个文档、Dockerfile、benchmark_app.py 中的 example/tests 路径全部更新。
+
+### 文档
+
+- `README.md` Seata 边界说明从"⚠️ 有边界"改为"✅ 可用"（3 处）。
+- `doc/CLOUD_MODULE.md` 新增 AT 模式使用指南（工作流程图 + 代码示例 + 限制说明）。
+- `doc/ORM_MODULE.md` 新增"Repository 分页查询"章节（原 REPOSITORY_MODULE.md 内容）。
+- 25 个文件版本号从 2.2.5 更新到 2.2.6。
+
 ## [2.2.5] - 2026-08-14
 
 ### 新增
@@ -14,7 +83,6 @@
 - `doc/ACTUATOR_MODULE.md` 新增第四章（Spring Boot Admin 可视化面板）、第五章（Prometheus + Grafana 工业级监控，含三步接入流程与多 worker 注意事项）、第六章（自定义业务指标）。
 - `doc/ORM_MODULE.md` 第五章新增"方法 1：@SelectPage 注解（推荐）"小节。
 - `README.md` 4.8 健康检查表新增 `/actuator/admin`、`/actuator/prometheus`、`/actuator/sysmetrics` 三个端点。
-- `doc/EIGHT_MODULES.md` Actuator 模块说明补充"Spring Boot Admin 可视化 + Prometheus 指标"。
 
 ### 测试
 

{springbootai-2.2.5/springbootAI.egg-info → springbootai-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: springbootAI
-Version: 2.2.5
+Version: 2.3.0
 Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
 Author-email: YuConggen <1516933915@qq.com>
 License-Expression: MIT
@@ -45,6 +45,8 @@ Provides-Extra: redis
 Requires-Dist: redis==8.1.0; extra == "redis"
 Provides-Extra: rabbitmq
 Requires-Dist: pika==1.4.4; extra == "rabbitmq"
+Provides-Extra: kafka
+Requires-Dist: kafka-python==2.0.2; extra == "kafka"
 Provides-Extra: nacos
 Requires-Dist: nacos-sdk-python==2.0.11; extra == "nacos"
 Provides-Extra: prometheus
@@ -61,7 +63,7 @@ Requires-Dist: langchain-core==1.5.4; extra == "ai"
 Requires-Dist: langchain-classic==1.0.8; extra == "ai"
 Requires-Dist: langchain-text-splitters==1.1.2; extra == "ai"
 Requires-Dist: langchain-community==0.4.2; extra == "ai"
-Requires-Dist: numpy==2.2.6; extra == "ai"
+Requires-Dist: numpy==2.3.0; extra == "ai"
 Requires-Dist: pydantic==2.13.4; extra == "ai"
 Provides-Extra: langchain
 Requires-Dist: langchain-openai==1.4.2; extra == "langchain"
@@ -69,7 +71,7 @@ Requires-Dist: langchain-core==1.5.4; extra == "langchain"
 Requires-Dist: langchain-classic==1.0.8; extra == "langchain"
 Requires-Dist: langchain-text-splitters==1.1.2; extra == "langchain"
 Requires-Dist: langchain-community==0.4.2; extra == "langchain"
-Requires-Dist: numpy==2.2.6; extra == "langchain"
+Requires-Dist: numpy==2.3.0; extra == "langchain"
 Requires-Dist: pydantic==2.13.4; extra == "langchain"
 Requires-Dist: faiss-cpu<2,>=1.7.4; extra == "langchain"
 Requires-Dist: pypdf<6,>=4.0.0; extra == "langchain"
@@ -89,6 +91,32 @@ Requires-Dist: langgraph==1.2.9; extra == "langgraph"
 Requires-Dist: langgraph-checkpoint-sqlite==3.1.1; extra == "langgraph"
 Provides-Extra: mcp
 Requires-Dist: mcp==2.0.0; extra == "mcp"
+Provides-Extra: web
+Requires-Dist: fastapi==0.115.6; extra == "web"
+Requires-Dist: uvicorn==0.34.0; extra == "web"
+Requires-Dist: pydantic==2.13.4; extra == "web"
+Requires-Dist: python-multipart==0.0.20; extra == "web"
+Provides-Extra: cloud
+Requires-Dist: springbootAI[web]; extra == "cloud"
+Requires-Dist: springbootAI[redis]; extra == "cloud"
+Requires-Dist: springbootAI[rabbitmq]; extra == "cloud"
+Requires-Dist: springbootAI[kafka]; extra == "cloud"
+Requires-Dist: httpx==0.28.1; extra == "cloud"
+Provides-Extra: all
+Requires-Dist: springbootAI[web]; extra == "all"
+Requires-Dist: springbootAI[mysql]; extra == "all"
+Requires-Dist: springbootAI[redis]; extra == "all"
+Requires-Dist: springbootAI[rabbitmq]; extra == "all"
+Requires-Dist: springbootAI[kafka]; extra == "all"
+Requires-Dist: springbootAI[prometheus]; extra == "all"
+Requires-Dist: springbootAI[logging]; extra == "all"
+Requires-Dist: springbootAI[excel]; extra == "all"
+Requires-Dist: springbootAI[ai]; extra == "all"
+Requires-Dist: springbootAI[langchain]; extra == "all"
+Requires-Dist: springbootAI[langgraph]; extra == "all"
+Requires-Dist: springbootAI[mcp]; extra == "all"
+Requires-Dist: httpx==0.28.1; extra == "all"
+Requires-Dist: psutil==6.1.1; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest==9.1.1; extra == "dev"
 Requires-Dist: pytest-cov==7.1.0; extra == "dev"
@@ -113,7 +141,7 @@ Requires-Dist: langchain-core==1.5.4; extra == "full"
 Requires-Dist: langchain-classic==1.0.8; extra == "full"
 Requires-Dist: langchain-text-splitters==1.1.2; extra == "full"
 Requires-Dist: langchain-community==0.4.2; extra == "full"
-Requires-Dist: numpy==2.2.6; extra == "full"
+Requires-Dist: numpy==2.3.0; extra == "full"
 Requires-Dist: pydantic==2.13.4; extra == "full"
 Requires-Dist: faiss-cpu<2,>=1.7.4; extra == "full"
 Requires-Dist: pypdf<6,>=4.0.0; extra == "full"
@@ -134,6 +162,10 @@ Dynamic: license-file
 
 # SpringBootAI
 
+<p align="center">
+  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+</p>
+
 [![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)
@@ -151,7 +183,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.2.1`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 当前验证的是官方 TC + TCC 回调，不会为 Python 数据库操作自动生成 AT `undo_log`。
+当前版本是 `2.3.0`；支持 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)
 
@@ -245,21 +277,24 @@ curl http://127.0.0.1:8080/api/hello/Alice
 | 模块 | 文档 | 安装方式 | 一句话说明 |
 |------|------|----------|-----------|
 | ✅ 新手入门 | [BEGINNER_GUIDE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | 随核心包 | 从零安装、创建项目、运行接口、打开 Swagger |
+| ✅ Web MVC | [WEB_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/WEB_MODULE.md) | 随核心包 | `@RestController` / 路由映射 / 参数绑定 / 跨域 / 全局异常处理 |
 | ✅ 常用注解模块 | [ANNOTATION_MODULES.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ANNOTATION_MODULES.md) | 随核心包 | Bean Validation / 条件装配 / 缓存增强 / CSV / `@Version` / `@Transient` |
+| ✅ Bean 生命周期与增强 | [LIFECYCLE_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/LIFECYCLE_MODULE.md) | 随核心包 | `@PostConstruct` / `@Slf4j` / `@Primary` / `@Profile` / `@AuditLog` / `@FeatureToggle` |
 | ✅ AOP / 后置鉴权 / 重试恢复 | [AOP_SECURITY_RETRY.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/AOP_SECURITY_RETRY.md) | 随核心包 | `@Aspect` 通知 / `@PostAuthorize` / `@Recover`，含小白示例与常见错误 |
+| ✅ 并发与弹性 | [CONCURRENCY_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CONCURRENCY_MODULE.md) | 随核心包 | `@Async` / `@Scheduled` / `@RateLimit` / `@CircuitBreaker` / `@Idempotent` / `@Lock` |
 | 📦 AI（对接大模型） | [AI_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/AI_MODULE.md) | `pip install springbootAI[ai]` | ChatClient / Advisor / Tools / RAG / Function Calling / 多厂商适配 |
 | 📦 LangChain | [LANGCHAIN_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/LANGCHAIN_MODULE.md) | `pip install springbootAI[langchain]` | Chains / Agents / Memory / Retrievers / VectorStores / 30+ 提供商 |
 | 📦 LangGraph | [LANGGRAPH_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/LANGGRAPH_MODULE.md) | `pip install springbootAI[langgraph]` | 状态图 / 条件路由 / 人工中断 / 注解式工作流 |
 | 📦 MCP | [MCP_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/MCP_MODULE.md) | `pip install springbootAI[mcp]` | MCP Client / Server / Tool / Resource / Prompt / 注解调用 |
-| ✅ 内嵌 PyMyBatis ORM | [ORM_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ORM_MODULE.md) | 随核心包 | Mapper 注解 / XML Mapper / 分页 / SQL 安全 / DDL 自动建表 |
+| ✅ 内嵌 PyMyBatis ORM | [ORM_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ORM_MODULE.md) | 随核心包 | Mapper 注解 / XML Mapper / 分页 / SQL 安全 / DDL 自动建表 / Repository 分页查询 |
 | ✅ JPA 实体与仓库 | [JPA_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/JPA_MODULE.md) | 随核心包 | `@Entity` + `@Table` / 字段自动推断 / `@CreateTime` / Repository / DataJpaTest |
 | ✅ Cloud 微服务 | [CLOUD_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CLOUD_MODULE.md) | 随核心包 | 服务注册发现 / 配置刷新 / Feign / Sentinel / Gateway / 分布式事务 |
+| 📦 消息队列 | [MESSAGING_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/MESSAGING_MODULE.md) | `pip install springbootAI[rabbitmq]` | `@RabbitListener` / `RabbitTemplate` RabbitMQ 消息收发 |
 | 📦 Excel 读写 | [EXCEL_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/EXCEL_MODULE.md) | `pip install springbootAI[excel]` | `@ExcelProperty` / `@ExcelIgnore` 注解驱动读写 |
 | 📦 CSV 读写 | [CSV_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CSV_MODULE.md) | `pip install springbootAI[csv]` | `@CsvProperty` / `@CsvIgnore` 注解驱动读写 |
 | ✅ Swagger 文档 | [SWAGGER_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/SWAGGER_MODULE.md) | 随核心包 | `@Tag` / `@Operation` 注解驱动 API 文档 |
 | ✅ 安全 | [SECURITY.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/SECURITY.md) | 随核心包 | JWT 生成校验 / 密码加密 / SQL 注入防护 / 访问控制 |
 | ✅ BeanUtils | [BEAN_UTILS.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEAN_UTILS.md) | 随核心包 | `copy_properties` / `clone` 属性复制工具 |
-| ✅ ① Repository | [REPOSITORY_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/REPOSITORY_MODULE.md) | 随核心包 | 不用手写SQL的分页查询 |
 | ✅ ② Actuator | [ACTUATOR_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ACTUATOR_MODULE.md) | 随核心包 | 系统健康检查面板 |
 | ✅ ③ 多数据源 | [DATASOURCE_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/DATASOURCE_MODULE.md) | 随核心包 | 读写分离 |
 | ✅ ④ 事务事件 | [TX_EVENT_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/TX_EVENT_MODULE.md) | 随核心包 | 操作完成后自动发通知 |
@@ -267,6 +302,10 @@ curl http://127.0.0.1:8080/api/hello/Alice
 | ✅ ⑥ 测试切片 | [TEST_SLICE_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/TEST_SLICE_MODULE.md) | 随核心包 | 只测试你关心的部分 |
 | ✅ ⑦ i18n | [I18N_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/I18N_MODULE.md) | 随核心包 | 中英文自动切换 |
 | ✅ ⑧ WebSocket | [WEBSOCKET_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/WEBSOCKET_MODULE.md) | 随核心包 | 像微信一样实时通信 |
+| ✅ 企业级注解驱动 | [ENTERPRISE_ANNOTATIONS.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ENTERPRISE_ANNOTATIONS.md) | 随核心包 | `@EnableOAuth2`/`@EnableCsrf`/`@EnableDevTools`/`@EnableBatchProcessing` 等10个注解 |
+| ✅ 数据库迁移 | [MIGRATION_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/MIGRATION_MODULE.md) | 随核心包 | Flyway风格版本化迁移/Undo回滚/迁移锁/变量替换 |
+| ✅ Starter机制 | [STARTER_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/STARTER_MODULE.md) | 随核心包 | `pip install springbootAI[web/cloud/all]` 组合依赖 |
+| ✅ CLI与脚手架 | [CLI_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CLI_MODULE.md) | 随核心包 | `springbootai init/run/docs` 命令行工具 |
 | — AI 与 LangChain 测试 | [AI_LANGCHAIN_TEST_GUIDE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/AI_LANGCHAIN_TEST_GUIDE.md) | — | AI 与 LangChain 测试说明 |
 | — 测试报告 | [TEST_REPORT.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/TEST_REPORT.md) | — | 全量测试用例与覆盖范围 |
 
@@ -277,10 +316,11 @@ curl http://127.0.0.1:8080/api/hello/Alice
 ### 🎯 新手推荐阅读顺序
 
 1. 先按 [新手入门指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) 跑通 `/api/hello/{name}`。
-2. 阅读本页第 4、6、7 章，理解配置、依赖注入和 Controller。
+2. 阅读本页第 4、6、7 章，理解配置、依赖注入和 Controller；深入学习 Web 注解看 [WEB_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/WEB_MODULE.md)。
 3. 做数据库 CRUD 时阅读 [ORM_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ORM_MODULE.md)。
 4. 需要输入校验、缓存或条件开关时阅读 [ANNOTATION_MODULES.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ANNOTATION_MODULES.md)。
-5. 最后再按业务需要选择安全、Cloud、AI、LangChain、Excel、WebSocket 等文档。
+5. 需要异步、定时任务、限流、熔断时阅读 [CONCURRENCY_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CONCURRENCY_MODULE.md)。
+6. 最后再按业务需要选择安全、Cloud、消息队列、AI、LangChain、Excel、WebSocket 等文档。
 
 ---
 
@@ -323,10 +363,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `spring` 框架 API | 2.2.1 |
-| `spring.orm.pymybatis` | 2.2.1 |
-| `spring.ai` AI 模块 | 2.2.1 |
-| `spring.langchain` LangChain 模块 | 2.2.1 |
+| `spring` 框架 API | 2.3.0 |
+| `spring.orm.pymybatis` | 2.3.0 |
+| `spring.ai` AI 模块 | 2.3.0 |
+| `spring.langchain` LangChain 模块 | 2.3.0 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景
@@ -342,7 +382,7 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 - `@Transactional` 支持七种 Spring 传播模式；`REQUIRES_NEW` 和 `NOT_SUPPORTED` 需要连接池有额外可用连接。
 - Profile 会筛选 `@Profile` Bean，并深度合并同目录的 `application-{profile}.yml`。
 - Nacos、RabbitMQ、Prometheus 依赖外部服务；Sentinel 限流熔断和 OpenTelemetry 追踪可内嵌运行。
-- HTTP 事务模式是持久化补偿协调器，不提供 Seata AT 一致性；`distributed` 模式当前提供真实 Seata TC + TCC 回调，不会自动代理 Python 数据源或生成 `undo_log`。
+- HTTP 事务模式是持久化补偿协调器；`distributed` 模式提供真实 Seata TC + TCC 回调；`at` 模式通过 ORM 拦截器自动记录 undo_log 并在回滚时反向恢复数据。
 - 限流、分布式锁、幂等和缓存语义依赖 Redis 等后端；核心业务必须选择 fail-closed，不能依赖进程内降级继续提供分布式语义。
 
 ### 1.6 注解使用总览
@@ -377,7 +417,7 @@ SpringBootAI 注解会先把元数据放到 `__spring_annotations__`。之后是
 | Nacos 服务发现 | ✅ 可用 | 服务注册/发现/订阅 |
 | Sentinel 限流熔断 | ✅ 可用 | 内嵌引擎，QPS 限流、异常比例熔断、热点参数限流，无需 Dashboard |
 | 分布式追踪 | ✅ 可用 | 原生 OpenTelemetry(W3C traceparent)，自动 HTTP/Feign 注入 |
-| Seata 分布式事务 | ⚠️ 有边界 | `distributed` 对接真实 Seata TC 并执行 TCC 回调；`http` 仅提供持久化补偿；均不等同 Python AT 数据源代理 |
+| Seata 分布式事务 | ✅ 可用 | `distributed` 对接真实 Seata TC 执行 TCC 回调；`at` 模式通过 ORM 拦截器自动记录 undo_log 并反向恢复；`http` 提供持久化补偿 |
 | API Gateway | ✅ 可用 | 轻量 ASGI/WSGI 网关，路由转发、路径重写、过滤器链、负载均衡 |
 | Prometheus 监控 | ✅ 可用 | Counter/Gauge/Histogram 指标暴露 |
 | Feign 声明式 HTTP | ✅ 可用 | 声明式接口、Fallback 降级、自动传播 XID 和 trace 头 |
@@ -482,7 +522,7 @@ python -c "from spring.orm.pymybatis import __version__; print(__version__)"
 
 ### 3.5 最小应用
 
-仓库中的 `example_all`、`example_langchain`、`example_langgraph`、`example_mcp`、`test_cloud_app` 只用于源码参考和回归验证，不会打包进 `springbootAI`。安装后请按下面结构创建自己的应用包。**每个被扫描目录都必须包含 `__init__.py`，并从项目根目录启动。**
+仓库中的 `examples/example_all`、`examples/example_langchain`、`examples/example_langgraph`、`examples/example_mcp`、`examples/test_cloud_app` 只用于源码参考和回归验证，不会打包进 `springbootAI`。安装后请按下面结构创建自己的应用包。**每个被扫描目录都必须包含 `__init__.py`，并从项目根目录启动。**
 
 创建包结构：
 
@@ -1660,7 +1700,7 @@ curl http://localhost:8080/actuator/health
 
 ## 15. 项目结构
 
-`example_all`、`example_langchain`、`example_langgraph`、`example_mcp`、`test_cloud_app` 是仓库级示例，不属于 `springbootAI` 安装包。实际项目应创建自己的应用包。
+`examples/example_all`、`examples/example_langchain`、`examples/example_langgraph`、`examples/example_mcp`、`examples/test_cloud_app` 是仓库级示例，不属于 `springbootAI` 安装包。实际项目应创建自己的应用包。
 
 推荐目录结构：
 
@@ -1767,7 +1807,7 @@ python -m pytest -q tests
 .\scripts\run-load-test.ps1 -Profile smoke
 ```
 
-完整参数和说明见 [性能测试指南](https://github.com/YUCONGGEN/springbootAI/blob/master/tests_performance/README.md)。
+完整参数和说明见 [性能测试指南](https://github.com/YUCONGGEN/springbootAI/blob/master/tests/performance/README.md)。
 
 AI、LangChain、LangGraph 和 MCP 已提供独立 workload，并已加入 9 小时 `mixed` 长稳测试。默认使用 Fake 模型和进程内 MCP Server，不访问外部模型、不会产生 Token 费用：
 

{springbootai-2.2.5 → springbootai-2.3.0}/README.md

@@ -1,5 +1,9 @@
 # SpringBootAI
 
+<p align="center">
+  <img src="doc/images/hero-banner.png" alt="SpringBootAI 功能总览" width="100%" />
+</p>
+
 [![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)
@@ -17,7 +21,7 @@ SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用
 | AI 与编排 | 模型调用、Tools、RAG、Chain、状态图、MCP client/server | LangChain / LangGraph / 官方 MCP SDK |
 | 生产治理 | 健康检查、Prometheus、限流熔断、追踪、Swagger | prometheus-client / OpenTelemetry / OpenAPI |
 
-当前版本是 `2.2.1`；支持 Python 3.10、3.11 和 3.12，许可证为 MIT。项目仍标记为 Beta。用于公网高并发、合规敏感或支付/订单/库存等核心系统前，必须完成目标数据库、流量模型、故障恢复和安全基线验证。内嵌 Gateway 适合内部路由，不替代公网 Nginx/Kong/WAF；Seata `distributed` 当前验证的是官方 TC + TCC 回调，不会为 Python 数据库操作自动生成 AT `undo_log`。
+当前版本是 `2.3.0`；支持 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)
 
@@ -111,21 +115,24 @@ curl http://127.0.0.1:8080/api/hello/Alice
 | 模块 | 文档 | 安装方式 | 一句话说明 |
 |------|------|----------|-----------|
 | ✅ 新手入门 | [BEGINNER_GUIDE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) | 随核心包 | 从零安装、创建项目、运行接口、打开 Swagger |
+| ✅ Web MVC | [WEB_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/WEB_MODULE.md) | 随核心包 | `@RestController` / 路由映射 / 参数绑定 / 跨域 / 全局异常处理 |
 | ✅ 常用注解模块 | [ANNOTATION_MODULES.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ANNOTATION_MODULES.md) | 随核心包 | Bean Validation / 条件装配 / 缓存增强 / CSV / `@Version` / `@Transient` |
+| ✅ Bean 生命周期与增强 | [LIFECYCLE_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/LIFECYCLE_MODULE.md) | 随核心包 | `@PostConstruct` / `@Slf4j` / `@Primary` / `@Profile` / `@AuditLog` / `@FeatureToggle` |
 | ✅ AOP / 后置鉴权 / 重试恢复 | [AOP_SECURITY_RETRY.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/AOP_SECURITY_RETRY.md) | 随核心包 | `@Aspect` 通知 / `@PostAuthorize` / `@Recover`，含小白示例与常见错误 |
+| ✅ 并发与弹性 | [CONCURRENCY_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CONCURRENCY_MODULE.md) | 随核心包 | `@Async` / `@Scheduled` / `@RateLimit` / `@CircuitBreaker` / `@Idempotent` / `@Lock` |
 | 📦 AI（对接大模型） | [AI_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/AI_MODULE.md) | `pip install springbootAI[ai]` | ChatClient / Advisor / Tools / RAG / Function Calling / 多厂商适配 |
 | 📦 LangChain | [LANGCHAIN_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/LANGCHAIN_MODULE.md) | `pip install springbootAI[langchain]` | Chains / Agents / Memory / Retrievers / VectorStores / 30+ 提供商 |
 | 📦 LangGraph | [LANGGRAPH_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/LANGGRAPH_MODULE.md) | `pip install springbootAI[langgraph]` | 状态图 / 条件路由 / 人工中断 / 注解式工作流 |
 | 📦 MCP | [MCP_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/MCP_MODULE.md) | `pip install springbootAI[mcp]` | MCP Client / Server / Tool / Resource / Prompt / 注解调用 |
-| ✅ 内嵌 PyMyBatis ORM | [ORM_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ORM_MODULE.md) | 随核心包 | Mapper 注解 / XML Mapper / 分页 / SQL 安全 / DDL 自动建表 |
+| ✅ 内嵌 PyMyBatis ORM | [ORM_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ORM_MODULE.md) | 随核心包 | Mapper 注解 / XML Mapper / 分页 / SQL 安全 / DDL 自动建表 / Repository 分页查询 |
 | ✅ JPA 实体与仓库 | [JPA_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/JPA_MODULE.md) | 随核心包 | `@Entity` + `@Table` / 字段自动推断 / `@CreateTime` / Repository / DataJpaTest |
 | ✅ Cloud 微服务 | [CLOUD_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CLOUD_MODULE.md) | 随核心包 | 服务注册发现 / 配置刷新 / Feign / Sentinel / Gateway / 分布式事务 |
+| 📦 消息队列 | [MESSAGING_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/MESSAGING_MODULE.md) | `pip install springbootAI[rabbitmq]` | `@RabbitListener` / `RabbitTemplate` RabbitMQ 消息收发 |
 | 📦 Excel 读写 | [EXCEL_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/EXCEL_MODULE.md) | `pip install springbootAI[excel]` | `@ExcelProperty` / `@ExcelIgnore` 注解驱动读写 |
 | 📦 CSV 读写 | [CSV_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CSV_MODULE.md) | `pip install springbootAI[csv]` | `@CsvProperty` / `@CsvIgnore` 注解驱动读写 |
 | ✅ Swagger 文档 | [SWAGGER_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/SWAGGER_MODULE.md) | 随核心包 | `@Tag` / `@Operation` 注解驱动 API 文档 |
 | ✅ 安全 | [SECURITY.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/SECURITY.md) | 随核心包 | JWT 生成校验 / 密码加密 / SQL 注入防护 / 访问控制 |
 | ✅ BeanUtils | [BEAN_UTILS.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEAN_UTILS.md) | 随核心包 | `copy_properties` / `clone` 属性复制工具 |
-| ✅ ① Repository | [REPOSITORY_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/REPOSITORY_MODULE.md) | 随核心包 | 不用手写SQL的分页查询 |
 | ✅ ② Actuator | [ACTUATOR_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ACTUATOR_MODULE.md) | 随核心包 | 系统健康检查面板 |
 | ✅ ③ 多数据源 | [DATASOURCE_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/DATASOURCE_MODULE.md) | 随核心包 | 读写分离 |
 | ✅ ④ 事务事件 | [TX_EVENT_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/TX_EVENT_MODULE.md) | 随核心包 | 操作完成后自动发通知 |
@@ -133,6 +140,10 @@ curl http://127.0.0.1:8080/api/hello/Alice
 | ✅ ⑥ 测试切片 | [TEST_SLICE_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/TEST_SLICE_MODULE.md) | 随核心包 | 只测试你关心的部分 |
 | ✅ ⑦ i18n | [I18N_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/I18N_MODULE.md) | 随核心包 | 中英文自动切换 |
 | ✅ ⑧ WebSocket | [WEBSOCKET_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/WEBSOCKET_MODULE.md) | 随核心包 | 像微信一样实时通信 |
+| ✅ 企业级注解驱动 | [ENTERPRISE_ANNOTATIONS.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ENTERPRISE_ANNOTATIONS.md) | 随核心包 | `@EnableOAuth2`/`@EnableCsrf`/`@EnableDevTools`/`@EnableBatchProcessing` 等10个注解 |
+| ✅ 数据库迁移 | [MIGRATION_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/MIGRATION_MODULE.md) | 随核心包 | Flyway风格版本化迁移/Undo回滚/迁移锁/变量替换 |
+| ✅ Starter机制 | [STARTER_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/STARTER_MODULE.md) | 随核心包 | `pip install springbootAI[web/cloud/all]` 组合依赖 |
+| ✅ CLI与脚手架 | [CLI_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CLI_MODULE.md) | 随核心包 | `springbootai init/run/docs` 命令行工具 |
 | — AI 与 LangChain 测试 | [AI_LANGCHAIN_TEST_GUIDE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/AI_LANGCHAIN_TEST_GUIDE.md) | — | AI 与 LangChain 测试说明 |
 | — 测试报告 | [TEST_REPORT.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/TEST_REPORT.md) | — | 全量测试用例与覆盖范围 |
 
@@ -143,10 +154,11 @@ curl http://127.0.0.1:8080/api/hello/Alice
 ### 🎯 新手推荐阅读顺序
 
 1. 先按 [新手入门指南](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/BEGINNER_GUIDE.md) 跑通 `/api/hello/{name}`。
-2. 阅读本页第 4、6、7 章，理解配置、依赖注入和 Controller。
+2. 阅读本页第 4、6、7 章，理解配置、依赖注入和 Controller；深入学习 Web 注解看 [WEB_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/WEB_MODULE.md)。
 3. 做数据库 CRUD 时阅读 [ORM_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ORM_MODULE.md)。
 4. 需要输入校验、缓存或条件开关时阅读 [ANNOTATION_MODULES.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/ANNOTATION_MODULES.md)。
-5. 最后再按业务需要选择安全、Cloud、AI、LangChain、Excel、WebSocket 等文档。
+5. 需要异步、定时任务、限流、熔断时阅读 [CONCURRENCY_MODULE.md](https://github.com/YUCONGGEN/springbootAI/blob/master/doc/CONCURRENCY_MODULE.md)。
+6. 最后再按业务需要选择安全、Cloud、消息队列、AI、LangChain、Excel、WebSocket 等文档。
 
 ---
 
@@ -189,10 +201,10 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 
 | 组件 | 当前版本 |
 |------|----------|
-| `spring` 框架 API | 2.2.1 |
-| `spring.orm.pymybatis` | 2.2.1 |
-| `spring.ai` AI 模块 | 2.2.1 |
-| `spring.langchain` LangChain 模块 | 2.2.1 |
+| `spring` 框架 API | 2.3.0 |
+| `spring.orm.pymybatis` | 2.3.0 |
+| `spring.ai` AI 模块 | 2.3.0 |
+| `spring.langchain` LangChain 模块 | 2.3.0 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景
@@ -208,7 +220,7 @@ SpringBootAI 是一个 **Python Web 框架**。它把 Java Spring Boot 的"注
 - `@Transactional` 支持七种 Spring 传播模式；`REQUIRES_NEW` 和 `NOT_SUPPORTED` 需要连接池有额外可用连接。
 - Profile 会筛选 `@Profile` Bean，并深度合并同目录的 `application-{profile}.yml`。
 - Nacos、RabbitMQ、Prometheus 依赖外部服务；Sentinel 限流熔断和 OpenTelemetry 追踪可内嵌运行。
-- HTTP 事务模式是持久化补偿协调器，不提供 Seata AT 一致性；`distributed` 模式当前提供真实 Seata TC + TCC 回调，不会自动代理 Python 数据源或生成 `undo_log`。
+- HTTP 事务模式是持久化补偿协调器；`distributed` 模式提供真实 Seata TC + TCC 回调；`at` 模式通过 ORM 拦截器自动记录 undo_log 并在回滚时反向恢复数据。
 - 限流、分布式锁、幂等和缓存语义依赖 Redis 等后端；核心业务必须选择 fail-closed，不能依赖进程内降级继续提供分布式语义。
 
 ### 1.6 注解使用总览
@@ -243,7 +255,7 @@ SpringBootAI 注解会先把元数据放到 `__spring_annotations__`。之后是
 | Nacos 服务发现 | ✅ 可用 | 服务注册/发现/订阅 |
 | Sentinel 限流熔断 | ✅ 可用 | 内嵌引擎，QPS 限流、异常比例熔断、热点参数限流，无需 Dashboard |
 | 分布式追踪 | ✅ 可用 | 原生 OpenTelemetry(W3C traceparent)，自动 HTTP/Feign 注入 |
-| Seata 分布式事务 | ⚠️ 有边界 | `distributed` 对接真实 Seata TC 并执行 TCC 回调；`http` 仅提供持久化补偿；均不等同 Python AT 数据源代理 |
+| Seata 分布式事务 | ✅ 可用 | `distributed` 对接真实 Seata TC 执行 TCC 回调；`at` 模式通过 ORM 拦截器自动记录 undo_log 并反向恢复；`http` 提供持久化补偿 |
 | API Gateway | ✅ 可用 | 轻量 ASGI/WSGI 网关，路由转发、路径重写、过滤器链、负载均衡 |
 | Prometheus 监控 | ✅ 可用 | Counter/Gauge/Histogram 指标暴露 |
 | Feign 声明式 HTTP | ✅ 可用 | 声明式接口、Fallback 降级、自动传播 XID 和 trace 头 |
@@ -348,7 +360,7 @@ python -c "from spring.orm.pymybatis import __version__; print(__version__)"
 
 ### 3.5 最小应用
 
-仓库中的 `example_all`、`example_langchain`、`example_langgraph`、`example_mcp`、`test_cloud_app` 只用于源码参考和回归验证，不会打包进 `springbootAI`。安装后请按下面结构创建自己的应用包。**每个被扫描目录都必须包含 `__init__.py`，并从项目根目录启动。**
+仓库中的 `examples/example_all`、`examples/example_langchain`、`examples/example_langgraph`、`examples/example_mcp`、`examples/test_cloud_app` 只用于源码参考和回归验证，不会打包进 `springbootAI`。安装后请按下面结构创建自己的应用包。**每个被扫描目录都必须包含 `__init__.py`，并从项目根目录启动。**
 
 创建包结构：
 
@@ -1526,7 +1538,7 @@ curl http://localhost:8080/actuator/health
 
 ## 15. 项目结构
 
-`example_all`、`example_langchain`、`example_langgraph`、`example_mcp`、`test_cloud_app` 是仓库级示例，不属于 `springbootAI` 安装包。实际项目应创建自己的应用包。
+`examples/example_all`、`examples/example_langchain`、`examples/example_langgraph`、`examples/example_mcp`、`examples/test_cloud_app` 是仓库级示例，不属于 `springbootAI` 安装包。实际项目应创建自己的应用包。
 
 推荐目录结构：
 
@@ -1633,7 +1645,7 @@ python -m pytest -q tests
 .\scripts\run-load-test.ps1 -Profile smoke
 ```
 
-完整参数和说明见 [性能测试指南](https://github.com/YUCONGGEN/springbootAI/blob/master/tests_performance/README.md)。
+完整参数和说明见 [性能测试指南](https://github.com/YUCONGGEN/springbootAI/blob/master/tests/performance/README.md)。
 
 AI、LangChain、LangGraph 和 MCP 已提供独立 workload，并已加入 9 小时 `mixed` 长稳测试。默认使用 Fake 模型和进程内 MCP Server，不访问外部模型、不会产生 Token 费用：
 

{springbootai-2.2.5 → springbootai-2.3.0}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 [project]
 # 发行名 springbootAI（PyPI 包名，pip install springbootAI）；导入包名仍为 spring
 name = "springbootAI"
-version = "2.2.5"
+version = "2.3.0"
 description = "Spring-style Python framework with Web, ORM, Cloud and AI integrations"
 readme = "README.md"
 license = "MIT"
@@ -71,6 +71,7 @@ redis = ["redis==8.1.0"]
 # 消息队列 - 类似 Spring Boot Starter AMQP
 # ========================================
 rabbitmq = ["pika==1.4.4"]
+kafka = ["kafka-python==2.0.2"]
 
 # ========================================
 # 服务发现 - 类似 Spring Cloud Alibaba Nacos
@@ -106,7 +107,7 @@ ai = [
     "langchain-classic==1.0.8",
     "langchain-text-splitters==1.1.2",
     "langchain-community==0.4.2",
-    "numpy==2.2.6",
+    "numpy==2.3.0",
     "pydantic==2.13.4",
 ]
 
@@ -122,7 +123,7 @@ langchain = [
     "langchain-classic==1.0.8",
     "langchain-text-splitters==1.1.2",
     "langchain-community==0.4.2",
-    "numpy==2.2.6",
+    "numpy==2.3.0",
     "pydantic==2.13.4",
     # 默认装上的向量库/文档/工具依赖（安全：全部锁定已知安全版本）
     "faiss-cpu>=1.7.4,<2",
@@ -158,6 +159,40 @@ mcp = [
     "mcp==2.0.0",
 ]
 
+# ========================================
+# 组合 Starter - 类似 Spring Boot Starter Web/Cloud/All
+# 安装：pip install springbootAI[web] / springbootAI[cloud] / springbootAI[all]
+# ========================================
+web = [
+    "fastapi==0.115.6",
+    "uvicorn==0.34.0",
+    "pydantic==2.13.4",
+    "python-multipart==0.0.20",
+]
+cloud = [
+    "springbootAI[web]",
+    "springbootAI[redis]",
+    "springbootAI[rabbitmq]",
+    "springbootAI[kafka]",
+    "httpx==0.28.1",
+]
+all = [
+    "springbootAI[web]",
+    "springbootAI[mysql]",
+    "springbootAI[redis]",
+    "springbootAI[rabbitmq]",
+    "springbootAI[kafka]",
+    "springbootAI[prometheus]",
+    "springbootAI[logging]",
+    "springbootAI[excel]",
+    "springbootAI[ai]",
+    "springbootAI[langchain]",
+    "springbootAI[langgraph]",
+    "springbootAI[mcp]",
+    "httpx==0.28.1",
+    "psutil==6.1.1",
+]
+
 # ========================================
 # 开发依赖
 # ========================================
@@ -196,7 +231,7 @@ full = [
     "langchain-classic==1.0.8",
     "langchain-text-splitters==1.1.2",
     "langchain-community==0.4.2",
-    "numpy==2.2.6",
+    "numpy==2.3.0",
     "pydantic==2.13.4",
     # LangChain 模块增强（对齐 springbootAI[langchain]）
     "faiss-cpu>=1.7.4,<2",
@@ -220,7 +255,7 @@ full = [
 ]
 
 [tool.pytest.ini_options]
-pythonpath = ["."]
+pythonpath = [".", "examples"]
 filterwarnings = [
     # 静默 langchain_classic 弃用告警和 community sunset 告警
     # 原因：本项目有意锁定 langchain classic (1.x) API，这些是预期内的框架级告警
@@ -253,6 +288,9 @@ Issues = "https://github.com/YUCONGGEN/springbootAI/issues"
 
 [project.scripts]
 springbootai = "spring.main:run_cli"
+# 项目脚手架工具（类似 Spring Initializr），初始化符合 SpringBootAI 风格的新项目
+# 用法：springbootai-init my-project --modules web,orm
+springbootai-init = "spring.cli.scaffold:main"
 
 [tool.setuptools.packages.find]
 include = ["spring*"]

{springbootai-2.2.5 → springbootai-2.3.0}/requirements-ai.txt

@@ -30,6 +30,7 @@ langchain-text-splitters==1.1.2
 langchain-community==0.4.2
 
 # 向量相似度计算（cosine_similarity 等，未安装时降级内置 math.sqrt 实现）
+# 锁定 2.2.6 以保持 Python 3.10 兼容性（numpy 2.3+ 要求 Python >=3.11）
 numpy==2.2.6
 
 # 数据校验（pydantic v2，OutputParser 结构化输出依赖）

{springbootai-2.2.5 → springbootai-2.3.0}/spring/__init__.py

@@ -5,7 +5,7 @@ from .config import *
 from .utils import *
 from .main import create_app, run, SpringApplication, run_cli
 
-__version__ = "2.2.1"
+__version__ = "2.3.0"
 __author__ = "yuconggen"
 __license__ = "MIT"