Merge branch '3.6.x'

CodeCasterX · CodeCasterX · commit 7e6059698b60 · 2025-12-21T22:51:44.000+08:00
diff --git a/.agent/workflows/test.md b/.agent/workflows/test.md
@@ -23,23 +23,19 @@ description: 执行完整的测试流程，包括单元测试、构建验证和
 
 ### 3. 启动 FIT 服务进行集成测试
 
-**关键要求：**
-- `fit` 命令无法在包含 FIT 框架的目录中执行
-- 必须在一个新建的动态插件目录下执行
-
 **启动步骤：**
 
-创建动态插件目录并启动 FIT 服务：
-```bash
-mkdir -p dynamic-plugins
-cd dynamic-plugins
-../build/bin/fit start
-```
+1. 创建动态插件目录：
+   - `run_command("mkdir -p dynamic-plugins")`
 
-- `run_command("mkdir -p dynamic-plugins && cd dynamic-plugins && ../build/bin/fit start", timeout=120000, run_in_background=true)`
+2. 启动 FIT 服务：
+   - `run_command("build/bin/fit start --plugin-dir=dynamic-plugins", timeout=120000, run_in_background=true)`
 
 使用后台运行模式，超时时间设置为 120 秒（2分钟），给服务足够的启动时间。
 
+**说明：**
+- 使用 `--plugin-dir=dynamic-plugins` 参数指定插件目录
+
 **启动成功的判断标准：**
 - 输出日志中包含启动成功的关键信息
 - 没有出现 ERROR 或 FATAL 级别的日志
@@ -69,8 +65,10 @@ cd dynamic-plugins
 
 ### 5. 清理测试环境
 
-测试完成后，停止 FIT 服务并返回项目根目录：
+测试完成后，停止 FIT 服务并清理动态创建的目录：
 - `run_command("pkill -f fit-discrete-launcher")`
+- `run_command("rm -rf build")`
+- `run_command("rm -rf dynamic-plugins")`
 
 ### 6. 生成测试报告
 
diff --git a/.claude/commands/test.md b/.claude/commands/test.md
@@ -3,98 +3,34 @@
 **用法：**
 - `/test` - 执行完整测试流程
 
-**执行步骤：**
+**执行方式：**
 
