jiazhizhong/higress
1
0
Fork 0
mirror of https://github.com/alibaba/higress.git synced 2026-05-11 14:27:27 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
3a61beb3f91237c549c4f2e3f4fc2667c4eb8105
higress/release-notes/2.2.0/README_ZH.md
johnlanni 3a61beb3f9 Add release notes
2026-02-10 14:01:23 +00:00

50 KiB
Raw Blame History

Higress

📋 本次发布概览

本次发布包含 92 项更新，涵盖了功能增强、Bug修复、性能优化等多个方面。

更新内容分布

  • 新功能: 48项
  • Bug修复: 20项
  • 重构优化: 3项
  • 文档更新: 20项
  • 测试改进: 1项

📝 完整变更日志

🚀 新功能 (Features)

  • Related PR: #3459
    Contributor: @johnlanni
    Change Log: 此PR通过添加claudeCodeMode配置项，使系统能够模拟Claude Code客户端请求格式，支持特定的OAuth令牌认证机制以及特殊的请求头和参数。
    Feature Value: 新增对Claude Code模式的支持极大地扩展了与Anthropic Claude API交互的能力，允许用户更灵活地使用OAuth令牌进行身份验证，从而提升了API调用的安全性和兼容性。

  • Related PR: #3455
    Contributor: @EndlessSeeker
    Change Log: 此PR更新了git子模块，包括升级envoy和go-control-plane版本，并同步istio到最新版的go-control-plane。
    Feature Value: 通过更新关键依赖库至最新版本，提升了系统的安全性与性能稳定性，为用户提供更可靠的服务体验。

  • Related PR: #3438
    Contributor: @johnlanni
    Change Log: 调整了文档结构，并创建了专门的Clawdbot插件目录，以实现Clawdbot真正的兼容性。包括了新的配置文件和示例代码。
    Feature Value: 通过改进技能集成流程，用户可以更流畅地配置插件，同时确保了与Clawdbot的完全兼容，提升了用户体验和系统的灵活性。

  • Related PR: #3437
    Contributor: @johnlanni
    Change Log: 此PR将higress-ai-gateway插件集成到higress-clawdbot-integration技能中，包括移动和重命名相关文件及更新文档，以简化用户安装与配置过程。
    Feature Value: 通过集成Higress AI Gateway插件至Clawdbot/OpenClaw技能，用户可以更便捷地管理和使用AI网关，从而提升开发效率和用户体验。

  • Related PR: #3436
    Contributor: @johnlanni
    Change Log: 此PR更新了Higress-OpenClaw集成的SKILL提供商列表，并将OpenClaw插件包从higress-standalone迁移到主仓库，增强了对常用提供商的支持。
    Feature Value: 通过增强提供商列表和迁移插件包，提升了Higress-OpenClaw集成的可用性和灵活性，让用户能够更方便地使用首选AI服务。

  • Related PR: #3428
    Contributor: @johnlanni
    Change Log: 新增了两个技能higress-auto-router和higress-clawdbot-integration，支持通过自然语言配置自动模型路由及Higress AI Gateway与Clawdbot的集成部署。
    Feature Value: 这些新功能允许用户更便捷地管理和配置AI网关，提高操作效率并增强了系统的灵活性，特别适合需要频繁调整路由规则或多语言支持的应用场景。

  • Related PR: #3427
    Contributor: @johnlanni
    Change Log: 新增了use_default_attributes配置选项，允许ai-statistics插件自动应用一组默认属性，简化用户配置流程。
    Feature Value: 通过提供默认属性配置，减少了用户的初始设置负担，使得插件更加易用，同时保持了高级定制的可能性，提升了用户体验。

  • Related PR: #3426
    Contributor: @johnlanni
    Change Log: PR为Higress环境下的LLM使用添加了一个Agent Session Monitor技能，实现了实时会话监控和日志分析。
    Feature Value: 此功能增强了对多轮对话过程中模型使用的可见性，帮助用户更好地理解和优化LLM在实际场景中的应用效果。

  • Related PR: #3424
    Contributor: @johnlanni
    Change Log: 此PR为ai-statistics插件添加了对记录详细token使用信息的支持，包括新增内置属性键reasoning_tokens和cached_tokens。
    Feature Value: 通过提供更详细的token使用情况报告，用户可以更好地理解AI处理过程中的资源消耗情况，有助于优化成本和性能。

  • Related PR: #3420
    Contributor: @johnlanni
    Change Log: 新增会话ID追踪功能，支持通过自定义头或默认头获取会话ID，从而追踪多轮对话。
    Feature Value: 此功能允许用户更好地跟踪和分析多轮对话中的行为，有助于提高聊天机器人的性能与用户体验。

  • Related PR: #3417
    Contributor: @johnlanni
    Change Log: 增加了对未支持配置片段的显著警告，并提供了迁移前检查命令以识别受影响的Ingress资源，同时更新了文档中的注解映射。
    Feature Value: 通过提供关键警告和指引，帮助用户在从Nginx迁移到Higress时避免潜在问题，确保迁移过程更加顺畅、安全。

  • Related PR: #3411
    Contributor: @johnlanni
    Change Log: 新增了一套从ingress-nginx迁移到Higress的技能，包括兼容性分析脚本、迁移测试脚本生成、WASM插件框架生成等工具。
    Feature Value: 为用户提供了一种便捷的方法来将现有的ingress-nginx配置无缝迁移到Higress上，降低了迁移难度和风险，提升了用户体验。

  • Related PR: #3409
    Contributor: @johnlanni
    Change Log: 此PR为ai-proxy插件添加了contextCleanupCommands配置项，允许用户定义清理对话上下文的命令。当用户消息与任何一个预设的清理命令完全匹配时，将清除该命令之前的所有非系统消息。
    Feature Value: 通过引入自定义上下文清理命令，用户能够主动管理对话历史记录，这有助于保持对话的清晰度并提高用户体验。特别地，对于需要频繁重置对话场景的应用而言，此功能极大提升了灵活性和实用性。

  • Related PR: #3404
    Contributor: @johnlanni
    Change Log: 引入了Higress社区治理日报生成功能，利用Claude AI助手自动追踪并汇总项目活动，包括新issues/PRs和评论动态。
    Feature Value: 该功能增强了社区治理的透明度与效率，通过每日报告帮助成员了解项目进展，促进问题解决和经验积累。

  • Related PR: #3403
    Contributor: @johnlanni
    Change Log: 新增基于用户消息内容的自动模型路由功能，通过正则规则分析内容来决定使用哪个模型。
    Feature Value: 该功能使网关能够根据用户输入的内容智能选择最匹配的处理模型，极大提升了用户体验和系统灵活性。

  • Related PR: #3402
    Contributor: @johnlanni
    Change Log: 新增了Claude技能，用于使用Go 1.24+开发Higress WASM插件，并提供了详细的文档和示例。
    Feature Value: 为开发者提供了一种新的方式来创建、修改或调试Higress网关插件，特别适用于HTTP请求响应处理，增强了开发效率。

  • Related PR: #3394
    Contributor: @changsci
    Change Log: 该PR实现了在provider.apiTokens未配置时从请求头中获取API密钥的功能。通过修改wasm-go插件的相关代码，增加了对OpenAI服务的支持。
    Feature Value: 增强了系统的灵活性和易用性，允许用户在未明确配置API令牌的情况下也能正常使用服务，简化了设置流程，提升了用户体验。

  • Related PR: #3384
    Contributor: @ThxCode-Chen
    Change Log: 此PR在watcher.go文件中增加了对上游IPv6静态地址的支持，修改了服务条目的生成逻辑以适应新的网络配置。
    Feature Value: 通过支持上游IPv6静态地址，用户可以更灵活地配置网络环境，特别是在需要使用IPv6进行通信的场景下，提高了系统的兼容性和可用性。

  • Related PR: #3375
    Contributor: @wydream
    Change Log: 本PR为ai-proxy插件的Vertex AI Provider添加了Vertex Raw模式支持，使得通过Vertex访问原生Vertex REST API时也能启用getAccessToken机制。
    Feature Value: 新增的Vertex Raw模式支持使用户能够直接调用Vertex AI上的第三方模型或其他非标准API路径，并享受自动OAuth认证，提升了用户体验和灵活性。

  • Related PR: #3367
    Contributor: @rinfx
    Change Log: 本PR更新了wasm-go依赖，并引入Foreign Function，允许Wasm插件实时感知Envoy宿主的日志级别，优化日志处理流程。
    Feature Value: 通过提前进行日志等级检查避免了不必要的内存操作，提升了性能和资源利用率，对于注重效率和性能的应用场景尤为重要。

  • Related PR: #3342
    Contributor: @Aias00
    Change Log: 此PR实现了将Nacos实例权重映射到Istio WorkloadEntry的权重，通过引入math库进行转换处理，并新增了大量测试用例以确保功能正确性。
    Feature Value: 通过此项功能增强，用户可以更灵活地控制服务间的流量分配策略，特别是在使用Istio作为服务网格时，能够更好地实现基于权重的服务发现与路由。

  • Related PR: #3335
    Contributor: @wydream
    Change Log: 本PR在ai-proxy插件的Vertex AI Provider中添加了图片生成支持，通过实现OpenAI到Vertex AI协议的转换实现了文生图功能。
    Feature Value: 允许用户使用标准的OpenAI SDK调用Vertex AI的图片生成能力，简化了开发者集成不同AI服务的过程，增强了插件的功能多样性。

  • Related PR: #3324
    Contributor: @wydream
    Change Log: 本PR为ai-proxy插件的Vertex AI Provider添加了OpenAI-compatible端点支持，实现了对Vertex AI模型使用OpenAI SDK和API格式直接调用的功能。
    Feature Value: 通过此功能，用户可以更方便地将现有基于OpenAI的应用程序无缝迁移到Vertex AI上，无需更改原有代码逻辑，极大地简化了开发者的迁移工作。

  • Related PR: #3318
    Contributor: @hanxiantao
    Change Log: 此PR通过使用withConditionalAuth中间件为debug endpoints添加了身份验证包装器，依据DebugAuth功能标志来维持现有行为。
    Feature Value: 增强了debug endpoints的安全性，使得只有经过Istio本地认证逻辑验证的请求才能访问这些端点，从而提高了系统的安全性与可控性。

  • Related PR: #3317
    Contributor: @rinfx
    Change Log: 新增了model-mapper和model-router两个WASM-Go插件，实现了基于LLM协议中model参数的映射与路由功能。
    Feature Value: 增强了Higress在大型语言模型场景下的治理能力，支持模型名称映射及无感降级、统一客户端模型名称，以及基于provider/model参数的路由分发。

  • Related PR: #3305
    Contributor: @CZJCC
    Change Log: 新增了对AWS Bedrock服务的Bearer Token认证支持，同时保留原有的AWS Signature V4认证方式，并清理了部分未使用的代码。
    Feature Value: 通过引入Bearer Token认证选项，用户现在可以更灵活地选择适合其安全需求的认证机制，从而提升了系统的安全性和易用性。

  • Related PR: #3301
    Contributor: @wydream
    Change Log: 本PR为ai-proxy插件的Vertex AI Provider添加了Express Mode支持，简化了配置过程，允许用户仅使用API Key即可访问Vertex AI。
    Feature Value: 通过引入Express Mode，用户可以更快速便捷地开始使用Vertex AI服务，无需再进行复杂的Service Account认证设置，极大地提升了用户体验和开发效率。

  • Related PR: #3295
    Contributor: @rinfx
    Change Log: 本PR在ai-security-guard插件中增加了对MCP(Model Context Protocol)的支持，实现了HandleMcpResponseBody和HandleMcpStreamingResponseBody方法来检查并可能拦截标准及流式响应。
    Feature Value: 新增的MCP支持功能增强了插件处理不同API类型的能力，允许用户更安全地使用MCP API，通过内容安全检查防止潜在的不安全信息传递。

  • Related PR: #3267
    Contributor: @erasernoob
    Change Log: 新增了hgctl agent模块，涉及多个文件的修改与新增，包括go.mod依赖更新、添加README文档说明以及agent.go和base.go等核心功能代码实现。
    Feature Value: 通过引入hgctl agent模块，为用户提供了一种新的管理和操作方式，增强了系统的灵活性和可扩展性，使得用户能够更方便地进行集群管理和配置。

  • Related PR: #3261
    Contributor: @rinfx
    Change Log: 此PR在gemini-2.5-flash和gemini-2.5-flash-lite中增加了关闭thinking的支持，并在响应中添加了reasoning token信息。
    Feature Value: 通过新增关闭thinking的功能以及显示reasoning token使用情况，用户能够更灵活地控制AI代理的行为并获得更详细的执行信息。

  • Related PR: #3255
    Contributor: @nixidexiangjiao
    Change Log: 优化了基于Lua的最小在途请求数负载均衡策略，解决了异常节点偏好性选择、新节点处理不一致以及采样分布不均的问题。
    Feature Value: 提升了系统的稳定性和服务可用性，减少了由于负载不均导致的服务故障，增强了对异常节点的自适应熔断能力。

  • Related PR: #3236
    Contributor: @rinfx
    Change Log: 该PR在vertex中增加了对claude模型的支持，并且处理了delta可能为空的情况，通过修改相关Go文件实现了新增功能。
    Feature Value: 新增的claude模型支持扩展了用户可用的AI能力范围，提升了系统的灵活性和实用性。同时，对于边界情况的处理增强了系统的稳定性和健壮性。

  • Related PR: #3218
    Contributor: @johnlanni
    Change Log: 此PR增强了模型映射器和路由器，添加了基于请求计数和内存使用量的自动重建触发机制，并扩展了支持的路径后缀。
    Feature Value: 通过监控关键指标并适时触发重建，提高了系统的稳定性和响应速度；同时，扩展路径支持提升了API的功能多样性。

  • Related PR: #3213
    Contributor: @rinfx
    Change Log: 此PR通过移除区域指定的方式，使ai-proxy支持全局(global)访问模式，以兼容最新的gemini-3系列模型需求。
    Feature Value: 增强了系统对于不同部署环境的适应性，特别是为使用全球区域配置的用户提供了一致且无缝的支持体验。

  • Related PR: #3206
    Contributor: @rinfx
    Change Log: 该PR实现了在内容安全检测插件中添加对请求体内的prompt和图片进行检查的功能，涉及解析OpenAI及Qwen生成的图像与文本数据。
    Feature Value: 增强了内容安全防护能力，确保了AI生成的内容符合安全标准，提升了用户使用体验的安全性和可靠性。

  • Related PR: #3200
    Contributor: @YTGhost
    Change Log: 此PR通过在chatToolMessage2BedrockMessage函数中添加对数组内容的支持，增强了ai-proxy插件处理不同类型消息的能力。
    Feature Value: 支持处理数组形式的内容扩大了聊天工具与Bedrock之间消息传递的灵活性，使得开发者能够更方便地集成多样化的应用需求。

  • Related PR: #3185
    Contributor: @rinfx
    Change Log: 此PR为ai-cache增加了重建逻辑，通过在内存占用过高时触发重建来优化缓存管理。
    Feature Value: 新增的重建机制有助于防止因缓存导致的内存溢出问题，提高了系统的稳定性和用户体验。

  • Related PR: #3184
    Contributor: @rinfx
    Change Log: 此PR为豆包服务添加了用户自定义域名配置的支持，涉及对Makefile及ai-proxy相关文件的修改，以实现更灵活的服务部署。
    Feature Value: 允许用户为豆包服务配置自定义域名，提升了服务部署灵活性和用户体验，满足了用户对于个性化域名配置的需求。

  • Related PR: #3175
    Contributor: @wydream
    Change Log: 此PR实现了一个新的通用提供者，用于处理无需路径重映射的请求，并更新了README文件以包含配置详情。同时增加了针对新功能的测试。
    Feature Value: 新增的通用提供者使得用户能够更灵活地处理不同供应商的服务请求，简化了跨平台应用开发，提升了系统的可维护性和扩展性。

  • Related PR: #3173
    Contributor: @EndlessSeeker
    Change Log: 新增了全局参数以支持推理扩展功能，通过在控制器部署配置中引入新的环境变量，并更新相关配置文件来实现。
    Feature Value: 该功能允许用户更灵活地配置和使用推理扩展，增强了系统的可定制性和适应性，为用户提供更多控制选项。

  • Related PR: #3171
    Contributor: @wilsonwu
    Change Log: 此PR为网关和控制器添加了拓扑分布约束的支持，通过在Helm模板中引入新的配置项，允许用户自定义这些组件的部署策略。
    Feature Value: 新增的拓扑分布约束功能使用户能够更好地控制服务实例在集群中的分布情况，提高系统的可用性和稳定性。

  • Related PR: #3160
    Contributor: @EndlessSeeker
    Change Log: 此PR升级了网关API到最新版本，涉及Makefile、go.mod等文件的更新，并在helm配置中添加了新的规则。
    Feature Value: 通过升级网关API至最新版本，提升了系统的兼容性和性能，使用户能够利用最新的API特性，增强了应用的灵活性和可扩展性。

  • Related PR: #3136
    Contributor: @Wangzy455
    Change Log: 实现了基于Milvus向量数据库的工具语义搜索功能，通过将工具描述转换为向量表示并使用向量相似性搜索来实现语义匹配。
    Feature Value: 此功能允许用户通过自然语言查询找到最相关的工具，极大提高了工具搜索的准确性和用户体验。

  • Related PR: #3075
    Contributor: @rinfx
    Change Log: 重构ai-security-guard插件以支持多模态输入处理，包括文本和图片生成场景的安全检测，并进行了模块化拆分。
    Feature Value: 增强了AI安全防护功能，使系统能够更全面地对多模态内容进行安全检查，提升了用户体验和系统的安全性。

  • Related PR: #3066
    Contributor: @EndlessSeeker
    Change Log: 升级Istio版本至1.27.1，并调整higress-core以适应新版本，修复了子模块分支拉取和集成测试的问题。
    Feature Value: 通过升级Istio版本和相关依赖，提高了系统的稳定性和性能，确保用户能够使用最新功能并减少潜在的兼容性问题。

  • Related PR: #3063
    Contributor: @rinfx
    Change Log: 此PR引入了基于特定指标（如并发数、TTFT、RT等）的负载均衡功能，允许用户自定义用于负载均衡的指标。
    Feature Value: 新增的功能使得系统可以根据更细粒度的性能指标来智能地分配请求，提高了集群资源利用率和响应速度，提升了用户体验。

  • Related PR: #3061
    Contributor: @Jing-ze
    Change Log: 该PR实现了响应缓存插件的修复与增强，包括改进缓存键提取逻辑、移除冗余参数、修正配置验证问题，并添加了全面的单元测试。
    Feature Value: 新增响应缓存插件能够显著提升应用性能，通过从请求头或请求体中提取缓存键并存储响应值，减少了重复请求对后端服务的压力。

  • Related PR: #2825
    Contributor: @CH3CHO
    Change Log: 此PR添加了一个traffic-editor插件，支持对请求/响应头进行多种修改操作，并采用更可扩展的代码结构。
    Feature Value: 新插件允许用户灵活地编辑请求和响应头部信息，增强了Higress网关的功能性和用户体验，提升了系统的灵活性与可维护性。

