docs: complete SDK Javadoc and core flow comments

Author: loong10k

src/main/java/io/github/easy4j/opencode/HttpCallCancellation.java

@@ -2,13 +2,12 @@
 
 /**
  * Binds a business-layer cancellation signal to a single OpenCode HTTP call.
- *
  * <p>Implementations allow callers to register a cancellation callback that will be invoked
  * when the underlying HTTP call should be aborted. The {@link #onCancel(Runnable)} method
  * returns an {@link AutoCloseable} that, when closed, unregisters the callback.</p>
  *
- * @author [@Loong Wan](https://github.com/loong10k)
- * @since 3.0.0
+ * @author <a href="https://github.com/loong10k">Loong Wan</a>
+ * @since 1.0.0
  * @see io.github.easy4j.opencode.api.OpenCodeHttpClient
  */
 @FunctionalInterface
@@ -18,14 +17,14 @@ public interface HttpCallCancellation {
      * Registers a cancellation callback and returns a handle to unregister it.
      *
      * @param callback the runnable to invoke when cancellation is requested
-     * @return an {@link AutoCloseable} that unregisters the callback when closed
+     * @return OpenCode SDK 返回的回调注销句柄对象
      */
     AutoCloseable onCancel(Runnable callback);
 
     /**
      * Returns whether this cancellation has been triggered.
      *
-     * @return {@code true} if cancellation has been requested, {@code false} otherwise
+     * @return 满足条件返回 {@code true}，否则返回 {@code false}
      */
     default boolean isCancelled() {
         return false;

src/main/java/io/github/easy4j/opencode/HttpResponseMode.java

@@ -2,15 +2,24 @@
 
 /**
  * HTTP 对话响应模式。
+ *
+ * @author <a href="https://github.com/loong10k">Loong Wan</a>
+ * @since 1.0.0
  */
 public enum HttpResponseMode {
 
-    /** 等待完整响应后一次性返回。 */
+    /**
+     * blocking枚举值。
+     */
     BLOCKING,
 
-    /** 消费 Provider SSE 并逐段回调。 */
+    /**
+     * stream枚举值。
+     */
     STREAM,
 
-    /** 由调用方根据结构化输出等请求特征选择。 */
+    /**
+     * auto枚举值。
+     */
     AUTO
 }

src/main/java/io/github/easy4j/opencode/OpenCodeCliConfig.java

@@ -4,13 +4,12 @@
 
 /**
  * Configuration for the local OpenCode CLI subsystem.
- *
  * <p>Covers local {@code opencode} executable path, timeouts, working directory,
  * and other CLI runtime settings. Can be mapped from Spring
  * {@code @ConfigurationProperties}.</p>
  *
- * @author [@Loong Wan](https://github.com/loong10k)
- * @since 3.0.0
+ * @author <a href="https://github.com/loong10k">Loong Wan</a>
+ * @since 1.0.0
  * @see OpenCodeClient
  * @see OpenCodeClientConfig
  */