-## 1. 清理构建产物
-
-删除之前的构建目录：
-```bash
-rm -rf build
-```
-
-## 2. 执行单元测试和构建
-
-运行 Maven 构建，这会执行全量单元测试并生成构建产物：
-```bash run_in_background timeout=900000
-mvn clean install
-```
-
-**说明：** 使用后台运行模式以避免超时限制
-
-**预期结果：**
-- 所有单元测试通过
-- 在根目录生成 `build/` 目录
-- 构建产物包含 `build/bin/fit` 启动脚本
-
-## 3. 启动 FIT 服务进行集成测试
-
-**关键要求：**
-- `fit` 命令无法在包含 FIT 框架的目录中执行
-- 必须在一个新建的动态插件目录下执行
-
-**启动步骤：**
-
-**创建动态插件目录并启动**
-```bash run_in_background timeout=120000
-mkdir -p dynamic-plugins
-cd dynamic-plugins
-../build/bin/fit start
-```
-
-使用后台运行模式，超时时间设置为 120 秒（2分钟），给服务足够的启动时间。
-
-**启动成功的判断标准：**
-- 输出日志中包含启动成功的关键信息
-- 没有出现 ERROR 或 FATAL 级别的日志
-- 服务端口（默认 8080）成功监听
-
-## 4. 验证服务功能
-
-### 4.1 健康检查接口验证（推荐）
-
-访问 Actuator 健康检查接口，验证插件加载情况：
-```bash
-curl -s http://localhost:8080/actuator/plugins
-```
-
-**预期结果：**
-- HTTP 状态码 200
-- 返回 JSON 格式的插件列表
-- 包含核心插件信息
-
-### 4.2 Swagger 文档页面验证
-
-访问 OpenAPI 文档页面，验证 HTTP 服务和文档生成功能：
-```bash
-curl -s http://localhost:8080/openapi.html
+使用自动化测试脚本执行完整的测试流程：
+```bash timeout=900000
+./.claude/run-test.sh
 ```
 
-**预期结果：**
-- HTTP 状态码 200
-- 返回 HTML 内容
-- 包含 Swagger UI 页面
+**测试流程包括：**
 
-## 5. 清理测试环境
-
-测试完成后，停止 FIT 服务并返回项目根目录：
-
-```bash
-cd ..
-# 停止 FIT 服务（找到进程并终止）
-```
+1. **清理构建产物** - 删除之前的 build 目录
+2. **执行单元测试和构建** - 运行 `mvn clean install` 执行全量单元测试
+3. **创建动态插件目录** - 创建 `dynamic-plugins` 目录
+4. **启动 FIT 服务** - 使用 `build/bin/fit start` 启动服务
+5. **验证健康检查接口** - 访问 `/actuator/plugins` 接口
+6. **验证 Swagger 文档** - 访问 `/openapi.html` 页面
+7. **清理测试环境** - 停止服务并删除构建产物
 
 **测试报告：**
 
-生成测试报告，包含：
-1. ✅/❌ 单元测试结果
-2. ✅/❌ 构建状态
-3. ✅/❌ FIT 服务启动状态
-4. ✅/❌ 健康检查接口响应
-5. ✅/❌ Swagger 文档页面可访问性
+脚本会自动生成测试报告，包含：
+1. ✅/✗ 单元测试结果
+2. ✅/✗ 构建状态
+3. ✅/✗ FIT 服务启动状态
+4. ✅/✗ 健康检查接口响应
+5. ✅/✗ Swagger 文档页面可访问性
 
 **注意事项：**
 
-1. **启动目录限制**：必须在动态插件目录下执行 `fit start`
-2. **端口冲突**：确保 8080 端口未被占用
-3. **权限问题**：确保 `build/bin/fit` 有执行权限
-4. **进程管理**：测试完成后记得停止 FIT 服务
+1. **端口冲突**：确保 8080 端口未被占用
+2. **权限配置**：测试脚本已在 `.claude/settings.json` 中配置自动授权
+3. **完全自动化**：整个测试流程无需手动确认，自动执行所有步骤
diff --git a/.claude/project-rules.md b/.claude/project-rules.md
@@ -187,6 +187,62 @@ Bash("OWNER_GROUP=$(ls -l README.md | awk '{print $3\":\"$4}') && sudo chown $OW
 - 新功能：`[模块名] Add <feature-description>`
 - 功能增强：`[模块名] Enhance <feature-description>`
 
+## Git 提交和版本控制规范
+
+### 规则 3: 禁止自动提交代码
+
+**⚠️ 重要规则（CRITICAL）：**
+
+**绝对不要**自动执行 `git commit` 或 `git add` 命令，除非用户明确使用 `/commit` 命令请求提交。
+
+**原因：**
+- 项目配置了 `/commit` 命令，说明用户希望自己控制提交时机
+- 用户可能需要在提交前进行额外的检查或修改
+- 自动提交会剥夺用户对版本控制的控制权
+
+**正确做法：**
+
+1. **完成代码修改后**
+   - ✅ 告知用户有哪些文件被修改
+   - ✅ 展示修改的内容摘要
+   - ✅ 提醒用户可以使用 `/commit` 命令进行提交
+   - ❌ 不要自动执行 `git add` 或 `git commit`
+
+2. **仅在用户明确请求时才提交**
+   - ✅ 用户运行 `/commit` 命令
+   - ✅ 用户明确说"提交这些修改"、"commit these changes"
+   - ❌ 不要在用户只是让你"修复问题"或"完成任务"时自动提交
+
+3. **示例对比**
+
+   **❌ 错误做法：**
+   ```
+   User: 请修复测试命令的清理步骤
+   Assistant:
+   [修复代码]
+   [自动执行 git add 和 git commit]  # ❌ 错误！
+   ```
+
+   **✅ 正确做法：**
+   ```
+   User: 请修复测试命令的清理步骤
+   Assistant:
+   [修复代码]
+   我已经完成了修复，修改了以下文件：
+   - .claude/commands/test.md
+   - .agent/workflows/test.md
+
+   你可以使用 `/commit` 命令来提交这些修改。
+   # ✅ 正确！等待用户决定何时提交
+   ```
+
+**例外情况：**
+
+只有在以下情况下可以自动提交：
+1. 用户明确说"修复后直接提交"或"fix and commit"
+2. 用户使用了 `/commit` 命令
+3. 某个 workflow 或 slash command 的定义中明确要求自动提交
+
 ## 通用最佳实践
 
 ### 文件操作
@@ -195,6 +251,7 @@ Bash("OWNER_GROUP=$(ls -l README.md | awk '{print $3\":\"$4}') && sudo chown $OW
 - 批量操作后统一修改权限
 
 ### Git 操作
+- **绝对不要自动提交代码**（参见规则 3）
 - 提交前检查 `.github/` 目录中的规范
 - 遵循项目的 commit message 格式
 - PR 描述要完整、清晰
diff --git a/.claude/run-test.sh b/.claude/run-test.sh
@@ -0,0 +1,112 @@
+#!/bin/bash
+# FIT Framework 完整测试脚本
+
+set -e  # 遇到错误立即退出
+
+echo "=========================================="
+echo "FIT Framework 测试流程"
+echo "=========================================="
+
+# 1. 清理构建产物
+echo ""
+echo "[1/6] 清理构建产物..."
+rm -rf build
+
+# 2. 执行单元测试和构建
+echo ""
+echo "[2/6] 执行 Maven 构建和单元测试..."
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+LOG_FILE="/tmp/maven-build-${TIMESTAMP}.log"
+echo "构建日志保存到: $LOG_FILE"
+
+mvn clean install > "$LOG_FILE" 2>&1
+BUILD_STATUS=$?
+
+# 只显示最后 100 行（包含构建摘要）
+echo "========== 构建摘要 =========="
+tail -100 "$LOG_FILE"
+
+# 如果构建失败，显示错误信息并退出
+if [ $BUILD_STATUS -ne 0 ]; then
+    echo ""
+    echo "========== 错误详情 =========="
+    grep -A 5 "BUILD FAILURE\|COMPILATION ERROR\|ERROR\|FAILED" "$LOG_FILE" | head -50
+    rm "$LOG_FILE"
+    exit $BUILD_STATUS
+fi
+
+rm "$LOG_FILE"
+echo "✓ Maven 构建成功"
+
+# 3. 创建动态插件目录
+echo ""
+echo "[3/6] 创建动态插件目录..."
+mkdir -p dynamic-plugins
+echo "✓ 动态插件目录创建成功"
+
+# 4. 启动 FIT 服务
+echo ""
+echo "[4/6] 启动 FIT 服务..."
+FIT_LOG="/tmp/fit-server-${TIMESTAMP}.log"
+build/bin/fit start --plugin-dir=dynamic-plugins > "$FIT_LOG" 2>&1 &
+FIT_PID=$!
+echo "FIT 服务进程 PID: $FIT_PID"
+echo "FIT 服务日志: $FIT_LOG"
+
+# 等待服务启动（最多 60 秒）
+echo "等待服务启动..."
+for i in {1..60}; do
+    if curl -s http://localhost:8080/actuator/health > /dev/null 2>&1; then
+        echo "✓ FIT 服务启动成功"
+        break
+    fi
+    if [ $i -eq 60 ]; then
+        echo "✗ FIT 服务启动超时"
+        echo "========== 启动日志 =========="
+        cat "$FIT_LOG"
+        kill $FIT_PID 2>/dev/null || true
+        exit 1
+    fi
+    sleep 1
+done
+
+# 5. 验证健康检查接口
+echo ""
+echo "[5/6] 验证健康检查接口..."
+PLUGINS_RESPONSE=$(curl -s http://localhost:8080/actuator/plugins)
+if [ $? -eq 0 ]; then
+    echo "✓ 健康检查接口正常"
+    echo "插件列表响应:"
+    echo "$PLUGINS_RESPONSE" | head -20
+else
+    echo "✗ 健康检查接口失败"
+    pkill -f fit-discrete-launcher || true
+    exit 1
+fi
+
+# 6. 验证 Swagger 文档页面
+echo ""
+echo "[6/6] 验证 Swagger 文档页面..."
+SWAGGER_RESPONSE=$(curl -s http://localhost:8080/openapi.html)
+if [ $? -eq 0 ] && echo "$SWAGGER_RESPONSE" | grep -q "swagger" 2>/dev/null || echo "$SWAGGER_RESPONSE" | grep -q "Swagger" 2>/dev/null; then
+    echo "✓ Swagger 文档页面可访问"
+else
+    echo "⚠ Swagger 文档页面响应异常（可能正常，取决于配置）"
+fi
+
+# 7. 清理测试环境
+echo ""
+echo "[7/7] 清理测试环境..."
+echo "停止 FIT 服务..."
+pkill -f fit-discrete-launcher || true
+sleep 2
+
+echo "删除构建产物和动态插件目录..."
+rm -rf build
+rm -rf dynamic-plugins
+rm -f "$FIT_LOG"
+
+echo ""
+echo "=========================================="
+echo "✓ 测试流程完成"
+echo "=========================================="
diff --git a/.claude/settings.json b/.claude/settings.json
diff --git a/framework/fit/java/fit-launcher/src/main/resources/bin/fit.js b/framework/fit/java/fit-launcher/src/main/resources/bin/fit.js
