Feat Releases

v1.5.0

2026-02-24 09:59

### 版本特性

- **Feat Core：**
  - [client] 重构 GZIP 输入流实现，支持完整的头部解析和更先进的异步解码算法。
  - [client] 修复 SSE 事件数据中的换行符转义问题。
  - [server] 修复静态资源处理器中的路径解析、HEAD 请求、空指针异常和 404 页面返回问题。
  - [server] 优化静态资源处理器的类路径资源定位功能，支持配置静态资源路径。
  - [server] 修复 HTTP 协议解析中的缓冲区边界检查和字节缓冲区位置错误。
  - [core] 添加方法实例化 Bean 的支持。
  - [core] 优化字节树子节点获取逻辑。
  - [router] 支持花括号 `{}` 形式的路径参数匹配。
  - 移除过时的 DeflaterInputStream 引用并优化异常处理。
  - 升级 smart-socket 至 1.8.3。

- **Feat AI：**
  - 实现 ReAct Agent 智能体，支持系统提示词、工具执行钩子和异常处理。
  - AI 代理工具改为异步执行模式，优化执行流程和消息处理机制。
  - 新增流式响应错误处理机制和失败处理机制。
  - 新增 Kimi-K2.5-Instruct 模型支持。
  - 重构提示词模板接口设计，优化 ReAct 智能体提示模板结构。
  - 新增子代理任务委托功能。
  - 实现 AI Agent 动作解析功能。
  - 新增 WebReader 网页阅读器功能，支持读取和转换网页内容。

- **Feat Cloud：**
  - 新增 MyBatis 集成支持，包括配置序列化、编译期 XML 配置解析和代码生成。
  - 新增分布式会话管理功能，集成 Redisun 支持集群会话管理。
  - 重构会话管理架构，实现本地会话管理器和集群会话管理器。
  - 改进 AOT 编译逻辑，支持扩展序列化器（MyBatis 和 Redisun 集成）。
  - RequestMapping 支持 `{}` 花括号形式的路径参数匹配。
  - 新增静态资源路径配置功能。
  - 新增 JSONArray 支持和结构体参数处理。
  - 增强控制器序列化器的参数处理能力，支持复杂类型参数。
  - 修复 JSON 解析空值导致的异常问题。
  - 修复列表参数反序列化问题。
  - 新增 Docker 部署支持，包括 JRE 版本和原生镜像示例。
  - 添加 Fat Jar 打包支持。
  - AsyncResponse 的 complete 方法返回类型调整为 AsyncResponse。

