test: add JUnit tests (>=90% coverage); docs: comprehensive English JavaDoc

Author: loong10k

src/main/java/io/github/easy4j/opencli/OpenCliClient.java

@@ -23,9 +23,18 @@
 import lombok.Getter;
 
 /**
- * OpenCLI Java SDK 入口：持有一组运行时配置与共享 {@link OpenCliExecutor}。
- */
-public class OpenCliClient {
+ * Entry point for the OpenCLI Java SDK. Holds a set of runtime configuration properties
+ and a shared {@link OpenCliExecutor}.
+ *
+ * <p>Usage example:</p>
+ * <pre>{@code
+ * OpenCliClient client = new OpenCliClient();
+ * OpenCliResult result = client.chatgpt().ask("hello", null, null);
+ * }</pre>
+ *
+ * @author [@Loong Wan](https://github.com/loong10k)
+ * @since 3.0.0
+ */public class OpenCliClient {
 
     @Getter
     private final OpenCliProperties properties;
@@ -34,7 +43,7 @@ public class OpenCliClient {
     private final OpenCliExecutor executor;
 
     /**
-     * 使用默认配置构造（可执行文件假定名为 {@code opencli}）。
+     * Constructs with default configuration (executable assumed to be {@code opencli} on PATH).
      */
     public OpenCliClient() {
         this(new OpenCliProperties());

src/main/java/io/github/easy4j/opencli/OpenCliExecutionTarget.java

@@ -1,12 +1,15 @@
 package io.github.easy4j.opencli;
 
 /**
- * OpenCLI 命令实际执行位置：本机子进程或与 opencli-admin 兼容的远端 Agent HTTP API。
- */
-public enum OpenCliExecutionTarget {
+ * Determines where an OpenCLI command is executed: as a local subprocess or via a remote
+ Agent HTTP API compatible with opencli-admin.
+ *
+ * @author [@Loong Wan](https://github.com/loong10k)
+ * @since 3.0.0
+ */public enum OpenCliExecutionTarget {
 
     /**
-     * 在本机通过 {@link OpenCliProperties} 的 {@code executable} 配置启动子进程（默认）。
+     * Launch a subprocess on the local machine using the {@code executable} configured in {@link OpenCliProperties} (default).
      */
     LOCAL_PROCESS,
 

src/main/java/io/github/easy4j/opencli/OpenCliProperties.java

@@ -7,7 +7,7 @@
 import lombok.Data;
 
 /**
- * OpenCLI 运行时配置（纯 POJO，无 Spring 耦合）。
+ * OpenCLI runtime configuration POJO with no Spring dependency.
  * <p>
  * 描述可执行文件、工作目录、超时、全局 argv 前缀、远端 Agent 以及需要注入子进程的环境变量
  *（例如 {@code OPENCLI_CDP_ENDPOINT}）。Spring Boot 可由上层以
@@ -18,7 +18,26 @@
  * {@link OpenCliExecutionTarget#REMOTE_AGENT_HTTP} 模式下用作 HTTP 客户端超时上限。
  * </p>
  */
-@Data
+@Data/**
+
+ * OpenCLI runtime configuration POJO with no Spring dependency.
+ *
+ * <p>Describes the executable path, working directory, timeout, global argv prefix,
+ * remote Agent settings, and environment variables injected into the subprocess
+ * (e.g.&nbsp;{@code OPENCLI_CDP_ENDPOINT}). Spring Boot applications can bind these
+ * fields via {@code @ConfigurationProperties(prefix = "opencli")}.</p>
+ *
+ * <p>{@link #commandTimeoutMillis} is used as the subprocess watchdog timeout in local
+ * mode and as the HTTP client timeout in {@link OpenCliExecutionTarget#REMOTE_AGENT_HTTP} mode.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public class OpenCliProperties {
 
     /**

src/main/java/io/github/easy4j/opencli/adapter/browser/chatgpt/ChatgptOpenCliClient.java

@@ -18,7 +18,21 @@
 /**
  * OpenCLI {@code chatgpt}（ChatGPT Web）浏览器适配器。
  */
-@RequiredArgsConstructor
+@RequiredArgsConstructor/**
+
+ * OpenCLI {@code chatgpt} (ChatGPT Web) browser adapter client.
+ *
+ * <p>Provides typed methods for ChatGPT Web interactions such as {@code ask}, {@code send},
+ * {@code history}, {@code image}, and session management.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public final class ChatgptOpenCliClient {
 
     private final OpenCliExecutor executor;

src/main/java/io/github/easy4j/opencli/adapter/browser/claude/ClaudeOpenCliClient.java

@@ -19,7 +19,21 @@
 /**
  * OpenCLI {@code claude} 浏览器适配器。
  */
-@RequiredArgsConstructor
+@RequiredArgsConstructor/**
+
+ * OpenCLI {@code claude} browser adapter client.
+ *
+ * <p>Provides typed methods for Claude Web interactions such as {@code ask}, {@code send},
+ * {@code history}, {@code detail}, and session management.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public final class ClaudeOpenCliClient {
 
     private final OpenCliExecutor executor;

src/main/java/io/github/easy4j/opencli/adapter/browser/deepseek/DeepseekOpenCliClient.java

@@ -18,7 +18,21 @@
 /**
  * OpenCLI {@code deepseek} 浏览器适配器。
  */
-@RequiredArgsConstructor
+@RequiredArgsConstructor/**
+
+ * OpenCLI {@code deepseek} browser adapter client.
+ *
+ * <p>Provides typed methods for DeepSeek Web interactions such as {@code ask}, {@code send},
+ * {@code history}, {@code detail}, and session management.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public final class DeepseekOpenCliClient {
 
     private final OpenCliExecutor executor;

src/main/java/io/github/easy4j/opencli/adapter/browser/gemini/GeminiOpenCliClient.java

@@ -16,7 +16,21 @@
 /**
  * OpenCLI {@code gemini} 浏览器适配器。
  */
-@RequiredArgsConstructor
+@RequiredArgsConstructor/**
+
+ * OpenCLI {@code gemini} browser adapter client.
+ *
+ * <p>Provides typed methods for Gemini Web interactions such as {@code ask}, {@code image},
+ * {@code deepResearch}, {@code history}, and session management.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public final class GeminiOpenCliClient {
 
     private final OpenCliExecutor executor;

src/main/java/io/github/easy4j/opencli/adapter/browser/jimeng/JimengOpenCliClient.java

@@ -15,7 +15,22 @@
 /**
  * OpenCLI {@code jimeng}（即梦）浏览器适配器。
  */
-@RequiredArgsConstructor
+@RequiredArgsConstructor/**
+
+ * OpenCLI {@code jimeng} (Jimeng/JiMeng) browser adapter client.
+ *
+ * <p>Provides typed methods for Jimeng generative media interactions including
+ * text-to-image, image-to-image, text-to-video, image-to-video, audio generation,
+ * digital human, and action copy.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public final class JimengOpenCliClient {
 
     private final OpenCliExecutor executor;

src/main/java/io/github/easy4j/opencli/adapter/browser/support/BrowserLlmOptions.java

@@ -9,7 +9,19 @@
  * 浏览器侧 LLM 适配器常用的超时、是否新开会话、JSON 输出等选项。
  */
 @Data
-@Builder
+@Builder/**
+
+ * Common options shared across browser-based LLM adapters (timeout, model selection,
+ * new-chat toggle, JSON output, etc.).
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public class BrowserLlmOptions {
 
     private Integer timeoutSeconds;

src/main/java/io/github/easy4j/opencli/adapter/desktop/codex/CodexOpenCliClient.java

@@ -14,7 +14,21 @@
 /**
  * OpenCLI {@code codex} 桌面适配器封装（Chrome DevTools / Electron）。
  */
-@RequiredArgsConstructor
+@RequiredArgsConstructor/**
+
+ * OpenCLI {@code codex} desktop adapter client (Chrome DevTools / Electron).
+ *
+ * <p>Provides typed methods for Codex desktop interactions such as {@code send}, {@code ask},
+ * {@code read}, {@code projects}, {@code history}, model management, and conversation export.</p>
+
+ *
+
+ * @author [@Loong Wan](https://github.com/loong10k)
+
+ * @since 3.0.0
+
+ */
+
 public final class CodexOpenCliClient {
 
     private final OpenCliExecutor executor;