rl-rock 1.2.4 → 1.2.6

package/README.md

@@ -11,8 +11,9 @@ ROCK (Remote Operation Container Kit) TypeScript SDK - 用于管理远程沙箱
 - 🚀 **沙箱管理** - 创建、启动、停止远程容器沙箱
 - 📁 **文件系统** - 上传、下载、读取、写入文件
 - 🖥️ **命令执行** - 同步/异步执行 Shell 命令
-- 🔧 **运行时环境** - 支持 Python、Node.js 运行时环境管理
-- 🤖 **Agent 框架** - 内置 Agent 支持自动化任务
+- 🔧 **运行时环境** - 支持 Python、Node.js 运行时环境管理（沙箱内安装）
+- 🤖 **模型服务** - 沙箱内模型服务安装与生命周期管理
+- 🎯 **Agent 框架** - 内置 Agent 支持自动化任务编排
 - 📦 **EnvHub** - 环境注册与管理
 - 🔄 **双模式构建** - 同时支持 ESM 和 CommonJS
 
@@ -128,6 +129,80 @@ const [obs, reward, terminated, truncated, info] = await env.step('action');
 await env.close();
 ```
 
+### 使用 RuntimeEnv (沙箱内运行时环境)
+
+```typescript
+import { Sandbox, RuntimeEnv, PythonRuntimeEnvConfig } from 'rl-rock';
+
+const sandbox = new Sandbox({ ... });
+await sandbox.start();
+
+// 创建 Python 运行时环境配置
+const pythonConfig: PythonRuntimeEnvConfig = {
+  type: 'python',
+  version: '3.11',
+  pipPackages: ['requests', 'numpy'],
+};
+
+// 在沙箱内安装 Python 运行时
+const runtimeEnv = await RuntimeEnv.create(sandbox, pythonConfig);
+
+// 使用 Python 执行命令
+await runtimeEnv.run('python -c "import requests; print(requests.__version__)"');
+```
+
+### 使用 ModelService (沙箱内模型服务)
+
+```typescript
+import { Sandbox, ModelService, ModelServiceConfig } from 'rl-rock';
+
+const sandbox = new Sandbox({ ... });
+await sandbox.start();
+
+// 创建模型服务配置
+const modelServiceConfig: ModelServiceConfig = {
+  enabled: true,
+  installCmd: 'pip install rl_rock[model-service]',
+};
+
+// 在沙箱内安装并启动模型服务
+const modelService = new ModelService(sandbox, modelServiceConfig);
+await modelService.install();
+await modelService.start();
+
+// 监控 Agent 进程
+await modelService.watchAgent('12345');
+
+// 停止服务
+await modelService.stop();
+```
+
+### 使用 Agent (自动化任务编排)
+
+```typescript
+import { Sandbox, DefaultAgent, RockAgentConfig } from 'rl-rock';
+
+const sandbox = new Sandbox({ ... });
+await sandbox.start();
+
+// 配置 Agent
+const agentConfig: RockAgentConfig = {
+  agentSession: 'my-agent-session',
+  runCmd: 'python agent.py --prompt {prompt}',
+  workingDir: './my-project',  // 本地目录，自动上传到沙箱
+  runtimeEnvConfig: { type: 'python', version: '3.11' },
+  modelServiceConfig: { enabled: true },
+};
+
+// 创建并安装 Agent
+const agent = new DefaultAgent(sandbox);
+await agent.install(agentConfig);
+
+// 运行 Agent
+const result = await agent.run('Please analyze the codebase');
+console.log(result.output);
+```
+
 ## 配置
 
 ### 环境变量
@@ -175,6 +250,9 @@ interface SandboxConfig {
 | `envhub-usage.ts` | EnvHub 环境管理示例 |
 | `sandbox-group.ts` | 沙箱组批量操作示例 |
 | `complete-workflow.ts` | 完整开发工作流示例 |
+| `runtime-env-usage.ts` | 运行时环境管理示例 |
+| `model-service-usage.ts` | 模型服务使用示例 |
+| `agent-usage.ts` | Agent 自动化任务示例 |
 
 ### 运行示例