Commit from GitHub Actions (Reduce Adoc)

Author: DQinYuan

README-EN.adoc

@@ -620,6 +620,43 @@ You can cache scripts before first execution using the following method to ensur
 
 Note that this cache has an unlimited size; be sure to control its size in your application. You can periodically clear the compilation cache by calling the `clearCompileCache` method.
 
+=== Clearing DFA Cache
+
+QLExpress uses ANTLR4 as its parsing engine. ANTLR4 builds a DFA (Deterministic Finite Automaton) cache at runtime to accelerate subsequent syntax parsing. This cache consumes a certain amount of memory.
+
+In some memory-sensitive scenarios, you can call the `clearDFACache` method to clear the DFA cache and release memory.
+
+> **IMPORTANT WARNING**: Clearing the DFA cache will cause a significant compilation performance degradation. It is NOT recommended for normal use cases.
+
+==== Use Cases
+
+* **Memory-sensitive applications**: When memory usage is a critical concern and you can tolerate slower compilation times
+* **Infrequently changing scripts**: When scripts are relatively stable and not frequently recompiled
+
+==== Best Practice
+
+Call this method immediately after parsing and caching your expression, and ensure all subsequent executions use the cached option to avoid recompilation. Example code:
+
+[source,java,indent=0]
+----
+        /*
+         * When the expression changes, parse it and add it to the expression cache;
+         * after parsing is complete, call clearDFACache.
+         */
+        Express4Runner runner = new Express4Runner(InitOptions.DEFAULT_OPTIONS);
+        runner.parseToDefinitionWithCache(exampleExpress);
+        runner.clearDFACache();
+        
+        /*
+         * All subsequent runs of this script must enable the cache option to ensure that re-compilation does not occur.
+         */
+        for (int i = 0; i < 3; i++) {
+            runner.execute(exampleExpress, Collections.emptyMap(), QLOptions.builder().cache(true).build());
+        }
+----
+
+By following this approach, you can minimize memory usage while maintaining performance.
+
 === Setting Timeout
 
 You can set a timeout for scripts to prevent infinite loops or other reasons from causing excessive consumption of application resources.

README.adoc

@@ -621,6 +621,43 @@ QLExpress4 支持通过自定义 `ClassSupplier` 来指定类加载器，这在
 
 注意该缓存的大小是无限的，业务上注意控制大小，可以调用 `clearCompileCache` 方法定期清空编译缓存。
 
+=== 清除 DFA 缓存
+
+QLExpress 使用 ANTLR4 作为解析引擎，ANTLR4 在运行时会构建 DFA (确定有限状态自动机) 缓存来加速后续的语法解析。这个缓存会占用一定的内存空间。
+
+在某些内存敏感的场景下，可以通过调用 `clearDFACache` 方法来清除 DFA 缓存，释放内存。
+
+> **重要警告**: 清除 DFA 缓存会导致编译性能大幅下降，正常情况下不建议使用此方法。
+
+==== 适用场景
+
+* **内存敏感型应用**: 当内存使用是关键考虑因素，且可以容忍较慢的编译时间时
+* **脚本不经常变更**: 当脚本相对稳定且不会频繁重新编译时
+
+==== 最佳实践
+
+在解析并缓存表达式后立即调用此方法，并确保后续所有执行都打开缓存选项以避免重新编译。示例代码如下：
+
+[source,java,indent=0]
+----
+        /*
+         * When the expression changes, parse it and add it to the expression cache;
+         * after parsing is complete, call clearDFACache.
+         */
+        Express4Runner runner = new Express4Runner(InitOptions.DEFAULT_OPTIONS);
+        runner.parseToDefinitionWithCache(exampleExpress);
+        runner.clearDFACache();
+        
+        /*
+         * All subsequent runs of this script must enable the cache option to ensure that re-compilation does not occur.
+         */
+        for (int i = 0; i < 3; i++) {
+            runner.execute(exampleExpress, Collections.emptyMap(), QLOptions.builder().cache(true).build());
+        }
+----
+
+通过这种方式，可以在保证性能的同时，最大限度地降低内存占用。
+
 === 设置超时时间
 
 可以给脚本设置一个超时时间，防止其中存在死循环或者其他原因导致应用资源被过量消耗。