springbootAI 2.3.4__tar.gz → 2.3.6__tar.gz

{springbootai-2.3.4 → springbootai-2.3.6}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [2.3.6] - 2026-08-20
+
+### PyPI 展示修复
+
+- 新增不含外链图片的 `README_PYPI.md`，作为 PyPI 项目说明，避免外链图片被转换到不可访问的 PyPI Camo 代理后显示为破损图片。
+- GitHub 继续使用包含功能总览图和状态徽章的 `README.md`，两端展示互不影响。
+- 发布版本升级到 `2.3.6`，同步框架主包、扩展模块、PyMyBatis 内嵌版本、README 版本矩阵和打包元数据。
+
+## [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
 
 ### 新增与完善

{springbootai-2.3.4 → springbootai-2.3.6}/MANIFEST.in

@@ -1,4 +1,4 @@
-include README.md
+include README.md README_PYPI.md
 include LICENSE
 include CHANGELOG.md
 include SECURITY.md

springbootai-2.3.6/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: springbootAI
+Version: 2.3.6
+Summary: Spring-style Python framework with Web, ORM, Cloud and AI integrations
+Author-email: YuConggen <1516933915@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/YUCONGGEN/springbootAI
+Project-URL: Repository, https://github.com/YUCONGGEN/springbootAI.git
+Project-URL: Documentation, https://github.com/YUCONGGEN/springbootAI#readme
+Project-URL: Changelog, https://github.com/YUCONGGEN/springbootAI/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/YUCONGGEN/springbootAI/issues
+Keywords: spring,springboot,mybatis,orm,web,framework,python,ai,langchain,langgraph,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Database
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi==0.141.1
+Requires-Dist: uvicorn==0.39.0
+Requires-Dist: websockets==15.0.1
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: DBUtils==3.1.2
+Requires-Dist: cryptography==50.0.0
+Requires-Dist: bcrypt==5.0.0
+Requires-Dist: pyjwt==2.13.0
+Requires-Dist: pydantic==2.13.4
+Requires-Dist: requests==2.34.2
+Requires-Dist: httpx==0.28.1
+Requires-Dist: defusedxml==0.7.1
+Provides-Extra: mysql
+Requires-Dist: PyMySQL==1.2.0; extra == "mysql"
+Provides-Extra: postgresql
+Requires-Dist: psycopg2-binary==2.9.12; extra == "postgresql"
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy==2.0.40; extra == "sqlalchemy"
+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
+Requires-Dist: prometheus-client==0.26.0; extra == "prometheus"
+Provides-Extra: logging
+Requires-Dist: loguru==0.7.3; extra == "logging"
+Provides-Extra: ast
+Requires-Dist: sqlglot==27.28.1; extra == "ast"
+Provides-Extra: excel
+Requires-Dist: openpyxl==3.1.5; extra == "excel"
+Provides-Extra: ai
+Requires-Dist: langchain-openai==1.4.2; extra == "ai"
+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: pydantic==2.13.4; extra == "ai"
+Provides-Extra: langchain
+Requires-Dist: langchain-openai==1.4.2; extra == "langchain"
+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: 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"
+Requires-Dist: beautifulsoup4<5,>=4.12.0; extra == "langchain"
+Requires-Dist: sqlalchemy<3,>=2.0.0; extra == "langchain"
+Requires-Dist: langchain-anthropic<2,>=0.2.0; extra == "langchain"
+Requires-Dist: langchain-ollama<2,>=0.2.0; extra == "langchain"
+Requires-Dist: langchain-chroma<2,>=0.1.0; extra == "langchain"
+Requires-Dist: langchain-mistralai<2,>=0.2.0; extra == "langchain"
+Requires-Dist: langchain-cohere<2,>=0.3.0; extra == "langchain"
+Requires-Dist: langchain-google-vertexai<3,>=2.0.0; extra == "langchain"
+Requires-Dist: langchain-deepseek<2,>=0.1.0; extra == "langchain"
+Requires-Dist: langchain-zhipuai<2,>=0.0.1; extra == "langchain"
+Requires-Dist: langchain-experimental<2,>=0.3.0; extra == "langchain"
+Provides-Extra: langgraph
+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.141.1; extra == "web"
+Requires-Dist: uvicorn==0.39.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"
+Requires-Dist: redis==8.1.0; extra == "dev"
+Requires-Dist: sqlglot==27.28.1; extra == "dev"
+Provides-Extra: full
+Requires-Dist: PyMySQL==1.2.0; extra == "full"
+Requires-Dist: psycopg2-binary==2.9.12; extra == "full"
+Requires-Dist: sqlalchemy==2.0.40; extra == "full"
+Requires-Dist: redis==8.1.0; extra == "full"
+Requires-Dist: pika==1.4.4; extra == "full"
+Requires-Dist: nacos-sdk-python==2.0.11; extra == "full"
+Requires-Dist: prometheus-client==0.26.0; extra == "full"
+Requires-Dist: loguru==0.7.3; extra == "full"
+Requires-Dist: sqlglot==27.28.1; extra == "full"
+Requires-Dist: defusedxml==0.7.1; extra == "full"
+Requires-Dist: requests==2.34.2; extra == "full"
+Requires-Dist: httpx==0.28.1; extra == "full"
+Requires-Dist: openpyxl==3.1.5; extra == "full"
+Requires-Dist: langchain-openai==1.4.2; extra == "full"
+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: 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"
+Requires-Dist: beautifulsoup4<5,>=4.12.0; extra == "full"
+Requires-Dist: langchain-experimental<2,>=0.3.0; extra == "full"
+Requires-Dist: langchain-anthropic<2,>=0.2.0; extra == "full"
+Requires-Dist: langchain-ollama<2,>=0.2.0; extra == "full"
+Requires-Dist: langchain-chroma<2,>=0.1.0; extra == "full"
+Requires-Dist: langchain-mistralai<2,>=0.2.0; extra == "full"
+Requires-Dist: langchain-cohere<2,>=0.3.0; extra == "full"
+Requires-Dist: langchain-google-vertexai<3,>=2.0.0; extra == "full"
+Requires-Dist: langchain-deepseek<2,>=0.1.0; extra == "full"
+Requires-Dist: langchain-zhipuai<2,>=0.0.1; extra == "full"
+Requires-Dist: langgraph==1.2.9; extra == "full"
+Requires-Dist: langgraph-checkpoint-sqlite==3.1.1; extra == "full"
+Requires-Dist: mcp==2.0.0; extra == "full"
+Dynamic: license-file
+
+# SpringBootAI
+
+SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用框架。你可以使用 Python 编写 `@RestController`、`@Service`、`@Mapper` 和 `@Autowired`，框架负责组件扫描、依赖注入、Web 路由、事务切面及应用生命周期。
+
+Web 运行时建立在 FastAPI、Starlette 和 Uvicorn 之上，同时提供 ORM、事务、缓存、消息队列、服务发现、生产治理以及 AI 生态集成。
+
+> SpringBootAI 不是 Java Spring Boot 的 Python 绑定，也不是 Spring 官方项目。它适合熟悉 Controller、Service、Mapper 分层方式的团队，用统一写法开发 Web API、内部管理系统、数据服务和 AI 应用。
+
+## 安装
+
+SpringBootAI 2.3.6 支持 Python 3.10、3.11 和 3.12：
+
+```bash
+python -m pip install springbootAI
+```
+
+需要可选模块时，可以按需安装：
+
+```bash
+python -m pip install "springbootAI[ai]"
+python -m pip install "springbootAI[langchain]"
+python -m pip install "springbootAI[langgraph]"
+python -m pip install "springbootAI[mcp]"
+python -m pip install "springbootAI[mysql]"
+python -m pip install "springbootAI[redis]"
+```
+
+安装全部可选能力：
+
+```bash
+python -m pip install "springbootAI[all]"
+```
+
+## 快速开始
+
+创建应用入口 `demo/Application.py`：
+
+```python
+from springbootai.annotations import SpringBootApplication
+from springbootai.main import run
+
+
+@SpringBootApplication(scan_base_packages=["demo"])
+class Application:
+    pass
+
+
+if __name__ == "__main__":
+    run(Application)
+```
+
+创建控制器 `demo/controller/HelloController.py`：
+
+```python
+from springbootai.annotations import GetMapping, RequestMapping, RestController
+from springbootai.web.swagger import Operation, Tag
+
+
+@Tag(name="入门接口", description="确认应用已经正常运行")
+@RequestMapping("/api")
+@RestController
+class HelloController:
+    @Operation(summary="打招呼")
+    @GetMapping("/hello/{name}")
+    def hello(self, name: str):
+        return {"message": f"Hello, {name}"}
+```
+
+创建 `demo/application.yml`，首次运行时关闭暂时不需要的外部资源：
+
+```yaml
+server:
+  host: 127.0.0.1
+  port: 8080
+
+database:
+  enabled: false
+
+redis:
+  enabled: false
+```
+
+启动应用：
+
+```bash
+python -m demo.Application
+```
+
+访问 `http://127.0.0.1:8080/api/hello/Alice` 验证接口，访问 `http://127.0.0.1:8080/docs` 查看 Swagger 文档。
+
+## 核心能力
+
+| 方向 | 能力 |
+|---|---|
+| Web 与 IoC | 路由映射、参数绑定、组件扫描、依赖注入、生命周期、Swagger |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务和自动回滚 |
+| 中间件与 Cloud | Redis、RabbitMQ、Kafka、Nacos、Feign、Gateway |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断和链路追踪 |
+| 安全能力 | JWT、OAuth2、CSRF、访问控制、密码加密和 SQL 注入防护 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph 和 MCP client/server |
+| 测试能力 | 测试切片、MockBean、TestPropertySource、集成测试和性能测试脚本 |
+
+## 考试认证与证书
+
+SpringBootAI 提供配套的在线考试认证平台。学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证内容建议重点关注：
+
+- 安装、项目结构、启动入口、扫描包、配置文件和 Swagger。
+- Controller、Service、Mapper 分层以及 Bean 注册、依赖注入和生命周期。
+- PyMyBatis、动态 SQL、分页、事务边界和回滚行为。
+- Profile、日志、健康检查、Prometheus、限流、熔断和测试切片。
+- JWT、OAuth2、CSRF、访问控制和常见安全错误处理。
+- ChatClient、Tools、RAG、LangChain、LangGraph 和 MCP。
+
+考试规则、题量、通过标准、证书领取方式和有效期以认证平台展示为准。
+
+## 文档
+
+- [GitHub 项目主页](https://github.com/YUCONGGEN/springbootAI)
+- [完整 README](https://github.com/YUCONGGEN/springbootAI#readme)
+- [新手指南](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)
+
+## 生产使用说明
+
+项目当前标记为 Beta。用于公网高并发、合规敏感或支付、订单、库存等核心系统前，请完成目标数据库、流量模型、故障恢复和安全基线验证。
+
+内嵌 Gateway 适合内部路由，不替代公网 Nginx、Kong 或 WAF。Seata `distributed` 模式对接官方 TC 与 TCC 回调；`at` 模式通过 ORM 拦截器生成 `undo_log` 实现自动回滚。
+
+## 许可证
+
+SpringBootAI 使用 [MIT License](https://github.com/YUCONGGEN/springbootAI/blob/master/LICENSE)。

{springbootai-2.3.4 → springbootai-2.3.6}/README.md

@@ -1,7 +1,7 @@
 # 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>
 
 [![PyPI](https://img.shields.io/pypi/v/springbootAI)](https://pypi.org/project/springbootAI/)
@@ -10,6 +10,39 @@
 [![Security](https://github.com/YUCONGGEN/springbootAI/actions/workflows/security.yml/badge.svg?branch=master)](https://github.com/YUCONGGEN/springbootAI/actions/workflows/security.yml)
 [![License](https://img.shields.io/pypi/l/springbootAI)](https://github.com/YUCONGGEN/springbootAI/blob/master/LICENSE)
 
+## 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 |
+
+
 SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用框架。你使用 Python 编写 `@RestController`、`@Service`、`@Mapper` 和 `@Autowired`，框架负责组件扫描、依赖注入、Web 路由、事务切面及生命周期；Web 运行时建立在 FastAPI/Starlette/Uvicorn 之上。
 
 它不是 Java Spring Boot 的 Python 绑定，也不是 Spring 官方项目。它适合熟悉 Controller/Service/Mapper 分层的团队，用统一写法开发 Web API、内部管理系统、数据服务和 AI 应用。
@@ -21,7 +54,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.6`；支持 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 +235,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.6 |
+| `springbootai.orm.pymybatis` | 2.3.6 |
+| `springbootai.ai` AI 模块 | 2.3.6 |
+| `springbootai.langchain` LangChain 模块 | 2.3.6 |
 | Python | 3.10+ |
 
 ### 1.4 适合什么场景

springbootai-2.3.6/README_PYPI.md

@@ -0,0 +1,137 @@
+# SpringBootAI
+
+SpringBootAI 是一个采用 Spring 风格注解和分层结构的 Python 应用框架。你可以使用 Python 编写 `@RestController`、`@Service`、`@Mapper` 和 `@Autowired`，框架负责组件扫描、依赖注入、Web 路由、事务切面及应用生命周期。
+
+Web 运行时建立在 FastAPI、Starlette 和 Uvicorn 之上，同时提供 ORM、事务、缓存、消息队列、服务发现、生产治理以及 AI 生态集成。
+
+> SpringBootAI 不是 Java Spring Boot 的 Python 绑定，也不是 Spring 官方项目。它适合熟悉 Controller、Service、Mapper 分层方式的团队，用统一写法开发 Web API、内部管理系统、数据服务和 AI 应用。
+
+## 安装
+
+SpringBootAI 2.3.6 支持 Python 3.10、3.11 和 3.12：
+
+```bash
+python -m pip install springbootAI
+```
+
+需要可选模块时，可以按需安装：
+
+```bash
+python -m pip install "springbootAI[ai]"
+python -m pip install "springbootAI[langchain]"
+python -m pip install "springbootAI[langgraph]"
+python -m pip install "springbootAI[mcp]"
+python -m pip install "springbootAI[mysql]"
+python -m pip install "springbootAI[redis]"
+```
+
+安装全部可选能力：
+
+```bash
+python -m pip install "springbootAI[all]"
+```
+
+## 快速开始
+
+创建应用入口 `demo/Application.py`：
+
+```python
+from springbootai.annotations import SpringBootApplication
+from springbootai.main import run
+
+
+@SpringBootApplication(scan_base_packages=["demo"])
+class Application:
+    pass
+
+
+if __name__ == "__main__":
+    run(Application)
+```
+
+创建控制器 `demo/controller/HelloController.py`：
+
+```python
+from springbootai.annotations import GetMapping, RequestMapping, RestController
+from springbootai.web.swagger import Operation, Tag
+
+
+@Tag(name="入门接口", description="确认应用已经正常运行")
+@RequestMapping("/api")
+@RestController
+class HelloController:
+    @Operation(summary="打招呼")
+    @GetMapping("/hello/{name}")
+    def hello(self, name: str):
+        return {"message": f"Hello, {name}"}
+```
+
+创建 `demo/application.yml`，首次运行时关闭暂时不需要的外部资源：
+
+```yaml
+server:
+  host: 127.0.0.1
+  port: 8080
+
+database:
+  enabled: false
+
+redis:
+  enabled: false
+```
+
+启动应用：
+
+```bash
+python -m demo.Application
+```
+
+访问 `http://127.0.0.1:8080/api/hello/Alice` 验证接口，访问 `http://127.0.0.1:8080/docs` 查看 Swagger 文档。
+
+## 核心能力
+
+| 方向 | 能力 |
+|---|---|
+| Web 与 IoC | 路由映射、参数绑定、组件扫描、依赖注入、生命周期、Swagger |
+| 数据与事务 | PyMyBatis Mapper、XML Mapper、分页、动态 SQL、事务和自动回滚 |
+| 中间件与 Cloud | Redis、RabbitMQ、Kafka、Nacos、Feign、Gateway |
+| 工程治理 | 配置合并、Profile、日志、健康检查、Prometheus、限流、熔断和链路追踪 |
+| 安全能力 | JWT、OAuth2、CSRF、访问控制、密码加密和 SQL 注入防护 |
+| AI 生态 | ChatClient、Tools、RAG、Advisor、LangChain、LangGraph 和 MCP client/server |
+| 测试能力 | 测试切片、MockBean、TestPropertySource、集成测试和性能测试脚本 |
+
+## 考试认证与证书
+
+SpringBootAI 提供配套的在线考试认证平台。学习者、团队成员和项目使用方可以通过认证考试检验自己对框架核心能力的掌握情况，并在通过考试后获得对应证书。
+
+认证入口：[http://www.yucg.cn:8230](http://www.yucg.cn:8230)
+
+认证内容建议重点关注：
+
+- 安装、项目结构、启动入口、扫描包、配置文件和 Swagger。
+- Controller、Service、Mapper 分层以及 Bean 注册、依赖注入和生命周期。
+- PyMyBatis、动态 SQL、分页、事务边界和回滚行为。
+- Profile、日志、健康检查、Prometheus、限流、熔断和测试切片。
+- JWT、OAuth2、CSRF、访问控制和常见安全错误处理。
+- ChatClient、Tools、RAG、LangChain、LangGraph 和 MCP。
+
+考试规则、题量、通过标准、证书领取方式和有效期以认证平台展示为准。
+
+## 文档
+
+- [GitHub 项目主页](https://github.com/YUCONGGEN/springbootAI)
+- [完整 README](https://github.com/YUCONGGEN/springbootAI#readme)
+- [新手指南](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)
+
+## 生产使用说明
+
+项目当前标记为 Beta。用于公网高并发、合规敏感或支付、订单、库存等核心系统前，请完成目标数据库、流量模型、故障恢复和安全基线验证。
+
+内嵌 Gateway 适合内部路由，不替代公网 Nginx、Kong 或 WAF。Seata `distributed` 模式对接官方 TC 与 TCC 回调；`at` 模式通过 ORM 拦截器生成 `undo_log` 实现自动回滚。
+
+## 许可证
+
+SpringBootAI 使用 [MIT License](https://github.com/YUCONGGEN/springbootAI/blob/master/LICENSE)。

{springbootai-2.3.4 → springbootai-2.3.6}/pyproject.toml

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