### 升级指南
1. 升级版本后处理编译报错问题。
2. 若使用了 `AsyncResponse@complete` 方法，注意其返回类型已变更为 `AsyncResponse`。
3. 若需技术支持可通过 [Gitee ISSUE](https://gitee.com/smartboot/feat/issues) 提交反馈。

### 兼容性说明
1. `AsyncResponse@complete` 方法返回类型从 `void` 修改为 `AsyncResponse`。
2. `ApplicationContext` 类已设为 final，构造函数访问权限调整。
3. Feat AI 模块中 Agent 相关接口存在多处重构，如 AgentOptions 构造方式、工具接口等。

发版详情：[https://mp.weixin.qq.com/s/fi0EmKhN9GHbUtZ6FfK3LA](https://mp.weixin.qq.com/s/fi0EmKhN9GHbUtZ6FfK3LA)

Last committed message: docs(guide): 更新版本历史文档添加发版详情链接

v1.4.2

637bbd4

2026-02-06 15:19

🚀 Feat v1.4.2 正式发布

Last committed message: chore(version): 更新项目版本到1.4.2

v1.4.1

162b85c

2026-01-30 14:20

🚀 Feat v1.4.1 正式发布

我们很高兴地发布 **Feat v1.4.1**！本次更新聚焦于核心性能优化、功能增强和 AI Agent 能力的持续进化，致力于为开发者提供更稳定、高效和智能的 Java Web 开发体验。

## 🚀 主要更新亮点

### **Feat Core：核心性能优化**
- ✅ **HTTP 客户端响应解析算法优化**：改进了 GZIP 响应解析算法，提升处理效率和健壮性。
- ✅ **Multipart 表单解析优化**：优化 `multipart/form-data` 请求处理策略，提升文件上传和表单处理的性能与稳定性。
- ✅ **HTTP 协议解析轻微性能提升**：底层解析算法优化，提升请求处理效率。
- ✅ **Session 管理优化**：
  - 将 Session 超时时间定义由 `maxAge` 调整为 `timeout`，配置更直观。
  - 开放 Session 可扩展性，支持本地会话与分布式会话的自定义实现。
- ✅ **移除 Endpoint@getConnection 接口**，推荐使用 `Endpoint@getHeader` 替代。

### **Feat Cloud：云原生功能增强**
- ✅ **JSON Array 请求自动解析**：支持自动解析 JSON 数组格式的请求体。
- ✅ **Redis 分布式 Session 支持**：新增基于 Redis 的分布式会话管理，适用于集群部署场景。
- ✅ **AOT 编译器增强**：
  - 新增 `$.feat.redis` 和 `$.feat.mybatis` 配置化注入。
  - 改进接口设计，为未来扩展三方中间件集成提供基础。

### **Feat Agent：AI 能力持续探索**
- ✅ **通用 AI Agent 工具集增强**：
  - 本地文件读写工具
  - 互联网搜索工具
  - 网页读取并自动转换为 Markdown 工具（减少 HTML 标签带来的 token 消耗，提升大模型理解效率）

### **其他重要改进**
- ⬆️ 升级 `smart-socket` 至 **1.8.1** 版本，提升性能与稳定性
- 🔧 优化多个核心模块实现细节
- 🐛 修复若干已知问题，增强系统稳定性

## 📦 快速开始

更新 Maven 依赖至最新版本：

```xml
<dependency>
    <groupId>tech.smartboot.feat</groupId>
    <artifactId>feat-core</artifactId>
    <version>1.4.1</version>
</dependency>
<dependency>
    <groupId>tech.smartboot.feat</groupId>
    <artifactId>feat-cloud-starter</artifactId>
    <version>1.4.1</version>
</dependency>
```

## 🧪 配置示例

**Redis 分布式 Session 配置（feat.yml）**：

```yaml
server:
  session:
    timeout: 1800        # Session超时时间(秒)
    store-type: redis    # 启用Redis存储

feat:
  redis:
    address: redis://127.0.0.1:6379
```

## 🧠 未来展望

我们将继续在以下方向持续演进：
- 性能优化：持续优化核心算法与实现
- 功能增强：根据开发者反馈丰富框架功能
- AI Agent：扩展工具集与推理能力
- 云原生集成：优化中间件集成体验

---

立即体验 Feat v1.4.1，感受高性能、云原生与 AI 融合的现代 Java 开发新体验！

Last committed message: chore(version): 移除SNAPSHOT后缀发布正式版本

v1.4.0

c83d06c

2025-11-28 13:32

v1.4.0

Last committed message: docs(ai): 更新 Agent 文档结构和内容

v1.3.0

8e37243

2025-09-14 12:24

v1.3.0

Last committed message: feat: 更新版本号至 1.3.0

v1.2.0

c81e8aa

2025-07-24 16:59

v1.2.0

Last committed message: build(feat): 更新项目版本至 1.2.0

v1.1.0

0ba7e4b

2025-06-13 13:58

v1.1.0

### 版本特性

- **Feat Core：**
    - 限制单进程内 Feat Banner 最多输出一次。
    - **`Router`** 支持定义相同 URL、不同 HTTP Method 的接口服务，提升 API 设计的灵活性。
    - RunLogger 自动感应日志级别变化，支持动态调整日志级别。
    - 日志级别环境变量由 `smarthttp.log.level` 调整为 `feat.log.level` 。
    - 将 DateUtils、GzipUtils、HttpUtils、NumberUtils、StringUtils、CollectionUtils、Constant、SHA1、WebSocketUtil 等工具类能力统一汇集至 `FeatUtils` 中，简化使用成本。
    - ByteTree 不再支持匹配期间动态 addNode，保障内存使用稳定性。
    - 升级 smart-socket 至 1.5.69。
- **Feat Cloud**
  - 新增 `feat.yaml`/`feat.yml` 配置文件解析，并通过`@Value`注入 Bean 或 Controller中。(类似 Spring 的 `application.yaml`)
  - 支持运行时动态调整指定 `loggerName` 的日志级别，便于灵活监控与调试。
  - ApplicationContext 新增 getOptions 方法用于获 Feat Cloud 配置。
  - Annotation Processor 重构，简化代码复杂度，提升扩展性。
  - 编译器自动将非统配 URI 注册至 ByteTree，提升解析性能。

---

### 升级指南

**pom升级**

tech.smartboot.feat:
    - feat-core：`1.0.0` => `1.1.0`
    - feat-cloud-starter：`1.0.0` => `1.1.0`
    - feat-ai：`1.0.0` => `1.1.0`

**代码升级**

参见下述**兼容性说明**

----
### 兼容性说明
- CloudOptions@addExternalBean 方法重命名为 registerBean，用于注册外部 Bean。
- 已废弃：DateUtils、GzipUtils、HttpUtils、NumberUtils、StringUtils、CollectionUtils、Constant、SHA1、WebSocketUtil

Last committed message: build: 更新项目版本至 1.1.0