From 136e4328c161f2c353b5495df9753473601e06ec Mon Sep 17 00:00:00 2001 From: johnlanni <6763318+johnlanni@users.noreply.github.com> Date: Tue, 3 Feb 2026 11:47:15 +0000 Subject: [PATCH] Add release notes --- release-notes/2.1.10/README.md | 501 +++++++++++++++++++++++++ release-notes/2.1.10/README_ZH.md | 590 ++++++++++++++++++++++++++++++ 2 files changed, 1091 insertions(+) create mode 100644 release-notes/2.1.10/README.md create mode 100644 release-notes/2.1.10/README_ZH.md diff --git a/release-notes/2.1.10/README.md b/release-notes/2.1.10/README.md new file mode 100644 index 000000000..fb037a0ef --- /dev/null +++ b/release-notes/2.1.10/README.md @@ -0,0 +1,501 @@ +# Higress + + +## 📋 Overview of This Release + +This release includes **84** updates, covering various aspects such as feature enhancements, bug fixes, and performance optimizations. + +### Update Distribution + +- **New Features**: 46 +- **Bug Fixes**: 18 +- **Refactoring and Optimization**: 1 +- **Documentation Updates**: 18 +- **Testing Improvements**: 1 + +--- + +## 📝 Complete Changelog + +### 🚀 New Features (Features) + +- **Related PR**: [#3438](https://github.com/alibaba/higress/pull/3438) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR significantly improves the `higress-clawdbot-integration` skill by adjusting the documentation structure, streamlining content, and adding support for the Clawdbot plugin. \ + **Feature Value**: This update allows users to configure plugins more smoothly and ensures true compatibility with Clawdbot, enhancing user experience and system flexibility. + +- **Related PR**: [#3437](https://github.com/alibaba/higress/pull/3437) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR integrates the `higress-ai-gateway` plugin into the `higress-clawdbot-integration` skill, including moving and packaging plugin files and updating the documentation. \ + **Feature Value**: This integration makes it easier for users to install and configure the connection between Higress AI Gateway and Clawbot/OpenClaw, simplifying the deployment process and enhancing user experience. + +- **Related PR**: [#3436](https://github.com/alibaba/higress/pull/3436) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR updates the SKILL provider list for Higress-OpenClaw integration and migrates the OpenClaw plugin package from `higress-standalone` to the main higress repository. \ + **Feature Value**: By enhancing the provider list and migrating the plugin package, users can more easily access commonly used providers, improving integration efficiency and user experience. + +- **Related PR**: [#3428](https://github.com/alibaba/higress/pull/3428) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds two new skills to the Higress AI Gateway and Clawdbot integration: automatic model routing configuration and gateway deployment via CLI parameters. It supports multilingual trigger words and hot reloading of configurations. \ + **Feature Value**: The new features enable users to manage AI model traffic distribution more flexibly and simplify the integration process with Clawdbot, enhancing system availability and usability. + +- **Related PR**: [#3427](https://github.com/alibaba/higress/pull/3427) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the `use_default_attributes` configuration option, which, when set to `true`, automatically applies a set of default attributes, simplifying the user configuration process. \ + **Feature Value**: This feature makes the `ai-statistics` plugin easier to use, especially for common use cases, reducing manual configuration work while maintaining full configurability. + +- **Related PR**: [#3426](https://github.com/alibaba/higress/pull/3426) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the Agent Session Monitor skill, supporting real-time monitoring of Higress access logs and tracking multi-turn conversation session IDs and token usage. \ + **Feature Value**: By providing real-time visibility into LLMs in the Higress environment, this helps users better understand and optimize the performance and cost of their AI assistants. + +- **Related PR**: [#3424](https://github.com/alibaba/higress/pull/3424) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds support for token usage details to the `ai-statistics` plugin, including the built-in attribute keys `reasoning_tokens` and `cached_tokens`, to better track resource consumption during inference. \ + **Feature Value**: By introducing more detailed token usage logging, users can more clearly understand resource usage during AI inference, aiding in model efficiency and cost control. + +- **Related PR**: [#3420](https://github.com/alibaba/higress/pull/3420) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds session ID tracking to the `ai-statistics` plugin, allowing users to track multi-turn conversations through custom or default headers. \ + **Feature Value**: The added session ID tracking capability helps better analyze and understand multi-turn conversation flows, enhancing user experience and system traceability. + +- **Related PR**: [#3417](https://github.com/alibaba/higress/pull/3417) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds key warnings and guidelines to the Nginx to Higress migration tool, including explicit warnings for unsupported fragment annotations and pre-migration check commands. \ + **Feature Value**: By providing clear warnings about unsupported configurations and pre-migration check methods, this helps users identify potential issues and complete the migration from Nginx to Higress more smoothly. + +- **Related PR**: [#3411](https://github.com/alibaba/higress/pull/3411) \ + **Contributor**: @johnlanni \ + **Change Log**: Added a comprehensive skill for migrating from ingress-nginx to Higress in a Kubernetes environment. Includes analysis scripts, migration test generators, and plugin skeleton generation tools. \ + **Feature Value**: This feature greatly simplifies the migration process from ingress-nginx to Higress by providing detailed compatibility analysis and automation tools, reducing migration difficulty and enhancing user experience. + +- **Related PR**: [#3409](https://github.com/alibaba/higress/pull/3409) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds the `contextCleanupCommands` configuration option to the `ai-proxy` plugin, allowing users to define commands to clear conversation context. When a user message exactly matches a cleanup command, all non-system messages before that command will be removed. \ + **Feature Value**: This new feature allows users to proactively clear previous conversation records by sending specific commands, thereby better controlling conversation history and enhancing user experience and privacy. + +- **Related PR**: [#3404](https://github.com/alibaba/higress/pull/3404) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the ability for the Claude AI assistant to automatically generate Higress community governance daily reports, including auto-tracking GitHub activities, progress tracking, and knowledge consolidation. \ + **Feature Value**: This feature helps community managers better understand project dynamics and issue progress, promoting efficient problem resolution and enhancing overall community governance. + +- **Related PR**: [#3403](https://github.com/alibaba/higress/pull/3403) \ + **Contributor**: @johnlanni \ + **Change Log**: Implemented a new automatic routing feature that dynamically selects the appropriate model to handle requests based on user message content and predefined regular expression rules. \ + **Feature Value**: This feature allows users to more flexibly configure services to automatically recognize and respond to different types of messages, reducing the need for manual model specification and enhancing system intelligence. + +- **Related PR**: [#3402](https://github.com/alibaba/higress/pull/3402) \ + **Contributor**: @johnlanni \ + **Change Log**: Added the Claude skill for developing Higress WASM plugins using Go 1.24+. Includes reference documentation and local testing guidelines for HTTP clients, Redis clients, etc. \ + **Feature Value**: Provides developers with detailed guidance and example code, making it easier for them to create, modify, or debug WASM plugins based on the Higress gateway, enhancing development efficiency and experience. + +- **Related PR**: [#3394](https://github.com/alibaba/higress/pull/3394) \ + **Contributor**: @changsci \ + **Change Log**: This PR extends the existing authentication mechanism by fetching API keys from request headers, particularly when `provider.apiTokens` is not configured, thus enhancing system flexibility. \ + **Feature Value**: This new feature allows users to more flexibly manage and pass API keys, ensuring normal service access even when direct configuration is missing, enhancing user experience and security. + +- **Related PR**: [#3384](https://github.com/alibaba/higress/pull/3384) \ + **Contributor**: @ThxCode-Chen \ + **Change Log**: Added support for upstream IPv6 static addresses in the `watcher.go` file, involving 31 lines of new code and 9 lines of deletions, mainly focusing on handling service entry generation logic. \ + **Feature Value**: Adding support for IPv6 static addresses enhances system network flexibility and compatibility, allowing users to configure more types of network addresses, thereby enhancing user experience and service diversity. + +- **Related PR**: [#3375](https://github.com/alibaba/higress/pull/3375) \ + **Contributor**: @wydream \ + **Change Log**: This PR adds Vertex Raw mode support to the Vertex AI Provider in the `ai-proxy` plugin, enabling the `getAccessToken` mechanism when accessing native REST APIs via Vertex. \ + **Feature Value**: Enhances support for native Vertex AI APIs, allowing direct calls to third-party hosted model APIs and enjoying automatic OAuth authentication, enhancing development flexibility and security. + +- **Related PR**: [#3367](https://github.com/alibaba/higress/pull/3367) \ + **Contributor**: @rinfx \ + **Change Log**: Updated the wasm-go dependency version and introduced Foreign Function, enabling Wasm plugins to perceive the Envoy host's log level in real time. By checking the log level upfront, unnecessary memory operations are avoided when there is a mismatch. \ + **Feature Value**: Enhances system performance, especially when handling large amounts of log data, reducing memory consumption and CPU usage, and improving response speed and resource utilization. + +- **Related PR**: [#3342](https://github.com/alibaba/higress/pull/3342) \ + **Contributor**: @Aias00 \ + **Change Log**: This PR implements the functionality of mapping Nacos instance weights to Istio WorkloadEntry weights in the watcher, using the math library for weight conversion. \ + **Feature Value**: This feature allows users to more flexibly control traffic distribution between services, enhancing system configurability and flexibility and improving integration with Istio. + +- **Related PR**: [#3335](https://github.com/alibaba/higress/pull/3335) \ + **Contributor**: @wydream \ + **Change Log**: This PR adds image generation support to the Vertex AI Provider in the `ai-proxy` plugin, achieving compatibility with OpenAI SDK and Vertex AI image generation. \ + **Feature Value**: The new image generation feature allows users to call Vertex AI services through standard OpenAI interfaces, simplifying cross-platform development and enhancing user experience. + +- **Related PR**: [#3324](https://github.com/alibaba/higress/pull/3324) \ + **Contributor**: @wydream \ + **Change Log**: This PR adds OpenAI-compatible endpoint support to the Vertex AI Provider in the `ai-proxy` plugin, enabling direct invocation of Vertex AI models. \ + **Feature Value**: By introducing OpenAI-compatible mode, developers can interact with Vertex AI using familiar OpenAI SDK and API formats, simplifying the integration process and enhancing development efficiency. + +- **Related PR**: [#3318](https://github.com/alibaba/higress/pull/3318) \ + **Contributor**: @hanxiantao \ + **Change Log**: This PR applies the native Istio authentication logic to the debugging endpoint using the `withConditionalAuth` middleware, while retaining the existing behavior based on the `DebugAuth` feature flag. \ + **Feature Value**: Adds authentication support for debugging endpoints, enhancing system security and ensuring that only authorized users can access these critical debugging interfaces, protecting the system from unauthorized access. + +- **Related PR**: [#3317](https://github.com/alibaba/higress/pull/3317) \ + **Contributor**: @rinfx \ + **Change Log**: Added two Wasm-Go plugins: `model-mapper` and `model-router`, implementing mapping and routing functions based on the `model` parameter in the LLM protocol. \ + **Feature Value**: Enhances Higress's capabilities in handling large language models, allowing flexible configuration to optimize request paths and model usage, enhancing system flexibility and performance. + +- **Related PR**: [#3305](https://github.com/alibaba/higress/pull/3305) \ + **Contributor**: @CZJCC \ + **Change Log**: Added Bearer Token authentication support for the AWS Bedrock provider, while retaining the existing AWS SigV4 authentication method and adjusting related configurations and header processing. \ + **Feature Value**: The new Bearer Token authentication method provides users with more flexibility, making it easier to choose the appropriate authentication mechanism when using AWS Bedrock services, enhancing user experience. + +- **Related PR**: [#3301](https://github.com/alibaba/higress/pull/3301) \ + **Contributor**: @wydream \ + **Change Log**: This PR implements Express Mode support in the Vertex AI Provider of the `ai-proxy` plugin, simplifying the authentication process for developers using Vertex AI, requiring only an API Key. \ + **Feature Value**: By introducing the Express Mode feature, users can start using Vertex AI more conveniently, without the need for complex Service Account configuration, enhancing developer efficiency and experience. + +- **Related PR**: [#3295](https://github.com/alibaba/higress/pull/3295) \ + **Contributor**: @rinfx \ + **Change Log**: This PR adds MCP protocol support to the `ai-security-guard` plugin, including implementing two response handling methods for content security checks and adding corresponding unit tests. \ + **Feature Value**: The new MCP support expands the plugin's application scope, allowing users to use the plugin for API call content security checks in more scenarios, enhancing system security. + +- **Related PR**: [#3267](https://github.com/alibaba/higress/pull/3267) \ + **Contributor**: @erasernoob \ + **Change Log**: Added the `hgctl agent` module, including basic functionality implementation and integration with related services, and updated `go.mod` and `go.sum` files to support new dependencies. \ + **Feature Value**: By introducing the `hgctl agent` module, a new management and control method is provided to users, enhancing system flexibility and operability and improving user experience. + +- **Related PR**: [#3261](https://github.com/alibaba/higress/pull/3261) \ + **Contributor**: @rinfx \ + **Change Log**: This PR adds the ability to disable thinking for `gemini-2.5-flash` and `gemini-2.5-flash-lite` and includes reasoning token information in the response, allowing users to better control AI behavior and understand its working details. \ + **Feature Value**: By allowing users to choose whether to enable the thinking feature and displaying reasoning token usage, system flexibility and transparency are enhanced, helping developers more effectively debug and optimize AI applications. + +- **Related PR**: [#3255](https://github.com/alibaba/higress/pull/3255) \ + **Contributor**: @nixidexiangjiao \ + **Change Log**: Optimized the Lua-based minimum in-flight requests load balancing strategy, addressing issues such as abnormal node preference selection, inconsistent new node handling, and uneven sampling distribution. \ + **Feature Value**: Improves system stability and service availability, reduces the fault amplification effect caused by abnormal nodes, and enhances support for new nodes and even traffic distribution. + +- **Related PR**: [#3236](https://github.com/alibaba/higress/pull/3236) \ + **Contributor**: @rinfx \ + **Change Log**: This PR adds support for the claude model in `vertex` and handles the case where `delta` might be empty, increasing system compatibility and stability. \ + **Feature Value**: Adding support for the claude model in `vertex` allows users to leverage a wider range of AI models for development and research, enhancing system flexibility and practicality. + +- **Related PR**: [#3218](https://github.com/alibaba/higress/pull/3218) \ + **Contributor**: @johnlanni \ + **Change Log**: Added an automatic rebuild trigger mechanism based on request count and memory usage, and expanded supported path suffixes, including `/rerank` and `/messages`. \ + **Feature Value**: These improvements enhance system stability and response speed, allowing effective handling of high loads or low memory situations through automatic rebuilding, while also enhancing support for new features. + +- **Related PR**: [#3213](https://github.com/alibaba/higress/pull/3213) \ + **Contributor**: @rinfx \ + **Change Log**: This PR updates the `vertex.go` file, changing the access method from region-specific to global, to support new models that only support global mode. \ + **Feature Value**: After adding support for the global region, users can more easily use new models like the gemini-3 series without specifying a specific geographic region. + +- **Related PR**: [#3206](https://github.com/alibaba/higress/pull/3206) \ + **Contributor**: @rinfx \ + **Change Log**: This PR primarily adds support for security checks on prompt and image content in the request body, especially when using OpenAI and Qwen to generate images. Enhanced the `parseOpenAIRequest` function to parse image data and improved related processing logic. \ + **Feature Value**: The new security check feature enhances system security when handling image generation requests, helping to prevent the spread of potential malicious content and providing users with a safer and more reliable service experience. + +- **Related PR**: [#3200](https://github.com/alibaba/higress/pull/3200) \ + **Contributor**: @YTGhost \ + **Change Log**: This PR adds support for array content in the `ai-proxy` plugin by modifying the relevant logic in the `bedrock.go` file, enabling correct handling when `content` is an array. \ + **Feature Value**: Enhances the `ai-proxy` plugin's ability to handle messages, now correctly supporting and converting array-formatted content, making chat tool message transmission more flexible and diverse. + +- **Related PR**: [#3185](https://github.com/alibaba/higress/pull/3185) \ + **Contributor**: @rinfx \ + **Change Log**: This PR adds a rebuild mechanism to `ai-cache`, updating `go.mod` and `go.sum` files and making minor adjustments to `main.go` to avoid excessive memory usage. \ + **Feature Value**: The new `ai-cache` rebuild mechanism effectively manages memory usage, preventing system performance degradation due to high memory consumption, enhancing system stability and user experience. + +- **Related PR**: [#3184](https://github.com/alibaba/higress/pull/3184) \ + **Contributor**: @rinfx \ + **Change Log**: This PR adds support for user-defined domain names in the Doubao extension, allowing users to configure service access domain names according to their needs. Main changes include adding compilation options in the `Makefile` and introducing new configuration items in `doubao.go` and `provider.go`. \ + **Feature Value**: The new custom domain configuration feature allows users to flexibly set up external service domain names based on actual needs, enhancing system flexibility and user experience. This helps better adapt to the requirements of different deployment environments. + +- **Related PR**: [#3175](https://github.com/alibaba/higress/pull/3175) \ + **Contributor**: @wydream \ + **Change Log**: Added a generic provider for handling requests that do not require path remapping, utilizing shared headers and `basePath` tools. Also updated the `README` file to include configuration details and introduced relevant tests. \ + **Feature Value**: By adding this generic provider, users can more flexibly handle requests from different suppliers without needing to make complex path modifications, lowering the usage threshold and enhancing system compatibility. + +- **Related PR**: [#3173](https://github.com/alibaba/higress/pull/3173) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: This PR adds a global parameter to the Higress Controller for controlling the enablement of the inference scaling feature. Main changes are in the `controller-deployment.yaml` and `values.yaml` files, adding new configuration items and documenting them in the `README` file. \ + **Feature Value**: The new global parameter allows users to more flexibly control the inference scaling feature in the Higress Controller, which is very useful for users who need to adjust behavior based on specific circumstances, enhancing system configurability and adaptability. + +- **Related PR**: [#3171](https://github.com/alibaba/higress/pull/3171) \ + **Contributor**: @wilsonwu \ + **Change Log**: This PR introduces support for topology distribution constraints for the gateway and controller, achieved by adding new fields in the relevant YAML configuration files. \ + **Feature Value**: The new support helps users better manage the distribution of pods within the cluster, optimizing resource usage and enhancing system high availability. + +- **Related PR**: [#3160](https://github.com/alibaba/higress/pull/3160) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: This PR upgrades the gateway API to the latest version, involving multiple modifications across several files, including `Makefile` and `go.mod`, to ensure compatibility with the latest API. \ + **Feature Value**: By introducing the latest gateway API support, users can enjoy more stable and feature-rich service mesh characteristics, enhancing system scalability and maintainability. + +- **Related PR**: [#3136](https://github.com/alibaba/higress/pull/3136) \ + **Contributor**: @Wangzy455 \ + **Change Log**: Added a tool semantic search function based on the Milvus vector database, allowing users to find the most relevant tools through natural language queries. \ + **Feature Value**: This feature enhances the system's search capabilities, enabling users to more accurately locate the required tools, enhancing user experience and work efficiency. + +- **Related PR**: [#3075](https://github.com/alibaba/higress/pull/3075) \ + **Contributor**: @rinfx \ + **Change Log**: Refactored the code to modularize, supporting multimodal input detection and image generation security checks, and fixed response anomalies in boundary conditions. \ + **Feature Value**: Enhanced the AI Security Guard's ability to handle multimodal inputs, improving system robustness and user experience, ensuring the security of content generation. + +- **Related PR**: [#3066](https://github.com/alibaba/higress/pull/3066) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: Upgraded Istio to version 1.27.1 and adjusted `higress-core` to adapt to the new version, fixing submodule branch pulling and integration testing issues. \ + **Feature Value**: By upgrading Istio and related dependencies, system stability and performance are enhanced, solving problems in the old version and providing users with more reliable services. + +- **Related PR**: [#3063](https://github.com/alibaba/higress/pull/3063) \ + **Contributor**: @rinfx \ + **Change Log**: Implemented cross-cluster and endpoint load balancing based on specified metrics, allowing users to select specific metrics for load balancing in the plugin configuration. \ + **Feature Value**: Enhances system flexibility and scalability, allowing users to optimize request distribution based on actual needs (e.g., concurrency, TTFT, RT), thereby enhancing overall service performance and response speed. + +- **Related PR**: [#3061](https://github.com/alibaba/higress/pull/3061) \ + **Contributor**: @Jing-ze \ + **Change Log**: This PR resolves multiple issues in the `response-cache` plugin and adds comprehensive unit tests. Improved cache key extraction logic, fixed interface mismatch errors, and cleaned up redundant spaces in configuration validation. \ + **Feature Value**: By enhancing the functionality and stability of the `response-cache` plugin, system performance and user experience are improved. Now supports extracting keys from request headers/bodies and caching responses, reducing the processing time for repeated requests. + +- **Related PR**: [#2825](https://github.com/alibaba/higress/pull/2825) \ + **Contributor**: @CH3CHO \ + **Change Log**: Added the `traffic-editor` plugin, supporting request and response header editing, providing a more flexible code structure to meet different needs. \ + **Feature Value**: Users can use this plugin to perform various types of modifications to request/response headers, such as deletion, renaming, etc., enhancing system flexibility and configurability. + +### 🐛 Bug Fixes (Bug Fixes) + +- **Related PR**: [#3434](https://github.com/alibaba/higress/pull/3434) \ + **Contributor**: @johnlanni \ + **Change Log**: Fixed a YAML parsing error in the frontmatter section of the SKILL file by adding double quotes to the description value to avoid misinterpreting colons as YAML syntax. \ + **Feature Value**: Resolved rendering issues caused by YAML parsing, ensuring that the skill description is displayed correctly, enhancing 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 the automatic routing mode. Ensured that the `model` field in the request body matches the routing decision after matching the target model. \ + **Feature Value**: Ensures that downstream services receive the correct model name, enhancing system consistency and accuracy, avoiding service anomalies or data processing deviations due to using the wrong model. + +- **Related PR**: [#3400](https://github.com/alibaba/higress/pull/3400) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR fixes the issue of duplicate definition of the `loadBalancerClass` field in Helm templates, resolving YAML parsing errors by removing the redundant definition. \ + **Feature Value**: Fixed the YAML parsing error when configuring `loadBalancerClass`, ensuring a more stable and reliable service deployment process. + +- **Related PR**: [#3370](https://github.com/alibaba/higress/pull/3370) \ + **Contributor**: @rinfx \ + **Change Log**: This PR fixes the issue of incorrect request body handling in the `model-mapper` when the suffix does not match, and adds JSON validation for the body content to ensure its validity. \ + **Feature Value**: By resolving unexpected request handling issues and enhancing input validation, system stability and data processing security are improved, providing a more reliable service experience to users. + +- **Related PR**: [#3341](https://github.com/alibaba/higress/pull/3341) \ + **Contributor**: @zth9 \ + **Change Log**: Fixed the issue of concurrent SSE connections returning the wrong endpoint, ensuring the correctness of the SSE server instance by updating the configuration file and filter logic. \ + **Feature Value**: Resolved the concurrent SSE connection issue encountered by users, enhancing system stability and reliability, and improving user experience. + +- **Related PR**: [#3258](https://github.com/alibaba/higress/pull/3258) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR corrects the MCP server version negotiation mechanism to comply with the specification, including updating related dependency versions. \ + **Feature Value**: By ensuring that the MCP server version negotiation complies with the specification, system compatibility and stability are enhanced, reducing potential communication errors. + +- **Related PR**: [#3257](https://github.com/alibaba/higress/pull/3257) \ + **Contributor**: @sjtuzbk \ + **Change Log**: This PR fixes the defect in the `ai-proxy` plugin where `difyApiUrl` was directly used as the host, by parsing the URL to correctly extract the hostname. \ + **Feature Value**: The fix enhances the plugin's stability and compatibility, ensuring that users can normally use the plugin when configuring custom API URLs, avoiding service interruptions due to incorrect handling. + +- **Related PR**: [#3252](https://github.com/alibaba/higress/pull/3252) \ + **Contributor**: @rinfx \ + **Change Log**: This PR adjusts the debug log messages and adds a penalty mechanism for error responses, delaying the processing of error responses to avoid interfering with service selection during load balancing. \ + **Feature Value**: Enhances the stability and reliability of cross-provider load balancing by delaying error responses to optimize the service selection process, reducing service interruptions caused by quick error returns. + +- **Related PR**: [#3251](https://github.com/alibaba/higress/pull/3251) \ + **Contributor**: @rinfx \ + **Change Log**: This PR handles the case where the content extracted from the configuration's JSONPath is empty by using `[empty content]` instead, ensuring that the program can continue to execute correctly. \ + **Feature Value**: This fix enhances system robustness, preventing potential errors or anomalies caused by empty content, thereby improving user experience and system reliability. + +- **Related PR**: [#3237](https://github.com/alibaba/higress/pull/3237) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR increases the buffer size for the request body when handling multipart data, resolving the issue of a too small buffer in the `model-router` when processing multipart form data. \ + **Feature Value**: Increasing the buffer size for handling multipart data ensures stability in scenarios like large file uploads, enhancing user experience. + +- **Related PR**: [#3225](https://github.com/alibaba/higress/pull/3225) \ + **Contributor**: @wydream \ + **Change Log**: Fixed the issue where the `basePathHandling` configuration did not work correctly when using the `protocol: original` setting. This was resolved by adjusting the request header transformation logic for multiple providers. \ + **Feature Value**: Ensures that when using the original protocol, users can correctly remove the base path prefix, enhancing the consistency and reliability of API calls, affecting over 27 service providers. + +- **Related PR**: [#3220](https://github.com/alibaba/higress/pull/3220) \ + **Contributor**: @Aias00 \ + **Change Log**: Fixed the issue where unhealthy or disabled service instances were improperly registered in Nacos, and ensured that the `AllowTools` field is always present during serialization. \ + **Feature Value**: By skipping unhealthy or disabled services, system stability and reliability are improved; ensuring consistent presentation of the `AllowTools` field avoids potential configuration misunderstandings. + +- **Related PR**: [#3211](https://github.com/alibaba/higress/pull/3211) \ + **Contributor**: @CH3CHO \ + **Change Log**: Updated the request body judgment logic in the `ai-proxy` plugin, replacing the old method of determining whether a request body exists based on `content-length` and `content-type` with the new `HasRequestBody` logic. \ + **Feature Value**: This change resolves the issue of incorrectly judging the presence of a request body under specific conditions, enhancing the accuracy of service request handling and avoiding potential data processing errors. + +- **Related PR**: [#3187](https://github.com/alibaba/higress/pull/3187) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR enables progress notifications by bypassing the handling of streamable response bodies in MCP. Specifically, it modified the `filter.go` file in the golang-filter plugin, involving small-scale adjustments to data encoding logic. \ + **Feature Value**: This change allows users to receive progress updates when using MCP for streaming, enhancing user experience and providing a more transparent data transmission process, especially useful for applications requiring real-time monitoring of transmission status. + +- **Related PR**: [#3168](https://github.com/alibaba/higress/pull/3168) \ + **Contributor**: @wydream \ + **Change Log**: Fixed the issue of query string loss during the OpenAI capability rewrite process, ensuring that query parameters are stripped and re-appended to the original path during path matching. \ + **Feature Value**: Resolved the path matching issue caused by query string interference, ensuring the correctness and stability of services like video content endpoints. + +- **Related PR**: [#3167](https://github.com/alibaba/higress/pull/3167) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: This PR updates the references to multiple submodules and simplifies the command logic for submodule initialization and update in the `Makefile`, deleting 25 lines of code and adding 8 lines. \ + **Feature Value**: By fixing submodule update issues and simplifying related scripts, the build efficiency and stability of the project are improved, ensuring users can obtain the latest dependency library versions. + +- **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 is 0 when the response does not contain an index, thus avoiding potential data loss issues. \ + **Feature Value**: This fix enhances system stability and data integrity, allowing users who rely on the `toolcall index` to more reliably handle related data, reducing errors due to missing indices. + +- **Related PR**: [#3022](https://github.com/alibaba/higress/pull/3022) \ + **Contributor**: @lwpk110 \ + **Change Log**: This PR fixes the issue of missing `podMonitorSelector` in the gateway metrics configuration, adding support for `gateway.metrics.labels` in the PodMonitor template and setting a default selector label to ensure automatic discovery by the kube-prometheus-stack monitoring system. \ + **Feature Value**: By adding support for custom selectors and setting default values, users can more flexibly configure their monitoring metrics, enhancing system observability and maintainability. + +### ♻️ Refactoring and Optimization (Refactoring) + +- **Related PR**: [#3155](https://github.com/alibaba/higress/pull/3155) \ + **Contributor**: @github-actions[bot] \ + **Change Log**: This PR updates the CRD files in the `helm` folder, adding the `routeType` field and its enumeration value definitions. \ + **Feature Value**: By updating the CRD configuration, the flexibility and extensibility of the application are enhanced, allowing users to choose different route types as needed. + +### 📚 Documentation Updates (Documentation) + +- **Related PR**: [#3442](https://github.com/alibaba/higress/pull/3442) \ + **Contributor**: @johnlanni \ + **Change Log**: Updated the `higress-clawdbot-integration` skill documentation, removing the `IMAGE_REPO` environment variable and retaining `PLUGIN_REGISTRY` as the single source. \ + **Feature Value**: Simplified the user configuration process, reducing the complexity of environment variable settings, and enhancing document consistency and usability. + +- **Related PR**: [#3441](https://github.com/alibaba/higress/pull/3441) \ + **Contributor**: @johnlanni \ + **Change Log**: Updated the skill documentation to reflect the new behavior of automatically selecting the best registry for container images and WASM plugins based on the timezone. \ + **Feature Value**: By automating timezone detection to select the best registry, the user configuration process is simplified, enhancing user experience and efficiency. + +- **Related PR**: [#3440](https://github.com/alibaba/higress/pull/3440) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds a troubleshooting guide for common errors during Higress AI Gateway API server deployment due to file descriptor limits. \ + **Feature Value**: By providing detailed troubleshooting information, users can quickly locate and fix service startup failures caused by system file descriptor limits, enhancing user experience. + +- **Related PR**: [#3439](https://github.com/alibaba/higress/pull/3439) \ + **Contributor**: @johnlanni \ + **Change Log**: This PR adds a guide for choosing geographically closer container image registries in the `higress-clawdbot-integration` SKILL documentation, including a new section on image registry selection, an environment variable table, and examples. \ + **Feature Value**: By providing a method to choose the nearest container image registry based on geographical location, this feature helps users optimize the Higress deployment process, reduce network latency, and improve user experience. + +- **Related PR**: [#3433](https://github.com/alibaba/higress/pull/3433) \ + **Contributor**: @johnlanni \ + + +# Higress Console + + +## 📋 Overview of This Release + +This release includes **18** updates, covering enhancements, bug fixes, and performance optimizations. + +### Update Distribution + +- **New Features**: 7 items +- **Bug Fixes**: 10 items +- **Documentation Updates**: 1 item + +--- + +## 📝 Complete Changelog + +### 🚀 New Features (Features) + +- **Related PR**: [#621](https://github.com/higress-group/higress-console/pull/621) \ + **Contributor**: @Thomas-Eliot \ + **Change Log**: This PR optimizes the interaction capabilities of the MCP Server, including rewriting the header host, modifying the interaction method to support transport selection, and handling special characters like @. \ + **Feature Value**: These improvements enhance the flexibility and compatibility of the MCP Server in various scenarios, making it easier for users to configure and use the MCP Server. + +- **Related PR**: [#612](https://github.com/higress-group/higress-console/pull/612) \ + **Contributor**: @zhwaaaaaa \ + **Change Log**: This PR adds ignore handling for hop-to-hop headers, particularly for the `transfer-encoding: chunked` header. It also enhances code readability and maintainability by adding comments at key points. \ + **Feature Value**: This feature resolves the issue where the Grafana page fails to work due to specific HTTP headers sent by the reverse proxy server, improving system compatibility and user experience. + +- **Related PR**: [#608](https://github.com/higress-group/higress-console/pull/608) \ + **Contributor**: @Libres-coder \ + **Change Log**: This PR adds plugin display support to the AI route management page, allowing users to view enabled plugins and see the "Enabled" label on the configuration page. \ + **Feature Value**: This enhancement improves the functional consistency and user experience of the AI route management page, enabling users to more intuitively manage and view enabled plugins in the AI route. + +- **Related PR**: [#604](https://github.com/higress-group/higress-console/pull/604) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR introduces support for path rewriting using regular expressions, implemented through the new `higress.io/rewrite-target` annotation, with corresponding code and test updates in relevant files. \ + **Feature Value**: The new feature allows users to flexibly define path rewriting rules using regular expressions, significantly enhancing the flexibility and functionality of application routing configurations, making it easier for developers to customize request paths as needed. + +- **Related PR**: [#603](https://github.com/higress-group/higress-console/pull/603) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR adds a feature to display a fixed service port 80 in the static service source settings, achieved by defining a constant in the code and updating the form component. \ + **Feature Value**: Adding the display of a fixed service port 80 helps users better understand and configure static service sources, improving the user experience. + +- **Related PR**: [#602](https://github.com/higress-group/higress-console/pull/602) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR implements search functionality in the process of selecting upstream services on the AI route configuration page, enhancing the interactivity and usability of the user interface. \ + **Feature Value**: The added search function enables users to quickly and accurately find the required upstream services, greatly improving configuration efficiency and user experience. + +- **Related PR**: [#566](https://github.com/higress-group/higress-console/pull/566) \ + **Contributor**: @OuterCyrex \ + **Change Log**: Adds support for custom Qwen services, including enabling internet search and uploading file IDs. \ + **Feature Value**: This enhancement increases the flexibility and functionality of the system, allowing users to configure custom Qwen services to meet more personalized needs. + +### 🐛 Bug Fixes (Bug Fixes) + +- **Related PR**: [#620](https://github.com/higress-group/higress-console/pull/620) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR fixes a spelling error in the `sortWasmPluginMatchRules` logic, ensuring the correctness and readability of the code. \ + **Feature Value**: By correcting the spelling error, the code quality is improved, reducing potential misunderstandings and maintenance costs, and enhancing the user experience. + +- **Related PR**: [#619](https://github.com/higress-group/higress-console/pull/619) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR removes version information from the data JSON when converting AiRoute to ConfigMap. This information is already stored in the ConfigMap metadata and does not need to be duplicated in the JSON. \ + **Feature Value**: Avoiding redundant information storage makes the data structure clearer and more reasonable, which helps improve the consistency and efficiency of configuration management, reducing potential data inconsistencies. + +- **Related PR**: [#618](https://github.com/higress-group/higress-console/pull/618) \ + **Contributor**: @CH3CHO \ + **Change Log**: Refactors the API authentication logic in the SystemController, eliminating security vulnerabilities. Adds the `AllowAnonymous` annotation and adjusts the `ApiStandardizationAspect` class to support the new authentication logic. \ + **Feature Value**: Fixes the security vulnerabilities in the SystemController, enhancing system security and protecting user data from unauthorized access. + +- **Related PR**: [#617](https://github.com/higress-group/higress-console/pull/617) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR fixes multiple errors in the front-end console, including missing unique key attributes for list items, issues with loading images that violate the content security policy, and incorrect type for the `Consumer.name` field. \ + **Feature Value**: By resolving these front-end errors, the stability and user experience of the application are improved. This helps reduce issues encountered by developers during debugging and ensures the application runs as expected. + +- **Related PR**: [#614](https://github.com/higress-group/higress-console/pull/614) \ + **Contributor**: @lc0138 \ + **Change Log**: Fixes an error in the type of the `type` field in the `ServiceSource` class by adding dictionary value validation to ensure the correct type. \ + **Feature Value**: This fix improves the stability and data accuracy of the system, preventing service anomalies due to type mismatches and enhancing the user experience. + +- **Related PR**: [#613](https://github.com/higress-group/higress-console/pull/613) \ + **Contributor**: @lc0138 \ + **Change Log**: This PR strengthens the content security policy (CSP) by modifying the front-end configuration, preventing cross-site scripting attacks and other security threats, ensuring the application is more secure and reliable. \ + **Feature Value**: Enhances the security of the front-end application, effectively defending against common web security attacks, protecting user data from unauthorized access or tampering, and improving user experience and trust. + +- **Related PR**: [#611](https://github.com/higress-group/higress-console/pull/611) \ + **Contributor**: @qshuai \ + **Change Log**: This PR fixes a spelling error in the controller API title in the `LlmProvidersController.java` file, ensuring consistency between the documentation and the code. \ + **Feature Value**: Fixing the title spelling error improves the accuracy and readability of the API documentation, helping developers better understand and use the relevant interfaces. + +- **Related PR**: [#609](https://github.com/higress-group/higress-console/pull/609) \ + **Contributor**: @CH3CHO \ + **Change Log**: This PR corrects the type of the `name` field in the `Consumer` interface from boolean to string, ensuring the accuracy of the type definition. \ + **Feature Value**: By fixing the type definition error, the code quality and maintainability are improved, reducing potential runtime errors and enhancing the developer experience. + +- **Related PR**: [#605](https://github.com/higress-group/higress-console/pull/605) \ + **Contributor**: @SaladDay \ + **Change Log**: Fixes the AI route name validation rules to support dot characters and unifies them to allow only lowercase letters. Also updates the error messages in both Chinese and English to accurately reflect the new validation logic. \ + **Feature Value**: Resolves the inconsistency between the UI prompt and backend validation logic, improving the consistency and accuracy of the user experience, ensuring users can correctly enter AI route names according to the latest rules. + +- **Related PR**: [#552](https://github.com/higress-group/higress-console/pull/552) \ + **Contributor**: @lcfang \ + **Change Log**: Adds the `vport` attribute to fix the issue of route configuration failure when the service instance port changes. By adding the `vport` attribute in the registry configuration, it ensures that changes to the backend service port do not affect the route. \ + **Feature Value**: Solves the compatibility issue caused by changes in the service instance port, enhancing the stability and user experience of the system, ensuring that services remain accessible even if the backend instance port changes. + +### 📚 Documentation Updates (Documentation) + +- **Related PR**: [#610](https://github.com/higress-group/higress-console/pull/610) \ + **Contributor**: @heimanba \ + **Change Log**: Updates the required and associated explanations for the document configuration fields, including changing the `rewrite` fields to optional and correcting some description texts. \ + **Feature Value**: By adjusting the field descriptions in the documentation, the configuration flexibility and compatibility are improved, helping users better understand and use the front-end canary plugin. + +--- + +## 📊 Release Statistics + +- 🚀 New Features: 7 items +- 🐛 Bug Fixes: 10 items +- 📚 Documentation Updates: 1 item + +**Total**: 18 changes + +Thank you to all contributors for their hard work! 🎉 + diff --git a/release-notes/2.1.10/README_ZH.md b/release-notes/2.1.10/README_ZH.md new file mode 100644 index 000000000..f8b3c60a0 --- /dev/null +++ b/release-notes/2.1.10/README_ZH.md @@ -0,0 +1,590 @@ +# Higress + + +## 📋 本次发布概览 + +本次发布包含 **84** 项更新,涵盖了功能增强、Bug修复、性能优化等多个方面。 + +### 更新内容分布 + +- **新功能**: 46项 +- **Bug修复**: 18项 +- **重构优化**: 1项 +- **文档更新**: 18项 +- **测试改进**: 1项 + +--- + +## 📝 完整变更日志 + +### 🚀 新功能 (Features) + +- **Related PR**: [#3438](https://github.com/alibaba/higress/pull/3438) \ + **Contributor**: @johnlanni \ + **Change Log**: 该PR通过调整文档结构、精简内容和新增Clawdbot插件支持,实现了对Higress-clawdbot-integration技能的显著改进。 \ + **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集成的SKILL提供商列表,并将OpenClaw插件包从higress-standalone迁移到主higress仓库。 \ + **Feature Value**: 通过增强提供商列表和迁移插件包,用户可以更容易地访问常用提供商,提高集成效率和用户体验。 + +- **Related PR**: [#3428](https://github.com/alibaba/higress/pull/3428) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR为Higress AI Gateway和Clawdbot集成添加了两项新技能:自动模型路由配置和通过CLI参数部署网关。支持多语言触发词并可热加载配置。 \ + **Feature Value**: 新增的功能使得用户能够更灵活地管理AI模型的流量分配,同时简化了与Clawdbot的集成过程,提升了系统的可用性和易用性。 + +- **Related PR**: [#3427](https://github.com/alibaba/higress/pull/3427) \ + **Contributor**: @johnlanni \ + **Change Log**: 增加了`use_default_attributes`配置选项,当设置为`true`时,插件将自动应用一组默认属性,简化了用户配置过程。 \ + **Feature Value**: 此功能使ai-statistics插件更加易于使用,特别是对于常见用例减少了手动配置工作量,同时保持了完全的可配置性。 + +- **Related PR**: [#3426](https://github.com/alibaba/higress/pull/3426) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增Agent Session Monitor技能,支持实时监控Higress访问日志,追踪多轮对话会话ID与token使用情况。 \ + **Feature Value**: 通过提供对LLM在Higress环境中的实时可见性,帮助用户更好地理解和优化其AI助手的性能和成本。 + +- **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-statistics插件添加了会话ID跟踪功能,支持用户通过自定义头或默认头来追踪多轮对话。 \ + **Feature Value**: 新增的会话ID跟踪能力有助于更好地分析和理解多轮对话流程,提升了用户体验及系统的可追溯性。 + +- **Related PR**: [#3417](https://github.com/alibaba/higress/pull/3417) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR为nginx到Higress迁移工具添加了关键警告和指南,包括对不支持的片段注释的明确警告以及预迁移检查命令。 \ + **Feature Value**: 通过提供关于不支持配置项的明确警告及预迁移检查方法,帮助用户识别可能的问题点,从而更顺利地完成从Nginx到Higress的迁移过程。 + +- **Related PR**: [#3411](https://github.com/alibaba/higress/pull/3411) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增了一个全面的技能,用于在Kubernetes环境中从ingress-nginx迁移到Higress。包括分析脚本、迁移测试生成器以及插件骨架生成等工具。 \ + **Feature Value**: 该功能极大地简化了用户从ingress-nginx到Higress的迁移过程,通过提供详细的兼容性分析和自动化工具降低了迁移难度,提升了用户体验。 + +- **Related PR**: [#3409](https://github.com/alibaba/higress/pull/3409) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR在ai-proxy插件中新增了contextCleanupCommands配置项,允许用户定义清除对话上下文的命令。当用户消息完全匹配到某个清理命令时,将移除该命令之前的所有非系统消息。 \ + **Feature Value**: 这个新功能使用户能够通过发送特定命令来主动清除之前的对话记录,从而更好地控制对话历史,提高了用户体验和隐私保护能力。 + +- **Related PR**: [#3404](https://github.com/alibaba/higress/pull/3404) \ + **Contributor**: @johnlanni \ + **Change Log**: 为Claude AI助手新增了自动生成Higress社区治理日报的能力,包括自动追踪GitHub活动、进度跟踪、知识沉淀等功能。 \ + **Feature Value**: 该功能通过自动化生成日报来帮助社区管理者更好地了解项目动态和问题进展,促进问题解决效率,提升整体社区治理水平。 + +- **Related PR**: [#3403](https://github.com/alibaba/higress/pull/3403) \ + **Contributor**: @johnlanni \ + **Change Log**: 实现了一个新的自动路由功能,根据用户消息内容和预设的正则规则来动态选择合适的模型处理请求。 \ + **Feature Value**: 通过此功能,用户可以更灵活地配置服务以自动识别并响应不同类型的消息,减少了手动指定模型的需求,提高了系统的智能化水平。 + +- **Related PR**: [#3402](https://github.com/alibaba/higress/pull/3402) \ + **Contributor**: @johnlanni \ + **Change Log**: 新增了Claude技能,用于使用Go 1.24+开发Higress WASM插件。涵盖了HTTP客户端、Redis客户端等参考文档及本地测试指南。 \ + **Feature Value**: 为开发者提供了详细的指导和示例代码,便于他们创建、修改或调试基于Higress网关的WASM插件,提升了开发效率与体验。 + +- **Related PR**: [#3394](https://github.com/alibaba/higress/pull/3394) \ + **Contributor**: @changsci \ + **Change Log**: 此PR通过在请求头中获取API密钥来扩展了现有的认证机制,特别是在provider.apiTokens未配置的情况下,从而增强了系统的灵活性。 \ + **Feature Value**: 这项新功能使用户能够更灵活地管理和传递API密钥,即使在直接配置缺失时也能保证服务的正常访问,提升了用户体验和安全性。 + +- **Related PR**: [#3384](https://github.com/alibaba/higress/pull/3384) \ + **Contributor**: @ThxCode-Chen \ + **Change Log**: 在watcher.go文件中添加了支持上游IPv6静态地址的功能,涉及31行新增代码和9行删除代码,主要改动集中在处理服务条目生成逻辑。 \ + **Feature Value**: 新增对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 AI原生API的支持,允许直接调用第三方托管模型API,并享受自动OAuth认证,提升了开发灵活性和安全性。 + +- **Related PR**: [#3367](https://github.com/alibaba/higress/pull/3367) \ + **Contributor**: @rinfx \ + **Change Log**: 更新了wasm-go依赖版本,并引入Foreign Function,使Wasm插件能够实时感知Envoy宿主的日志等级。通过将日志等级检查前置,在不匹配时避免不必要的内存操作。 \ + **Feature Value**: 提升了系统性能,特别是在处理大量日志数据时,减少了内存消耗和CPU使用率,提高了响应速度和资源利用率。 + +- **Related PR**: [#3342](https://github.com/alibaba/higress/pull/3342) \ + **Contributor**: @Aias00 \ + **Change Log**: 该PR实现了在watcher中将Nacos实例权重映射到Istio WorkloadEntry权重的功能,通过引入math库处理权重转换。 \ + **Feature Value**: 此功能使得用户能够更灵活地控制服务间的流量分配,提高系统的可配置性和灵活性,增强了与Istio的集成能力。 + +- **Related PR**: [#3335](https://github.com/alibaba/higress/pull/3335) \ + **Contributor**: @wydream \ + **Change Log**: 本PR为ai-proxy插件的Vertex AI Provider添加了图片生成支持,实现了OpenAI SDK与Vertex AI图像生成功能的兼容。 \ + **Feature Value**: 新增的图片生成功能使用户能够通过标准的OpenAI接口调用Vertex AI服务,简化了跨平台开发流程,提升了用户体验。 + +- **Related PR**: [#3324](https://github.com/alibaba/higress/pull/3324) \ + **Contributor**: @wydream \ + **Change Log**: 本PR为ai-proxy插件的Vertex AI Provider添加了OpenAI-compatible端点支持,实现了对Vertex AI模型的直接调用功能。 \ + **Feature Value**: 通过引入OpenAI-compatible模式,开发者可以使用熟悉的OpenAI SDK和API格式与Vertex AI进行交互,简化了集成过程,提高了开发效率。 + +- **Related PR**: [#3318](https://github.com/alibaba/higress/pull/3318) \ + **Contributor**: @hanxiantao \ + **Change Log**: 该PR通过使用withConditionalAuth中间件将Istio的原生认证逻辑应用于调试端点,同时保留基于DebugAuth功能标志的现有行为。 \ + **Feature Value**: 新增了对调试端点的身份验证支持,提高了系统的安全性,使得只有授权用户才能访问这些关键调试接口,从而保护系统免受未授权访问。 + +- **Related PR**: [#3317](https://github.com/alibaba/higress/pull/3317) \ + **Contributor**: @rinfx \ + **Change Log**: 新增了两个WASM-Go插件:model-mapper和model-router,分别实现了基于LLM协议中model参数的映射与路由功能。 \ + **Feature Value**: 增强了Higress在处理大规模语言模型时的能力,通过灵活配置可以优化请求路径及模型使用,提升系统灵活性与性能。 + +- **Related PR**: [#3305](https://github.com/alibaba/higress/pull/3305) \ + **Contributor**: @CZJCC \ + **Change Log**: 为AWS Bedrock提供商添加了Bearer Token认证支持,同时保留了现有的AWS SigV4认证方式,并对相关配置和请求头处理进行了调整。 \ + **Feature Value**: 新增的Bearer Token认证方法为用户提供了更多灵活性,使得在使用AWS Bedrock服务时可以更方便地选择合适的认证机制,提升了用户体验。 + +- **Related PR**: [#3301](https://github.com/alibaba/higress/pull/3301) \ + **Contributor**: @wydream \ + **Change Log**: 本 PR 在 ai-proxy 插件的 Vertex AI Provider 中实现了 Express Mode 支持,简化了开发者使用 Vertex AI 的认证流程,仅需 API Key 即可。 \ + **Feature Value**: 通过引入 Express Mode 功能,用户可以更便捷地开始使用 Vertex AI,无需进行复杂的 Service Account 配置,提升了开发者的效率和体验。 + +- **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**: 新增了hgctl agent模块,包括基础功能实现和相关服务的集成,同时更新了go.mod和go.sum文件以支持新依赖。 \ + **Feature Value**: 通过引入hgctl agent模块,为用户提供了一种新的管理和控制方式,增强了系统的灵活性和可操作性,提升了用户体验。 + +- **Related PR**: [#3261](https://github.com/alibaba/higress/pull/3261) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR为gemini-2.5-flash和gemini-2.5-flash-lite增加了关闭thinking的功能,并在响应中加入了reasoning token信息,使用户能够更好地控制AI的行为并了解其工作细节。 \ + **Feature Value**: 通过允许用户选择是否启用thinking功能以及展示reasoning token使用情况,增强了系统的灵活性与透明度,帮助开发者更有效地调试及优化AI应用程序。 + +- **Related PR**: [#3255](https://github.com/alibaba/higress/pull/3255) \ + **Contributor**: @nixidexiangjiao \ + **Change Log**: 优化了基于Lua的最小在途请求数负载均衡策略,解决了异常节点偏好选择、新节点处理不一致及采样分布不均的问题。 \ + **Feature Value**: 提高了系统的稳定性和服务可用性,减少了异常节点导致的故障放大效应,并增强了对新节点的支持和流量均匀分配。 + +- **Related PR**: [#3236](https://github.com/alibaba/higress/pull/3236) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR通过在vertex中添加对claude模型的支持并处理了delta可能为空的情况,增加了系统的兼容性和稳定性。 \ + **Feature Value**: 新增了对vertex中claude模型的支持,使得用户能够利用更广泛的AI模型进行开发与研究,提升了系统的灵活性和实用性。 + +- **Related PR**: [#3218](https://github.com/alibaba/higress/pull/3218) \ + **Contributor**: @johnlanni \ + **Change Log**: 增加了基于请求计数和内存使用的自动重建触发机制,并扩展了支持的路径后缀,包括/rerank和/messages。 \ + **Feature Value**: 这些改进提升了系统的稳定性和响应速度,通过自动重建可以有效应对高负载或内存不足的情况,同时增强了对新功能的支持。 + +- **Related PR**: [#3213](https://github.com/alibaba/higress/pull/3213) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR更新了vertex.go文件,将之前基于具体区域的访问方式改为支持全局访问,以兼容仅支持全球模式的新模型。 \ + **Feature Value**: 增加了对global区域的支持后,用户可以更方便地使用如gemini-3系列这样的新模型,无需指定具体的地理区域。 + +- **Related PR**: [#3206](https://github.com/alibaba/higress/pull/3206) \ + **Contributor**: @rinfx \ + **Change Log**: 本次PR主要增加了对请求体中的prompt和图片内容进行安全检查的支持,特别是在使用OpenAI和Qwen生成图片时。通过增强parseOpenAIRequest函数来解析图像数据,并完善了相关处理逻辑。 \ + **Feature Value**: 新增的安全检查功能提高了系统在处理图片生成请求时的安全性,有助于防止潜在的恶意内容传播,为用户提供更安全可靠的服务体验。 + +- **Related PR**: [#3200](https://github.com/alibaba/higress/pull/3200) \ + **Contributor**: @YTGhost \ + **Change Log**: 此PR在ai-proxy插件中增加了对数组内容的支持,通过修改bedrock.go文件的相关逻辑,实现了当content为数组时的正确处理。 \ + **Feature Value**: 增强了ai-proxy插件处理消息的能力,使得现在可以正确支持和转换数组形式的内容,这将让聊天工具的消息传递更加灵活多样。 + +- **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中添加编译选项以及在doubao.go和provider.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向Higress Controller添加了一个全局参数,用于控制推理扩展功能的启用。主要变更位于`controller-deployment.yaml`和`values.yaml`文件中,增加了新的配置项,并在README文件中添加了相应的文档说明。 \ + **Feature Value**: 新增的全局参数允许用户更灵活地控制Higress Controller中的推理扩展功能,这对于需要根据具体情况调整行为的用户来说非常有用,可以提高系统的可配置性和适应性。 + +- **Related PR**: [#3171](https://github.com/alibaba/higress/pull/3171) \ + **Contributor**: @wilsonwu \ + **Change Log**: 此PR引入了对网关和控制器的拓扑分布约束支持,通过在相关YAML配置文件中添加新的字段来实现。 \ + **Feature Value**: 新增的支持能够帮助用户更好地管理集群内Pod的分布情况,从而优化资源使用和提升系统的高可用性。 + +- **Related PR**: [#3160](https://github.com/alibaba/higress/pull/3160) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 此PR将网关API升级到最新版本,涉及到了Makefile、go.mod等多个文件的多处修改,以确保与最新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**: 重构了代码实现模块化,支持多模态输入检测与图片生成安全检查,并修复了边界情况下的响应异常问题。 \ + **Feature Value**: 增强了AI安全卫士处理多模态输入的能力,提升了系统的鲁棒性和用户体验,确保了内容生成的安全性。 + +- **Related PR**: [#3066](https://github.com/alibaba/higress/pull/3066) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 升级Istio版本至1.27.1,并调整higress-core以适配新版本,修复了子模块分支拉取和集成测试问题。 \ + **Feature Value**: 通过升级Istio版本和相关依赖,提升了系统的稳定性和性能,解决了旧版本存在的问题,为用户提供更可靠的服务。 + +- **Related PR**: [#3063](https://github.com/alibaba/higress/pull/3063) \ + **Contributor**: @rinfx \ + **Change Log**: 实现了基于指定指标的跨集群和端点负载均衡功能,用户可在插件配置中选择用于负载均衡的具体指标。 \ + **Feature Value**: 增强了系统的灵活性与可扩展性,允许用户根据实际需求(如并发数、TTFT、RT等)优化请求分配,从而提升整体服务性能和响应速度。 + +- **Related PR**: [#3061](https://github.com/alibaba/higress/pull/3061) \ + **Contributor**: @Jing-ze \ + **Change Log**: 本PR解决了response-cache插件中的多个问题,并增加了全面的单元测试。改进了缓存键提取逻辑,修复了接口不匹配错误,清理了配置验证中的多余空格。 \ + **Feature Value**: 通过增强响应缓存插件的功能和稳定性,提高了系统的性能和用户体验。现在支持从请求头/请求体中提取key并缓存响应,减少了重复请求的处理时间。 + +- **Related PR**: [#2825](https://github.com/alibaba/higress/pull/2825) \ + **Contributor**: @CH3CHO \ + **Change Log**: 新增了`traffic-editor`插件,支持请求和响应头的编辑功能,提供更灵活的代码结构以适应不同的需求。 \ + **Feature Value**: 用户可以通过此插件对请求/响应头进行多种类型的修改,如删除、重命名等,提高了系统的灵活性与可配置性。 + +### 🐛 Bug修复 (Bug Fixes) + +- **Related PR**: [#3434](https://github.com/alibaba/higress/pull/3434) \ + **Contributor**: @johnlanni \ + **Change Log**: 修正了技能文件中frontmatter部分的YAML解析错误,通过为描述值添加双引号来避免冒号被误解析为YAML语法。 \ + **Feature Value**: 解决了因YAML解析导致的渲染问题,确保了技能描述能够正确显示,提升了用户体验和文档准确性。 + +- **Related PR**: [#3422](https://github.com/alibaba/higress/pull/3422) \ + **Contributor**: @johnlanni \ + **Change Log**: 修正了model-router插件在自动路由模式下,请求体中的model字段未更新的问题。通过匹配确定目标模型后,确保请求体的model字段与路由决策一致。 \ + **Feature Value**: 确保下游服务接收到正确的模型名称,提升了系统的一致性和准确性,避免因使用错误模型而导致的服务异常或数据处理偏差。 + +- **Related PR**: [#3400](https://github.com/alibaba/higress/pull/3400) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR修复了在Helm模板中重复定义loadBalancerClass字段的问题,通过移除多余的定义解决了YAML解析错误。 \ + **Feature Value**: 修复了配置loadBalancerClass时出现的YAML解析错误,确保服务部署过程更加稳定可靠。 + +- **Related PR**: [#3370](https://github.com/alibaba/higress/pull/3370) \ + **Contributor**: @rinfx \ + **Change Log**: 此PR修复了model-mapper中后缀不匹配时错误处理请求body的问题,并添加了对body内容的json验证,确保其有效性。 \ + **Feature Value**: 通过解决非预期的请求处理问题并增强输入验证,提高了系统的稳定性和数据处理的安全性,为用户提供更可靠的服务体验。 + +- **Related PR**: [#3341](https://github.com/alibaba/higress/pull/3341) \ + **Contributor**: @zth9 \ + **Change Log**: 修复了并发SSE连接返回错误端点的问题,通过更新配置文件及过滤器中的逻辑来确保SSE服务器实例的正确性。 \ + **Feature Value**: 解决了用户在使用过程中遇到的并发SSE连接问题,提高了系统的稳定性和可靠性,增强了用户体验。 + +- **Related PR**: [#3258](https://github.com/alibaba/higress/pull/3258) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR修正了MCP服务器版本协商机制,使其符合规范要求。具体改动包括更新相关依赖版本。 \ + **Feature Value**: 通过确保MCP服务器版本协商符合规范,提高了系统的兼容性和稳定性,减少了潜在的通信错误。 + +- **Related PR**: [#3257](https://github.com/alibaba/higress/pull/3257) \ + **Contributor**: @sjtuzbk \ + **Change Log**: 该PR修复了ai-proxy插件直接将difyApiUrl作为host使用的缺陷,通过解析URL来正确提取hostname。 \ + **Feature Value**: 修复后提高了插件的稳定性和兼容性,确保用户在配置自定义API URL时能够正常工作,避免因错误处理导致的服务中断。 + +- **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**: 当根据配置中的jsonpath提取的内容为空时,该PR通过使用`[empty content]`替代空内容来处理这种情况,确保了程序能够正确地继续执行。 \ + **Feature Value**: 此修复提高了系统的健壮性,防止因提取内容为空而导致的潜在错误或异常,从而提升了用户体验和系统的可靠性。 + +- **Related PR**: [#3237](https://github.com/alibaba/higress/pull/3237) \ + **Contributor**: @CH3CHO \ + **Change Log**: 该PR通过增加处理multipart数据时请求体缓冲区大小,解决了在model-router中处理多部分表单数据时可能出现的缓冲区过小问题。 \ + **Feature Value**: 增大了处理multipart数据时请求体的缓冲区大小,确保了大文件上传等场景下的稳定性,提升了用户体验。 + +- **Related PR**: [#3225](https://github.com/alibaba/higress/pull/3225) \ + **Contributor**: @wydream \ + **Change Log**: 修正了当使用`protocol: original`设置时,`basePathHandling`配置未能正确工作的问题。通过调整多个提供商的请求头转换逻辑来修复此问题。 \ + **Feature Value**: 确保在使用原始协议时,用户能够正确地移除基本路径前缀,从而提高了API调用的一致性和可靠性,影响超过27个服务提供商。 + +- **Related PR**: [#3220](https://github.com/alibaba/higress/pull/3220) \ + **Contributor**: @Aias00 \ + **Change Log**: 修复了Nacos中不健康或禁用的服务实例被不当注册的问题,并确保`AllowTools`字段在序列化时始终存在。 \ + **Feature Value**: 通过跳过不健康或禁用的服务,提高了系统的稳定性和可靠性;同时保证了`AllowTools`字段的一致性呈现,避免了潜在的配置误解。 + +- **Related PR**: [#3211](https://github.com/alibaba/higress/pull/3211) \ + **Contributor**: @CH3CHO \ + **Change Log**: 更新了ai-proxy插件中请求体判断逻辑,将旧的根据content-length和content-type来决定是否有请求体的方式替换为新的HasRequestBody逻辑。 \ + **Feature Value**: 此更改解决了特定条件下误判请求体存在的问题,提高了服务处理请求时的准确性,避免了潜在的数据处理错误。 + +- **Related PR**: [#3187](https://github.com/alibaba/higress/pull/3187) \ + **Contributor**: @CH3CHO \ + **Change Log**: 该PR通过绕过MCP可流式传输的响应体处理,使得进度通知成为可能。具体来说,它在golang-filter插件中修改了filter.go文件,涉及到了对数据编码逻辑的小范围调整。 \ + **Feature Value**: 此更改允许用户在使用MCP进行流式传输时接收进度更新,从而增强了用户体验并提供了更透明的数据传输过程。对于需要实时监控传输状态的应用场景特别有用。 + +- **Related PR**: [#3168](https://github.com/alibaba/higress/pull/3168) \ + **Contributor**: @wydream \ + **Change Log**: 修复了OpenAI能力重写过程中查询字符串丢失的问题,确保在路径匹配时剥离查询参数再拼接回原路径。 \ + **Feature Value**: 解决了因查询字符串干扰导致的路径匹配问题,保证了如视频内容端点等服务的正确性和稳定性。 + +- **Related PR**: [#3167](https://github.com/alibaba/higress/pull/3167) \ + **Contributor**: @EndlessSeeker \ + **Change Log**: 此PR更新了多个子模块的引用,并简化了Makefile中关于子模块初始化和更新的命令逻辑,总共删除了25行代码并添加了8行。 \ + **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的用户而言,能够更可靠地处理相关数据,减少因缺失index导致的错误。 + +- **Related PR**: [#3022](https://github.com/alibaba/higress/pull/3022) \ + **Contributor**: @lwpk110 \ + **Change Log**: 此PR修复了gateway metrics配置中缺少podMonitorSelector的问题,为PodMonitor模板增加了对`gateway.metrics.labels`的支持,并设置了默认的选择器标签以确保被kube-prometheus-stack监控系统自动发现。 \ + **Feature Value**: 通过增加对自定义选择器的支持和设置默认值,用户可以更灵活地配置其监控指标,从而提高系统的可观察性和维护性。 + +### ♻️ 重构优化 (Refactoring) + +- **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**: [#3442](https://github.com/alibaba/higress/pull/3442) \ + **Contributor**: @johnlanni \ + **Change Log**: 更新了higress-clawdbot-integration技能文档,移除了环境变量`IMAGE_REPO`,仅保留`PLUGIN_REGISTRY`作为单一来源。 \ + **Feature Value**: 简化了用户配置过程,减少了环境变量设置的复杂性,提高了文档的一致性和易用性。 + +- **Related PR**: [#3441](https://github.com/alibaba/higress/pull/3441) \ + **Contributor**: @johnlanni \ + **Change Log**: 更新了技能文档,以反映基于时区自动选择容器镜像和WASM插件的最佳注册表的新行为。 \ + **Feature Value**: 通过自动化时区检测来选择最佳注册表,简化了用户配置流程,提高了用户体验和效率。 + +- **Related PR**: [#3440](https://github.com/alibaba/higress/pull/3440) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR增加了关于解决Higress AI Gateway API服务器部署时由于文件描述符限制导致的常见错误的故障排除指南。 \ + **Feature Value**: 通过提供详细的故障排除信息,帮助用户快速定位和修复因系统文件描述符限制导致的服务启动失败问题,提升了用户体验。 + +- **Related PR**: [#3439](https://github.com/alibaba/higress/pull/3439) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR在higress-clawdbot-integration SKILL文档中增加了地理上更接近的容器镜像仓库选择指南,包括新增了镜像仓库选择部分、环境变量表以及示例。 \ + **Feature Value**: 通过提供根据地理位置选择最近的容器镜像仓库的方法,该功能帮助用户优化Higress部署流程,减少网络延迟,提升使用体验。 + +- **Related PR**: [#3433](https://github.com/alibaba/higress/pull/3433) \ + **Contributor**: @johnlanni \ + **Change Log**: 优化了higress-auto-router技能文档,包括添加YAML前言、移动触发条件至前言、移除冗余部分并提高了清晰度。 \ + **Feature Value**: 通过遵循Clawdbot最佳实践更新文档结构,使技能更易于理解和触发,提升了用户体验。 + +- **Related PR**: [#3432](https://github.com/alibaba/higress/pull/3432) \ + **Contributor**: @johnlanni \ + **Change Log**: 优化了`higress-clawdbot-integration`技能文档,使其遵循Clawdbot的最佳实践,包括添加适当的YAML frontmatter、移除冗余部分、提高清晰度。 \ + **Feature Value**: 通过改进文档结构和内容,使用户更容易理解和使用Higress AI Gateway与Clawdbot集成的功能,提升了用户体验。 + +- **Related PR**: [#3431](https://github.com/alibaba/higress/pull/3431) \ + **Contributor**: @johnlanni \ + **Change Log**: 更新了higress-clawdbot-integration SKILL.md文档,添加了关于新的config子命令及其热重载支持的说明。 \ + **Feature Value**: 通过新增的config子命令文档,用户能够更方便地管理和更新API密钥,并且支持热重载,提升了操作便捷性和系统灵活性。 + +- **Related PR**: [#3418](https://github.com/alibaba/higress/pull/3418) \ + **Contributor**: @johnlanni \ + **Change Log**: 优化了nginx-to-higress迁移文档,新增英文版README并保留中文版本,同时强调了简易模式下的零配置迁移优势。 \ + **Feature Value**: 提升了文档的多语言支持及可读性,帮助用户更清晰地理解迁移过程中的核心优势和步骤,增强用户体验。 + +- **Related PR**: [#3416](https://github.com/alibaba/higress/pull/3416) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR增加了从Nginx Ingress到Higress网关迁移的详细文档,包括配置兼容性、逐步迁移策略及WASM插件开发等实用案例。 \ + **Feature Value**: 为用户提供了一站式的迁移指南,降低迁移难度和风险,提升用户体验,并加速迁移过程中的问题解决。 + +- **Related PR**: [#3405](https://github.com/alibaba/higress/pull/3405) \ + **Contributor**: @johnlanni \ + **Change Log**: 修正了README文档中的错误表述,将所有错误引用从Claude更正为Clawdbot,并更新了相关描述和使用方式。 \ + **Feature Value**: 确保文档准确无误,避免用户误解,正确传达了skill的设计目的与实际应用场景。 + +- **Related PR**: [#3250](https://github.com/alibaba/higress/pull/3250) \ + **Contributor**: @firebook \ + **Change Log**: 此PR更新了ADOPTERS.md文件中关于vipshop使用情况的描述,保持项目文档与实际情况一致。 \ + **Feature Value**: 通过确保ADOPTERS.md中的信息准确无误,帮助社区成员了解哪些组织正在使用该项目,增强项目的可信度和影响力。 + +- **Related PR**: [#3249](https://github.com/alibaba/higress/pull/3249) \ + **Contributor**: @zzjin \ + **Change Log**: 此PR在ADOPTERS.md文件中添加了labring作为新的采用者,更新了项目的采用者列表。 \ + **Feature Value**: 通过展示更多项目采用者,增加了社区的透明度和可信度,有助于吸引新用户和贡献者加入。 + +- **Related PR**: [#3244](https://github.com/alibaba/higress/pull/3244) \ + **Contributor**: @maplecap \ + **Change Log**: 该PR在ADOPTERS.md文件中添加了快手作为Higress项目的新采纳者,更新了文档以反映这一变化。 \ + **Feature Value**: 通过将快手加入到项目的采纳者列表中,增强了该项目对外展示的可信度和影响力,同时也为潜在用户提供了更多参考案例。 + +- **Related PR**: [#3241](https://github.com/alibaba/higress/pull/3241) \ + **Contributor**: @qshuai \ + **Change Log**: 修正了ai-token-ratelimit插件文档中的一个错误配置项,确保文档准确反映插件功能。 \ + **Feature Value**: 通过移除文档中不再使用的配置项,帮助用户更好地理解和使用ai-token-ratelimit插件,避免因文档误导而产生的混淆。 + +- **Related PR**: [#3234](https://github.com/alibaba/higress/pull/3234) \ + **Contributor**: @firebook \ + **Change Log**: 此PR在ADOPTERS.md文件中添加了vipshop作为Higress项目的采用者之一。 \ + **Feature Value**: 通过将vipshop加入到项目采用者列表中,增强了社区对Higress的认可度,并向潜在用户展示了该软件的广泛应用。 + +- **Related PR**: [#3233](https://github.com/alibaba/higress/pull/3233) \ + **Contributor**: @CH3CHO \ + **Change Log**: 该PR将Trip.com添加到了Higress项目的采用者列表中,更新了ADOPTERS.md文件。 \ + **Feature Value**: 增强了项目信誉度,展示了更多知名公司对该开源项目的认可与支持,有助于吸引更多潜在用户和贡献者。 + +- **Related PR**: [#3231](https://github.com/alibaba/higress/pull/3231) \ + **Contributor**: @johnlanni \ + **Change Log**: 此PR添加了一个新的ADOPTERS.md文件,用于记录和展示采用Higress项目的组织名单。 \ + **Feature Value**: 通过列出使用Higress的组织,可以提高项目的知名度和信任度,同时也为潜在用户提供了参考案例,有助于社区建设和推广。 + +- **Related PR**: [#3129](https://github.com/alibaba/higress/pull/3129) \ + **Contributor**: @github-actions[bot] \ + **Change Log**: 此PR添加了2.1.9版本的英文和中文版发布说明,详细记录了新功能、Bug修复、重构优化等更新。 \ + **Feature Value**: 新增的发布说明帮助用户快速了解最新版本的关键更新及其影响,提升了信息透明度与用户体验。 + +### 🧪 测试改进 (Testing) + +- **Related PR**: [#3230](https://github.com/alibaba/higress/pull/3230) \ + **Contributor**: @007gzs \ + **Change Log**: 此PR为Rust插件的rule matcher增加了部分匹配单元测试,并修复了demo wrapper-say-hello获取配置的一个bug。 \ + **Feature Value**: 通过增加单元测试提升了代码质量与稳定性,确保了规则匹配器功能的正确性;同时修复了一个配置获取问题,提高了用户使用体验。 + +--- + +## 📊 发布统计 + +- 🚀 新功能: 46项 +- 🐛 Bug修复: 18项 +- ♻️ 重构优化: 1项 +- 📚 文档更新: 18项 +- 🧪 测试改进: 1项 + +**总计**: 84项更改 + +感谢所有贡献者的辛勤付出!🎉 + + +# 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**: 此PR优化了MCP Server的交互能力,包括重写header host、修改交互方式支持选择transport以及处理特殊字符@等。 \ + **Feature Value**: 这些改进提升了MCP Server在不同场景下的灵活性和兼容性,使用户能够更方便地配置和使用MCP Server。 + +- **Related PR**: [#612](https://github.com/higress-group/higress-console/pull/612) \ + **Contributor**: @zhwaaaaaa \ + **Change Log**: 此PR添加了对hop-to-hop头部的忽略处理,特别是针对transfer-encoding: chunked头部。通过在关键代码处添加注释,增强了代码可读性和维护性。 \ + **Feature Value**: 这项功能解决了Grafana页面因反向代理服务器发送特定HTTP头部而无法正常工作的问题,提高了系统的兼容性和用户体验。 + +- **Related PR**: [#608](https://github.com/higress-group/higress-console/pull/608) \ + **Contributor**: @Libres-coder \ + **Change Log**: 此PR为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注解实现,并在相关文件中进行了相应的代码及测试更新。 \ + **Feature Value**: 新增的功能允许用户利用正则表达式灵活地定义路径重写规则,极大地增强了应用路由配置的灵活性和功能丰富性,方便了开发者根据需求定制化处理请求路径。 + +- **Related PR**: [#603](https://github.com/higress-group/higress-console/pull/603) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR在静态服务源设置中添加了展示固定服务端口80的功能,通过在代码中定义常量并更新表单组件实现。 \ + **Feature Value**: 新增显示固定服务端口80的功能,有助于用户更清晰地了解和配置静态服务源,提高用户体验。 + +- **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**: 此PR修复了sortWasmPluginMatchRules逻辑中的拼写错误,确保了代码的正确性和可读性。 \ + **Feature Value**: 通过修正拼写错误,提高了代码质量,减少了潜在的误解和维护成本,提升了用户体验。 + +- **Related PR**: [#619](https://github.com/higress-group/higress-console/pull/619) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR移除了从AiRoute转换成ConfigMap时数据json中的版本信息。这些信息已经在ConfigMap的元数据中保存,无需在json中重复。 \ + **Feature Value**: 避免了冗余信息的存储,使得数据结构更加清晰与合理,有助于提高配置管理的一致性和效率,减少了潜在的数据不一致问题。 + +- **Related PR**: [#618](https://github.com/higress-group/higress-console/pull/618) \ + **Contributor**: @CH3CHO \ + **Change Log**: 重构了SystemController中的API认证逻辑,消除了安全漏洞。新增AllowAnonymous注解,并调整了ApiStandardizationAspect类以支持新的认证逻辑。 \ + **Feature Value**: 修复了SystemController中存在的安全漏洞,提高了系统的安全性,保护用户数据不受未经授权的访问影响。 + +- **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通过修改前端配置加强了内容安全策略(CSP),防止跨站脚本攻击等安全威胁,确保应用更加安全可靠。 \ + **Feature Value**: 增强了前端应用的安全性,有效抵御常见Web安全攻击,保护用户数据不被非法访问或篡改,提升了用户体验和信任度。 + +- **Related PR**: [#611](https://github.com/higress-group/higress-console/pull/611) \ + **Contributor**: @qshuai \ + **Change Log**: 该PR修复了LlmProvidersController.java文件中关于控制器API标题的拼写错误,确保了文档与代码的一致性。 \ + **Feature Value**: 修复标题拼写错误提高了API文档的准确性和可读性,有助于开发者更好地理解和使用相关接口。 + +- **Related PR**: [#609](https://github.com/higress-group/higress-console/pull/609) \ + **Contributor**: @CH3CHO \ + **Change Log**: 此PR修正了Consumer接口中name字段的类型错误,从布尔值更改为字符串,确保了类型定义的准确性。 \ + **Feature Value**: 通过修复类型定义错误,提高了代码质量和可维护性,减少了潜在的运行时错误,提升了开发者体验。 + +- **Related PR**: [#605](https://github.com/higress-group/higress-console/pull/605) \ + **Contributor**: @SaladDay \ + **Change Log**: 修正了AI路由名称验证规则,使其支持点号,并统一为仅允许小写字母。同时更新了中英文错误提示信息以准确反映新的验证逻辑。 \ + **Feature Value**: 解决了界面提示与后端验证逻辑不一致的问题,提升了用户体验的一致性和准确性,确保用户能够根据最新的规则正确输入AI路由名称。 + +- **Related PR**: [#552](https://github.com/higress-group/higress-console/pull/552) \ + **Contributor**: @lcfang \ + **Change Log**: 新增vport属性以修复当服务实例端口变化时导致的路由配置失效问题,通过在注册中心配置中添加vport属性,确保后端服务端口更改不会影响路由。 \ + **Feature Value**: 解决了因服务实例端口变动引发的兼容性问题,提升了系统的稳定性和用户体验,保证了即使后端实例端口发生变化也能正常访问服务。 + +### 📚 文档更新 (Documentation) + +- **Related PR**: [#610](https://github.com/higress-group/higress-console/pull/610) \ + **Contributor**: @heimanba \ + **Change Log**: 更新了文档配置字段的必填说明和关联说明,包括将rewrite等字段改为非必填,并修正了部分描述文本。 \ + **Feature Value**: 通过调整文档中的字段描述,提升了配置灵活性和兼容性,帮助用户更好地理解和使用前端灰度插件。 + +--- + +## 📊 发布统计 + +- 🚀 新功能: 7项 +- 🐛 Bug修复: 10项 +- 📚 文档更新: 1项 + +**总计**: 18项更改 + +感谢所有贡献者的辛勤付出!🎉 + +