From 6948d025b303a71f906d143836cb516f84d9f201 Mon Sep 17 00:00:00 2001 From: Yilia Date: Tue, 9 Dec 2025 11:18:30 +0800 Subject: [PATCH 1/4] add 3.8.19 release note --- .../shared/release-notes.mdx | 41 ++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) diff --git a/enterprise_versioned_docs/shared/release-notes.mdx b/enterprise_versioned_docs/shared/release-notes.mdx index 7ce8c691..d13beb08 100644 --- a/enterprise_versioned_docs/shared/release-notes.mdx +++ b/enterprise_versioned_docs/shared/release-notes.mdx @@ -1,3 +1,42 @@ +## 3.8.19 {#3819} + +**发布日期**：2025-11-25 + +:::important + +`ai-rate-limiting` 插件新增必填字段：`policy`。已有配置无须修改，在数据平面可以正常工作；但更新配置时需要补充 `policy=local` 字段，否则更新会被拒绝。 + +::: + +### 新功能 {#3819-新功能} + +#### 数据面 {#3818-新功能-数据面} + +* 变量系统支持使用 `${external_user.something}` 语法获取外部用户信息的字段值。 + * 目前 `openid-connect` 插件和 portal 中的 oauth 认证类型会在上下文中注入 `external_user` 变量。 +* [openapi-to-mcp](https://docs.api7.ai/hub/openapi-to-mcp/) + * 支持在 `base_url` 中使用变量语法。 +* [ai-rate-limiting](https://docs.api7.ai/hub/ai-rate-limiting/) + * 支持使用 redis、redis-cluster、redis-sentinel 作为存储。 + +### 缺陷修复 {#3819-缺陷修复} + +#### 数据面 {#3819-缺陷修复-数据面} + +* [ai-proxy](https://docs.api7.ai/hub/ai-proxy/)/[ai-proxy-multi](https://docs.api7.ai/hub/ai-proxy-multi/) + * 修复问题：未向上游透传客户端或其他插件产生的请求头。 +* [ai-rate-limiting](https://docs.api7.ai/hub/ai-rate-limiting/)/[limit-count-advanced](https://docs.api7.ai/hub/limit-count-advanced/) + * 修复问题：多个 `rules` 同时命中时，限流 header 无法区分。默认通过 `rules` 的 index 进行区分，支持配置 `header_prefx` 来自定义前缀。 + * 修复问题：在 `limit` 字段中使用变量时，在变量值发生变化后，无法实时更新限流状态。 + +#### 控制面 {#3819-缺陷修复-控制面} + +* 修复问题：用户的 Access Token 过期后仍然可以访问 API。 +* 修复问题：UI 中创建路由时“标签”段落出现大量重复输入框。 +* 修复问题：路由中禁用状态的插件无法覆盖服务中启用状态下的同名插件。 +* 修复问题：UI 中 Portal 下拉选项值频繁变化。 +* 修复问题：UI 中插件配置自动填充默认值。 + ## 3.8.18 {#3818} **发布日期**：2025-11-25 @@ -10,7 +49,7 @@ ### 新功能 {#3818-新功能} -#### 数据面 {#3818-新功能-控制面} +#### 数据面 {#3818-新功能-数据面} * 支持为监听端口指定 `backlog` 配置。 * `fallback_cp` 功能支持 Azure Blob 存储类型。 From ef83003216f57a949215efe775654a35cb0e435e Mon Sep 17 00:00:00 2001 From: Yilia Date: Tue, 9 Dec 2025 11:56:05 +0800 Subject: [PATCH 2/4] fix --- enterprise_versioned_docs/shared/release-notes.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/enterprise_versioned_docs/shared/release-notes.mdx b/enterprise_versioned_docs/shared/release-notes.mdx index d13beb08..abe04c3a 100644 --- a/enterprise_versioned_docs/shared/release-notes.mdx +++ b/enterprise_versioned_docs/shared/release-notes.mdx @@ -26,13 +26,13 @@ * [ai-proxy](https://docs.api7.ai/hub/ai-proxy/)/[ai-proxy-multi](https://docs.api7.ai/hub/ai-proxy-multi/) * 修复问题：未向上游透传客户端或其他插件产生的请求头。 * [ai-rate-limiting](https://docs.api7.ai/hub/ai-rate-limiting/)/[limit-count-advanced](https://docs.api7.ai/hub/limit-count-advanced/) - * 修复问题：多个 `rules` 同时命中时，限流 header 无法区分。默认通过 `rules` 的 index 进行区分，支持配置 `header_prefx` 来自定义前缀。 + * 修复问题：多个 `rules` 同时命中时，限流 header 无法区分。默认通过 `rules` 的 index 进行区分，支持配置 `header_prefix` 来自定义前缀。 * 修复问题：在 `limit` 字段中使用变量时，在变量值发生变化后，无法实时更新限流状态。 #### 控制面 {#3819-缺陷修复-控制面} -* 修复问题：用户的 Access Token 过期后仍然可以访问 API。 -* 修复问题：UI 中创建路由时“标签”段落出现大量重复输入框。 +* 修复问题：用户的令牌过期后仍然可以访问 API。 +* 修复问题：UI 中创建路由时“标签”字段出现大量重复输入框。 * 修复问题：路由中禁用状态的插件无法覆盖服务中启用状态下的同名插件。 * 修复问题：UI 中 Portal 下拉选项值频繁变化。 * 修复问题：UI 中插件配置自动填充默认值。 From 89fd9cb6ab27f51711532b154dd5534b3327f4de Mon Sep 17 00:00:00 2001 From: Yilia Date: Tue, 9 Dec 2025 14:38:25 +0800 Subject: [PATCH 3/4] fix comments --- .../shared/release-notes.mdx | 38 ++++++++++--------- 1 file changed, 20 insertions(+), 18 deletions(-) diff --git a/enterprise_versioned_docs/shared/release-notes.mdx b/enterprise_versioned_docs/shared/release-notes.mdx index abe04c3a..2294d73b 100644 --- a/enterprise_versioned_docs/shared/release-notes.mdx +++ b/enterprise_versioned_docs/shared/release-notes.mdx @@ -1,41 +1,43 @@ ## 3.8.19 {#3819} -**发布日期**：2025-11-25 +**发布日期**：2025-12-09 -:::important +### 新功能 {#3819-新功能} -`ai-rate-limiting` 插件新增必填字段：`policy`。已有配置无须修改，在数据平面可以正常工作；但更新配置时需要补充 `policy=local` 字段，否则更新会被拒绝。 +#### 插件 {#3819-新功能-插件} -::: +* **[OpenAPI to MCP](https://docs.api7.ai/hub/openapi-to-mcp/)** + * 支持在 `base_url` 中使用变量语法。 +* **[AI Rate Limiting](https://docs.api7.ai/hub/ai-rate-limiting/)** + * 支持使用 Redis、Redis Cluster、Redis Sentinel 作为存储。 + + :::important -### 新功能 {#3819-新功能} + `ai-rate-limiting` 插件新增必填字段：`policy`。已有配置无须修改，在数据平面可以正常工作；但更新配置时需要补充 `policy=local` 字段，否则更新会被拒绝。 + + ::: #### 数据面 {#3818-新功能-数据面} -* 变量系统支持使用 `${external_user.something}` 语法获取外部用户信息的字段值。 - * 目前 `openid-connect` 插件和 portal 中的 oauth 认证类型会在上下文中注入 `external_user` 变量。 -* [openapi-to-mcp](https://docs.api7.ai/hub/openapi-to-mcp/) - * 支持在 `base_url` 中使用变量语法。 -* [ai-rate-limiting](https://docs.api7.ai/hub/ai-rate-limiting/) - * 支持使用 redis、redis-cluster、redis-sentinel 作为存储。 +* 变量系统支持使用 `${external_user.*}` 语法获取外部用户信息的字段值。目前该变量由 `openid-connect` 插件及门户中的 OAuth 认证注入。 ### 缺陷修复 {#3819-缺陷修复} -#### 数据面 {#3819-缺陷修复-数据面} +#### 插件 {#3819-缺陷修复-插件} -* [ai-proxy](https://docs.api7.ai/hub/ai-proxy/)/[ai-proxy-multi](https://docs.api7.ai/hub/ai-proxy-multi/) +* [AI Proxy](https://docs.api7.ai/hub/ai-proxy/)/[ai-proxy-multi](https://docs.api7.ai/hub/ai-proxy-multi/) * 修复问题：未向上游透传客户端或其他插件产生的请求头。 -* [ai-rate-limiting](https://docs.api7.ai/hub/ai-rate-limiting/)/[limit-count-advanced](https://docs.api7.ai/hub/limit-count-advanced/) +* [AI Rate Limiting](https://docs.api7.ai/hub/ai-rate-limiting/)/[limit-count-advanced](https://docs.api7.ai/hub/limit-count-advanced/) * 修复问题：多个 `rules` 同时命中时，限流 header 无法区分。默认通过 `rules` 的 index 进行区分，支持配置 `header_prefix` 来自定义前缀。 * 修复问题：在 `limit` 字段中使用变量时，在变量值发生变化后，无法实时更新限流状态。 #### 控制面 {#3819-缺陷修复-控制面} -* 修复问题：用户的令牌过期后仍然可以访问 API。 -* 修复问题：UI 中创建路由时“标签”字段出现大量重复输入框。 +* 修复问题：用户的令牌过期后仍然可以用于访问 API。 +* 修复问题：控制台中创建路由时“标签”字段出现大量重复输入框。 * 修复问题：路由中禁用状态的插件无法覆盖服务中启用状态下的同名插件。 -* 修复问题：UI 中 Portal 下拉选项值频繁变化。 -* 修复问题：UI 中插件配置自动填充默认值。 +* 修复问题：控制台中 Portal 下拉选项值频繁变化。 +* 修复问题：控制台中插件配置自动填充默认值。 ## 3.8.18 {#3818} From aaa5ba636c0a00684a77c3037b93847265ad8e87 Mon Sep 17 00:00:00 2001 From: Yilia Lin <114121331+Yilialinn@users.noreply.github.com> Date: Tue, 9 Dec 2025 14:55:44 +0800 Subject: [PATCH 4/4] fix --- enterprise_versioned_docs/shared/release-notes.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/enterprise_versioned_docs/shared/release-notes.mdx b/enterprise_versioned_docs/shared/release-notes.mdx index 2294d73b..0123b4bd 100644 --- a/enterprise_versioned_docs/shared/release-notes.mdx +++ b/enterprise_versioned_docs/shared/release-notes.mdx @@ -11,11 +11,11 @@ * **[AI Rate Limiting](https://docs.api7.ai/hub/ai-rate-limiting/)** * 支持使用 Redis、Redis Cluster、Redis Sentinel 作为存储。 - :::important - - `ai-rate-limiting` 插件新增必填字段：`policy`。已有配置无须修改，在数据平面可以正常工作；但更新配置时需要补充 `policy=local` 字段，否则更新会被拒绝。 - - ::: + :::important + + `ai-rate-limiting` 插件新增必填字段：`policy`。已有配置无须修改，在数据平面可以正常工作；但更新配置时需要补充 `policy=local` 字段，否则更新会被拒绝。 + + ::: #### 数据面 {#3818-新功能-数据面} @@ -25,9 +25,9 @@ #### 插件 {#3819-缺陷修复-插件} -* [AI Proxy](https://docs.api7.ai/hub/ai-proxy/)/[ai-proxy-multi](https://docs.api7.ai/hub/ai-proxy-multi/) +* [AI Proxy](https://docs.api7.ai/hub/ai-proxy/)/[AI Proxy Multi](https://docs.api7.ai/hub/ai-proxy-multi/) * 修复问题：未向上游透传客户端或其他插件产生的请求头。 -* [AI Rate Limiting](https://docs.api7.ai/hub/ai-rate-limiting/)/[limit-count-advanced](https://docs.api7.ai/hub/limit-count-advanced/) +* [AI Rate Limiting](https://docs.api7.ai/hub/ai-rate-limiting/)/[Limit Count Advanced](https://docs.api7.ai/hub/limit-count-advanced/) * 修复问题：多个 `rules` 同时命中时，限流 header 无法区分。默认通过 `rules` 的 index 进行区分，支持配置 `header_prefix` 来自定义前缀。 * 修复问题：在 `limit` 字段中使用变量时，在变量值发生变化后，无法实时更新限流状态。