Merge pull request #852 from Gujiassh/docs/kotlin-code-interpreter-pip-648

docs(kotlin): clarify code-interpreter image for pip usage

Author: Pangjiping

sdks/code-interpreter/kotlin/README.md

@@ -102,6 +102,28 @@ The Code Interpreter SDK relies on a specialized environment. Ensure your sandbo
 
 For detailed information about supported languages and versions, please refer to the [Environment Documentation](../../../sandboxes/code-interpreter/README.md).
 
+### Troubleshooting: `pip: command not found`
+
+If you are using the Kotlin/Java client and run shell commands such as
+`pip install pandas`, make sure the sandbox is created from the
+`opensandbox/code-interpreter` image (or a derivative) and uses the
+Code Interpreter entrypoint:
+
+```java
+Sandbox sandbox = Sandbox.builder()
+    .image("opensandbox/code-interpreter:v1.0.2")
+    .entrypoint("/opt/opensandbox/code-interpreter.sh")
+    .env("PYTHON_VERSION", "3.11")
+    .build();
+```
+
+The plain Sandbox SDK can also talk to generic sandbox images, but those
+images are not guaranteed to include Python or `pip`. In that case,
+commands such as `pip install ...` will fail with `pip: command not found`.
+Use the package manager that matches the image you launched, or switch to the
+Code Interpreter image when you need Python package installation/runtime
+behavior.
+
 ### Language Version Selection
 
 You can specify the desired version of a programming language by setting the corresponding environment variable when building the `Sandbox`.

sdks/code-interpreter/kotlin/README_zh.md

@@ -102,6 +102,25 @@ Code Interpreter SDK 依赖于特定的运行环境。请确保你的沙箱服
 
 关于支持的语言和具体版本的详细信息，请参考 [环境文档](../../../sandboxes/code-interpreter/README_zh.md)。
 
+### 排错：`pip: command not found`
+
+如果你在 Kotlin / Java 客户端里执行了 `pip install pandas` 这类命令，请先确认
+当前沙箱使用的是 `opensandbox/code-interpreter` 镜像（或其衍生镜像），并且入口点
+是 Code Interpreter 的启动脚本：
+
+```java
+Sandbox sandbox = Sandbox.builder()
+    .image("opensandbox/code-interpreter:v1.0.2")
+    .entrypoint("/opt/opensandbox/code-interpreter.sh")
+    .env("PYTHON_VERSION", "3.11")
+    .build();
+```
+
+普通 Sandbox SDK 也可以连接任意通用沙箱镜像，但这些镜像并不保证预装 Python 或
+`pip`。在这种情况下，执行 `pip install ...` 会报 `pip: command not found`。
+如果需要 Python 运行时和包管理能力，请切换到 Code Interpreter 镜像；否则请使用
+与你当前镜像匹配的包管理方式。
+
 ### 语言版本选择
 
 你可以在创建 `Sandbox` 时通过环境变量指定所需的编程语言版本。