🐛 Bug修复 (Bug Fixes)

  • Related PR: #3448
    Contributor: @lexburner
    Change Log: 修复了在处理Qwen API响应时，因Choices数组为空导致的数组越界错误。通过增加空数组检查避免程序崩溃。
    Feature Value: 解决了高并发场景下可能出现的程序异常退出问题，提升了系统的稳定性和健壮性，保证了用户请求能够被正确处理。

  • Related PR: #3434
    Contributor: @johnlanni
    Change Log: 修正了技能文件前言中描述值未被正确引用的问题，通过将描述值用双引号包裹来避免YAML解析错误。
    Feature Value: 解决了因特定字符导致的YAML解析失败问题，确保了技能文档能够正确显示和解析，提升了用户体验和文档准确性。

  • Related PR: #3422
    Contributor: @johnlanni
    Change Log: 修复了model-router插件自动路由模式下请求体中的model字段未同步更新的问题，确保在做出路由决策后，请求体中model字段能正确反映实际使用的模型。
    Feature Value: 此修复解决了下游服务因接收到错误的请求体模型名称而导致的问题，提升了系统的准确性和可靠性，保证用户能够在自动路由模式下获得正确的处理结果。

  • Related PR: #3400
    Contributor: @johnlanni
    Change Log: 移除了service.yaml中重复的loadBalancerClass定义，解决了因重复定义导致的YAML解析错误。
    Feature Value: 修复了配置loadBalancerClass时出现的YAML解析错误问题，提升了用户体验和系统稳定性。

  • Related PR: #3380
    Contributor: @Thomas-Eliot
    Change Log: 在请求体处理函数中添加了上下文设置操作，将请求模型存入上下文中，确保调用链中能够正确获取到请求模型的数据。
    Feature Value: 修复了请求模型上下文未设置的问题，提高了系统的稳定性和数据的一致性，使用户在使用过程中不会因为上下文缺失而遇到错误。

  • Related PR: #3370
    Contributor: @rinfx
    Change Log: 修复了model-mapper中后缀不匹配时仍会处理请求body的问题，并增加了对请求body的JSON验证，确保传入的数据是有效的JSON格式。
    Feature Value: 此修复提升了系统的健壮性和用户数据的准确性。通过过滤无效输入并确保数据完整性，增强了用户体验和系统稳定性。

  • Related PR: #3341
    Contributor: @zth9
    Change Log: 修复了并发SSE连接返回错误端点的问题，确保了在多连接场景下正确处理SSE请求，涉及配置与过滤器逻辑的调整。
    Feature Value: 提高了系统的稳定性和可靠性，避免因并发访问导致的错误响应，提升了用户体验和数据传输准确性。

  • Related PR: #3258
    Contributor: @johnlanni
    Change Log: 修复了MCP服务器版本协商的问题，使其符合规范。调整了依赖库的版本。
    Feature Value: 确保MCP服务器按照预期与规范兼容，提高了系统的稳定性和可靠性，减少了潜在的通信错误。

  • Related PR: #3257
    Contributor: @sjtuzbk
    Change Log: 该PR修复了ai-proxy插件直接把host重写为difyApiUrl的问题，通过引入net/url包来正确解析和提取hostname。
    Feature Value: 修复此bug确保了当配置difyApiUrl时，能够准确地仅替换目标主机名而不是整个URL，提升了系统稳定性和用户体验。

  • Related PR: #3252
    Contributor: @rinfx
    Change Log: 此PR调整了debug日志信息，并引入了错误响应的惩罚机制，确保在遇到错误响应时不会过快地尝试重新选择服务。
    Feature Value: 通过增加对错误响应的处理机制，有效避免了因快速重试导致的服务选择干扰问题，提升了系统的稳定性和用户体验。

  • Related PR: #3251
    Contributor: @rinfx
    Change Log: 本PR针对从配置中通过jsonpath提取出的内容为空时的情况进行了特殊处理，使用预定义的字符串[empty content]来替代原本空的内容。
    Feature Value: 这项改动确保了在待检测内容为空的情况下系统仍能正常运行，避免了因为空内容而导致的潜在问题或错误，提升了系统的稳定性和用户体验。

  • Related PR: #3237
    Contributor: @CH3CHO
    Change Log: 此PR通过增加model-router处理multipart数据时请求体缓冲区大小，解决了在处理大文件上传或其他大体积multipart数据时可能出现的缓冲区过小问题。
    Feature Value: 提高了系统处理大型multipart数据的能力，减少了因缓冲区不足导致的数据丢失或处理失败情况，提升了用户体验和系统的健壮性。

  • Related PR: #3225
    Contributor: @wydream
    Change Log: 修复了当设置为protocol: original时，basePathHandling: removePrefix配置不正确工作的问题。通过修改多个提供商的TransformRequestHeaders实现来避免覆盖basePath处理。
    Feature Value: 确保在使用protocol: original时，basePathHandling功能正常运行，提高了包括Azure, OpenAI在内的27+提供商的一致性和可靠性。

  • Related PR: #3220
    Contributor: @Aias00
    Change Log: 此PR修复了两个问题：一是跳过Nacos中不健康或禁用的服务实例，二是确保AllowTools字段在序列化时始终被包含。
    Feature Value: 通过过滤不健康或未启用的服务实例，提高了系统的稳定性和可靠性；同时，保证了配置的一致性，避免因字段缺失导致的潜在问题。

  • Related PR: #3211
    Contributor: @CH3CHO
    Change Log: 此PR修复了ai-proxy插件中旧的HasRequestBody逻辑问题，确保在特定条件下能够正确判断请求是否包含有效主体。
    Feature Value: 通过更新逻辑，提高了请求处理的准确性和稳定性，避免因错误判断导致的功能异常，提升了用户体验。

  • Related PR: #3187
    Contributor: @CH3CHO
    Change Log: 该PR绕过了MCP可流式传输的响应体处理，以允许进度通知，解决了在处理特定类型数据时可能出现的问题。
    Feature Value: 通过绕过不必要的响应体处理步骤，此修复增强了系统的灵活性和用户体验，特别是在需要实时更新状态的应用场景中。

  • Related PR: #3168
    Contributor: @wydream
    Change Log: 修复了OpenAI能力重写过程中丢弃查询字符串的问题，通过在执行正则匹配前剥离并保存查询参数，在匹配后重新附加这些参数。
    Feature Value: 确保了带有查询字符串的API请求能够正确解析和处理，提升了系统对复杂路径的支持度，改善了用户体验。

  • Related PR: #3167
    Contributor: @EndlessSeeker
    Change Log: 该PR更新了多个子模块的版本，并简化了Makefile中关于子模块初始化和更新的命令，以确保子模块能够正确地被拉取。
    Feature Value: 通过更新子模块并优化相关脚本，提高了项目的构建过程效率，减少了潜在的构建错误，提升了开发者的使用体验。

  • Related PR: #3148
    Contributor: @rinfx
    Change Log: 移除了toolcall结构体中index字段的omitempty标签，确保当响应中没有提供index时，默认值为0。
    Feature Value: 修复了响应中缺少toolcall索引的问题，保证了数据的一致性和完整性，提升了系统的稳定性和用户体验。

  • Related PR: #3022
    Contributor: @lwpk110
    Change Log: 此PR修复了helm和podmonitor配置中的问题，通过添加podMonitorSelector选项支持gateway.metrics.labels，确保与kube-prometheus-stack的兼容性。
    Feature Value: 增强了监控系统的自动发现能力，使得用户能够更灵活地配置和监控网关指标，提升了系统的可维护性和用户体验。

