From 3bf39b60ea9247a75e4a15ae58e9733567a67b2e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 12 Feb 2026 14:02:50 +0800 Subject: [PATCH] Add release notes (#3468) Co-authored-by: johnlanni <6763318+johnlanni@users.noreply.github.com> --- release-notes/2.2.0/README.md | 501 +++++++++++++++++++++++++++++ release-notes/2.2.0/README_ZH.md | 531 +++++++++++++++++++++++++++++++ 2 files changed, 1032 insertions(+) create mode 100644 release-notes/2.2.0/README.md create mode 100644 release-notes/2.2.0/README_ZH.md diff --git a/release-notes/2.2.0/README.md b/release-notes/2.2.0/README.md new file mode 100644 index 000000000..059d839c6 --- /dev/null +++ b/release-notes/2.2.0/README.md @@ -0,0 +1,501 @@ +# Higress + + +## 📋 Overview of This Release + +This release includes **73** updates, covering enhancements, bug fixes, performance optimizations, and more. + +### Update Distribution + +- **New Features**: 48 +- **Bug Fixes**: 20 +- **Refactoring and Optimization**: 3 +- **Documentation Updates**: 2 + +--- + +## 📝 Complete Changelog + +### 🚀 New Features (Features) + +- **Related PR**: [#3459](https://github.com/alibaba/higress/pull/3459) \ + **Contributor**: @johnlanni \ + **Change Log**: Added support for Claude Code mode, allowing authentication with OAuth tokens and mimicking the request format of the Claude CLI. \ + **Feature Value**: This feature expands the ability to interact with the Anthropic Claude API, enabling users to utilize more customized configuration options to meet specific needs. + +- **Related PR**: [#3455](https://github.com/alibaba/higress/pull/3455) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: This PR updated the project's submodules, including upgrading Envoy and go-control-plane versions, and updating Istio to use the latest version of go-control-plane. \ + **Feature Value**: By synchronizing with the latest key dependency libraries, it enhances system compatibility and stability, helping users receive better service and support. + +- **Related PR**: [#3438](https://github.com/alibaba/higress/pull/3438) \ + **Contributor**: @johnlanni \ + **Change Log**: Improved the documentation structure of the higress-clawdbot-integration skill, streamlined and merged duplicate content, and achieved full compatibility with the Clawdbot plugin. \ + **Feature Value**: By optimizing the documentation structure and ensuring the compatibility of the Clawdbot plugin, it enhances the user experience, simplifies the configuration process, and allows users to integrate and configure the gateway more quickly and conveniently. + +- **Related PR**: [#3437](https://github.com/alibaba/higress/pull/3437) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR integrated the `higress-ai-gateway` plugin into the `higress-clawdbot-integration` skill, simplifying the installation and configuration process by migrating and bundling related files. \ + **Feature Value**: This feature enables users to more easily install and configure Higress AI Gateway with Clawbot/OpenClaw, enhancing user experience and software usability. + +- **Related PR**: [#3436](https://github.com/alibaba/higress/pull/3436) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR updated the list of service providers in the Higress-OpenClaw integration and moved the OpenClaw plugin package from higress-standalone to the main repository. \ + **Feature Value**: By enhancing the list of service providers and integrating the plugin package, users can more easily configure and use Higress AI Gateway, improving the user experience and system flexibility. + +- **Related PR**: [#3428](https://github.com/alibaba/higress/pull/3428) \ + **Contributor**: @johnlanni \ + **Change Log**: Added two new skills, higress-auto-router and higress-clawdbot-integration, supporting natural language configuration for automatic model routing and deployment of Higress AI Gateway via CLI parameters. \ + **Feature Value**: This enhancement improves the integration capabilities of Higress AI Gateway with Clawbot, providing users with a more convenient configuration method and flexible routing strategies, thereby enhancing the user experience. + +- **Related PR**: [#3427](https://github.com/alibaba/higress/pull/3427) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the `use_default_attributes` configuration option, allowing the ai-statistics plugin to use a default attribute set, simplifying the user configuration process. This change involves significant modifications to the main logic file. \ + **Feature Value**: By introducing the functionality to automatically apply default attributes, it reduces the initial setup burden for users, making the ai-statistics plugin easier to get started with while maintaining advanced customization capabilities to meet specific needs. + +- **Related PR**: [#3426](https://github.com/alibaba/higress/pull/3426) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the Agent Session Monitor skill, supporting real-time parsing of Higress access logs, tracking multi-turn conversations through `session_id`, and providing token usage analysis. \ + **Feature Value**: By monitoring the real-time usage of LLMs in the Higress environment, users can better understand and control resource consumption, optimizing the performance of the conversation system. + +- **Related PR**: [#3424](https://github.com/alibaba/higress/pull/3424) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR added support for detailed token usage information in the ai-statistics plugin, including two new built-in attribute keys: `reasoning_tokens` and `cached_tokens`. \ + **Feature Value**: By recording more detailed token usage, users can better understand and optimize resource consumption during the AI inference process, which helps improve efficiency and reduce costs. + +- **Related PR**: [#3420](https://github.com/alibaba/higress/pull/3420) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR added session ID tracking to the AI statistics plugin, supporting the retrieval of session IDs through custom headers or default headers to track multi-turn conversations. \ + **Feature Value**: The new session ID tracking capability helps users better analyze and understand the interaction of multi-turn conversations, enhancing the observability and user experience of the system. + +- **Related PR**: [#3417](https://github.com/alibaba/higress/pull/3417) \ + **Contributor**: @johnlanni \ + **Change Log**: Added an important warning about unsupported fragments and provided pre-migration check commands to help users identify affected Ingress resources. \ + **Feature Value**: By providing critical warnings and guidelines, this feature significantly reduces potential issues during migration, improving the user experience and migration success rate. + +- **Related PR**: [#3411](https://github.com/alibaba/higress/pull/3411) \ + **Contributor**: @johnlanni \ + **Change Log**: Added a skill for migrating from ingress-nginx to Higress, including analyzing existing Nginx Ingress resources, generating migration test scripts, and creating Wasm plugin frameworks for unsupported features. \ + **Feature Value**: This feature helps users smoothly migrate their Kubernetes environments from ingress-nginx to Higress, providing detailed migration guides and tools to reduce migration burdens and enhance the user experience. + +- **Related PR**: [#3409](https://github.com/alibaba/higress/pull/3409) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the `contextCleanupCommands` configuration option, allowing users to define commands to clean up the conversation context. When a user message exactly matches the configured cleanup command, all non-system messages before that command will be cleared. \ + **Feature Value**: This feature enables users to actively manage their conversation history by sending predefined commands to clear irrelevant or outdated messages, thus improving the quality and relevance of the conversation. + +- **Related PR**: [#3404](https://github.com/alibaba/higress/pull/3404) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the Higress community governance daily report generation skill, which can automatically track project GitHub activity and generate structured reports. \ + **Feature Value**: This feature helps users better track and manage the daily progress and issue resolution of the project, enhancing community engagement and issue resolution efficiency. + +- **Related PR**: [#3403](https://github.com/alibaba/higress/pull/3403) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR added an automatic routing feature based on the content of user messages to the model-router plugin. It uses regular expressions to match user input and decide which model to use. \ + **Feature Value**: This feature allows the selection of the most appropriate processing model based on the message content, greatly enhancing the user experience and system flexibility, making the service more intelligent and efficient. + +- **Related PR**: [#3402](https://github.com/alibaba/higress/pull/3402) \ + **Contributor**: @johnlanni \ + **Change Log**: Added a Claude skill for developing Higress WASM plugins using Go 1.24+, covering reference documents for HTTP client, Redis client, and local testing. \ + **Feature Value**: This feature provides a comprehensive guide for developers to create and debug Higress gateway plugins, significantly improving work efficiency and plugin quality. + +- **Related PR**: [#3394](https://github.com/alibaba/higress/pull/3394) \ + **Contributor**: @changsci \ + **Change Log**: When `provider.apiTokens` is not configured, support retrieving the API key from the request header. The changes mainly involve importing `proxywasm` in `openai.go` and adding related configuration logic in `provider.go`. \ + **Feature Value**: This feature enhances system flexibility, allowing users to pass the API key through the request header, thus enabling normal service use even when `provider.apiTokens` is not configured, improving the user experience and security. + +- **Related PR**: [#3384](https://github.com/alibaba/higress/pull/3384) \ + **Contributor**: @ThxCode-Chen \ + **Change Log**: This PR enhanced the system's ability to handle IPv6 addresses by adding support for static IPv6 addresses in the `watcher.go` file. Specifically, it introduced new logic in the `generateServiceEntry` function to recognize and handle static IPv6 addresses. \ + **Feature Value**: The added support for static IPv6 addresses allows users to use IPv6 addresses in their network configurations, enhancing the system's network flexibility and compatibility, and providing convenience for users who need to deploy in an IPv6 environment. + +- **Related PR**: [#3375](https://github.com/alibaba/higress/pull/3375) \ + **Contributor**: @wydream \ + **Change Log**: This PR added Vertex Raw mode support to the Vertex AI Provider of the ai-proxy plugin, enabling the `getAccessToken` mechanism when accessing native REST APIs via Vertex. \ + **Feature Value**: The added Vertex Raw mode support enhances the user's ability to directly invoke Vertex AI hosted models and ensures automatic OAuth authentication when using native API paths, improving the user experience. + +- **Related PR**: [#3367](https://github.com/alibaba/higress/pull/3367) \ + **Contributor**: @rinfx \ + **Change Log**: This PR updated the wasm-go dependency, introducing Foreign Function to enable Wasm plugins to perceive the log level of the Envoy host in real-time and optimizing the log handling process to improve performance. \ + **Feature Value**: This feature enhances system runtime efficiency, especially under high load, by reducing unnecessary memory allocation and copying operations, resulting in lower resource consumption and better application response speed for users. + +- **Related PR**: [#3342](https://github.com/alibaba/higress/pull/3342) \ + **Contributor**: @Aias00 \ + **Change Log**: This PR implemented the mapping of Nacos instance weights to Istio WorkloadEntry weights in watchers, ensuring more precise traffic distribution between services. \ + **Feature Value**: By mapping Nacos instance weights to Istio WorkloadEntry weights, it enhances the flexibility and accuracy of traffic management in the service mesh, allowing users to more finely control request distribution between services. + +- **Related PR**: [#3335](https://github.com/alibaba/higress/pull/3335) \ + **Contributor**: @wydream \ + **Change Log**: This PR added image generation support to the Vertex AI Provider of the ai-proxy plugin, implementing the conversion of OpenAI's image generation protocol to Vertex AI's image generation protocol. \ + **Feature Value**: Users can now call the image generation functionality of Vertex AI using the standard OpenAI SDK, enhancing the plugin's functionality and user experience. + +- **Related PR**: [#3324](https://github.com/alibaba/higress/pull/3324) \ + **Contributor**: @wydream \ + **Change Log**: This PR implemented OpenAI-compatible endpoint support in the Vertex AI Provider of the ai-proxy plugin, allowing developers to directly use the OpenAI SDK and API format to call Vertex AI models. \ + **Feature Value**: By adding OpenAI-compatible endpoint support, this feature simplifies the migration process from OpenAI to Vertex AI, making it easier for users to seamlessly integrate Vertex AI services using existing OpenAI toolchains, enhancing development efficiency and user experience. + +- **Related PR**: [#3318](https://github.com/alibaba/higress/pull/3318) \ + **Contributor**: @hanxiantao \ + **Change Log**: Applied Istio's native authentication logic to the debug endpoint using the `withConditionalAuth` middleware, while maintaining the existing behavior based on the `DebugAuth` feature flag. \ + **Feature Value**: This enhancement enhances system security by ensuring that only authenticated users can access the debug endpoint, thereby reducing potential security risks and providing a more secure service environment. + +- **Related PR**: [#3317](https://github.com/alibaba/higress/pull/3317) \ + **Contributor**: @rinfx \ + **Change Log**: Added two Wasm-Go plugins, `model-mapper` and `model-router`, supporting mapping and routing based on the `model` parameter in the LLM protocol, including prefix matching and wildcard fallback. \ + **Feature Value**: This enhancement improves Higress's ability to handle large language model requests, improving the user experience and service efficiency by more flexibly managing model names and provider information. + +- **Related PR**: [#3305](https://github.com/alibaba/higress/pull/3305) \ + **Contributor**: @CZJCC \ + **Change Log**: Added Bearer Token authentication support for the AWS Bedrock provider, retaining the original AWS Signature V4 authentication method and cleaning up some unused code. \ + **Feature Value**: This feature provides more flexible authentication options, allowing users to choose the appropriate authentication method based on their needs, thereby enhancing the system's flexibility and security. + +- **Related PR**: [#3301](https://github.com/alibaba/higress/pull/3301) \ + **Contributor**: @wydream \ + **Change Log**: This PR implemented Express Mode support for the Vertex AI Provider of the ai-proxy plugin, simplifying the authentication process and allowing users to start using an API Key quickly. \ + **Feature Value**: By adding Express Mode support, users no longer need to configure complex Service Account authentication to use Vertex AI, significantly lowering the entry barrier and enhancing the user experience. + +- **Related PR**: [#3295](https://github.com/alibaba/higress/pull/3295) \ + **Contributor**: @rinfx \ + **Change Log**: This PR added MCP support to the ai-security-guard plugin, including security checks for both standard and streaming responses. \ + **Feature Value**: By adding support for MCP API types, the plugin can now better protect data related to the model context protocol, enhancing the overall security of the system. + +- **Related PR**: [#3267](https://github.com/alibaba/higress/pull/3267) \ + **Contributor**: @erasernoob \ + **Change Log**: This PR implemented the hgctl agent module, adding new features and related services, and updating dependencies. \ + **Feature Value**: The new hgctl agent module provides users with more powerful command-line tool support, enhancing the system's operability and user experience. + +- **Related PR**: [#3261](https://github.com/alibaba/higress/pull/3261) \ + **Contributor**: @rinfx \ + **Change Log**: This PR added the ability to disable thinking for gemini-2.5-flash and its simplified version, and included reasoning token usage information in the response. \ + **Feature Value**: By adding the ability to disable thinking and providing reasoning token consumption details, users can more flexibly control the behavior of the AI proxy and better understand resource consumption. + +- **Related PR**: [#3255](https://github.com/alibaba/higress/pull/3255) \ + **Contributor**: @nixidexiangjiao \ + **Change Log**: Improved the global minimum request count load balancing strategy, fixing issues with abnormal node preference, inconsistent new node handling, and uneven sampling distribution, enhancing the stability and accuracy of the algorithm. \ + **Feature Value**: By optimizing the load balancing algorithm, it avoids concentrating traffic on faulty nodes, leading to service interruptions, and enhances system availability and reliability, reducing operational burdens. + +- **Related PR**: [#3236](https://github.com/alibaba/higress/pull/3236) \ + **Contributor**: @rinfx \ + **Change Log**: This PR implemented support for the Claude model in Vertex AI and handled cases where delta might be empty, ensuring system stability in edge cases. \ + **Feature Value**: The added support for the Claude model in Vertex AI broadens the application scenarios of the AI proxy plugin, allowing users to leverage a wider range of AI models, increasing the system's flexibility and applicability. + +- **Related PR**: [#3218](https://github.com/alibaba/higress/pull/3218) \ + **Contributor**: @johnlanni \ + **Change Log**: Enhanced the model mapper and router, adding request count monitoring and memory usage monitoring, and setting up an automatic rebuild trigger mechanism; expanded supported path suffixes. \ + **Feature Value**: By adding an automatic rebuild trigger mechanism, it enhances the stability of the service under high load or low memory conditions. The expanded path support allows more features to be correctly routed and processed, improving the system's flexibility and compatibility. + +- **Related PR**: [#3213](https://github.com/alibaba/higress/pull/3213) \ + **Contributor**: @rinfx \ + **Change Log**: This PR added support for global regions in the Vertex AI support, modifying the request domain to accommodate the latest Gemini-3 series models. \ + **Feature Value**: This enhancement improves system compatibility, allowing users to seamlessly access the latest Gemini-3 series models, enhancing the user experience and system flexibility. + +- **Related PR**: [#3206](https://github.com/alibaba/higress/pull/3206) \ + **Contributor**: @rinfx \ + **Change Log**: This PR implemented content checking for prompts and images in the request body for the AI security guard plugin, enhancing content security detection. \ + **Feature Value**: By supporting checks for prompts and images, it improves the system's security when handling image generation requests, helping to protect users from inappropriate content. + +- **Related PR**: [#3200](https://github.com/alibaba/higress/pull/3200) \ + **Contributor**: @YTGhost \ + **Change Log**: This PR added support for array-type content in the ai-proxy plugin, extending the `chatToolMessage2BedrockMessage` function's handling capabilities. \ + **Feature Value**: This enhancement improves message processing, allowing the system to correctly parse and convert array-formatted message content, enhancing the user experience and system flexibility. + +- **Related PR**: [#3185](https://github.com/alibaba/higress/pull/3185) \ + **Contributor**: @rinfx \ + **Change Log**: This PR added a rebuild logic for ai-cache, optimizing memory management to avoid high memory usage issues. The changes are mainly concentrated in `go.mod`, `go.sum`, and `main.go` files. \ + **Feature Value**: The newly added ai-cache rebuild logic effectively prevents memory overflow issues caused by caching, enhancing system stability and performance, providing a more reliable user experience. + +- **Related PR**: [#3184](https://github.com/alibaba/higress/pull/3184) \ + **Contributor**: @rinfx \ + **Change Log**: This PR added support for user-defined domain name configuration in the DouBao plugin, involving modifications to the `Makefile` and two Go files, allowing the service to communicate based on the new domain. \ + **Feature Value**: Allowing users to configure custom domain names for specific services enhances the system's flexibility and user experience, enabling users to adjust service access paths according to their needs. + +- **Related PR**: [#3175](https://github.com/alibaba/higress/pull/3175) \ + **Contributor**: @wydream \ + **Change Log**: Added a new generic provider to handle requests for unmapped paths, utilizing shared headers and `basePath` tool. Additionally, updated the README to include configuration details and introduced relevant tests. \ + **Feature Value**: By providing a vendor-agnostic generic provider, users can more flexibly handle various requests, enhancing the system's adaptability and maintainability. + +- **Related PR**: [#3173](https://github.com/alibaba/higress/pull/3173) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: This PR added a new global parameter to support inference scaling, involving updates to Helm templates and values files, enhancing system flexibility. \ + **Feature Value**: The new global parameter allows users to enable or disable the inference scaling feature, providing more configuration options to better meet the needs of different scenarios. + +- **Related PR**: [#3171](https://github.com/alibaba/higress/pull/3171) \ + **Contributor**: @wilsonwu \ + **Change Log**: This PR added topology spread constraints support for the gateway and controller, implemented through new configuration items in Helm templates. \ + **Feature Value**: This new feature allows users to define more granular Pod distribution policies, enhancing the availability and stability of services within the cluster. + +- **Related PR**: [#3160](https://github.com/alibaba/higress/pull/3160) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: This PR upgraded the gateway API to the latest version, updated related dependencies, and modified some configuration files to adapt to new features. \ + **Feature Value**: By introducing the latest gateway API features, it enhances the system's compatibility and scalability, providing users with more advanced and secure network service functions. + +- **Related PR**: [#3136](https://github.com/alibaba/higress/pull/3136) \ + **Contributor**: @Wangzy455 \ + **Change Log**: Added a tool search server based on the Milvus vector database, achieving semantic matching by converting tool descriptions into vectors. \ + **Feature Value**: Users can now find the most relevant tools through natural language queries, enhancing the user experience and simplifying the tool search process. + +- **Related PR**: [#3075](https://github.com/alibaba/higress/pull/3075) \ + **Contributor**: @rinfx \ + **Change Log**: This PR refactored the AI security guard plugin to support multimodal input detection and improved security for text and image generation scenarios. It also fixed some boundary case response anomalies. \ + **Feature Value**: By introducing multimodal input support and enhanced security detection capabilities, it improves the system's flexibility and security, providing users with more comprehensive content protection in different application scenarios. + +- **Related PR**: [#3066](https://github.com/alibaba/higress/pull/3066) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: Upgraded Istio to version 1.27.1, adjusted higress-core to adapt to the new Istio version, fixed submodule branch pull issues, and corrected integration tests. \ + **Feature Value**: This upgrade enhances system stability and compatibility, improves performance, and ensures compatibility with the latest Istio version, providing users with a better service experience. + +- **Related PR**: [#3063](https://github.com/alibaba/higress/pull/3063) \ + **Contributor**: @rinfx \ + **Change Log**: Added the ability to perform cross-cluster and endpoint load balancing based on specific metrics such as concurrency, TTFT, and RT, allowing users to more flexibly configure load balancing strategies. \ + **Feature Value**: This feature allows users to choose the appropriate backend service based on custom performance metrics, thereby improving the overall response speed and service quality of the system, enhancing the user experience. + +- **Related PR**: [#3061](https://github.com/alibaba/higress/pull/3061) \ + **Contributor**: @Jing-ze \ + **Change Log**: This PR fixed the implementation issues of the `response-cache` plugin and added comprehensive unit tests, including cache key extraction logic, interface mismatch issues, and trailing whitespace corrections in configuration validation. \ + **Feature Value**: By optimizing the response cache plugin, users can more reliably use the caching feature, improving system performance and response speed while reducing unnecessary resource consumption. + +- **Related PR**: [#2825](https://github.com/alibaba/higress/pull/2825) \ + **Contributor**: @CH3CHO \ + **Change Log**: Added the `traffic-editor` plugin, allowing users to edit requests and responses. The plugin provides multiple operation types, including deletion, renaming, and updating, and has an extensible code structure. \ + **Feature Value**: This feature enhances the flexibility and functionality of the Higress gateway, allowing users to more freely control the content of HTTP requests and responses, meeting more personalized needs and enhancing the user experience. + +### 🐛 Bug Fixes (Bug Fixes) + +- **Related PR**: [#3448](https://github.com/alibaba/higress/pull/3448) \ + **Contributor**: @lexburner \ + **Change Log**: Fixed an out-of-bounds error in the Qwen API response handling due to an empty selection array. The fix adds a null check to avoid runtime errors. \ + **Feature Value**: This enhancement improves system stability and robustness, preventing service crashes due to abnormal API responses, and enhances the user experience. + +- **Related PR**: [#3434](https://github.com/alibaba/higress/pull/3434) \ + **Contributor**: @johnlanni \ + **Change Log**: Fixed a YAML parsing error in the skill description by adding double quotes around values containing colons, ensuring they are treated as regular characters rather than YAML syntax. \ + **Feature Value**: This fix resolves rendering issues caused by special YAML characters, ensuring the skill page displays correctly and enhancing the user experience and document accuracy. + +- **Related PR**: [#3422](https://github.com/alibaba/higress/pull/3422) \ + **Contributor**: @johnlanni \ + **Change Log**: Fixed an issue in the `model-router` plugin where the `model` field in the request body was not updated in auto-routing mode. The correct logic adjustment ensures the model field accurately reflects the routing decision. \ + **Feature Value**: This fix ensures that the model name received by downstream services is the value after the correct routing decision, not the default `higress/auto`, enhancing system consistency and accuracy. + +- **Related PR**: [#3400](https://github.com/alibaba/higress/pull/3400) \ + **Contributor**: @johnlanni \ + **Change Log**: Fixed a duplicate definition of the `loadBalancerClass` field in `service.yaml` by removing the redundant definition to avoid YAML parsing errors. \ + **Feature Value**: This fix resolves YAML parsing errors caused by duplicate fields, ensuring users can configure `loadBalancerClass` without encountering issues, enhancing system stability and the user experience. + +- **Related PR**: [#3380](https://github.com/alibaba/higress/pull/3380) \ + **Contributor**: @Thomas-Eliot \ + **Change Log**: This PR added the setting of the request model context in the request handling function, ensuring that the request model data can be correctly accessed throughout the call chain. \ + **Feature Value**: This fix resolves the issue of the request model context not being set, allowing the system to correctly pass and use request model information, improving system stability and data consistency. + +- **Related PR**: [#3370](https://github.com/alibaba/higress/pull/3370) \ + **Contributor**: @rinfx \ + **Change Log**: Fixed an issue in the `model-mapper` component where the request body was still processed even if the suffix did not match, and added JSON validation for the body to ensure its validity. \ + **Feature Value**: This enhancement improves system stability and data processing accuracy, avoiding application anomalies due to invalid or incorrectly formatted request bodies, enhancing the user experience. + +- **Related PR**: [#3341](https://github.com/alibaba/higress/pull/3341) \ + **Contributor**: @zth9 \ + **Change Log**: This PR fixed an issue with concurrent SSE connections returning incorrect endpoints, by modifying the `mcp-session` plugin configuration and filter logic to ensure that SSE server instances are correctly created for each filter. \ + **Feature Value**: This fix resolves endpoint errors that may occur in concurrent SSE connection scenarios, enhancing system stability and reliability, which is a significant improvement for applications relying on SSE for real-time communication. + +- **Related PR**: [#3258](https://github.com/alibaba/higress/pull/3258) \ + **Contributor**: @johnlanni \ + **Change Log**: Fixed the MCP server version negotiation issue to comply with the specification. Updated dependencies to ensure compatibility and stability. \ + **Feature Value**: This fix enhances system stability and compatibility, ensuring that the MCP server can correctly negotiate versions with clients, improving the user experience and system reliability. + +- **Related PR**: [#3257](https://github.com/alibaba/higress/pull/3257) \ + **Contributor**: @sjtuzbk \ + **Change Log**: This PR fixed the issue in the `ai-proxy` plugin where the `host` was directly rewritten to `difyApiUrl` by using the `net/url` package to correctly extract the hostname. \ + **Feature Value**: After the fix, users can more accurately handle the hostname when configuring `difyApiUrl`, avoiding connection issues due to incorrect rewriting, enhancing system stability and the user experience. + +- **Related PR**: [#3252](https://github.com/alibaba/higress/pull/3252) \ + **Contributor**: @rinfx \ + **Change Log**: This PR fixed the error response issue in cross-provider load balancing by adding a penalty mechanism to prevent fast error responses from disrupting service selection and adjusting debug log information. \ + **Feature Value**: By improving error response handling and enhancing debugging capabilities, it improves system stability and reliability during load balancing, reducing the risk of service disruptions due to error responses. + +- **Related PR**: [#3251](https://github.com/alibaba/higress/pull/3251) \ + **Contributor**: @rinfx \ + **Change Log**: This PR addressed the situation where content extracted from a specified jsonpath in the configuration is empty. When detecting empty content, it replaces the detected content with `[empty content]`. \ + **Feature Value**: By introducing a special handling mechanism for empty content, it ensures that the system can operate normally even in the absence of data, enhancing system robustness and the user experience. + +- **Related PR**: [#3237](https://github.com/alibaba/higress/pull/3237) \ + **Contributor**: @CH3CHO \ + **Change Log**: Increased the request body buffer size for multipart data in the `model-router` to support larger file uploads. \ + **Feature Value**: This enhancement improves the system's ability to handle large file uploads, reducing data truncation issues due to small buffers, and enhancing the user experience. + +- **Related PR**: [#3225](https://github.com/alibaba/higress/pull/3225) \ + **Contributor**: @wydream \ + **Change Log**: Fixed the issue where `basePathHandling: removePrefix` did not work correctly when using the `protocol: original` configuration. Adjusted the request header transformation logic in multiple providers to ensure the path prefix is correctly removed. \ + **Feature Value**: This fix resolves the path handling failure in specific configurations, ensuring that API calls to over 27 AI service providers work as expected, enhancing system stability and reliability. + +- **Related PR**: [#3220](https://github.com/alibaba/higress/pull/3220) \ + **Contributor**: @Aias00 \ + **Change Log**: This PR fixed two issues: 1. Skipping unhealthy or disabled Nacos services; 2. Ensuring the `AllowTools` field is serialized even if it is empty. \ + **Feature Value**: By skipping unhealthy or disabled services, it improves system stability and reliability. Additionally, ensuring consistent output of the `AllowTools` field avoids potential configuration issues due to missing fields. + +- **Related PR**: [#3211](https://github.com/alibaba/higress/pull/3211) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR modified the logic in the `ai-proxy` plugin for determining if a request contains a request body, changing from relying on specific header information to using the new `HasRequestBody` logic. \ + **Feature Value**: By correcting the request body detection logic, it improves the accuracy and efficiency of handling HTTP requests, reducing misjudgment issues caused by the old logic. + +- **Related PR**: [#3187](https://github.com/alibaba/higress/pull/3187) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR bypassed the handling of streamable response bodies in MCP to allow progress notifications, resolving the issue of not being able to correctly display progress during data transmission. \ + **Feature Value**: By bypassing the response body handling in specific situations, users can more accurately obtain progress information during data transmission, enhancing the user experience. + +- **Related PR**: [#3168](https://github.com/alibaba/higress/pull/3168) \ + **Contributor**: @wydream \ + **Change Log**: Fixed an issue where the query string was incorrectly removed when processing paths with regular expressions. It strips the query string first, performs the match, and then reappends the query string. \ + **Feature Value**: This ensures that API requests with regular expression paths are correctly parsed and retain their original query parameters, enhancing system compatibility and the user experience. + +- **Related PR**: [#3167](https://github.com/alibaba/higress/pull/3167) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: Updated multiple submodule references to the latest version and simplified the `Makefile` commands related to submodules, reducing redundant code. \ + **Feature Value**: By ensuring all submodules are up-to-date and synchronized, this fix improves project stability and maintainability, reducing potential compatibility issues. + +- **Related PR**: [#3148](https://github.com/alibaba/higress/pull/3148) \ + **Contributor**: @rinfx \ + **Change Log**: Removed the `omitempty` tag from the `toolcall index` field, ensuring that the default value 0 is correctly passed even if there is no index. \ + **Feature Value**: This fix resolves the issue of missing `toolcall index` in the response, ensuring data consistency and integrity, and enhancing system stability and the user experience. + +- **Related PR**: [#3022](https://github.com/alibaba/higress/pull/3022) \ + **Contributor**: @lwpk110 \ + **Change Log**: This PR resolved the issue of missing support for `gateway.metrics.labels` in the Helm template by adding a `podMonitorSelector` to the gateway metrics configuration and setting a default PodMonitor selector label to ensure seamless auto-discovery with the kube-prometheus-stack monitoring system. \ + **Feature Value**: This fix enhances Prometheus monitoring integration, allowing users to more flexibly configure and collect gateway metrics data, thereby improving system observability and management efficiency. + +### ♻️ Refactoring and Optimization (Refactoring) + +- **Related PR**: [#3462](https://github.com/alibaba/higress/pull/3462) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR removed the automatic injection of Bash tools in Claude Code mode, including deleting related constants, logic code, and test cases, and updating the documentation. \ + **Feature Value**: By removing unnecessary features, it simplifies the codebase and reduces maintenance costs. This change helps improve system stability and reduce potential sources of errors. + +- **Related PR**: [#3457](https://github.com/alibaba/higress/pull/3457) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR primarily updated the version number to 2.2.0, adjusted the Envoy submodule branch, and corrected the package URL pattern in the `Makefile`. \ + **Feature Value**: By updating the version and related configurations, it ensures the consistency and correctness of software builds, avoiding potential build errors due to version mismatches. + +- **Related PR**: [#3155](https + +# Higress Console + + +## 📋 Overview of This Release + +This release includes **18** updates, covering enhancements, bug fixes, and performance optimizations. + +### Update Distribution + +- **New Features**: 7 +- **Bug Fixes**: 10 +- **Documentation Updates**: 1 + +--- + +## 📝 Full Changelog + +### 🚀 New Features (Features) + +- **Related PR**: [#621](https://github.com/higress-group/higress-console/pull/621) \ + **Contributor**: @Thomas-Eliot \ + **Change Log**: Enhanced some interaction capabilities of the MCP Server, including header host rewriting in direct routing scenarios, support for selecting transport, and support for special characters in the DB to MCP Server scenario. \ + **Feature Value**: Increased system flexibility and usability, allowing users to more easily customize MCP Server configurations, and resolved previous path confusion issues. + +- **Related PR**: [#612](https://github.com/higress-group/higress-console/pull/612) \ + **Contributor**: @zhwaaaaaa \ + **Change Log**: Added hop-to-hop headers to the ignore list, resolving the issue where Grafana pages could not work properly due to the reverse proxy sending the `transfer-encoding: chunked` header. \ + **Feature Value**: Improved system compatibility and stability by adhering to RFC 2616, ensuring that Grafana monitoring pages display correctly when using a reverse proxy. + +- **Related PR**: [#608](https://github.com/higress-group/higress-console/pull/608) \ + **Contributor**: @Libres-coder \ + **Change Log**: Added support for displaying AI routing management page plugins, allowing users to view enabled plugins and their status through extended AI routing entries. \ + **Feature Value**: Enhanced user experience by allowing users to intuitively see which plugins are activated on the AI routing configuration interface, thus better managing and understanding the AI routing configuration. + +- **Related PR**: [#604](https://github.com/higress-group/higress-console/pull/604) \ + **Contributor**: @CH3CHO \ + **Change Log**: Introduced the use of the `higress.io/rewrite-target` annotation to support path rewriting based on regular expressions, involving modifications to the SDK server and frontend localization files. \ + **Feature Value**: The new path rewriting capability allows users to define URL routing rules more flexibly, enhancing system configurability and user experience. + +- **Related PR**: [#603](https://github.com/higress-group/higress-console/pull/603) \ + **Contributor**: @CH3CHO \ + **Change Log**: Displayed a fixed service port 80 for static service sources on the frontend page, implemented by adding a static constant in the component. \ + **Feature Value**: This feature allows users to clearly see the service port number used by static service sources, improving configuration transparency and user experience. + +- **Related PR**: [#602](https://github.com/higress-group/higress-console/pull/602) \ + **Contributor**: @CH3CHO \ + **Change Log**: Added support for service search functionality during AI routing configuration, optimizing the frontend interface to make it easier for users to find and select upstream services. \ + **Feature Value**: Enhanced user experience, especially when dealing with a large number of services, allowing users to quickly locate the required services, improving efficiency and ease of use. + +- **Related PR**: [#566](https://github.com/higress-group/higress-console/pull/566) \ + **Contributor**: @OuterCyrex \ + **Change Log**: Added support for custom Qwen services, including enabling internet search and file ID upload. The main changes were focused on the frontend interface and backend service processing logic. \ + **Feature Value**: Provided users with more flexible service configuration options, allowing them to customize Qwen service behavior according to their needs, enhancing system extensibility and user experience. + +### 🐛 Bug Fixes (Bug Fixes) + +- **Related PR**: [#620](https://github.com/higress-group/higress-console/pull/620) \ + **Contributor**: @CH3CHO \ + **Change Log**: Fixed a spelling error in the `sortWasmPluginMatchRules` logic, ensuring that the rule matching function works as expected. \ + **Feature Value**: Resolved a potential misoperation issue, improving system stability and user experience. + +- **Related PR**: [#619](https://github.com/higress-group/higress-console/pull/619) \ + **Contributor**: @CH3CHO \ + **Change Log**: Removed version information from the data JSON when converting AiRoute to ConfigMap, as this information is already stored in the ConfigMap metadata. \ + **Feature Value**: By avoiding redundant storage of version information, reduced redundancy and ensured data consistency, thereby improving system reliability and maintainability. + +- **Related PR**: [#618](https://github.com/higress-group/higress-console/pull/618) \ + **Contributor**: @CH3CHO \ + **Change Log**: Refactored the API authentication logic in SystemController by introducing new annotations and modifying existing AOP aspects to eliminate security vulnerabilities. \ + **Feature Value**: Resolved security risks in API authentication, enhancing system security and protecting user data from potential threats. + +- **Related PR**: [#617](https://github.com/higress-group/higress-console/pull/617) \ + **Contributor**: @CH3CHO \ + **Change Log**: Fixed several errors in the frontend console, including missing unique key attributes for list items, image loading violations of the content security policy, and incorrect type for the Consumer.name field. \ + **Feature Value**: By addressing these frontend issues, improved user experience and application stability. Reducing console warnings and errors enhances user trust in the system and ensures the correct execution of functions. + +- **Related PR**: [#614](https://github.com/higress-group/higress-console/pull/614) \ + **Contributor**: @lc0138 \ + **Change Log**: Corrected the type error in the `type` field of the ServiceSource class and added dictionary value validation to ensure data consistency. \ + **Feature Value**: By fixing the type error and introducing dictionary value validation, improved system stability and reliability, avoiding potential data inconsistency issues. + +- **Related PR**: [#613](https://github.com/higress-group/higress-console/pull/613) \ + **Contributor**: @lc0138 \ + **Change Log**: This PR modified the `document.tsx` file, adding 15 lines of code, primarily to fix security issues related to the frontend CSP, ensuring the application's security. \ + **Feature Value**: Fixed frontend CSP and other security risks, enhancing system security and protecting user data from potential threats, improving user experience and trust. + +- **Related PR**: [#611](https://github.com/higress-group/higress-console/pull/611) \ + **Contributor**: @qshuai \ + **Change Log**: Corrected a spelling error in an API title in `LlmProvidersController.java`, changing 'Add a new route' to a more appropriate description. \ + **Feature Value**: Correcting the API documentation title improves code readability and maintainability, ensuring developers can accurately understand each API's function, thus enhancing user experience. + +- **Related PR**: [#609](https://github.com/higress-group/higress-console/pull/609) \ + **Contributor**: @CH3CHO \ + **Change Log**: Fixed the type error in the `name` field of the Consumer interface, changing it from a boolean to a string. \ + **Feature Value**: Corrected the data type inconsistency in the Consumer.name field, ensuring data consistency and correctness, improving system stability and reliability. + +- **Related PR**: [#605](https://github.com/higress-group/higress-console/pull/605) \ + **Contributor**: @SaladDay \ + **Change Log**: Adjusted the regular expression validation rules for AI route names to support periods and unify case restrictions. Also updated the Chinese and English error messages to accurately reflect the new validation logic. \ + **Feature Value**: Resolved inconsistencies in route name validation, improving user experience and ensuring that user input conforms to expectations without causing confusion due to misleading prompts. + +- **Related PR**: [#552](https://github.com/higress-group/higress-console/pull/552) \ + **Contributor**: @lcfang \ + **Change Log**: This PR added a `vport` attribute to adapt to `mcpbridge`, solving the issue of route configuration failure due to inconsistent backend service ports. Multiple files were changed, including the addition of the VPort class. \ + **Feature Value**: Resolved compatibility issues caused by changes in the service instance ports in the registry, enhancing system stability and user experience, ensuring that services run normally even when ports change. + +### 📚 Documentation Updates (Documentation) + +- **Related PR**: [#610](https://github.com/higress-group/higress-console/pull/610) \ + **Contributor**: @heimanba \ + **Change Log**: Adjusted the required fields for multiple fields in the frontend canary plugin configuration documentation and updated the associated rules to reflect the latest configuration flexibility. Also corrected some descriptive text to ensure document consistency and accuracy. \ + **Feature Value**: By increasing the flexibility and compatibility of configuration options, enhanced user experience, allowing users to configure canaries more flexibly; synchronized updates of Chinese and English documents also ensured accurate information dissemination. + +--- + +## 📊 Release Statistics + +- 🚀 New Features: 7 +- 🐛 Bug Fixes: 10 +- 📚 Documentation Updates: 1 + +**Total**: 18 changes + +Thanks to all contributors for their hard work! 🎉 + diff --git a/release-notes/2.2.0/README_ZH.md b/release-notes/2.2.0/README_ZH.md new file mode 100644 index 000000000..531067b69 --- /dev/null +++ b/release-notes/2.2.0/README_ZH.md @@ -0,0 +1,531 @@ +# Higress + + +## 📋 本次发布概览 + +本次发布包含 **73** 项更新,涵盖了功能增强、Bug修复、性能优化等多个方面。 + +### 更新内容分布 + +- **新功能**: 48项 +- **Bug修复**: 20项 +- **重构优化**: 3项 +- **文档更新**: 2项 + +--- + +## 📝 完整变更日志 + +### 🚀 新功能 (Features) + +- **Related PR**: [#3459](https://github.com/alibaba/higress/pull/3459) \ + **Contributor**: @johnlanni \ + **Change Log**: 增加了对Claude Code模式的支持,允许使用OAuth令牌进行身份验证,并模仿Claude CLI的请求格式。 \ + **Feature Value**: 此功能扩展了与Anthropic Claude API交互的能力,使用户能够利用更多定制化的配置选项来满足特定需求。 + +- **Related PR**: [#3455](https://github.com/alibaba/higress/pull/3455) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 此PR更新了项目中的子模块,包括升级Envoy和go-control-plane版本,并更新Istio以使用最新版的go-control-plane。 \ + **Feature Value**: 通过同步最新版本的关键依赖库,提升了系统的兼容性和稳定性,有助于用户获得更好的服务与支持。 + +- **Related PR**: [#3438](https://github.com/alibaba/higress/pull/3438) \ + **Contributor**: @johnlanni \ + **Change Log**: 改进了higress-clawdbot-integration技能的文档结构,精简并合并了重复内容,并实现了Clawdbot插件的完全兼容性。 \ + **Feature Value**: 通过优化文档结构和确保Clawdbot插件的兼容性,提高了用户的使用体验,简化了配置流程,使用户能够更快速、便捷地完成网关的集成与配置。 + +- **Related PR**: [#3437](https://github.com/alibaba/higress/pull/3437) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR将`higress-ai-gateway`插件集成到了`higress-clawdbot-integration`技能中,通过迁移和捆绑相关文件简化了安装与配置流程。 \ + **Feature Value**: 该功能使用户能够更便捷地安装并配置Higress AI Gateway与Clawdbot/OpenClaw,提升了用户体验和软件的易用性。 + +- **Related PR**: [#3436](https://github.com/alibaba/higress/pull/3436) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR更新了Higress-OpenClaw集成中的服务提供商列表,并将OpenClaw插件包从higress-standalone迁移到主仓库。 \ + **Feature Value**: 通过增强的服务提供商列表和整合的插件包,用户可以更容易地配置和使用Higress AI Gateway,提升了用户体验和系统的灵活性。 + +- **Related PR**: [#3428](https://github.com/alibaba/higress/pull/3428) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增了两个技能higress-auto-router和higress-clawdbot-integration,支持自然语言配置自动模型路由以及通过CLI参数部署Higress AI Gateway。 \ + **Feature Value**: 增强了Higress AI Gateway与Clawdbot的集成能力,为用户提供更便捷的配置方式及灵活的路由策略,提升了用户体验。 + +- **Related PR**: [#3427](https://github.com/alibaba/higress/pull/3427) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增了`use_default_attributes`配置选项,允许ai-statistics插件使用默认属性集,简化用户配置流程。这一变更涉及对主逻辑文件的较大修改。 \ + **Feature Value**: 通过引入自动应用默认属性的功能,减少了用户的初始设置负担,使得ai-statistics插件更加易于上手,同时保持了高级自定义能力以满足特定需求。 + +- **Related PR**: [#3426](https://github.com/alibaba/higress/pull/3426) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增Agent Session Monitor技能,支持实时解析Higress访问日志,追踪多轮对话并通过session_id进行会话管理,同时提供token使用情况分析。 \ + **Feature Value**: 通过实时监控LLM在Higress环境中的使用情况,用户可以更好地了解和控制资源消耗,优化对话系统性能。 + +- **Related PR**: [#3424](https://github.com/alibaba/higress/pull/3424) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR为ai-statistics插件添加了对token详细使用信息的支持,包括reasoning_tokens和cached_tokens两个新的内置属性键。 \ + **Feature Value**: 通过记录更详细的token使用情况,用户能够更好地了解和优化AI推理过程中的资源消耗,有助于提高效率和降低成本。 + +- **Related PR**: [#3420](https://github.com/alibaba/higress/pull/3420) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR为AI统计插件添加了会话ID跟踪功能,支持通过自定义头或默认头获取会话ID,以追踪多轮对话。 \ + **Feature Value**: 新增会话ID跟踪能力可以帮助用户更好地分析和理解多轮对话的交互情况,提升了系统的可观测性和用户体验。 + +- **Related PR**: [#3417](https://github.com/alibaba/higress/pull/3417) \ + **Contributor**: @johnlanni \ + **Change Log**: 增加了关于不支持片段的重要警告,并提供了迁移前检查命令,以帮助用户识别受影响的Ingress资源。 \ + **Feature Value**: 通过提供关键警告和指南,该功能显著减少了迁移过程中可能遇到的问题,提高了用户体验和迁移成功率。 + +- **Related PR**: [#3411](https://github.com/alibaba/higress/pull/3411) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增了从ingress-nginx迁移到Higress的技能,包括分析现有Nginx Ingress资源、生成迁移测试脚本、为不支持的功能创建WASM插件框架等。 \ + **Feature Value**: 帮助用户平滑地将Kubernetes环境中的ingress-nginx迁移到Higress,通过提供详细的迁移指南和工具减轻迁移负担,提升用户体验。 + +- **Related PR**: [#3409](https://github.com/alibaba/higress/pull/3409) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增`contextCleanupCommands`配置项,允许用户自定义清理对话上下文的命令,当用户消息与配置的清理命令完全匹配时,将清除该命令之前的所有非系统消息。 \ + **Feature Value**: 此功能使用户能够主动管理其对话历史记录,通过发送预设命令来清除无关或过期的消息,从而提高对话质量和相关性。 + +- **Related PR**: [#3404](https://github.com/alibaba/higress/pull/3404) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增了Higress社区治理日报生成技能,能够自动追踪项目GitHub活动并生成结构化报告。 \ + **Feature Value**: 该功能帮助用户更好地跟踪和管理项目的日常进展与问题解决情况,提升社区活跃度及问题处理效率。 + +- **Related PR**: [#3403](https://github.com/alibaba/higress/pull/3403) \ + **Contributor**: @johnlanni \ + **Change Log**: 本PR为model-router插件新增了基于用户消息内容的自动路由功能。通过正则表达式匹配用户输入来决定使用哪个模型。 \ + **Feature Value**: 此功能允许根据消息内容自动选择最合适的处理模型,极大提升了用户体验和系统的灵活性,使得服务更加智能高效。 + +- **Related PR**: [#3402](https://github.com/alibaba/higress/pull/3402) \ + **Contributor**: @johnlanni \ + **Change Log**: 增加了使用Go 1.24+开发Higress WASM插件的Claude技能,涵盖了HTTP客户端、Redis客户端以及本地测试等多个参考文档。 \ + **Feature Value**: 此功能为开发者提供了一套详尽的指南来创建和调试Higress网关插件,极大提升了工作效率及插件质量。 + +- **Related PR**: [#3394](https://github.com/alibaba/higress/pull/3394) \ + **Contributor**: @changsci \ + **Change Log**: 当provider.apiTokens未配置时,支持从请求头获取API密钥。更改主要涉及在openai.go中导入proxywasm,并在provider.go中添加相关配置逻辑。 \ + **Feature Value**: 此功能增强了系统的灵活性,允许用户通过请求头传递API密钥,从而在不配置provider.apiTokens的情况下也能正常使用服务,提高了用户体验和安全性。 + +- **Related PR**: [#3384](https://github.com/alibaba/higress/pull/3384) \ + **Contributor**: @ThxCode-Chen \ + **Change Log**: 此PR通过在watcher.go文件中添加了对ipv6静态地址的支持,增强了系统处理IPv6地址的能力。具体来说,在generateServiceEntry函数中引入了新的逻辑来识别和处理IPv6静态地址。 \ + **Feature Value**: 新增的IPv6静态地址支持功能允许用户在网络配置中使用IPv6地址,从而提升了系统的网络灵活性与兼容性,为需要IPv6环境部署的用户提供了便利。 + +- **Related PR**: [#3375](https://github.com/alibaba/higress/pull/3375) \ + **Contributor**: @wydream \ + **Change Log**: 本PR为ai-proxy插件的Vertex AI Provider添加了Vertex Raw模式支持,使得通过Vertex访问原生REST API时也能启用getAccessToken机制。 \ + **Feature Value**: 新增的Vertex Raw模式支持增强了用户直接调用Vertex AI托管模型的能力,并且确保了在使用原生API路径时能够自动进行OAuth认证,提升了用户体验。 + +- **Related PR**: [#3367](https://github.com/alibaba/higress/pull/3367) \ + **Contributor**: @rinfx \ + **Change Log**: 此次PR更新了wasm-go依赖,通过引入Foreign Function使Wasm插件可以实时感知Envoy宿主的日志等级,并优化了日志处理流程来提升性能。 \ + **Feature Value**: 此功能提升了系统的运行效率,特别是在高负载情况下,减少了不必要的内存分配与复制操作,对用户来说意味着更低的资源消耗和更好的应用响应速度。 + +- **Related PR**: [#3342](https://github.com/alibaba/higress/pull/3342) \ + **Contributor**: @Aias00 \ + **Change Log**: 该PR实现了Nacos实例权重与Istio WorkloadEntry权重在watchers中的映射,确保了服务间的流量分配更加精确。 \ + **Feature Value**: 通过将Nacos实例权重映射到Istio WorkloadEntry权重,增强了服务网格中流量管理的灵活性和准确性,使用户能够更精细地控制服务间的请求分发。 + +- **Related PR**: [#3335](https://github.com/alibaba/higress/pull/3335) \ + **Contributor**: @wydream \ + **Change Log**: 本 PR 为 ai-proxy 插件的 Vertex AI Provider 添加了图片生成支持,实现了将 OpenAI 的图片生成协议转换为 Vertex AI 的图片生成协议。 \ + **Feature Value**: 用户现在可以通过标准的 OpenAI SDK 调用 Vertex AI 的图片生成功能,增强了插件的功能性和用户体验。 + +- **Related PR**: [#3324](https://github.com/alibaba/higress/pull/3324) \ + **Contributor**: @wydream \ + **Change Log**: 本PR在ai-proxy插件的Vertex AI Provider中实现了OpenAI-compatible端点支持,使开发者能够直接使用OpenAI SDK和API格式调用Vertex AI模型。 \ + **Feature Value**: 通过添加OpenAI-compatible端点支持,此功能简化了从OpenAI到Vertex AI的迁移过程,方便用户利用现有的OpenAI工具链无缝对接Vertex AI服务,提升了开发效率和用户体验。 + +- **Related PR**: [#3318](https://github.com/alibaba/higress/pull/3318) \ + **Contributor**: @hanxiantao \ + **Change Log**: 通过使用withConditionalAuth中间件,将Istio的原生认证逻辑应用于调试端点,同时保持基于DebugAuth功能标志的现有行为。 \ + **Feature Value**: 增强系统的安全性,确保只有经过身份验证的用户才能访问调试端点,从而减少潜在的安全风险,提供更安全的服务环境。 + +- **Related PR**: [#3317](https://github.com/alibaba/higress/pull/3317) \ + **Contributor**: @rinfx \ + **Change Log**: 新增了model-mapper与model-router两个WASM-Go插件,支持基于LLM协议中model参数的映射及路由功能,包括前缀匹配、通配符兜底等。 \ + **Feature Value**: 增强了Higress在处理大型语言模型请求时的能力,通过更灵活地管理模型名称和提供者信息来改善用户体验和服务效率。 + +- **Related PR**: [#3305](https://github.com/alibaba/higress/pull/3305) \ + **Contributor**: @CZJCC \ + **Change Log**: 新增了对AWS Bedrock提供者的Bearer Token认证支持,同时保留了原有的AWS Signature V4认证方式,并清理了一些未使用的代码。 \ + **Feature Value**: 为用户提供了更灵活的身份验证选项,使他们能够根据自己的需求选择合适的认证方法,从而提高了系统的灵活性和安全性。 + +- **Related PR**: [#3301](https://github.com/alibaba/higress/pull/3301) \ + **Contributor**: @wydream \ + **Change Log**: 本PR为ai-proxy插件的Vertex AI Provider实现了Express Mode支持,简化了认证流程,使用户可以使用API Key快速开始。 \ + **Feature Value**: 通过添加Express Mode支持,用户不再需要配置复杂的Service Account认证即可利用Vertex AI,极大地降低了使用门槛,提升了用户体验。 + +- **Related PR**: [#3295](https://github.com/alibaba/higress/pull/3295) \ + **Contributor**: @rinfx \ + **Change Log**: 本PR为ai-security-guard插件增加了对MCP的支持,包括处理标准响应和流式响应的安全检查功能。 \ + **Feature Value**: 通过增加对MCP API类型的支持,该插件现在可以更好地保护模型上下文协议相关的数据安全,提升了系统的整体安全性。 + +- **Related PR**: [#3267](https://github.com/alibaba/higress/pull/3267) \ + **Contributor**: @erasernoob \ + **Change Log**: 本PR实现了hgctl agent模块,增加了新的功能和相关服务,并对依赖进行了更新。 \ + **Feature Value**: 新增的hgctl agent模块为用户提供了更强大的命令行工具支持,提升了系统的可操作性和用户体验。 + +- **Related PR**: [#3261](https://github.com/alibaba/higress/pull/3261) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR为gemini-2.5-flash和其简化版增加了关闭thinking的功能,并在响应中加入了reasoning token的使用信息。 \ + **Feature Value**: 通过新增关闭thinking的能力及提供reasoning token消耗详情,用户可以更灵活地控制AI代理的行为并更好地理解资源消耗情况。 + +- **Related PR**: [#3255](https://github.com/alibaba/higress/pull/3255) \ + **Contributor**: @nixidexiangjiao \ + **Change Log**: 改进了全局最小请求数负载均衡策略,修复了异常节点偏好性选择、新节点处理不一致和采样分布不均的问题,提升了算法的稳定性和准确性。 \ + **Feature Value**: 通过优化负载均衡算法,避免了流量集中到故障节点导致的服务中断,增强了系统的可用性和可靠性,同时减少了运维负担。 + +- **Related PR**: [#3236](https://github.com/alibaba/higress/pull/3236) \ + **Contributor**: @rinfx \ + **Change Log**: 本PR实现了对Vertex AI中Claude模型的支持,并处理了delta可能为空的情况,确保了在边界情况下的系统稳定性。 \ + **Feature Value**: 新增了对Vertex AI平台下Claude模型的支持,拓宽了AI代理插件的应用场景,让用户能够利用更多种类的AI模型,增加了系统的灵活性和适用性。 + +- **Related PR**: [#3218](https://github.com/alibaba/higress/pull/3218) \ + **Contributor**: @johnlanni \ + **Change Log**: 增强了模型映射器和路由器,添加了请求计数监视与内存使用监控,并设置了自动重建触发机制;扩展了支持的路径后缀。 \ + **Feature Value**: 通过增加自动重建触发机制,提升了服务在高负载或内存不足情况下的稳定性。扩展的路径支持使更多功能得以正确路由和处理,提高了系统的灵活性和兼容性。 + +- **Related PR**: [#3213](https://github.com/alibaba/higress/pull/3213) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR在vertex支持中增加了对全球区域的支持,通过修改请求域名以适应最新gemini-3系列模型的需求。 \ + **Feature Value**: 增强了系统兼容性,使得用户能够无缝访问最新的gemini-3系列模型,提升了用户体验和系统的灵活性。 + +- **Related PR**: [#3206](https://github.com/alibaba/higress/pull/3206) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR实现了AI安全卫士插件对于请求体中prompt和图片的内容检查功能,增强了内容安全检测能力。 \ + **Feature Value**: 通过支持对prompt和图片的检查,提高了系统在处理图像生成请求时的安全性,有助于保护用户免受不当内容的影响。 + +- **Related PR**: [#3200](https://github.com/alibaba/higress/pull/3200) \ + **Contributor**: @YTGhost \ + **Change Log**: 此PR在ai-proxy插件中添加了对数组类型内容的支持,扩展了chatToolMessage2BedrockMessage函数处理能力。 \ + **Feature Value**: 增强了消息处理功能,使得系统能够正确解析和转换数组格式的消息内容,提升了用户体验和系统的灵活性。 + +- **Related PR**: [#3185](https://github.com/alibaba/higress/pull/3185) \ + **Contributor**: @rinfx \ + **Change Log**: 该PR增加了ai-cache的重建逻辑,通过优化内存管理避免了高内存占用问题。变更主要集中在go.mod、go.sum和main.go文件中。 \ + **Feature Value**: 新增加的ai-cache重建逻辑能够有效防止因缓存导致的内存溢出问题,提升了系统的稳定性和性能,为用户提供更可靠的使用体验。 + +- **Related PR**: [#3184](https://github.com/alibaba/higress/pull/3184) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR在豆包插件中添加了用户自定义域名配置的支持,涉及修改Makefile以及两个Go文件,使服务能够基于新的域名进行通信。 \ + **Feature Value**: 允许用户为特定服务配置自定义域名,增强了系统的灵活性和用户体验,让用户可以根据自身需求调整服务访问路径。 + +- **Related PR**: [#3175](https://github.com/alibaba/higress/pull/3175) \ + **Contributor**: @wydream \ + **Change Log**: 添加了一个新的通用提供商,用于处理未映射路径的请求,并利用共享头和basePath工具。同时更新了README以包含配置细节,并引入了相关测试。 \ + **Feature Value**: 通过提供一个与供应商无关的通用提供商,用户可以更灵活地处理各种请求,提高系统的适应性和可维护性。 + +- **Related PR**: [#3173](https://github.com/alibaba/higress/pull/3173) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 此PR通过在全局配置中添加了一个新的参数来支持推理扩展,涉及到了Helm模板和值文件的更新,增强了系统的灵活性。 \ + **Feature Value**: 新增的全局参数允许用户启用或禁用推理扩展功能,这为用户提供了更多的配置选项,从而更好地满足了不同场景下的需求。 + +- **Related PR**: [#3171](https://github.com/alibaba/higress/pull/3171) \ + **Contributor**: @wilsonwu \ + **Change Log**: 此PR为gateway和controller添加了topology spread constraints支持,通过在Helm模板中引入新的配置项实现。 \ + **Feature Value**: 新增的功能允许用户定义更细粒度的Pod分布策略,有助于提高集群内服务的可用性和稳定性。 + +- **Related PR**: [#3160](https://github.com/alibaba/higress/pull/3160) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 此PR升级了网关API至最新版本,并更新了相关依赖项,修改了部分配置文件以适配新特性。 \ + **Feature Value**: 通过引入最新的网关API特性,提升了系统的兼容性和可扩展性,为用户提供更先进、更安全的网络服务功能。 + +- **Related PR**: [#3136](https://github.com/alibaba/higress/pull/3136) \ + **Contributor**: @Wangzy455 \ + **Change Log**: 新增了一个基于Milvus向量数据库的工具搜索服务器,通过将工具描述转换为向量来实现语义匹配。 \ + **Feature Value**: 用户现在可以通过自然语言查询找到最相关的工具,这提高了用户体验并简化了工具查找过程。 + +- **Related PR**: [#3075](https://github.com/alibaba/higress/pull/3075) \ + **Contributor**: @rinfx \ + **Change Log**: 本PR对AI安全防护插件进行了重构,以支持多模态输入检测,并改进了文本和图片生成场景下的安全性。同时修复了部分边界情况下的响应异常问题。 \ + **Feature Value**: 通过引入多模态输入支持与增强的安全检测能力,提升了系统的灵活性及安全性,使用户在不同应用场景中获得更全面的内容保护。 + +- **Related PR**: [#3066](https://github.com/alibaba/higress/pull/3066) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 升级Istio至1.27.1版本,调整higress-core以适配新版本Istio,修复子模块分支拉取问题,并修正集成测试。 \ + **Feature Value**: 此次升级增强了系统的稳定性和兼容性,提升了性能并确保了与最新Istio版本的兼容,为用户提供了更好的服务体验。 + +- **Related PR**: [#3063](https://github.com/alibaba/higress/pull/3063) \ + **Contributor**: @rinfx \ + **Change Log**: 新增了根据具体指标如并发数、TTFT、RT等进行跨集群和端点负载均衡的功能,使得用户能够更加灵活地配置负载均衡策略。 \ + **Feature Value**: 此功能允许用户基于自定义的性能指标选择合适的后端服务,从而提高系统的整体响应速度和服务质量,增强了用户体验。 + +- **Related PR**: [#3061](https://github.com/alibaba/higress/pull/3061) \ + **Contributor**: @Jing-ze \ + **Change Log**: 此PR修复了response-cache插件的实现问题并添加了全面的单元测试,包括缓存键提取逻辑、接口不匹配问题以及配置验证中的尾部空白修正。 \ + **Feature Value**: 通过优化响应缓存插件,用户可以更可靠地使用缓存功能,提高系统性能和响应速度,同时减少不必要的资源消耗。 + +- **Related PR**: [#2825](https://github.com/alibaba/higress/pull/2825) \ + **Contributor**: @CH3CHO \ + **Change Log**: 新增了`traffic-editor`插件,允许用户对请求和响应进行编辑。该插件提供了包括删除、重命名、更新等在内的多种操作类型,并且具备可扩展的代码结构。 \ + **Feature Value**: 此功能增强了Higress网关的灵活性和功能性,让用户能够更自由地控制HTTP请求和响应的内容,满足更多个性化需求,提升了用户体验。 + +### 🐛 Bug修复 (Bug Fixes) + +- **Related PR**: [#3448](https://github.com/alibaba/higress/pull/3448) \ + **Contributor**: @lexburner \ + **Change Log**: 修复了在处理Qwen API响应时,由于空的选择数组导致的数组越界错误。通过添加空值检查避免了运行时错误。 \ + **Feature Value**: 提升了系统的稳定性和健壮性,防止因API响应异常而导致服务崩溃,改善了用户体验。 + +- **Related PR**: [#3434](https://github.com/alibaba/higress/pull/3434) \ + **Contributor**: @johnlanni \ + **Change Log**: 修复了技能描述中的YAML解析错误,通过在含有冒号的描述值外添加双引号,确保这些冒号被当作普通字符而非YAML语法的一部分处理。 \ + **Feature Value**: 此修复解决了由于YAML特殊字符导致的渲染问题,保证了技能页面能够正确显示,提升了用户的使用体验和文档的准确性。 + +- **Related PR**: [#3422](https://github.com/alibaba/higress/pull/3422) \ + **Contributor**: @johnlanni \ + **Change Log**: 修复了model-router插件在自动路由模式下,请求体中的model字段未更新的问题。通过正确的逻辑调整确保模型字段能够准确反映路由决策。 \ + **Feature Value**: 此修复保证了下游服务接收到的模型名称是经过正确路由决定后的值,而非默认的‘higress/auto’,提升了系统间的一致性和准确性。 + +- **Related PR**: [#3400](https://github.com/alibaba/higress/pull/3400) \ + **Contributor**: @johnlanni \ + **Change Log**: 修复了service.yaml中loadBalancerClass字段重复定义的问题,删除了多余的定义以避免YAML解析错误。 \ + **Feature Value**: 解决了因字段重复导致的YAML解析错误,确保用户可以正常配置loadBalancerClass而不遇到问题,提升了系统的稳定性和用户体验。 + +- **Related PR**: [#3380](https://github.com/alibaba/higress/pull/3380) \ + **Contributor**: @Thomas-Eliot \ + **Change Log**: 本PR在请求处理函数中增加了对请求模型上下文的设置,确保了在整个调用链中能够正确访问到请求模型的数据。 \ + **Feature Value**: 修复了请求模型上下文未设置的问题,使得系统可以正确地传递和使用请求模型信息,提高了系统的稳定性和数据一致性。 + +- **Related PR**: [#3370](https://github.com/alibaba/higress/pull/3370) \ + **Contributor**: @rinfx \ + **Change Log**: 修复了model-mapper组件中后缀不匹配时仍处理请求body的问题,并增加了对body的JSON验证,确保其有效性。 \ + **Feature Value**: 提高了系统的稳定性和数据处理准确性,避免了由于无效或错误格式的请求体导致的应用异常,增强了用户体验。 + +- **Related PR**: [#3341](https://github.com/alibaba/higress/pull/3341) \ + **Contributor**: @zth9 \ + **Change Log**: 此PR修复了并发SSE连接返回错误端点的问题,通过修改mcp-session插件的配置和过滤器逻辑来确保SSE服务器实例正确地为每个过滤器创建。 \ + **Feature Value**: 解决了并发SSE连接情况下可能出现的端点错误问题,提升了系统的稳定性和可靠性,对于需要依赖SSE进行实时通信的应用来说是一次重要的改进。 + +- **Related PR**: [#3258](https://github.com/alibaba/higress/pull/3258) \ + **Contributor**: @johnlanni \ + **Change Log**: 修复了MCP服务器版本协商问题,使其符合规范。通过更新依赖项确保兼容性和稳定性。 \ + **Feature Value**: 此修复增强了系统的稳定性和兼容性,确保MCP服务器能够正确地与客户端进行版本协商,提升了用户体验和系统可靠性。 + +- **Related PR**: [#3257](https://github.com/alibaba/higress/pull/3257) \ + **Contributor**: @sjtuzbk \ + **Change Log**: 此PR修复了ai-proxy插件中直接将host重写为difyApiUrl的问题,通过使用net/url包正确提取hostname。 \ + **Feature Value**: 修复后,用户在配置difyApiUrl时能够更准确地处理主机名,避免因错误重写导致的连接问题,提升了系统的稳定性和用户体验。 + +- **Related PR**: [#3252](https://github.com/alibaba/higress/pull/3252) \ + **Contributor**: @rinfx \ + **Change Log**: 该PR修正了跨提供者负载均衡中的错误响应问题,通过增加惩罚机制来避免过快的错误响应干扰服务选择,并调整了debug日志信息。 \ + **Feature Value**: 通过改进错误响应处理和增强调试能力,提高了系统在负载均衡时的稳定性和可靠性,减少了因错误响应导致的服务中断风险。 + +- **Related PR**: [#3251](https://github.com/alibaba/higress/pull/3251) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR针对从配置中指定的jsonpath提取内容为空的情况进行了处理,当检测到内容为空时,将以[empty content]替代原本应被检测的内容。 \ + **Feature Value**: 通过引入对空内容的特殊处理机制,确保了即使在数据缺失的情况下系统也能正常运行,提升了系统的健壮性和用户体验。 + +- **Related PR**: [#3237](https://github.com/alibaba/higress/pull/3237) \ + **Contributor**: @CH3CHO \ + **Change Log**: 增加了model-router处理multipart数据时的请求体缓冲区大小,以支持更大的文件上传。 \ + **Feature Value**: 提高了系统处理大文件上传的能力,减少了因缓冲区过小而导致的数据截断问题,提升了用户体验。 + +- **Related PR**: [#3225](https://github.com/alibaba/higress/pull/3225) \ + **Contributor**: @wydream \ + **Change Log**: 修复了当使用`protocol: original`配置时,`basePathHandling: removePrefix`不正确工作的问题。调整了多个提供商中的请求头转换逻辑以确保路径前缀被正确移除。 \ + **Feature Value**: 此修复解决了在特定配置下路径处理失败的问题,确保了27个以上AI服务提供商的API调用能够按照预期工作,提升了系统的稳定性和可靠性。 + +- **Related PR**: [#3220](https://github.com/alibaba/higress/pull/3220) \ + **Contributor**: @Aias00 \ + **Change Log**: 本次PR修复了两个问题:1. 跳过不健康或禁用的Nacos服务;2. 确保`AllowTools`字段即使为空时也能够被序列化。 \ + **Feature Value**: 通过跳过不健康或禁用的服务,提高了系统的稳定性和可靠性。同时,确保`AllowTools`字段的一致性输出,避免了因字段丢失导致的潜在配置问题。 + +- **Related PR**: [#3211](https://github.com/alibaba/higress/pull/3211) \ + **Contributor**: @CH3CHO \ + **Change Log**: 该PR修改了ai-proxy插件中判断请求是否含有请求体的逻辑,从依赖于特定头部信息改为采用新的HasRequestBody逻辑。 \ + **Feature Value**: 通过修正请求体检测逻辑,提高了处理HTTP请求时的准确性与效率,减少了因旧逻辑导致的误判问题。 + +- **Related PR**: [#3187](https://github.com/alibaba/higress/pull/3187) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR绕过了MCP可流式传输的响应体处理,以允许进度通知,解决了在数据传输过程中无法正确显示进度的问题。 \ + **Feature Value**: 通过绕过特定情况下的响应体处理,用户可以更准确地获取到数据传输过程中的进度信息,提升了用户体验。 + +- **Related PR**: [#3168](https://github.com/alibaba/higress/pull/3168) \ + **Contributor**: @wydream \ + **Change Log**: 修复了在处理带正则表达式的路径时,查询字符串被错误地移除的问题。通过先剥离查询字符串再进行匹配,并在匹配后重新附加查询字符串。 \ + **Feature Value**: 确保了使用正则路径的API请求能够正确解析并保留原有的查询参数,提升了系统的兼容性和用户体验。 + +- **Related PR**: [#3167](https://github.com/alibaba/higress/pull/3167) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 更新了多个子模块引用到最新版本,并简化了Makefile中与子模块相关的命令,减少了冗余代码。 \ + **Feature Value**: 通过确保所有子模块都是最新的并保持同步,此修复提高了项目的稳定性和可维护性,减少了潜在的兼容性问题。 + +- **Related PR**: [#3148](https://github.com/alibaba/higress/pull/3148) \ + **Contributor**: @rinfx \ + **Change Log**: 移除了toolcall index字段的omitempty标签,确保即使没有index时也能正确传递默认值0。 \ + **Feature Value**: 修复了响应中缺少toolcall index时的问题,保证了数据的一致性和完整性,提升了系统的稳定性和用户体验。 + +- **Related PR**: [#3022](https://github.com/alibaba/higress/pull/3022) \ + **Contributor**: @lwpk110 \ + **Change Log**: 此PR通过为gateway metrics配置添加podMonitorSelector,解决了在Helm模板中缺少对`gateway.metrics.labels`支持的问题,并设置了默认的PodMonitor选择器标签以确保与kube-prometheus-stack监控系统的无缝自动发现。 \ + **Feature Value**: 该修复增强了Prometheus监控集成能力,使得用户能够更灵活地配置和收集网关度量数据,从而提高了系统的可观测性和管理效率。 + +### ♻️ 重构优化 (Refactoring) + +- **Related PR**: [#3462](https://github.com/alibaba/higress/pull/3462) \ + **Contributor**: @johnlanni \ + **Change Log**: 该PR移除了Claude Code模式下自动注入Bash工具的功能,包括删除相关常量、逻辑代码及测试用例,并更新了文档。 \ + **Feature Value**: 通过去除不必要的功能,简化了代码库并减少了维护成本。此变动有助于提高系统的稳定性和减少潜在错误来源。 + +- **Related PR**: [#3457](https://github.com/alibaba/higress/pull/3457) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR主要更新了版本号至2.2.0,并调整了Envoy子模块的分支,同时修正了Makefile中的包URL模式指向。 \ + **Feature Value**: 通过更新版本和相关配置,确保了软件构建的一致性和正确性,避免了因版本不匹配导致的潜在构建错误。 + +- **Related PR**: [#3155](https://github.com/alibaba/higress/pull/3155) \ + **Contributor**: @github-actions[bot] \ + **Change Log**: 此PR更新了helm文件夹中的CRD文件,增加了routeType字段及其枚举值定义。 \ + **Feature Value**: 通过更新CRD文件,使得配置更加灵活与明确,有助于用户更好地理解和使用相关资源定义。 + +### 📚 文档更新 (Documentation) + +- **Related PR**: [#3244](https://github.com/alibaba/higress/pull/3244) \ + **Contributor**: @maplecap \ + **Change Log**: 在ADOPTERS.md文件中添加了快手作为Higress项目的采用者,更新了项目采纳者列表。 \ + **Feature Value**: 通过展示更多知名企业的采用情况,增加了项目的可信度和影响力,有助于吸引更多用户和贡献者关注并使用Higress。 + +- **Related PR**: [#3241](https://github.com/alibaba/higress/pull/3241) \ + **Contributor**: @qshuai \ + **Change Log**: 该PR删除了ai-token-ratelimit插件README文件中一个未知配置项的错误条目。 \ + **Feature Value**: 修复文档中的误导信息,帮助用户更准确地理解和使用插件功能,避免因文档错误导致的配置问题。 + +--- + +## 📊 发布统计 + +- 🚀 新功能: 48项 +- 🐛 Bug修复: 20项 +- ♻️ 重构优化: 3项 +- 📚 文档更新: 2项 + +**总计**: 73项更改 + +感谢所有贡献者的辛勤付出!🎉 + + +# Higress Console + + +## 📋 本次发布概览 + +本次发布包含 **18** 项更新,涵盖了功能增强、Bug修复、性能优化等多个方面。 + +### 更新内容分布 + +- **新功能**: 7项 +- **Bug修复**: 10项 +- **文档更新**: 1项 + +--- + +## 📝 完整变更日志 + +### 🚀 新功能 (Features) + +- **Related PR**: [#621](https://github.com/higress-group/higress-console/pull/621) \ + **Contributor**: @Thomas-Eliot \ + **Change Log**: 优化了MCP Server的部分交互能力,包括直接路由场景下的header host重写、支持选择transport、以及DB to MCP Server场景下对特殊字符的支持。 \ + **Feature Value**: 提升了系统的灵活性和易用性,使得用户在配置MCP Server时能够更方便地进行自定义设置,同时解决了之前存在的路径混淆问题。 + +- **Related PR**: [#612](https://github.com/higress-group/higress-console/pull/612) \ + **Contributor**: @zhwaaaaaa \ + **Change Log**: 添加了hop-to-hop头部至忽略列表,解决Grafana页面因反向代理发送transfer-encoding: chunked头导致无法正常工作的问题。 \ + **Feature Value**: 通过符合RFC 2616规范来改进系统的兼容性和稳定性,确保Grafana监控页面在使用反向代理时能够正确显示。 + +- **Related PR**: [#608](https://github.com/higress-group/higress-console/pull/608) \ + **Contributor**: @Libres-coder \ + **Change Log**: 新增了AI路由管理页面插件显示支持,通过扩展AI路由条目使用户能够查看已启用的插件及其状态。 \ + **Feature Value**: 提升了用户体验,允许用户直观地在AI路由配置界面上看到哪些插件已被激活,从而更好地管理和理解AI路由的配置情况。 + +- **Related PR**: [#604](https://github.com/higress-group/higress-console/pull/604) \ + **Contributor**: @CH3CHO \ + **Change Log**: 本PR引入了使用`higress.io/rewrite-target`注解来支持基于正则表达式的路径重写功能,涉及SDK服务端和前端本地化文件的修改。 \ + **Feature Value**: 新增的路径重写能力允许用户通过更灵活的方式定义URL路由规则,提升了系统的可配置性和用户体验。 + +- **Related PR**: [#603](https://github.com/higress-group/higress-console/pull/603) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR在前端页面上为静态服务源显示固定的服务端口80,通过在组件中添加静态常量实现。 \ + **Feature Value**: 该功能让用户能够清晰地看到静态服务源所使用的服务端口号,提高了配置的透明度和用户体验。 + +- **Related PR**: [#602](https://github.com/higress-group/higress-console/pull/602) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR在AI路由配置时支持了服务搜索功能,通过前端界面优化,使得用户能够更方便地查找和选择上游服务。 \ + **Feature Value**: 增强了用户体验,特别是在处理大量服务时,用户可以快速定位所需的服务,提升了工作效率和使用便捷性。 + +- **Related PR**: [#566](https://github.com/higress-group/higress-console/pull/566) \ + **Contributor**: @OuterCyrex \ + **Change Log**: 新增自定义Qwen服务支持,包括启用互联网搜索、文件ID上传等功能。主要变更集中在前端界面和后端服务处理逻辑。 \ + **Feature Value**: 为用户提供更灵活的服务配置选项,允许用户根据需求定制Qwen服务行为,提升了系统的可扩展性和用户体验。 + +### 🐛 Bug修复 (Bug Fixes) + +- **Related PR**: [#620](https://github.com/higress-group/higress-console/pull/620) \ + **Contributor**: @CH3CHO \ + **Change Log**: 修正了sortWasmPluginMatchRules逻辑中的拼写错误,确保规则匹配功能按预期工作。 \ + **Feature Value**: 修复了潜在的误操作问题,提高了系统的稳定性和用户使用体验。 + +- **Related PR**: [#619](https://github.com/higress-group/higress-console/pull/619) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR在将AiRoute转换为ConfigMap时移除了数据JSON中的版本信息,因为这些信息已经在ConfigMap的元数据中保存。 \ + **Feature Value**: 通过避免重复存储版本信息,减少了冗余并确保了数据的一致性,从而提高了系统的可靠性和维护性。 + +- **Related PR**: [#618](https://github.com/higress-group/higress-console/pull/618) \ + **Contributor**: @CH3CHO \ + **Change Log**: 重构了SystemController中的API认证逻辑,通过引入新的注解和修改现有AOP切面来消除安全漏洞。 \ + **Feature Value**: 修复了API认证中存在的安全隐患,提高了系统的安全性,保护用户数据免受潜在威胁。 + +- **Related PR**: [#617](https://github.com/higress-group/higress-console/pull/617) \ + **Contributor**: @CH3CHO \ + **Change Log**: 该PR修复了前端控制台中的一些错误,包括列表元素缺少唯一key属性、图片加载违反内容安全策略以及Consumer.name字段类型错误。 \ + **Feature Value**: 通过解决这些前端问题,提高了用户体验和应用程序的稳定性。减少控制台警告和错误可以增强用户对系统的信任感,并确保功能的正确执行。 + +- **Related PR**: [#614](https://github.com/higress-group/higress-console/pull/614) \ + **Contributor**: @lc0138 \ + **Change Log**: 修正了ServiceSource类中type字段的类型错误,并添加了字典值校验以确保数据一致性。 \ + **Feature Value**: 通过修复类型错误并引入字典值校验,提高了系统的稳定性和可靠性,避免了潜在的数据不一致问题。 + +- **Related PR**: [#613](https://github.com/higress-group/higress-console/pull/613) \ + **Contributor**: @lc0138 \ + **Change Log**: 本次PR通过对document.tsx文件的修改,新增了15行代码,主要修复了与前端CSP相关的安全问题,确保应用的安全性。 \ + **Feature Value**: 修复了前端CSP等安全风险,提高了系统的安全性,保护用户数据免受潜在威胁,提升了用户体验和信任度。 + +- **Related PR**: [#611](https://github.com/higress-group/higress-console/pull/611) \ + **Contributor**: @qshuai \ + **Change Log**: 此PR修正了LlmProvidersController.java中的一个API标题拼写错误,从'Add a new route'更正为更合适的描述。 \ + **Feature Value**: 修正API文档的标题有助于提高代码的可读性和维护性,确保开发者能够准确理解每个API的功能,从而提升用户体验。 + +- **Related PR**: [#609](https://github.com/higress-group/higress-console/pull/609) \ + **Contributor**: @CH3CHO \ + **Change Log**: 修复了Consumer接口中name字段类型错误的问题,将布尔值更改为字符串。 \ + **Feature Value**: 修正了Consumer.name字段的数据类型不一致问题,确保了数据的一致性和正确性,提高了系统的稳定性和可靠性。 + +- **Related PR**: [#605](https://github.com/higress-group/higress-console/pull/605) \ + **Contributor**: @SaladDay \ + **Change Log**: 调整了AI路由名称的正则表达式验证规则,使其支持点号,并统一了大小写限制。同时更新了中英文错误提示信息以准确反映新的验证逻辑。 \ + **Feature Value**: 修正了路由名称验证中的不一致问题,改善了用户体验,确保用户输入符合预期且不会因误导性提示而感到困惑。 + +- **Related PR**: [#552](https://github.com/higress-group/higress-console/pull/552) \ + **Contributor**: @lcfang \ + **Change Log**: 此PR通过新增vport属性适配mcpbridge,解决因服务后端端口不一致导致的路由配置失效问题。涉及多个文件变更,包括新增VPort类。 \ + **Feature Value**: 解决了注册中心服务实例端口变化导致的兼容性问题,提升了系统的稳定性和用户体验,确保了即使在端口变动的情况下,服务也能正常运行。 + +### 📚 文档更新 (Documentation) + +- **Related PR**: [#610](https://github.com/higress-group/higress-console/pull/610) \ + **Contributor**: @heimanba \ + **Change Log**: 调整了前端灰度插件配置文档中的多个字段的必填性要求,并更新了关联规则以反映最新的配置灵活性。同时,修正了部分描述文本,确保文档的一致性和准确性。 \ + **Feature Value**: 通过增加配置项的灵活性和兼容性,提升了用户体验,使用户能够更灵活地进行灰度配置;中英文文档同步更新也保证了信息的准确传达。 + +--- + +## 📊 发布统计 + +- 🚀 新功能: 7项 +- 🐛 Bug修复: 10项 +- 📚 文档更新: 1项 + +**总计**: 18项更改 + +感谢所有贡献者的辛勤付出!🎉 + +