版本发布记录

v2.8.0

发布时间：2025/9/10

新特性

• API 接口支持 Server-Sent Events (SSE) 事件流响应： API 中实现 SSE
• Client 客户端支持处理 Server-Sent Events (SSE) 等流式响应： 处理 SSE 响应
• @api 装饰器新增 timeout 参数，用于为 API 类的处理函数指定超时时间或为 Client 类的请求函数指定请求超时
• 新增 HTTP 缓存插件 api.Cache：可以自动处理 Last-Modified / Etag 等 HTTP 缓存机制
• 新增搜索参数 orm.Search, 可以支持多种搜索模式对多个模型字段进行搜索匹配
• orm.Schema 支持在查询函数中定义请求上下文参数（如当前请求用户 / IP），在序列化时通过 context 参数传当前请求对象实现请求上下文字段的查询
• meta gen_openapi 命令支持 --split 参数，可以将 API 文档按照接口输出到独立的文件中，每个接口文档文件都包含接口的完整参数与响应定义，更方便 AI 工具解析读取

优化项

• 优化 orm.Field 的字段解析和校验和字段规则的整合
• Client 客户端在 with 与 async with 语句块中会复用请求会话 （httpx.Client / aiohttp.Session / requests.Session）

问题修复

• 修复自动生成的 OpenAPI 文档的 YAML 输出

v2.7.6

发布时间：2025/6/6

新特性

• UtilMeta 服务实例新增 adapt(route: str) 方法，用于在现有 Python 后端项目中引入 UtilMeta 框架接口，并需要同时声明 UtilMeta 服务配置时使用
• API 函数支持同时定义多个 request.Query ，request.Headers 与 request.Body (可以对应不同的 Content-Type)，支持对应的数据解析与 OpenAPI 文档生成
• orm.Field 支持定义值查询函数，可以用于方便高效地组织关系对象序列化之外的自定义查询代码
• meta gen_openapi 命令新增 --prefix 参数，用于指定一个 API 路径前缀，只生成这个路径下的 API 文档

优化项

