This is an automated email from the ASF dual-hosted git repository.
juzhiyuan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/apisix-website.git
The following commit(s) were added to refs/heads/master by this push:
new 1de5dceba23 fix: polish Chinese translations of 3.15-3.18 release
notes (#2114)
1de5dceba23 is described below
commit 1de5dceba2358a915a0644243f8a118517ec547e
Author: Traky Deng <[email protected]>
AuthorDate: Mon Sep 7 18:50:51 2026 +0800
fix: polish Chinese translations of 3.15-3.18 release notes (#2114)
---
.../2026/02/05/release-apache-apisix-3.15.0.md | 6 ++--
.../2026/04/07/release-apache-apisix-3.16.0.md | 14 ++++-----
.../2026/06/15/release-apache-apisix-3.17.0.md | 10 +++----
.../2026/08/20/release-apache-apisix-3.18.0.md | 34 +++++++++++-----------
4 files changed, 32 insertions(+), 32 deletions(-)
diff --git a/blog/zh/blog/2026/02/05/release-apache-apisix-3.15.0.md
b/blog/zh/blog/2026/02/05/release-apache-apisix-3.15.0.md
index 926445b7a5e..8aadba09fff 100644
--- a/blog/zh/blog/2026/02/05/release-apache-apisix-3.15.0.md
+++ b/blog/zh/blog/2026/02/05/release-apache-apisix-3.15.0.md
@@ -25,7 +25,7 @@ tags: [Community]
本次版本新增了对多种 AI 提供商的支持，增强了日志记录能力，并在服务发现、安全性和插件功能等方面进行了多项改进。
-此外，该版本还包含了一项重大变更。如果您发现这项变更会对您的使用产生影响，请进行相应的计划升级。
+此外，该版本还包含了一项重大变更，可能会影响现有部署。请查看该变更并相应地规划升级。
## 重大变更
@@ -120,13 +120,13 @@ API 驱动的独立模式（主要用于 Ingress 控制器）现在支持新的
- 支持 file-driven standalone 模式下的状态 API (PR
[#12810](https://github.com/apache/apisix/pull/12810))
- 正确处理 Kubernetes 服务发现中的 EndpointSlices (PR
[#12634](https://github.com/apache/apisix/pull/12634))
-- 将资源名称长度从 100 个字符放宽至 256 个字符，以更好地支持入口控制器名称生成模式 (PR
[#11822](https://github.com/apache/apisix/pull/11822))
+- 将资源名称长度从 100 个字符放宽至 256 个字符，以更好地支持 Ingress 控制器名称生成模式 (PR
[#11822](https://github.com/apache/apisix/pull/11822))
- 为流路由添加验证和删除保护 (PR [#12794](https://github.com/apache/apisix/pull/12794))
- 通过在 `limit-conn` 插件中配置 Redis 密钥过期时间来防止永久配额阻塞 (PR
[#12872](https://github.com/apache/apisix/pull/12872))
- 通过在 SkyWalking 集成中路由命中时启动计时器来提高计时精度 (PR
[#12855](https://github.com/apache/apisix/pull/12855))
- 通过在销毁 Prometheus 时移除不必要的深拷贝来提高性能 (PR
[#12905](https://github.com/apache/apisix/pull/12905))
- 通过在 `limit-req` 插件中确保安全的 Redis 键驱逐来防止数据损坏 (PR
[#12911](https://github.com/apache/apisix/pull/12911))
-- 通过在 `limit-count` 插件中使用元父级来识别插件源来改进调试 (PR
[#12900](https://github.com/apache/apisix/pull/12900))
+- 通过在 `limit-count` 插件中使用父级元数据来识别插件源来改进调试 (PR
[#12900](https://github.com/apache/apisix/pull/12900))
- 在 MQTT 插件中，将 `protocol_name` 设置为可选，并将其默认值设为 `MQTT` (PR
[#12831](https://github.com/apache/apisix/pull/12831))
- 在 `batch-requests` 插件中，确保子响应的数量与子请求的数量匹配 (PR
[#12779](https://github.com/apache/apisix/pull/12779))
- 修正 `ai-proxy-multi` 插件中的日志模式键 (PR
[#12795](https://github.com/apache/apisix/pull/12795))
diff --git a/blog/zh/blog/2026/04/07/release-apache-apisix-3.16.0.md
b/blog/zh/blog/2026/04/07/release-apache-apisix-3.16.0.md
index f6150f96906..2c5ad02080b 100644
--- a/blog/zh/blog/2026/04/07/release-apache-apisix-3.16.0.md
+++ b/blog/zh/blog/2026/04/07/release-apache-apisix-3.16.0.md
@@ -15,17 +15,17 @@ keywords:
- API Management Platform
- New Release
- Cloud Native
-description: Apache APISIX 3.16.0 版本于 2026 年 4 月 7
日发布。该版本带来了一系列新功能、修复、以及相关用户体验优化。
+description: Apache APISIX 3.16.0 版本于 2026 年 4 月 7
日发布。该版本带来了一系列新功能、缺陷修复、以及相关用户体验优化。
tags: [Community]
---
-我们很高兴地宣布 Apache APISIX 3.16.0 版本已经发布。该版本带来了一系列新功能、修复、以及相关用户体验优化。
+我们很高兴地宣布 Apache APISIX 3.16.0 版本已经发布。该版本带来了一系列新功能、缺陷修复、以及相关用户体验优化。
<!--truncate-->
本次版本扩展了速率限制能力，增强了 OpenTelemetry 可观测性，新增了认证、日志记录和服务发现等方面的插件功能，同时包含多项缺陷修复和稳定性改进。
-此外，该版本还包含了两项重大变更。如果您发现这些变更会对您的使用产生影响，请进行相应的计划升级。
+此外，该版本还包含了两项重大变更，可能会影响现有部署。请审阅这些变更并相应地规划您的升级。
## 重大变更
@@ -66,7 +66,7 @@ tags: [Community]
OpenTelemetry 插件现在可以生成更多 span，覆盖各个 NGINX 阶段、每个插件的执行过程、DNS 解析、密钥获取、SSL client
hello 处理以及路由匹配。这为请求处理提供了更深入的可观测性。
-同时新增了全局 `tracing: false` 配置项，可用于选择性地禁用追踪。此外，OTel 语义规范属性已更新，与最新规范保持一致。
+同时新增了全局 `tracing: false` 配置项，可用于选择性地禁用追踪。此外，OTel 语义约定属性已更新，与最新规范保持一致。
更多信息，请参阅 [PR #12686](https://github.com/apache/apisix/pull/12686)。
@@ -90,7 +90,7 @@ OpenTelemetry 插件现在可以生成更多 span，覆盖各个 NGINX 阶段、
### Eureka 服务发现支持基于主机名的节点
-Eureka 服务发现模块现在除了支持 IP 地址节点外，还支持以主机名（域名）注册的节点。此前，只有使用 IP 地址的节点才能被正确处理。这使
APISIX 能够与服务使用 DNS 名称注册的 Eureka 部署集成。
+Eureka 服务发现模块现在除了支持 IP 地址节点外，还支持以主机名（域名）注册的节点。此前，只有使用 IP 地址的节点才能被正确处理。这使
APISIX 能够集成那些服务使用 DNS 名称注册的 Eureka 部署。
更多信息，请参阅 [PR #12993](https://github.com/apache/apisix/pull/12993)。
@@ -108,7 +108,7 @@ Eureka 服务发现模块现在除了支持 IP 地址节点外，还支持以主
### `jwt-auth` 插件支持更多签名算法
-`jwt-auth` 插件现在通过新增的 `jwt-auth/parser.lua` 模块支持更多 JWT 签名算法，包括 RS256、ES256
等。此前仅较好地支持 HS256。这使 APISIX 能够与使用非对称密钥签发 Token 的身份提供商集成。
+`jwt-auth` 插件现在通过新增的 `jwt-auth/parser.lua` 模块支持更多 JWT 签名算法，包括 RS256、ES256
等。此前仅 HS256 得到了良好支持。这使 APISIX 能够与使用非对称密钥签发 Token 的身份提供商集成。
更多信息，请参阅 [PR #12944](https://github.com/apache/apisix/pull/12944)。
@@ -142,7 +142,7 @@ Eureka 服务发现模块现在除了支持 IP 地址节点外，还支持以主
- 修复 `limit-req` 消费者隔离问题，使用 `parent.resource_key` 确保消费者在不同路由间共享正确的计数器 (PR
[#13019](https://github.com/apache/apisix/pull/13019))
- 移除 `ai-rate-limiting` 插件 schema 中错误存在的 `sync_interval` 字段 (PR
[#12959](https://github.com/apache/apisix/pull/12959))
- 将 Docker 独立模式的 YAML 配置校验从 Shell 脚本迁移至 Lua，以更稳健地处理所有合法 YAML 变体 (PR
[#12949](https://github.com/apache/apisix/pull/12949))
-- 修正 `config.yaml.example` 中 AI 插件优先级注释和排序 (PR
[#12926](https://github.com/apache/apisix/pull/12926))
+- 修正 `config.yaml.example` 中 AI 插件的优先级排序 (PR
[#12926](https://github.com/apache/apisix/pull/12926))
## 更新日志
diff --git a/blog/zh/blog/2026/06/15/release-apache-apisix-3.17.0.md
b/blog/zh/blog/2026/06/15/release-apache-apisix-3.17.0.md
index 037768c34de..da2aa5530fc 100644
--- a/blog/zh/blog/2026/06/15/release-apache-apisix-3.17.0.md
+++ b/blog/zh/blog/2026/06/15/release-apache-apisix-3.17.0.md
@@ -147,7 +147,7 @@ Apache APISIX 3.17.0 为 GraphQL 工作负载引入了两个新插件。
### `proxy-cache` 的正确性和缓存安全性改进
-此版本改进了 `proxy-cache` 插件的正确性表现，包括在内存模式中遵循上游 `Vary` 标头、避免缓存 `Vary: *` 响应，以及让
`PURGE` 能够正确处理过期和多变体缓存条目。此外，除非显式启用 Cookie 缓存，否则内存缓存不会存储由上游或其他插件添加了 `Set-Cookie`
标头的响应。
+此版本改进了 `proxy-cache` 插件的正确性，包括在内存模式中遵循上游 `Vary` 标头、避免缓存 `Vary: *` 响应，以及让
`PURGE` 能够正确处理过期和多变体缓存条目。此外，除非显式启用 Cookie 缓存，否则内存缓存不会存储由上游或其他插件添加了 `Set-Cookie`
标头的响应。
更多信息，请参阅 [PR #13376](https://github.com/apache/apisix/pull/13376)。
@@ -169,11 +169,11 @@ Apache APISIX 3.17.0 为 GraphQL 工作负载引入了两个新插件。
此版本修复了多个身份认证和会话处理问题。
-`authz-keycloak` 在追加请求方法作用域时不再修改共享权限配置。`authz-casdoor` 现在会按 `client_id`
隔离会话。`cas-auth` 插件也强化了回调和会话处理逻辑，以防止无效回调会话以及跨路由会话复用；同时支持绝对 URL 形式的
`cas_callback_uri`，并在 CAS 单点登出回调格式错误时返回 `400`，避免返回 `500` 或接受空 ticket。
+`authz-keycloak` 在追加请求方法作用域时不再修改共享权限配置。`authz-casdoor` 现在会按 `client_id`
隔离会话。`cas-auth` 插件也强化了回调和会话处理逻辑，以防止无效回调会话以及跨路由会话复用；同时支持绝对 URL 形式的
`cas_callback_uri`，并在 CAS 单点登出回调畸形时返回 `400`，避免返回 `500` 或接受空 ticket。
更多信息，请参阅 [PR #13410](https://github.com/apache/apisix/pull/13410)、[PR
#13387](https://github.com/apache/apisix/pull/13387)、[PR
#13427](https://github.com/apache/apisix/pull/13427)、[PR
#13413](https://github.com/apache/apisix/pull/13413) 和 [PR
#13471](https://github.com/apache/apisix/pull/13471)。
-### 更好的敏感信息处理和令牌校验
+### 更好的 Secret 处理和令牌校验
此版本在启用字段加密时，扩展了对敏感插件字段的静态加密覆盖范围，包括 session secret、Redis 密码、日志插件凭证、serverless
token 和 AI 提供商凭证。同时，它还避免在解析错误中暴露原始 Google Cloud 凭证文件内容，并确保 `jwe-decrypt`
会拒绝无法解密的令牌，而不是继续将其转发到上游。
@@ -188,7 +188,7 @@ Apache APISIX 3.17.0 为 GraphQL 工作负载引入了两个新插件。
## 其他更新
- 通过在单次请求内缓存已解析的 JSON、form 和 multipart 请求体，提升请求体处理性能（PR
[#13377](https://github.com/apache/apisix/pull/13377) 和 PR
[#13356](https://github.com/apache/apisix/pull/13356)）
-- 通过更快的 SSE 解码、更好的断连处理，以及在无需重写时复用原始请求体，提升 AI 流式处理性能和行为表现（PR
[#13391](https://github.com/apache/apisix/pull/13391)、PR
[#13254](https://github.com/apache/apisix/pull/13254) 和 PR
[#13406](https://github.com/apache/apisix/pull/13406)）
+- 通过更快的 SSE 解码、更好的断连处理，以及在无需重写时复用原始请求体，提升 AI 流式处理性能和行为（PR
[#13391](https://github.com/apache/apisix/pull/13391)、PR
[#13254](https://github.com/apache/apisix/pull/13254) 和 PR
[#13406](https://github.com/apache/apisix/pull/13406)）
- 为 `hmac-auth`、`forward-auth`、`ai-proxy` 和 `ai-proxy-multi` 添加
`max_req_body_size` 保护，以 `413` 拒绝过大的请求体（PR
[#13478](https://github.com/apache/apisix/pull/13478) 和 PR
[#13466](https://github.com/apache/apisix/pull/13466)）
- 改进 `openid-connect` 兼容性，支持更新版 `lua-resty-session` 配置项，在本地 JWT 校验、PKCE 和
`private_key_jwt` 模式下将 `client_secret` 设为可选，并对 bearer-token JWT 或 introspection
响应应用 `claim_schema` 校验（PR [#13178](https://github.com/apache/apisix/pull/13178)
和 PR [#13472](https://github.com/apache/apisix/pull/13472)）
- 通过在多个请求处理路径中使用按请求分配替代共享可变表，提升并发安全性（PR
[#13369](https://github.com/apache/apisix/pull/13369)）
@@ -196,7 +196,7 @@ Apache APISIX 3.17.0 为 GraphQL 工作负载引入了两个新插件。
- 修复未包含 `Content-Length` 的 HTTP/2 和 HTTP/3 请求体处理问题（PR
[#13428](https://github.com/apache/apisix/pull/13428)）
- 通过使用 `EVALSHA` 和 `NOSCRIPT` 回退机制优化基于 Redis 的 `limit-count`（PR
[#13363](https://github.com/apache/apisix/pull/13363)）
- 通过拒绝畸形 RESP 长度并限制命令预分配大小，强化 Redis xRPC 请求解析（PR
[#13483](https://github.com/apache/apisix/pull/13483)）
-- 强化 `cors`、`multi-auth` 和 `body-transformer` 对畸形输入的处理，包括缺失的 `Origin`
标头、返回状态码但不返回错误消息的认证插件、格式错误的 multipart 请求体，以及会覆盖保留模板辅助函数的请求字段。DingTalk
认证现在也会在认证前清理客户端自行传入的 `X-Userinfo` 标头（PR
[#13469](https://github.com/apache/apisix/pull/13469) 和 PR
[#13491](https://github.com/apache/apisix/pull/13491)）
+- 强化 `cors`、`multi-auth` 和 `body-transformer` 对畸形输入的处理，包括缺失的 `Origin`
标头、返回状态码但不返回错误消息的认证插件、畸形的 multipart 请求体，以及会遮蔽保留模板辅助函数的请求字段。DingTalk
认证现在也会在认证前清理客户端自行传入的 `X-Userinfo` 标头（PR
[#13469](https://github.com/apache/apisix/pull/13469) 和 PR
[#13491](https://github.com/apache/apisix/pull/13491)）
## 变更日志
diff --git a/blog/zh/blog/2026/08/20/release-apache-apisix-3.18.0.md
b/blog/zh/blog/2026/08/20/release-apache-apisix-3.18.0.md
index 5e3c62b2e92..796f33dfbbf 100644
--- a/blog/zh/blog/2026/08/20/release-apache-apisix-3.18.0.md
+++ b/blog/zh/blog/2026/08/20/release-apache-apisix-3.18.0.md
@@ -35,7 +35,7 @@ tags: [Community]
`Apisix-Plugins` 响应头不再返回去重后的插件名称列表，而是按执行顺序返回
`plugin-name#phase`。依赖该响应头的解析工具需要相应更新。
-**升级计划：** 如果系统会读取 `Apisix-Plugins`，请让解析逻辑支持
`plugin-name#phase`、同一插件出现在多个阶段以及有序条目。`body_filter`、`log`
等响应头发送后的阶段是提前推算的，不能作为阶段实际执行的依据；如果工具会根据该响应头作出判断，请使用代表性路由验证结果。
+**升级计划：** 如果系统会读取 `Apisix-Plugins`，请让解析逻辑支持
`plugin-name#phase`、同一插件出现在多个阶段以及有序条目。`body_filter`、`log`
等属于在响应头中推断列出的后续阶段，不能作为阶段实际执行的依据；如果工具会根据该响应头作出判断，请使用代表性路由验证结果。
更多信息，请参阅 [PR #13710](https://github.com/apache/apisix/pull/13710)。
@@ -89,7 +89,7 @@ tags: [Community]
### 写入时检查重复的 Consumer 身份验证键
-Admin API 现在会在写入时检查 `key-auth`、`basic-auth`、`jwt-auth`、`hmac-auth` 与 LDAP
身份验证中跨 Consumer 或凭证重复的查找键，并以 400 拒绝检测到的冲突。该保护是尽力而为：本地监听到的 Consumer
数据可能滞后于快速或并发写入，传入的 Secret 或环境变量引用也无法在此检查中解析。
+Admin API 现在会在写入时检查 `key-auth`、`basic-auth`、`jwt-auth`、`hmac-auth` 与 LDAP
身份验证中跨 Consumer 或凭证重复的查找键，并以 400 拒绝检测到的冲突。该保护属于尽力而为（best-effort）性质：本地监听到的
Consumer 数据可能滞后于快速或并发写入，传入的 Secret 或环境变量引用也无法在此检查中解析。
**升级计划：** 上线前应独立审计现有 Consumer 与凭证中的重复身份验证键，包括通过 Secret
或环境变量引用提供的值，并先解决冲突。不要将新的 Admin API 检查作为唯一的唯一性保障；可行时应串行执行敏感迁移，随后更新每个受影响的
Consumer，并实际发起认证以确认身份归属正确。
@@ -113,7 +113,7 @@ Admin API 现在会在写入时检查 `key-auth`、`basic-auth`、`jwt-auth`、`
### 现有 LDAP TLS 验证开始真正生效
-LDAP 客户端依赖升级后，`ldap-auth.tls_verify: true`
会真正执行证书验证，而不再是无效配置。使用自签名证书或证书主机名不匹配的部署，需要安装受信任且匹配的证书，或在适当场景显式关闭验证。
+LDAP 客户端依赖升级后，`ldap-auth.tls_verify: true`
会真正执行证书验证，而不再是空操作（no-op）。使用自签名证书或证书主机名不匹配的部署，需要安装受信任且匹配的证书，或在适当场景显式关闭验证。
**升级计划：** 如果现有 `ldap-auth` 部署启用了 `tls_verify`，请在上线前根据 `ldap_uri` 验证证书链和
SAN，并配置所需的受信任 CA。只需测试实际使用的加密连接模式，例如 LDAPS 或 StartTLS；关闭证书验证的配置不会新增此失败路径。
@@ -151,7 +151,7 @@ APISIX 3.18.0 扩展了 AI Gateway、身份验证、L4 代理、可观测性、
`ai-proxy`、`ai-proxy-multi` 与 `ai-request-rewrite` 现在默认通过
`ngx_http_ffi_client` 向上游 LLM 发送请求。该客户端基于 C 实现，可降低出站 HTTP 开销，同时支持与
`lua-resty-http` 相同的缓冲、流式、TLS 和连接复用路径。
-APISIX 3.18.0 固定的 APISIX-Runtime 已包含兼容的 v0.1.3 客户端及其 APISIX 域名解析钩子。该钩子可保持网关原有的
DNS 行为，包括 `dns_resolver`、`/etc/hosts` 和搜索域处理，同时为 `Host` 请求头与 SNI 保留原始主机名。
+APISIX 3.18.0 固定使用的 APISIX-Runtime 已包含兼容的 v0.1.3 客户端及其 APISIX
域名解析钩子。该钩子可保持网关原有的 DNS 行为，包括 `dns_resolver`、`/etc/hosts` 和搜索域处理，同时为 `Host` 请求头与
SNI 保留原始主机名。
使用自行构建或旧版 APISIX-Runtime 的运维人员可以显式保留 Lua 客户端：
@@ -161,7 +161,7 @@ plugin_attr:
http_client: lua-resty-http
```
-配置的客户端不可用时，传输层不会静默切换到另一客户端。本版本固定的 APISIX-Runtime 无需兼容性调整；自定义 APISIX-Runtime
用户应确认客户端版本，或选择 `lua-resty-http`，随后测试实际提供商使用的 DNS、TLS、缓冲响应和流式路径。
+配置的客户端不可用时，传输层不会静默切换到另一客户端。本版本固定使用的 APISIX-Runtime 无需兼容性调整；自定义 APISIX-Runtime
用户应确认客户端版本，或选择 `lua-resty-http`，随后测试实际提供商使用的 DNS、TLS、缓冲响应和流式路径。
更多信息，请参阅 [PR #13778](https://github.com/apache/apisix/pull/13778)。
@@ -203,7 +203,7 @@ plugin_attr:
### 根据语义将提示词路由到不同模型
-`ai-proxy-multi` 新增 `semantic`
负载均衡算法，适用于多个模型能力、成本和延迟并不相同的部署。一个统一端点可以将编程问题路由到能力更强的模型，将翻译请求路由到低成本模型，并将无法归类的流量交给通用回退实例，而无需向客户端暴露提供商拓扑。
+`ai-proxy-multi` 新增 `semantic`
负载均衡算法，适用于可用模型不可互换的部署。一个统一端点可以将编程问题路由到能力更强的模型，将翻译请求路由到低成本模型，并将无法归类的流量交给通用回退实例，而无需向客户端暴露提供商拓扑。
APISIX
会为每个实例的自然语言示例生成一次嵌入向量，并按配置版本缓存参考向量。每个请求只需生成一次提示词嵌入向量，随后在进程内完成余弦相似度比较，不需要向量数据库。如果嵌入向量生成失败或没有分数超过阈值，请求会交给配置的回退实例。
@@ -250,7 +250,7 @@ APISIX 会为每个实例的自然语言示例生成一次嵌入向量，并按
}
```
-语义选择是尽力而为的路由能力，并非内容安全控制；实例选定后目前也不提供基于健康状态的重试。
+语义选择是一种尽力而为（best-effort）的路由方式，并非内容安全控制；实例选定后目前也不提供基于健康状态的重试。
更多信息，请参阅 [PR #13676](https://github.com/apache/apisix/pull/13676)。
@@ -423,7 +423,7 @@ Prometheus 新增 AI 缓存命中、未命中和绕过计数器、嵌入向量
}
```
-浏览器流程故障也会得到更友好的恢复。过期回调或 `temporarily_unavailable` 响应可以从原始 URL
重新启动认证，并通过受限重试计数器避免重定向循环。`access_denied` 等明确拒绝结果不会重试。
+浏览器流程故障也能更优雅地恢复。过期回调或 `temporarily_unavailable` 响应可以从原始 URL
重新启动认证，并通过受限重试计数器避免重定向循环。`access_denied` 等明确拒绝结果不会重试。
更多信息，请参阅 [PR #13649](https://github.com/apache/apisix/pull/13649)、[PR
#13616](https://github.com/apache/apisix/pull/13616)、[PR
#13712](https://github.com/apache/apisix/pull/13712) 和 [PR
#13825](https://github.com/apache/apisix/pull/13825)。
@@ -475,20 +475,20 @@ APISIX 可以在匹配参数化路由时保留 `%2F` 编码，使 `cat%2Fdog`
### AI Gateway 正确性与协议兼容性
-AI 代理现在能够保留更多上游提供商的原始语义，并使重试与前一次尝试相互隔离。请求未重试时，客户端会收到原始 429/5xx 错误体和
Content-Type；发生回退时，每个实例都从未被修改的客户端请求体重新构造请求，避免模型选项在实例之间泄漏。AI
延迟变量在成功和错误响应上也统一使用毫秒。参阅 [PR
#13565](https://github.com/apache/apisix/pull/13565)、[PR
#13793](https://github.com/apache/apisix/pull/13793) 和 [PR
#13711](https://github.com/apache/apisix/pull/13711)。
+AI 代理现在能够更好地保留上游提供商的原始意图，并使重试与前一次尝试相互隔离。请求未重试时，客户端会收到原始 429/5xx 错误体和
Content-Type；发生回退时，每个实例都从未被修改的客户端请求体重新构造请求，避免模型选项在实例之间泄漏。AI
延迟变量在成功和错误响应上也统一使用毫秒。参阅 [PR
#13565](https://github.com/apache/apisix/pull/13565)、[PR
#13793](https://github.com/apache/apisix/pull/13793) 和 [PR
#13711](https://github.com/apache/apisix/pull/13711)。
-协议转换变得更加可靠和忠实：
+协议转换变得更加可靠，也更贴合上游原意：
- 上游流在打开内容块前结束时，Anthropic 客户端不再挂起；无效的 `tool_call` 参数也不会丢弃原本可用的响应。参阅 [PR
#13583](https://github.com/apache/apisix/pull/13583) 和 [PR
#13599](https://github.com/apache/apisix/pull/13599)。
- Anthropic 工具结果顺序、工具名称映射、推理强度、结构化输出和消息形态现在更符合 OpenAI 兼容上游的预期。参阅 [PR
#13674](https://github.com/apache/apisix/pull/13674)。
-- 结构化与多模态消息内容会为文本消费者进行一致展开，同时在精确缓存键中保持区别；包含非文本状态的提示词会绕过语义缓存。参阅 [PR
#13634](https://github.com/apache/apisix/pull/13634) 和 [PR
#13654](https://github.com/apache/apisix/pull/13654)。
-- 协议转换将一个上游数据块展开为多个客户端事件时，实时审核不再重复计算同一数据块。参阅 [PR
#13765](https://github.com/apache/apisix/pull/13765)。
+- 结构化与多模态消息内容会为文本消费者一致地展平，同时在精确缓存键中保持区别；包含非文本状态的提示词会绕过语义缓存。参阅 [PR
#13634](https://github.com/apache/apisix/pull/13634) 和 [PR
#13654](https://github.com/apache/apisix/pull/13654)。
+- 协议转换将一个上游数据块扇出为多个客户端事件时，实时审核不再重复计算同一数据块。参阅 [PR
#13765](https://github.com/apache/apisix/pull/13765)。
`ai-request-rewrite` 的内部请求现在只携带插件中配置的提供商凭证，不再转发下游客户端的 `Cookie`
及其他请求头；当提供商通过查询参数、`api-key` 或 SigV4 进行身份验证，而不会覆盖 `Authorization` 请求头时，客户端的
`Authorization` 也不会再被转发。透明代理的 `ai-proxy` 路径仍会按文档转发客户端请求头。参阅 [PR
#13699](https://github.com/apache/apisix/pull/13699)。
### 身份验证与身份安全
-身份验证插件现在可以干净地拒绝异常输入，并防止客户端控制的身份数据到达上游服务：
+身份验证插件现在可以干净地拒绝畸形输入，并防止客户端控制的身份数据到达上游服务：
- 异常 JWT 签名返回 401，而不再触发 500；`jwe-decrypt` 在关闭 `strict` 时也会正确允许缺少令牌的请求。参阅 [PR
#13518](https://github.com/apache/apisix/pull/13518) 和 [PR
#13822](https://github.com/apache/apisix/pull/13822)。
- `wolf-rbac` 与 `attach-consumer-label` 会在应用受信任身份数据前始终删除客户端传入的身份请求头。参阅 [PR
#13696](https://github.com/apache/apisix/pull/13696) 和 [PR
#13590](https://github.com/apache/apisix/pull/13590)。
@@ -525,7 +525,7 @@ CAS 单点登出回调现在会在插件处终止，不再转发到上游；Casd
内存 `proxy-cache` 策略现在使用具有唯一映射关系的存储键格式，使构造请求无法读取或覆盖其他请求的 Vary
变体。布局版本也已升级，因此升级前的内存缓存条目在过期前将无法命中。`graphql-proxy-cache` 的 PURGE 也会删除索引中的所有 Vary
变体，而不再只删除旧的基础条目。参阅 [PR #13831](https://github.com/apache/apisix/pull/13831) 和
[PR #13523](https://github.com/apache/apisix/pull/13523)。
-缓冲后的请求体现在会在内部 HTTP 调用前重新生成正确的消息边界信息。`forward-auth`、AWS Lambda、Azure Functions
与 OpenFunction 会移除已经不再适用的客户端 `Transfer-Encoding` 和 `Content-Length`，由 HTTP
客户端根据实际缓冲请求体重新生成 `Content-Length`。参阅 [PR
#13642](https://github.com/apache/apisix/pull/13642) 和 [PR
#13798](https://github.com/apache/apisix/pull/13798)。
+缓冲后的请求体现在会在内部 HTTP 调用前被正确重新封装。`forward-auth`、AWS Lambda、Azure Functions 与
OpenFunction 会移除已经不再适用的客户端 `Transfer-Encoding` 和 `Content-Length`，由 HTTP
客户端根据实际缓冲请求体重新生成 `Content-Length`。参阅 [PR
#13642](https://github.com/apache/apisix/pull/13642) 和 [PR
#13798](https://github.com/apache/apisix/pull/13798)。
其他数据处理修复包括：
@@ -537,7 +537,7 @@ CAS 单点登出回调现在会在插件处终止，不再转发到上游；Casd
### 日志与可观测性
-日志负载和凭证更不容易泄漏或跨配置串用：
+日志负载和凭证更不容易泄漏或跨配置边界混用：
- Elasticsearch、Kafka、RocketMQ、SLS 与 Syslog 不再把序列化日志负载写入错误日志；Kafka SASL
凭证也会在错误路径中脱敏。参阅 [PR #13502](https://github.com/apache/apisix/pull/13502) 和 [PR
#13786](https://github.com/apache/apisix/pull/13786)。
- Loki 会按请求解析动态标签，并按解析后的标签集合对批次中的条目分组，避免一个服务的标签泄漏到另一个服务。参阅 [PR
#13562](https://github.com/apache/apisix/pull/13562)。
@@ -557,9 +557,9 @@ OpenTelemetry Tracer 会在元数据变更后重建，核心 Span 注入也会
环境变量与 Secret 处理也获得多项修复：
-- 精确键环境变量查找可避免前缀冲突；配置键替换会移除未解析旧键；`nginx_config.envs` 也会安全引用包含空格的值。参阅 [PR
#13595](https://github.com/apache/apisix/pull/13595)、[PR
#12885](https://github.com/apache/apisix/pull/12885) 和 [PR
#13713](https://github.com/apache/apisix/pull/13713)。
+- 精确键环境变量查找可避免前缀冲突；配置键替换会移除未解析的键；`nginx_config.envs` 也会安全引用包含空格的值。参阅 [PR
#13595](https://github.com/apache/apisix/pull/13595)、[PR
#12885](https://github.com/apache/apisix/pull/12885) 和 [PR
#13713](https://github.com/apache/apisix/pull/13713)。
- `/secrets` 变化时 Secret 缓存会失效；未解析引用会生成包含字段信息的错误，而不再静默失败。参阅 [PR
#13668](https://github.com/apache/apisix/pull/13668) 和 [PR
#13737](https://github.com/apache/apisix/pull/13737)。
-- Secret 引用仍未解析时，Consumer 身份验证会拒绝请求，而不再使用引用字符串继续认证。Stream TLS 与引用的上游 SSL
对象也会正确初始化和解析由环境变量或 Secret 提供的证书材料。参阅 [PR
#13667](https://github.com/apache/apisix/pull/13667)、[PR
#12935](https://github.com/apache/apisix/pull/12935) 和 [PR
#13062](https://github.com/apache/apisix/pull/13062)。
+- Secret 引用仍未解析时，Consumer 身份验证会直接拒绝请求（fail closed），而不是继续完成认证。Stream TLS 与引用的上游
SSL 对象也会正确初始化和解析由环境变量或 Secret 提供的证书材料。参阅 [PR
#13667](https://github.com/apache/apisix/pull/13667)、[PR
#12935](https://github.com/apache/apisix/pull/12935) 和 [PR
#13062](https://github.com/apache/apisix/pull/13062)。
合并 Consumer 与 Route 配置后，插件状态会被保留；父资源查找也支持所有可携带插件的资源类型。参阅 [PR
#13757](https://github.com/apache/apisix/pull/13757) 和 [PR
#13663](https://github.com/apache/apisix/pull/13663)。
