fix: 修复 HttpToolTest 中 JSON 字符串处理方式并完善 API 文档

修改 HttpToolTest 测试类，将 Tool.execute() 的字符串参数改为使用 ObjectSerializer
反序列化后的 Map 对象，避免依赖 fastjson 的自动 JSON 解析行为。

同时在 ValueFetcher 和 ValueSetter 的 JavaDoc 中明确说明：当参数为 String 时，
默认按普通字符串处理，不会自动解析 JSON 文本。如需从 JSON 字符串中取值或设置属性，
调用方应先使用 ObjectSerializer 将其反序列化为对象。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: CodeCasterX

framework/fel/java/services/tool-service/src/test/java/modelengine/fel/tool/support/HttpToolTest.java

@@ -25,6 +25,7 @@
 import modelengine.fitframework.util.IoUtils;
 import modelengine.fitframework.util.MapBuilder;
 import modelengine.fitframework.util.StringUtils;
+import modelengine.fitframework.util.TypeUtils;
 import modelengine.fitframework.value.ValueFetcher;
 
 import org.junit.jupiter.api.AfterAll;
@@ -34,6 +35,7 @@
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.lang.reflect.Type;
 import java.net.ServerSocket;
 import java.net.URL;
 import java.util.HashMap;
@@ -124,6 +126,12 @@ private static Tool createTool(Tool.Info info) {
         return factory.create(info, toolMetadata);
     }
 
+    private static Map<String, Object> deserializeJsonObject(String json) {
+        ObjectSerializer jsonSerializer = new JacksonObjectSerializer(null, null, null, true);
+        Type objectType = TypeUtils.parameterized(Map.class, new Type[] {String.class, Object.class});
+        return jsonSerializer.deserialize(json, objectType);
+    }
+
     @Test
     @DisplayName("测试返回值为 Map 成功")
     void shouldReturnMap() {
@@ -186,7 +194,8 @@ void BasicShouldReturnOk() {
         Tool.Info info = readToolInfo("basic-auth.json");
         Tool tool = createTool(info);
 
-        boolean result = cast(tool.execute("{\"name\":\"testuser\", \"pwd\":\"testpass\"}"));
+        Map<String, Object> args = deserializeJsonObject("{\"name\":\"testuser\", \"pwd\":\"testpass\"}");
+        boolean result = cast(tool.execute(args));
         assertThat(result).isEqualTo(true);
     }
 
@@ -196,7 +205,8 @@ void ApiKeyShouldReturnOk() {
         Tool.Info info = readToolInfo("api-key-auth.json");
         Tool tool = createTool(info);
 
-        boolean result = cast(tool.execute("{\"name\":\"ApiKey\", \"pwd\":\"ApiKeyValue\"}"));
+        Map<String, Object> args = deserializeJsonObject("{\"name\":\"ApiKey\", \"pwd\":\"ApiKeyValue\"}");
+        boolean result = cast(tool.execute(args));
         assertThat(result).isEqualTo(true);
     }
 
@@ -206,7 +216,8 @@ void ApiKeyQueryShouldReturnOk() {
         Tool.Info info = readToolInfo("api-key-query-auth.json");
         Tool tool = createTool(info);
 
-        boolean result = cast(tool.execute("{\"name\":\"ApiKey\", \"pwd\":\"ApiKeyValue\"}"));
+        Map<String, Object> args = deserializeJsonObject("{\"name\":\"ApiKey\", \"pwd\":\"ApiKeyValue\"}");
+        boolean result = cast(tool.execute(args));
         assertThat(result).isEqualTo(true);
     }
 
@@ -216,7 +227,8 @@ void BearerShouldReturnOk() {
         Tool.Info info = readToolInfo("bearer-auth.json");
         Tool tool = createTool(info);
 
-        boolean result = cast(tool.execute("{\"name\":\"test666666666\", \"pwd\":\"invalid\"}"));
+        Map<String, Object> args = deserializeJsonObject("{\"name\":\"test666666666\", \"pwd\":\"invalid\"}");
+        boolean result = cast(tool.execute(args));
         assertThat(result).isEqualTo(true);
     }
-}
+}

framework/fit/java/fit-api/src/main/java/modelengine/fitframework/value/ValueFetcher.java

@@ -40,6 +40,9 @@ public interface ValueFetcher {
      * +---------------------+--------------+---------------------+
      * </pre>
      * 任意输入对象都可以转换为键值对的形式。
+     * <p><strong>注意：</strong>当 {@code object} 为 {@link String} 时，默认按普通字符串处理，不会自动解析 JSON 文本。
+     * 如果需要从 JSON 字符串中取值，请调用方先使用 {@link modelengine.fitframework.serialization.ObjectSerializer}
+     * 将其反序列化为对象，再调用本方法。</p>
      * 
      * @param object 表示指定对象的 {@link Object}。
      * @param propertyPath 表示待获取属性的路径的 {@link String}。

framework/fit/java/fit-api/src/main/java/modelengine/fitframework/value/ValueSetter.java

@@ -41,6 +41,9 @@ public interface ValueSetter {
      * +---------------------+--------------+-------+----------------------+
      * </pre>
      * 任意输入对象都可以转换为键值对的形式。
+     * <p><strong>注意：</strong>当 {@code object} 为 {@link String} 时，默认按普通字符串处理，不会自动解析 JSON 文本。
+     * 如果需要在 JSON 字符串上设置属性，请调用方先使用 {@link modelengine.fitframework.serialization.ObjectSerializer}
+     * 将其反序列化为对象，再调用本方法。</p>
      * 
      * @param object 表示指定对象的 {@link Object}。
      * @param propertyPath 表示待替换属性的路径的 {@link String}。