Files
higress/release-notes/2.1.9-rc.1/README_ZH.md
2025-10-09 09:42:29 +00:00

10 KiB
Raw Blame History

Higress

📋 本次发布概览

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

更新内容分布

  • 新功能: 3项
  • Bug修复: 5项
  • 重构优化: 1项
  • 文档更新: 2项

📝 完整变更日志

🚀 新功能 (Features)

  • Related PR: #2978
    Contributor: @rinfx
    Change Log: 在key-auth插件中无论认证是否通过在确定消费者名称后都会记录下来。这通过向HTTP请求头添加X-Mse-Consumer字段来实现。
    Feature Value: 该功能允许系统更早地获取并记录消费者的名称,这对于日志记录和后续处理非常重要,可以提高系统的可追踪性和透明度。

  • Related PR: #2968
    Contributor: @2456868764
    Change Log: 此PR引入了矢量数据库的映射核心功能包括字段映射系统和索引配置管理支持多种索引类型。
    Feature Value: 通过提供灵活的字段映射和索引配置能力,使得用户能够更方便地与不同数据库架构进行集成,提升了系统的兼容性和灵活性。

  • Related PR: #2943
    Contributor: @Guo-Chenxu
    Change Log: 增加了自定义系统提示的功能让用户在生成发布笔记时能添加个性化说明。通过修改GitHub Actions工作流文件实现。
    Feature Value: 此功能允许用户在生成发布笔记时加入自定义的系统提示,增强了发布笔记的灵活性与信息丰富度,提升了用户体验。

🐛 Bug修复 (Bug Fixes)

  • Related PR: #2973
    Contributor: @CH3CHO
    Change Log: 此PR修复了Higress 2.1.8版本中mcp-session过滤器不支持将match_rule_domain设置为空字符串的问题,通过使用通配符来匹配所有域以消除兼容性风险。
    Feature Value: 解决了因特定配置导致的兼容性问题,确保用户在升级或配置过程中不会遇到由空字符串设置引起的错误,提升了系统的稳定性和用户体验。

  • Related PR: #2952
    Contributor: @Erica177
    Change Log: 修正了ToolSecurity结构体中Id字段的JSON标签从type改为id确保数据序列化时正确映射。
    Feature Value: 此修复解决了因字段映射错误导致的数据不一致问题,提高了系统的稳定性和数据准确性。

  • Related PR: #2948
    Contributor: @johnlanni
    Change Log: 修复了Azure服务URL类型检测逻辑支持自定义完整路径。增强了Azure OpenAI响应API处理能力并改进了流式事件解析中的边缘情况。
    Feature Value: 确保了与Azure OpenAI服务的兼容性更强提升了错误处理能力和用户体验特别是在使用非标准路径或流式响应时。

  • Related PR: #2942
    Contributor: @2456868764
    Change Log: 修复了LLM提供者为空的问题并优化了文档和提示信息。具体包括更新README.md以改进说明调整LLM默认模型。
    Feature Value: 通过增强LLM提供者的初始化健壮性并优化相关文档提高了系统的稳定性和用户体验使用户能更清晰地了解系统配置和使用方法。

  • Related PR: #2941
    Contributor: @rinfx
    Change Log: 此PR修复了与旧配置兼容性的问题确保系统能够正确处理过时的配置参数避免因配置变更导致的潜在错误。
    Feature Value: 通过支持旧版本配置,增强了系统的向后兼容能力,减少了因升级或配置调整给用户带来的不便,提升了用户体验。

♻️ 重构优化 (Refactoring)

  • Related PR: #2945
    Contributor: @rinfx
    Change Log: 优化全局最小请求数选pod的逻辑更新了ai-load-balancer相关的Lua脚本代码减少了不必要的检查和提高了性能。
    Feature Value: 通过改进负载均衡策略中的最小请求数算法,提升了系统的响应速度与资源分配效率,使用户可以更高效地利用集群资源。

📚 文档更新 (Documentation)

  • Related PR: #2965
    Contributor: @CH3CHO
    Change Log: 更新了ai-proxy插件README文件中azureServiceUrl字段的描述以提供更清晰准确的信息。
    Feature Value: 通过改进文档中的描述使得用户能够更好地理解如何配置Azure OpenAI服务URL从而提高使用体验和配置准确性。

  • Related PR: #2940
    Contributor: @github-actions[bot]
    Change Log: 此PR为2.1.8版本添加了英文和中文的发布说明文档详细记录了该版本中的30项更新。
    Feature Value: 通过提供详细的发布笔记用户能够更容易地理解新版本中包含的功能改进、Bug修复等信息从而更好地利用新特性。