• OpenAPI 文档支持提取 API 函数中的 doc_string (三引号 """ 中的内容) 到 description
• Operations 系统支持 clear_daily 参数，启用后每天只会运行一次数据清理
• File 类型新增 content_md5 属性获取文件内容的 md5 值（可用于去重检测或缓存）

问题修复

• 修复 aioredis 的导入问题（redis>=4.2.0rc1+ 中内置了异步功能）

v2.7.5

发布时间：2025/3/21

新特性

• ·Operations 系统支持配置 connection_key 对本地或内网的直连管理模式请求进行鉴权，配置 connection_key 与 private_scope 参数后可以在 UtilMeta 管理平台中直接管理与客户端位于同一内网的 UtilMeta 服务
• 新增 meta check 命令用于检测 UtilMeta 服务是否加载正常（启动无错误）

优化项

• 优化 orm.Field 支持与模型字段名冲突的表达式或 lookup 查询处理
• 优化各 Adaptor 适配器（包括响应，客户端请求，文件等）的运行时识别，指定 __backends_package__
• 优化 File 文件对于 ResponseFile (HTTP 响应作为文件) 的文件名识别
• 优化数据库驱动的 Session 的保存（save） 行为
• 优化 Filter 组件的 query 查询函数对于 @classmethod 类方法的处理
• orm 支持查询和序列化 managed=False 的 Django 模型（如没有主键的数据库视图）

问题修复

• 修复 Django 应用挂载路由（__as__ 方法） 的问题

v2.7.4

发布时间：2025/2/10

优化项

• 优化 orm.Field 的 queryset 处理逻辑，优化子查询判定并增加鲁棒性
• ORM 支持级联多层的关系对象更新，并避免 Self 自引用和循环引用可能造成的无限递归问题

v2.7.3

发布时间：2025/1/24

优化项

• DjangoSettings 的 apps_package 支持指定多个 app 目录
• 对可选模型字段（设置了 default）的 orm 行为进行优化
• Operations 系统的任务日志支持更详细的控制和输出
• 优化 Operations 系统数据管理接口，对创建于更新时的约束错误返回 400 响应
• 优化包含类型逻辑嵌套的请求体的 Content-Type 识别

v2.7.2

发布时间：2024/12/26

优化项

• Client 类对于响应码不匹配任何响应模板的响应，会在 fail_silently=False 时抛出错误，提高响应结果的确定性

问题修复

• Operations 系统的数据管理功能（对应 UtilMeta 平台的 Data 板块）的数据查询问题修复

v2.7.1

发布时间：2024/12/25

新特性

• orm.Schema 的 save / asave / bulk_save / abulk_save 方法支持 using 参数，可以传入数据库连接的名称（默认是 default 或模型配置的数据库）作为查询的数据库连接

优化项

• 对 orm.Schema 查询的无限循环嵌套问题解决方式进行优化，增加了 Perference.orm_schema_query_max_depth 设置限制 Schema 查询深度，默认为 100
• 对 FastAPI / Starlette 应用优化服务端报错的处理逻辑，能够在日志中记录 FastAPI 接口抛出的异常调用栈信息

问题修复

• 修复了 MySQL 异步连接数据库的一些问题
• 修复了 Retry 插件的一些问题
• 修复了命令行工具中 -- 参数的解析问题

API 变更

• utilmeta.core.orm.ModelAdaptor：模型适配器的方法进行了变更，新增了 ModelQueryAdaptor 处理模型适配器的查询方法

v2.7.0

发布时间：2024/12/19

新特性

• 支持连接到 代理节点 进行内网服务集群的管理
• 支持解析与同步 Django Ninja 的 OpenAPI 文档
• 支持 meta.ini 中指定 pidfile 存储当前服务进程 PID，同时支持 restart 重启服务命令和 down 停止服务命令

优化项

• Client 类的 base_url 参数支持携带 URL 查询参数，将会解析为 base_query 添加到每个 Client 类的请求中

问题修复

• 修复 API 类上定义的 response 响应模板的结果类型在生成的 OpenAPI 文档中缺失的问题

v2.6.4

发布时间：2024/11/22

新特性

• 支持直接连接与管理本地服务
• 支持管理 Django 的 ASGI 应用
• Operations 系统支持监控与观测数据库连接与存储数据，支持时序数据的降采样查询

优化项

• 优化 OperationsAPI 的挂载逻辑，支持 懒挂载 以增加鲁棒性
• 支持在服务启动前检查与按照数据库依赖
• 优化 Operations 系统中 secret_names 的数据处理逻辑，增加对嵌套结构的检测
• 支持 @api 装饰器中声明的 tags 参数整合到生成的 OpenAPI 文档中
• 优化 setup 命令的模板配置
• 优化数据库 Session 的 must_create 参数逻辑

问题修复

• 修复异步 API 服务使用 Operations 系统的连接关闭问题

兼容性

• Django 向下支持到 3.0 版本（可支持管理 Django >= 3.0 的项目）

API 变更

• utilmeta.core.cache.Cache 的异步 API 函数变更，不再使用与同步函数同名的函数（如 get, update），而是使用前缀为 a 的函数，如 aget, aupdate，原有的用法保留，但会在后续的版本中移除

v2.6.0

发布时间：2024/11/11

新功能

• 新增一个内置的 Operations 运维管理系统，能够对 API 服务进行实时观测与管理
• 支持 Perference 配置，调整 UtilMeta 框架的一些特性参数
• 支持 声明式 Web 客户端 的挂载，钩子与客户端代码的自动生成
• 支持 orm.Schema 中关系字段与关系对象的创建与更新

优化项

• 重构优化 API 插件系统的实现，使得 API 插件的执行顺序逻辑与装饰器相同
• 优化 orm.Query 的 distinct 逻辑，增加可配置 __distinct__ 参数
• 优化支持局域变量（locals()）的类型提示解析
• Error 错误对象新增 request 参数与属性可以访问当前的 API 请求，更方便错误处理插件的处理
• 支持 Response 对象的 pprint 方法 #7

问题修复

• 修复异步插件的调用
• 修复发送与处理 multipart/form-data 数据中的 filename 文件名逻辑
• 优化响应中对文件的处理

兼容性

• 修复 SQLite 在 windows 与低版本 Python（3.9）上的异常行为

v2.5.8

发布时间：2024/9/21

优化项

• 支持 yaml 配置文件 #6
• 支持自动安装运行服务端 backend 所需的依赖

问题修复

• 修复了 openapi 文档生成的一些问题

v2.5.6

发布时间：2024/8/16

问题修复

• 修复了 jwt 鉴权相关的兼容性问题

v2.5.5

发布时间：2024/7/20

问题修复

• 修复了 OpenAPI 文档生成相关的问题

v2.5.2

发布时间：2024/4/24

v2.4

发布时间：2024/1/29

新特性

• 支持了基本的 声明式 Web 客户端 特性

v2.3

发布时间：2024/1/24

API 变更

• 调整了用户鉴权的登录函数 login 参数与 JWT 鉴权组件参数

v2.2

发布时间：2024/1/20

优化项

• 优化鉴权与 Session 相关的 API 用法

v.2.1

发布时间：2023/12/18

新特性

• V2 版本框架的首次发布，提供了声明式的 API 与 ORM 特性

v1

版本时间：2019/11 ~ 2023/11

旧版本的 UtilMeta 框架，现已不进行支持