liteflow: Instructions file for Claude Code

CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在本仓库中工作时提供指引。

概述

LiteFlow（v2.16.1）是一个轻量级规则引擎框架，用于复杂的组件化业务编排。它通过 DSL 驱动工作流，支持热重载和 11 种脚本语言。项目面向 Java 8+（最高支持到 JDK 25），拥有 2000+ 测试用例。

官方文档：https://liteflow.cc/pages/5816c5/

命令

构建

# 构建整个项目（模块集由 JDK 版本自动选择 —— 见下方说明）
mvn clean package -DskipTests

# 带测试构建
mvn clean package

# 构建指定模块
mvn clean package -DskipTests -pl liteflow-core

# 发布生产模块（手动选择 profile，不会自动激活）
mvn clean package -DskipTests -P release-on-8     # JDK 8 发布产物
mvn clean package -DskipTests -P release-on-17     # agent + spring-boot4-starter

JDK 驱动的模块选择（重要）： 根 pom.xml 中没有顶层的 <modules> 块 —— 构建的模块列表完全由按 JDK 激活的 profile 提供：

• compile-8-to-16（在 JDK [1.8,17) 上激活）：core、scripts、rules、spring-boot-starter、spring、solon、testcase-el、el-builder、metrics、benchmark。
• compile-17+（在 JDK [17,) 上激活）：以上全部，外加 liteflow-agent 和 liteflow-spring-boot4-starter。

因此 liteflow-agent 和 liteflow-spring-boot4-starter 只有在 JDK 17+ 上构建时才会被纳入。这两个模块以 maven.compiler.target=17 编译，但根 pom 注释指出 agentscope-java（agent 背后的引擎）运行时需要 Java 21+ —— 本仓库当前的开发 JDK 为 21。release-on-8 / release-on-17 这两个 profile 没有 <activation>，必须用 -P 手动选择：release-on-8 发布 JDK 8 产物（含 liteflow-metrics），release-on-17 只发布 liteflow-agent 与 liteflow-spring-boot4-starter。

运行测试

测试用例的编写位置（强制约定）： 所有测试用例必须写在 liteflow-testcase-el/ 下对应的测试模块中，禁止写在 liteflow-core、liteflow-metrics、liteflow-spring* 等核心代码模块下。核心代码模块只放生产代码，不放测试。新增功能时，请在 liteflow-testcase-el/ 下选择（或新建）合适的测试模块来覆盖该功能（按框架 / 配置源 / 脚本 / 特性维度划分，见下文「测试基础设施」）。

注意： 根 pom 的 surefire 默认 skipTests=true，直接 mvn test 不会真正执行测试，需要显式加 -DskipTests=false。

# 运行所有测试
mvn test -DskipTests=false

# 运行指定模块的测试（liteflow-testcase-el/ 下有 30+ 个测试模块）
mvn test -DskipTests=false -pl liteflow-testcase-el/liteflow-testcase-el-springboot

# 运行单个测试类
mvn test -DskipTests=false -pl liteflow-testcase-el/liteflow-testcase-el-springboot -Dtest=FlowExecutorTest

# 运行指定的测试方法
mvn test -DskipTests=false -pl liteflow-testcase-el/liteflow-testcase-el-springboot -Dtest=FlowExecutorTest#testExecute