From 80a6d9236ade191a5de0975abe4de5a6e7e63915 Mon Sep 17 00:00:00 2001
From: zhou zhou <3272660260@qq.com>
Date: 星期四, 19 三月 2026 14:03:10 +0800
Subject: [PATCH] #AI.注释

---
 rsf-server/src/main/java/com/vincent/rsf/server/ai/tool/BuiltinToolGovernanceSupport.java |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)

diff --git a/rsf-server/src/main/java/com/vincent/rsf/server/ai/tool/BuiltinToolGovernanceSupport.java b/rsf-server/src/main/java/com/vincent/rsf/server/ai/tool/BuiltinToolGovernanceSupport.java
index 06030dc..ec96b73 100644
--- a/rsf-server/src/main/java/com/vincent/rsf/server/ai/tool/BuiltinToolGovernanceSupport.java
+++ b/rsf-server/src/main/java/com/vincent/rsf/server/ai/tool/BuiltinToolGovernanceSupport.java
@@ -11,6 +11,10 @@
     private BuiltinToolGovernanceSupport() {
     }
 
+    /**
+     * 鎶婂伐鍏峰叆鍙傞噷鐨� limit 缁熶竴鏀舵暃鍒板畨鍏ㄨ寖鍥村唴銆�
+     * 鎵�鏈夊唴缃彧璇诲伐鍏烽兘閫氳繃璇ユ柟娉曢檺鍒惰繑鍥炶妯★紝閬垮厤妯″瀷涓�娆℃煡璇㈣繃澶氭暟鎹��
+     */
     public static int normalizeLimit(Integer limit, int defaultValue, int maxValue) {
         if (limit == null) {
             return defaultValue;
@@ -21,6 +25,10 @@
         return limit;
     }
 
+    /**
+     * 瑕佹眰澶氫釜杩囨护鏉′欢閲岃嚦灏戞湁涓�涓湁鏁堝�笺��
+     * 杩欐槸闃叉 AI 宸ュ叿琚ā鍨嬪綋鎴愨�滃叏琛ㄦ壂鎻忔帴鍙b�濅娇鐢ㄧ殑绗竴閬撲繚鎶ゃ��
+     */
     public static void requireAnyFilter(String message, String... values) {
         if (values == null || values.length == 0) {
             throw new CoolException(message);
@@ -33,6 +41,10 @@
         throw new CoolException(message);
     }
 
+    /**
+     * 娓呮礂鍗曚釜鏂囨湰鍨嬫煡璇㈠弬鏁帮紝骞堕檺鍒舵渶澶ч暱搴︺��
+     * 杩欓噷鍙仛杞婚噺娌荤悊锛屼笉鍋氭ā绯婂厹搴曟垨鑷姩绾犻敊锛岄潪娉曡緭鍏ョ洿鎺ユ嫆缁濄��
+     */
     public static String sanitizeQueryText(String value, String fieldLabel, int maxLength) {
         if (!StringUtils.hasText(value)) {
             return null;
@@ -44,6 +56,10 @@
         return normalized;
     }
 
+    /**
+     * 娓呮礂瀛楃涓叉暟缁勫瀷鍙傛暟锛屽父鐢ㄤ簬绔欑偣绫诲瀷銆佺姸鎬佸垪琛ㄧ瓑鎵归噺杩囨护鏉′欢銆�
+     * 杩斿洖缁撴灉浼氳嚜鍔ㄥ墧闄ょ┖鍊硷紝浣嗗鏋滄渶缁堜负绌轰粛鐒惰涓洪潪娉曡姹傘��
+     */
     public static List<String> sanitizeStringList(List<String> values, String fieldLabel, int maxSize, int maxItemLength) {
         if (values == null || values.isEmpty()) {
             throw new CoolException(fieldLabel + "涓嶈兘涓虹┖");

--
Gitblit v1.9.1