♻️ 重构优化 (Refactoring)

  • Related PR: #3462
    Contributor: @johnlanni
    Change Log: 移除了Claude Code模式下的自动Bash工具注入功能，包括相关常量、逻辑代码及测试用例，并更新了中英文文档。
    Feature Value: 通过去除不必要的自动Bash工具注入，简化了代码库并提升了系统性能，同时保持了核心功能的完整性和可用性。

  • Related PR: #3457
    Contributor: @johnlanni
    Change Log: 此PR主要更新了版本号至2.2.0，并调整了一些子模块的分支指向，同时修改了Makefile中的ENVOY_PACKAGE_URL_PATTERN变量值。
    Feature Value: 通过更新版本号和相关配置，确保项目与最新依赖库保持一致，从而避免因版本不匹配导致的潜在构建错误。

  • Related PR: #3155
    Contributor: @github-actions[bot]
    Change Log: 此PR更新了helm文件夹中的CRD文件，增加了关于routeType的枚举配置。
    Feature Value: 通过更新CRD文件增加新的枚举配置选项，提升了应用定义的灵活性和可维护性，使得用户能够更方便地进行资源管理和定制。

📚 文档更新 (Documentation)

  • Related PR: #3461
    Contributor: @johnlanni
    Change Log: 在文档中添加了Claude Code (OAuth模式)的配置指南，包括获得OAuth令牌的方法，以及如何将其作为Higress AI网关中的一个选项。
    Feature Value: 该更新帮助用户了解并设置新的Claude Code OAuth模式，简化了与AI Gateway集成的过程，使更多开发者能够轻松使用这项服务。

  • Related PR: #3449
    Contributor: @github-actions[bot]
    Change Log: 此PR为版本2.1.10添加了英文和中文的发布说明，详细记录了该版本中包含的所有更新类型及其数量。
    Feature Value: 提供详尽的版本更新信息有助于用户更好地了解新版本改进之处，包括新增功能、Bug修复等，便于用户评估升级必要性。

  • Related PR: #3442
    Contributor: @johnlanni
    Change Log: 该PR移除了文档中对IMAGE_REPO环境变量的引用，现在仅需配置PLUGIN_REGISTRY，简化了用户部署流程。
    Feature Value: 通过减少一个不必要的环境变量配置项，提高了文档清晰度和用户体验，使得项目设置更加直观简单。

  • Related PR: #3441
    Contributor: @johnlanni
    Change Log: 更新了技能文档，以反映基于时区自动选择容器镜像和WASM插件最优注册表的新行为。
    Feature Value: 通过改进文档来指导用户如何利用新实现的自动化功能，简化了用户的操作流程并提高了体验。

  • Related PR: #3440
    Contributor: @johnlanni
    Change Log: 增加了针对Higress AI Gateway API服务器部署时遇到的常见错误（如“too many open files”）的故障排除指南。
    Feature Value: 通过提供详细的故障排查信息，帮助用户更快速地识别和解决因系统配置不当导致的服务启动失败问题，提升用户体验。

  • Related PR: #3439
    Contributor: @johnlanni
    Change Log: 此PR在higress-clawdbot-integration SKILL文档中添加了关于选择地理位置更近的容器镜像仓库指南，包括新增图像仓库选择部分、环境变量表以及示例。
    Feature Value: 通过提供针对不同地区的镜像仓库选择指导，用户可以更快地部署应用并提高数据访问速度与稳定性，从而提升用户体验。

  • Related PR: #3433
    Contributor: @johnlanni
    Change Log: 优化了higress-auto-router技能文档，增加了YAML前言，将触发条件移至前言描述中，并去除了冗余部分，提高了文档的清晰度和简洁性。
    Feature Value: 通过遵循Clawdbot的最佳实践标准，改进了技能文档的质量，使用户能够更方便地理解和使用higress-auto-router功能。

  • Related PR: #3432
    Contributor: @johnlanni
    Change Log: 优化了higress-clawdbot-integration技能文档，使其遵循Clawdbot的最佳实践。包括添加了正确的YAML前导信息、移动触发条件到前导信息的描述中、移除冗余部分并提高了清晰度。
    Feature Value: 改进后的文档增强了可读性和易用性，使用户更容易理解和使用Higress AI Gateway与Clawdbot集成的功能，从而提升用户体验。

  • Related PR: #3431
    Contributor: @johnlanni
    Change Log: 更新了higress-clawdbot-integration/SKILL.md文档，添加了关于新config子命令（支持热重载）的说明部分。
    Feature Value: 通过引入新的配置管理命令，用户现在可以更方便地管理和更新API密钥，并且更改会实时生效，提升了使用的灵活性和便捷性。

  • Related PR: #3418
    Contributor: @johnlanni
    Change Log: 优化了nginx-to-higress-migration技能的README文档，新增英文版本，并将原有的中文版移至单独文件，同时添加语言切换链接。
    Feature Value: 改进后的文档结构清晰，支持多语言选择，提升了用户理解和使用迁移工具的能力，特别是对于非中文用户更为友好。

  • Related PR: #3416
    Contributor: @johnlanni
    Change Log: 本PR为从Nginx Ingress迁移至Higress网关增加了详细的实践指南，包括配置示例、迁移策略及常见问题解答等内容。
    Feature Value: 此文档更新极大地方便了计划将Nginx迁移到Higress的用户，通过提供具体的步骤和案例分析简化了迁移过程，减少了潜在的技术障碍。

  • Related PR: #3405
    Contributor: @johnlanni
    Change Log: 更新了README.md文档，修正了技能名称和描述中的错误引用，确保所有提及改为Clawdbot及相关术语。
    Feature Value: 提高了文档的准确性，避免用户误解该技能仅支持Claude模型，正确指导用户如何使用Clawdbot触发技能。

  • Related PR: #3250
    Contributor: @firebook
    Change Log: 此PR更新了ADOPTERS.md文件中关于vipshop使用情况的描述，确保了文档内容的准确性和时效性。
    Feature Value: 通过更新相关项目采用者的实际使用案例，有助于增强社区对项目的信任度，并为潜在用户提供参考，展示了Higress在实际场景中的应用价值。

  • Related PR: #3249
    Contributor: @zzjin
    Change Log: 此PR在ADOPTERS.md文件中添加了labring作为Higress项目的采用者之一。
    Feature Value: 通过更新ADOPTERS.md，社区能够更好地了解哪些组织正在使用Higress项目，从而增强项目的可信度和影响力。

  • Related PR: #3244
    Contributor: @maplecap
    Change Log: 此PR在ADOPTERS.md文件中添加了快手作为Higress项目的采用者，更新了项目采用者的列表。
    Feature Value: 通过展示更多的企业用户采用情况，增强了社区对Higress项目的信心，并为潜在用户提供参考案例，促进了项目的推广。

  • Related PR: #3241
    Contributor: @qshuai
    Change Log: 该PR从ai-token-ratelimit插件的中英文文档中移除了一个未知配置项<show_limit_quota_header>，确保了文档与实际功能的一致性。
    Feature Value: 修正了文档中的错误信息，避免了用户因参考不准确的配置而遇到问题，提升了文档的整体质量与可靠性。

  • Related PR: #3234
    Contributor: @firebook
    Change Log: 该PR在ADOPTERS.md文件中添加了vipshop作为Higress项目的用户。变更仅涉及文档更新，没有代码变动。
    Feature Value: 通过将vipshop列入项目采纳者名单，增加了项目的可信度和吸引力，有助于其他潜在用户了解Higress的广泛应用情况。

  • Related PR: #3233
    Contributor: @CH3CHO
    Change Log: 此PR在ADOPTERS.md文件中添加了Trip.com作为Higress项目的新采纳者，同时对列表进行了更新。
    Feature Value: 通过将Trip.com列为项目的采纳者之一，增强了社区的信任度和项目的知名度，有助于吸引更多用户关注并尝试使用Higress。

  • Related PR: #3231
    Contributor: @johnlanni
    Change Log: 此PR添加了一个ADOPTERS.md文件，用于记录项目采用者，帮助社区成员了解Higress的实际应用情况。
    Feature Value: 通过列出项目的采用者，增强了社区的透明度和信任度，有助于新用户理解项目在实际场景中的应用价值。

  • Related PR: #3129
    Contributor: @github-actions[bot]
    Change Log: 此PR添加了2.1.9版本的发布说明，包括英文和中文版本。详细介绍了该版本中的所有更新内容。
    Feature Value: 为用户提供清晰详尽的新版本更新概览，便于用户了解新功能、修复的bug及其他改进，增强了用户体验。

