optimize FEL javadoc and pom

Author: CodeCasterX

framework/dependency/pom.xml

@@ -56,7 +56,7 @@
         <druid.version>1.2.20</druid.version>
         <fastjson.version>1.2.83</fastjson.version>
         <guava.version>32.0.1-jre</guava.version>
-        <h2.version>2.3.232</h2.version>
+        <hanlp.version>portable-1.8.4</hanlp.version>
         <lombok.version>1.18.36</lombok.version>
         <jackson.version>2.18.2</jackson.version>
         <mybatis.version>3.5.13</mybatis.version>
@@ -415,6 +415,33 @@
                 <version>${fit.version}</version>
             </dependency>
 
+            <!-- FEL -->
+            <dependency>
+                <groupId>org.fitframework.fel</groupId>
+                <artifactId>fel-core</artifactId>
+                <version>${fit.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.fitframework.fel</groupId>
+                <artifactId>tool-service</artifactId>
+                <version>${fit.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.fitframework.fel</groupId>
+                <artifactId>tool-info</artifactId>
+                <version>${fit.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.fitframework.fel</groupId>
+                <artifactId>tool-mcp-common</artifactId>
+                <version>${fit.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.fitframework.fel</groupId>
+                <artifactId>tool-mcp-client-service</artifactId>
+                <version>${fit.version}</version>
+            </dependency>
+
             <!-- Ohscript -->
             <dependency>
                 <groupId>org.fitframework.ohscript</groupId>
@@ -453,6 +480,11 @@
                 <artifactId>guava</artifactId>
                 <version>${guava.version}</version>
             </dependency>
+            <dependency>
+                <groupId>com.hankcs</groupId>
+                <artifactId>hanlp</artifactId>
+                <version>${hanlp.version}</version>
+            </dependency>
             <dependency>
                 <groupId>net.bytebuddy</groupId>
                 <artifactId>byte-buddy</artifactId>

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/activities/AiActivity.java

@@ -32,6 +32,11 @@ protected AiActivity(F flow) {
         this.flow = Validation.notNull(flow, "Flow cannot be null.");
     }
 
+    /**
+     * 获取 AI 节点所对应的流程对象。
+     *
+     * @return AI 节点所对应的流程对象。
+     */
     public F flow() {
         return this.flow;
     }

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/activities/AiMatchHappen.java

@@ -30,6 +30,12 @@ public class AiMatchHappen<O, D, I, RF extends Flow<D>, F extends AiFlow<D, RF>>
 
     private final F flow;
 
+    /**
+     * 创建一个 AI 流程匹配发生器。
+     *
+     * @param matchHappen 匹配发生器。
+     * @param flow AI 流程。
+     */
     public AiMatchHappen(MatchHappen<O, D, I, RF> matchHappen, F flow) {
         this.matchHappen = Validation.notNull(matchHappen, "MatchHappen cannot be null.");
         this.flow = Validation.notNull(flow, "Flow cannot be null.");

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/activities/AiMatchToHappen.java

@@ -31,6 +31,12 @@ public class AiMatchToHappen<D, I, RF extends Flow<D>, F extends AiFlow<D, RF>>
 
     private final F flow;
 
+    /**
+     * 创建一个 {@link AiMatchToHappen} 对象。
+     *
+     * @param matchToHappen 匹配条件。
+     * @param flow AI 流程。
+     */
     public AiMatchToHappen(MatchToHappen<D, I, RF> matchToHappen, F flow) {
         this.matchToHappen = Validation.notNull(matchToHappen, "matchToHappen cannot be null.");
         this.flow = Validation.notNull(flow, "Flow cannot be null.");
@@ -75,8 +81,8 @@ public <O> AiMatchHappen<O, D, I, RF, F> match(Operators.Whether<I> whether,
     /**
      * 提供一个默认的处理逻辑，并结束条件节点。
      *
-     * @param processor 表示分支处理器的 {@link AiBranchProcessor}{@code <}{@link O}{@code , }{@link D}{@code ,
-     * }{@link ?}{@code , }{@link RF}{@code , }{@link F}{@code >}。
+     * @param processor 表示分支处理器的 {@link AiBranchProcessor}{@code <}{@link O}{@code , }{@link D}{@code ,?,
+     * }{@link RF}{@code , }{@link F}{@code >}。
      * @param <O> 表示第一个条件分支指定的返回类型。
      * @return 表示条件节点的 {@link AiState}{@code <}{@link O}{@code , }{@link D}{@code , }{@link O}{@code ,
      * }{@link RF}{@code , }{@link F}{@code >}。

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/activities/AiParallel.java

@@ -40,6 +40,7 @@ public AiParallel(Parallel<D, I, RF> parallel, F flow) {
     /**
      * 生成平行节点的子分支。
      *
+     * @param <O> 表示分支处理器的输入参数的类型。
      * @param processor 表示分支处理器的 {@link AiBranchProcessor}{@code <}{@link O}{@code , }{@link D}{@code ,
      * }{@link I}{@code , }{@link RF}{@code , }{@link F}{@code >}。
      * @return 表示平行节点子分支的 {@link AiFork}{@code <}{@link O}{@code , }{@link D}{@code , }{@link I}{@code ,

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/activities/AiStart.java

@@ -397,6 +397,7 @@ public AiState<Content, D, O, RF, F> synthesize(Synthesizer<O> synthesizer) {
     /**
      * 将模型处理返回值的格式化解析。
      *
+     * @param <R> 表示解析器的返回值类型。
      * @param parser 表示格式化解析器的 {@link Parser}{@code <}{@link R}{@code >}。
      * @return 表示格式化解析节点的 {@link AiState}{@code <}{@link O}{@code , }{@link D}{@code , }{@link O}{@code ,
      * }{@link RF}{@code , }{@link F}{@code >}。
@@ -505,8 +506,8 @@ public <R> AiState<R, D, O, RF, F> delegate(AiProcessFlow<O, R> aiFlow) {
      * @return 表示委托节点的 {@link AiState}{@code <}{@link R}{@code , }{@link D}{@code , }{@link O}{@code ,
      * }{@link RF}{@code , }{@link F}{@code >}。
      * @throws IllegalArgumentException <ul>
-     * <li>当 {@code aiFlow} 为 {@code null}时。</il>
-     * <li>当 {@code nodeId} 为 {@code null} 、空字符串或只有空白字符的字符串时。</il>
+     * <li>当 {@code aiFlow} 为 {@code null}时。</li>
+     * <li>当 {@code nodeId} 为 {@code null} 、空字符串或只有空白字符的字符串时。</li>
      * </ul>
      */
     public <R> AiState<R, D, O, RF, F> delegate(AiProcessFlow<O, R> aiFlow, String nodeId) {

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/flows/AiFlow.java

@@ -23,6 +23,11 @@
 public class AiFlow<D, F extends Flow<D>> extends IdGenerator {
     private final F flow;
 
+    /**
+     * 创建一个 AI 流程。
+     *
+     * @param flow 流程。
+     */
     public AiFlow(F flow) {
         this.flow = Validation.notNull(flow, "Flow cannot be null.");
     }

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/flows/AiProcessFlow.java

@@ -32,6 +32,11 @@ public class AiProcessFlow<D, R> extends AiFlow<D, ProcessFlow<D>>
     private final Map<EmitterListener<R, FlowSession>, EmitterListener<Object, FlowSession>> listeners =
             new ConcurrentHashMap<>();
 
+    /**
+     * 创建一个流程。
+     *
+     * @param flow 表示流程。
+     */
     public AiProcessFlow(ProcessFlow<D> flow) {
         super(flow);
     }

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/flows/ConverseLatch.java

@@ -73,22 +73,47 @@ public T await() {
         return this.data;
     }
 
+    /**
+     * Returns the data.
+     *
+     * @return The data.
+     */
     public T data() {
         return this.data;
     }
 
+    /**
+     * Sets the data.
+     *
+     * @param data The data.
+     */
     public void data(T data) {
         this.data = data;
     }
 
+    /**
+     * Returns the throwable.
+     *
+     * @return The throwable.
+     */
     public Throwable throwable() {
         return this.throwable;
     }
 
+    /**
+     * Sets the throwable.
+     *
+     * @param throwable The throwable.
+     */
     public void throwable(Throwable throwable) {
         this.throwable = throwable;
     }
 
+    /**
+     * Returns the count-down latch.
+     *
+     * @return The count-down latch.
+     */
     public CountDownLatch countDownLatch() {
         return this.countDownLatch;
     }

framework/fel/java/fel-flow/src/main/java/modelengine/fel/engine/operators/models/ChatBlockModel.java

@@ -7,11 +7,11 @@
 package modelengine.fel.engine.operators.models;
 
 import modelengine.fel.core.chat.ChatMessage;
+import modelengine.fel.core.chat.ChatModel;
 import modelengine.fel.core.chat.ChatOption;
 import modelengine.fel.core.chat.MessageType;
 import modelengine.fel.core.chat.Prompt;
 import modelengine.fel.core.chat.support.AiMessage;
-import modelengine.fel.core.chat.ChatModel;
 import modelengine.fel.core.memory.Memory;
 import modelengine.fel.core.model.BlockModel;
 import modelengine.fel.engine.util.AiFlowSession;
@@ -32,10 +32,21 @@ public class ChatBlockModel implements BlockModel<Prompt, ChatMessage> {
     private final ChatModel provider;
     private final ChatOption option;
 
+    /**
+     * 创建一个阻塞对话模型。
+     *
+     * @param provider 聊天模型提供者。
+     */
     public ChatBlockModel(ChatModel provider) {
         this(provider, ChatOption.custom().build());
     }
 
+    /**
+     * 创建一个阻塞对话模型。
+     *
+     * @param provider 聊天模型提供者。
+     * @param option 聊天模型选项。
+     */
     public ChatBlockModel(ChatModel provider, ChatOption option) {
         this.provider = Validation.notNull(provider, "The model provider cannot be null.");
         this.option = Validation.notNull(option, "The chat options cannot be null.");