From 49a4c9eb01192dbd999dc24d750f9c0425cf9654 Mon Sep 17 00:00:00 2001
From: slhafzjw <slhafzjw@slhaf.work>
Date: Sun, 21 Dec 2025 22:05:46 +0800
Subject: [PATCH] docs(RunnerClient): add architecture-location comment on
 RunnerClient

---
 .../core/action/runner/RunnerClient.java        | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Partner-Main/src/main/java/work/slhaf/partner/core/action/runner/RunnerClient.java b/Partner-Main/src/main/java/work/slhaf/partner/core/action/runner/RunnerClient.java
index 019c104c..3798cf78 100644
--- a/Partner-Main/src/main/java/work/slhaf/partner/core/action/runner/RunnerClient.java
+++ b/Partner-Main/src/main/java/work/slhaf/partner/core/action/runner/RunnerClient.java
@@ -39,6 +39,23 @@ import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.function.Consumer;
 import java.util.function.Function;
 
+/**
+ * 执行客户端抽象类
+ * <br/>
+ * 只负责暴露序列化、执行等相应接口，具体逻辑交给下游实现
+ * <br/>
+ * 默认存在两类实现，{@link LocalRunnerClient} 和 {@link SandboxRunnerClient}
+ * <ol>
+ *     LocalRunnerClient:
+ *     <li>
+ *         对应本地运行环境，可在本地启动 MCP 客户端将 RunnerClient 暴露的能力接口转发至本地 MCP Client 并执行
+ *     </li>
+ *     SandboxRunnerClient:
+ *     <li>
+ *         对应沙盒运行环境，该 Client 仅作为沙盒环境的客户端，不持有额外能力，仅保持远端连接已存在行动的内容更新
+ *     </li>
+ * </ol>
+ */
 @Slf4j
 public abstract class RunnerClient {