🧪 测试改进 (Testing)

  • Related PR: #3230
    Contributor: @007gzs
    Change Log: 增加了rule matcher的部分匹配单元测试，并修复了wrapper-say-hello示例中获取配置的bug。
    Feature Value: 通过增加单元测试提高了代码质量与稳定性，同时解决了配置获取的问题，提升了用户体验。

📊 发布统计

  • 🚀 新功能: 48项
  • 🐛 Bug修复: 20项
  • ♻️ 重构优化: 3项
  • 📚 文档更新: 20项
  • 🧪 测试改进: 1项

总计: 92项更改

感谢所有贡献者的辛勤付出！🎉

Higress Console

📋 本次发布概览

本次发布包含 18 项更新，涵盖了功能增强、Bug修复、性能优化等多个方面。

更新内容分布

  • 新功能: 7项
  • Bug修复: 10项
  • 文档更新: 1项

📝 完整变更日志

🚀 新功能 (Features)

  • Related PR: #621
    Contributor: @Thomas-Eliot
    Change Log: 此PR优化了mcp server的交互能力，包括重写header host、支持选择transport方式并替换path为完整路径，以及更新dsn字符处理逻辑以支持特殊字符@。
    Feature Value: 这些改进提升了用户在配置和服务使用上的体验，特别是对于需要直接路由到mcp server或从DB连接至mcp服务的情况，简化了设置流程，减少了因配置错误导致的问题。

  • Related PR: #612
    Contributor: @zhwaaaaaa
    Change Log: 此PR添加了对hop-to-hop头的支持，特别是忽略了transfer-encoding: chunked头部，以解决Grafana页面无法正常工作的问题。
    Feature Value: 通过忽略特定的hop-to-hop头部，确保了Grafana页面在反向代理服务器后的正常运行，提升了用户体验和系统的兼容性。

  • Related PR: #608
    Contributor: @Libres-coder
    Change Log: 该PR为AI路由管理页面添加了显示已启用插件的功能，使用户能够查看和管理AI路由中的插件。
    Feature Value: 此功能使得AI路由管理和常规路由管理一致，提高了用户体验，便于用户在AI路由配置中直观地看到哪些插件处于激活状态。

  • Related PR: #604
    Contributor: @CH3CHO
    Change Log: 此PR通过添加higress.io/rewrite-target注解支持使用正则表达式进行路径重写，增强了路径处理的灵活性。
    Feature Value: 引入了基于正则表达式的路径重写功能，使用户能够更灵活地配置请求路径转换规则，满足更复杂的应用场景需求。

  • Related PR: #603
    Contributor: @CH3CHO
    Change Log: 该PR在前端组件中添加了一个静态服务端口80的显示逻辑，通过定义常量STATIC_SERVICE_PORT并在适当位置引用它实现。
    Feature Value: 此功能允许用户明确看到静态服务源使用的服务端口为80，增强了界面的信息透明度和用户体验。

  • Related PR: #602
    Contributor: @CH3CHO
    Change Log: 此PR在前端页面上添加了对AI路由上游服务选择时的搜索支持，通过在服务列表中引入搜索栏来提高用户操作效率。
    Feature Value: 为用户提供更便捷的服务配置体验，特别是在面对大量可选服务时，能够快速定位所需服务，极大提升了工作效率和用户体验。

  • Related PR: #566
    Contributor: @OuterCyrex
    Change Log: 本PR通过添加QwenLlmProviderHandler类及相关配置支持自定义Qwen服务，扩展了系统的功能。包括启用了互联网搜索、文件ID上传等功能。
    Feature Value: 新增的自定义Qwen服务支持为用户提供更灵活的服务配置选项，特别是对于需要自定义设置或特定功能的用户来说非常有用，提升了用户体验和系统灵活性。