📊 发布统计

  • 🚀 新功能: 3项
  • 🐛 Bug修复: 5项
  • ♻️ 重构优化: 1项
  • 📚 文档更新: 2项

总计: 11项更改

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

Higress Console

📋 本次发布概览

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

更新内容分布

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

重点关注

本次发布包含 1 项重要更新,建议重点关注:

  • feat: Support using a known service in OpenAI LLM provider (#589): 此功能允许用户在OpenAI LLM中使用预定义的服务从而提高开发效率与灵活性满足更广泛的应用场景需求。

详细信息请查看下方重要功能详述部分。


🌟 重要功能详述

以下是本次发布中的重要功能和改进的详细说明:

1. feat: Support using a known service in OpenAI LLM provider

相关PR: #589 | 贡献者: @CH3CHO

使用背景

随着越来越多的组织和服务开始采用大型语言模型LLM对这些模型的访问和管理变得尤为重要。特别是在需要与特定已知服务进行集成的情况下例如内部部署的OpenAI API服务器或自定义的API端点。此功能解决了在Higress系统中直接支持自定义OpenAI服务的需求使用户能够更灵活地配置和使用他们的服务。目标用户群体包括但不限于开发者、运维人员以及需要高度定制化解决方案的企业。

功能详述

此次更新主要集中在OpenaiLlmProviderHandler类中,引入了自定义服务源的支持。通过添加新的配置项如openaiCustomServiceNameopenaiCustomServicePort用户现在可以直接指定其自定义OpenAI服务的详细信息。此外代码还改进了处理逻辑如果指定了自定义上游服务则不会为默认服务创建服务源。这种设计不仅简化了配置流程也提高了系统的可扩展性。技术上这是通过重写buildServiceSourcebuildUpstreamService方法来实现的,其中包含了对用户自定义设置的检查。

使用方式

要启用并配置此新功能用户首先需要在其OpenAI LLM提供商设置中提供必要的自定义服务信息。这通常涉及到填写诸如自定义服务名称、主机地址及端口号等字段。具体步骤通常是1. 在Higress控制台或对应的配置文件中找到相关LLM提供者的设置部分2. 根据提示填入相应的自定义服务详情3. 保存更改。一个典型的应用场景可能是公司希望使用自己内部托管的OpenAI接口而不是官方提供的公共接口。需要注意的是确保所提供的自定义服务地址是准确无误的并且网络可达非常重要。

功能价值

这项功能极大地丰富了Higress平台对于不同环境下的适应能力特别是对于那些需要高度定制化的应用场景来说尤为关键。它不仅提升了用户体验——让配置过程变得更加直观简单同时也促进了整体系统的稳定性和安全性因为现在可以直接利用受信任的内部资源。从长远来看这样的增强有助于构建更加健壮的生态系统鼓励更多创新性的应用开发。


📝 完整变更日志

🐛 Bug修复 (Bug Fixes)

  • Related PR: #591
    Contributor: @CH3CHO
    Change Log: 修复了启用路由重写时未正确验证必填字段的问题,确保hostnewPath.path在启用状态下都必须提供有效值。
    Feature Value: 此修复提高了系统配置的准确性与健壮性,防止因配置不完整导致的功能异常,提升了用户体验。

  • Related PR: #590
    Contributor: @CH3CHO
    Change Log: 修复了Route.customLabels处理逻辑中的错误确保内置标签在更新时能够被正确排除。
    Feature Value: 解决了用户在更新Route时自定义标签与内置标签冲突的问题提升了系统的稳定性和用户体验。

📚 文档更新 (Documentation)

  • Related PR: #595
    Contributor: @CH3CHO
    Change Log: 此PR更新了README.md文件移除了非项目级别的描述并添加了代码格式指南。
    Feature Value: 通过清理无关信息并提供格式化建议,帮助开发者更清晰地理解项目文档,促进了代码贡献的一致性和可读性。

📊 发布统计

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

总计: 4项更改包含1项重要更新

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