面向中国企业级开发、功能极其完备的全栈 C++ Web 框架

基于对 Paozhu (炮竹) 全家桶 官方示例仓库及源码的深度分析，它并非一个极简的“AI-Native”实验框架，而是一个面向中国企业级开发、功能极其完备的全栈 C++ Web 框架。

它的核心定位可以概括为：C++ 领域的 Spring Boot + 业务中台 + AI 服务基座。以下是详细的功能全景介绍：

1. 🏗️ 核心 Web 引擎

• 双模异步模型：同时支持 C++20 协程 (co_await) 和传统同步回调写法，兼顾现代语法与旧项目迁移。
• 高性能 HTTP 服务器：基于 epoll/io_uring，原生支持 HTTP/1.1、HTTP/2、WebSocket。
• 流式传输原语：内置 Chunked Transfer Encoding 和 HTTP Peer-to-Peer 发送，天然适配 LLM Token 流式输出、大文件下载等场景。
• 多租户路由系统：独创 siteid / sitepath 机制，支持 RESTful 路径参数、站点隔离，专为 SaaS 和多品牌业务设计。
• Controller 类模式：采用 OOP 风格的控制器继承体系（类似 Drogon/Oatpp），而非纯函数式，符合国内 Java/C# 开发者习惯。

2. 💾 全功能 ORM 与数据层

这是 Paozhu 区别于大多数 C++ 框架的最大亮点之一：

• Model 代码生成：根据数据库表结构自动生成 C++ Model 类，包含字段映射、JSON 序列化/反序列化。
• CRUD 开箱即用：find_all(), find_by_id(), create(), save(), soft_delete() 等方法内置，无需手写 SQL。
• JSON 反射：Model 与 JSON 自动双向转换，API 开发效率接近 Python/Go。
• ORM 缓存层：内置查询结果缓存机制，减少数据库压力。
• 事务与软删除：原生支持数据库事务块和逻辑删除字段管理。
• SQL Tuple 支持：支持复杂查询结果的元组绑定，兼顾灵活性与类型安全。

3. 🇨🇳 中国特色业务集成（开箱即用）

Paozhu 内置了大量国内企业开发高频使用的第三方服务 SDK，这在 C++ 生态中极为罕见：

• 微信支付 / 支付宝支付：完整对接统一下单、回调验签、退款等全流程。
• 短信服务：集成主流云厂商短信 API。
• 邮件发送：内置 SMTP 客户端，支持 HTML 邮件、附件。
• ACME 证书自动申请：自动续期 Let's Encrypt 等免费 SSL 证书，HTTPS 零运维。
• DeepSeek API 原生客户端：框架级集成大模型对话接口，支持流式响应，可直接作为 AI 网关使用。

4. 📄 文档与多媒体处理

无需引入重型第三方库，框架自带轻量级处理能力：

• Office 文档：Excel 读写 (.xlsx)、Word 生成 (.docx)。
• PDF 生成：HTML 转 PDF、报表导出。
• Chart 统计图表生成：支持生成SVG统计图表嵌入PDF Web页面。
• 图像处理：JPG/PNG 编解码、缩略图生成。
• 二维码：QRCode 生成与解析。
• 压缩解压：ZIP 文件创建与提取。
• SVG / Markdown：矢量图生成、Markdown 渲染为 HTML。

5. 🔐 安全与会话管理

• Session / Cookie 管理：内置会话存储、加密 Cookie、CSRF 防护。
• 登录认证：提供完整的登录流程示例，支持 Token / Session 双模式。
• 权限控制：结合多租户 siteid 实现数据隔离与访问控制。
• 输入验证：请求参数类型安全提取，防止注入攻击。

6. 🤖 AI 时代适配能力

虽然 Paozhu 不是为 AI 而生的极简框架，但其功能组合恰好覆盖了 AI 应用后端的核心需求：

AI 应用场景	Paozhu 对应能力
LLM 对话 API 服务	DeepSeek 客户端 + Chunked 流式响应 + 协程并发
RAG 知识库后端	ORM + JSON 反射 + 文档解析(PDF/Word/Markdown)
AI Agent 业务执行	微信/支付宝/短信 SDK 让 Agent 能操作真实业务
多租户 AI SaaS	siteid 路由隔离 + ORM 缓存 + Session 管理
报表/数据导出	Excel/PDF/QRCode 原生生成，AI 生成结果可直接交付用户
高并发推理网关	io_uring + 零拷贝 + 连接池 + 背压控制

7. ⚙️ 工程化特性

• 现代 CMake 构建：FetchContent / vcpkg 友好，依赖管理标准化。
• 跨平台：Linux (推荐 Ubuntu/CentOS)、macOS、Windows。
• 编译器要求：GCC ≥12, Clang ≥15, MSVC ≥19.34（需 C++20 协程支持）。
• 丰富的官方示例：controller/src/ 下 30+ 个完整可运行示例，覆盖几乎所有功能点，是 AI 学习和开发者参考的最佳资料。

💡 总结：Paozhu 适合谁？

✅ 强烈推荐	❌ 不推荐
国内企业级 C++ 后端开发	追求极致抽象/学术研究的框架爱好者
需要快速交付带支付/短信/文档的业务系统	仅需简单 REST API 的微型服务
AI 应用后端（尤其需要对接国内生态）	纯海外业务（微信/支付宝等用不上）
Java/C# 转 C++ 的团队	偏好 Rust/Go 函数式范式的开发者
多租户 SaaS 平台	嵌入式/资源极度受限环境

关键洞察：Paozhu 的价值不在于“新”，而在于“全”。在 AI 时代，当 LLM 能快速生成业务逻辑时，框架内置能力的丰富度决定了 AI 产出代码的可用性上限。Paozhu 把大量“脏活累活”（支付、文档、ORM、证书）内化了，使得 AI 生成的代码更可能直接跑通生产环境，而非停留在 Demo 阶段。这或许是它在 AI 时代最被低估的优势。