🐛 Bug修复 (Bug Fixes)

  • Related PR: #620
    Contributor: @CH3CHO
    Change Log: 修正了sortWasmPluginMatchRules逻辑中的拼写错误，确保了规则排序功能的准确性。
    Feature Value: 修复拼写错误有助于提高系统的稳定性和用户体验，避免因简单的打字错误导致的潜在问题。

  • Related PR: #619
    Contributor: @CH3CHO
    Change Log: 此PR在将AiRoute转换为ConfigMap时移除了数据JSON中的版本信息，因为该信息已保存在ConfigMap的元数据中。
    Feature Value: 通过移除重复的版本信息，简化了ConfigMap的数据结构，避免了冗余，并确保了数据的一致性和准确性。

  • Related PR: #618
    Contributor: @CH3CHO
    Change Log: 此PR重构了SystemController中的API认证逻辑，通过移除安全漏洞提升了系统的安全性。修改集中在几个控制器文件上，包括新增AllowAnonymous注解。
    Feature Value: 修复了一个潜在的安全问题，增强了系统的安全性，防止未经授权的访问，从而保护用户数据和应用免受攻击。

  • Related PR: #617
    Contributor: @CH3CHO
    Change Log: 修正了前端控制台中的一些错误，包括列表元素缺少唯一key属性、违反内容安全策略的图片加载问题以及Consumer.name字段类型错误。
    Feature Value: 通过解决这些问题，提高了应用的稳定性和安全性，改善了用户体验，并确保了数据类型的正确性。

  • Related PR: #614
    Contributor: @lc0138
    Change Log: 此PR修复了ServiceSource类型字段的错误，通过添加字典值校验来确保type字段的正确性。
    Feature Value: 该修复提高了系统的稳定性和数据准确性，防止因不正确的服务来源类型导致的问题，提升了用户体验。

  • Related PR: #613
    Contributor: @lc0138
    Change Log: 此PR通过修改前端document.tsx文件，解决了编号#594的安全漏洞问题，具体涉及CSP（内容安全策略）配置的调整以增强应用安全性。
    Feature Value: 修复了前端存在的CSP及其他安全风险，提升了系统的整体安全性，保护用户免受潜在的安全威胁如XSS攻击等，增强了用户体验和数据保护。

  • Related PR: #611
    Contributor: @qshuai
    Change Log: 此PR修正了LlmProvidersController.java中的一个拼写错误，将API接口的描述从'Add a new route'更正为'Add a new LlmProvider'。
    Feature Value: 修正文档中的拼写错误提高了代码的可读性和准确性，确保开发人员在使用API时不会因误导性信息而产生混淆。

  • Related PR: #609
    Contributor: @CH3CHO
    Change Log: 修复了Consumer接口中name字段类型错误的问题，将布尔类型更改为字符串类型。
    Feature Value: 确保了Consumer.name字段的数据类型正确性，避免了因类型不匹配导致的潜在错误，提升了系统的稳定性和数据准确性。

  • Related PR: #605
    Contributor: @SaladDay
    Change Log: 修正了AI路由名称验证规则，使其支持点号并只允许小写字母。同时更新了中英文错误提示信息以准确描述新的验证规则。
    Feature Value: 解决了界面提示与实际验证逻辑不一致的问题，提升了用户在配置AI路由时的体验和准确性，减少了因验证规则不一致导致的混淆。

  • Related PR: #552
    Contributor: @lcfang
    Change Log: 为了解决服务后端端口不一致导致的兼容性问题，新增了vport属性。通过在配置注册中心时选择性配置vport，默认端口或指定服务虚拟端口来确保路由配置的有效性。
    Feature Value: 此修复提升了系统对不同服务实例端口变化情况下的适应能力，增强了系统的稳定性和用户体验。对于使用eureka、nacos等注册中心的用户来说，能够避免因端口更改而导致的服务中断问题，提高了服务可用性和一致性。

📚 文档更新 (Documentation)

  • Related PR: #610
    Contributor: @heimanba
    Change Log: 此PR主要调整了前端灰度插件文档中的多个配置字段说明，包括将rewrite等字段设为非必填，并更新了rules中name字段的关联规则，同时修正了一些术语和描述确保一致性。
    Feature Value: 通过这些文档更新，提升了用户理解和使用前端灰度插件时的灵活性与兼容性，使开发者能够更准确地根据需求配置服务，减少了由于配置不明确导致的错误。

📊 发布统计

  • 🚀 新功能: 7项
  • 🐛 Bug修复: 10项
  • 📚 文档更新: 1项

总计: 18项更改

感谢所有贡献者的辛勤付出！🎉

Reference in New Issue View Git Blame Copy Permalink