openclaw-multi-auto 1.4.6 → 1.4.7

package/docs/browser-architecture.md

@@ -0,0 +1,602 @@
+# OpenClaw 浏览器操作架构文档
+
+## 概述
+
+OpenClaw 提供完整的浏览器自动化能力，允许用户通过 CLI 或编程接口控制真实浏览器进行页面导航、截图、表单填写、代码执行等操作。
+
+## 整体架构
+
+```
+┌─────────────────────────────────────────────────────┐
+│                  用户/系统请求                          │
+│                           ↓                                  │
+│                  ┌─────────────┐                     │
+│                  │  CLI 命令层  │                     │
+│                  └─────────────┘                     │
+│                           ↓                                  │
+│                  ┌─────────────┐                     │
+│                  │ 浏览器控制 │                     │
+│                  └─────────────┘                     │
+│                           ↓                                  │
+│                  ┌─────────────┐                     │
+│                  │ Browser Server │                     │
+│                  │ (Express HTTP)│                     │
+│                  └─────────────┘                     │
+│                           ↓                                  │
+│                  ┌─────────────┐                     │
+│                  │ Playwright CDP │                     │
+│                  └─────────────┘                     │
+│                           ↓                                  │
+│                  ┌─────────────┐                     │
+│                  │ Chrome/Edge │                     │
+│                  └─────────────┘                     │
+│                           ↓                                  │
+│                  返回：截图、PDF、页面操作                    │
+└─────────────────────────────────────────────────────┘
+```
+
+## 核心组件
+
+### 1. 浏览器控制服务器
+
+**位置**: `src/browser/server.ts`
+
+**功能**:
+- 启动 HTTP 服务器监听本地端口 (默认配置的端口)
+- 接收来自 CLI 的控制命令
+- 管理浏览器会话状态和认证
+- 注册浏览器路由处理不同类型的请求
+
+**启动流程**:
+```typescript
+1. 加载配置 (loadConfig)
+2. 检查 browser.enabled 是否启用
+3. 解析浏览器控制认证配置
+4. 创建 Express 应用实例
+5. 安装通用中间件和认证中间件
+6. 创建路由上下文 (createBrowserRouteContext)
+7. 注册所有浏览器路由 (registerBrowserRoutes)
+8. 监听配置端口 (app.listen(port, "127.0.0.1"))
+9. 初始化扩展中继配置
+10. 返回服务器状态对象
+```
+
+**认证方式**:
+- **Token 认证**: 使用配置的 token (CDP endpoint auth)
+- **Password 认证**: 使用密码方式认证
+- **内置 Token**: 认证失败时自动生成的 gateway.auth.token
+- **关闭模式**: 不启用任何认证 (auth=off)
+
+### 2. 路由分发器
+
+**位置**: `src/browser/routes/dispatcher.ts`
+
+**功能**:
+- 将 HTTP 请求路由到对应的处理器
+- 支持参数解析和路径规范化
+- 提供统一的错误处理
+
+**支持的路由**:
+| 路由 | 方法 | 处理器 | 说明 |
+|------|------|--------|------|
+| `/status` | GET | 获取浏览器运行状态 |
+| `/navigate` | POST | 导航到指定 URL |
+| `/screenshot` | POST | 截取当前页面 |
+| `/pdf` | POST | 生成页面 PDF |
+| `/act` | POST | 执行各种操作 |
+| `/evaluate` | POST | 执行 JavaScript 代码 |
+
+### 3. Agent 操作路由
+
+**位置**: `src/browser/routes/agent.ts`
+
+**Agent 操作功能**:
+
+#### 3.1 导航操作 (`/navigate`)
+
+**请求参数**:
+```typescript
+{
+  url: string;        // 目标 URL (必需)
+  targetId?: string;   // 目标标签页 ID
+}
+```
+
+**实现流程**:
+```typescript
+1. 接收导航请求
+2. 获取目标 ID (resolveTargetIdFromBody)
+3. 进入 Playwright 路由上下文 (withPlaywrightRouteContext)
+4. 调用 pw.navigateViaPlaywright()
+5. 传递导航策略 (withBrowserNavigationPolicy)
+6. 执行导航到目标 URL
+7. 导航后可能触发渲染器切换 (resolveTargetIdAfterNavigate)
+8. 获取最新目标 ID
+9. 返回目标 ID 和 URL
+
+响应示例:
+```json
+{
+  "ok": true,
+  "targetId": "chrome-tab-12345",
+  "url": "https://example.com"
+}
+```
+
+#### 3.2 截图操作 (`/screenshot`)
+
+**请求参数**:
+```typescript
+{
+  targetId?: string;   // 目标标签页 ID (可选)
+  fullPage?: boolean; // 是否截取整个页面 (可选，默认 false)
+  ref?: string;        // 引用 ID (可选)
+}
+```
+
+**实现流程**:
+```typescript
+1. 接收截图请求
+2. 获取目标 ID
+3. 进入 Playwright 路由上下文
+4. 规范化截图配置 (normalizeBrowserScreenshot)
+5. 调用 pw.pdfViaPlaywright() - 截取为 PDF
+6. 检查文件大小是否超过限制
+7. 调用 saveBrowserMediaResponse() 保存媒体文件
+8. 返回保存的文件路径和 URL
+
+响应示例:
+```json
+{
+  "ok": true,
+  "path": "/media/browser/screenshot-20240313-123456.png",
+  "targetId": "chrome-tab-12345",
+  "url": "https://example.com"
+}
+```
+
+#### 3.3 PDF 操作 (`/pdf`)
+
+**请求参数**:
+```typescript
+{
+  targetId?: string;   // 目标标签页 ID
+}
+```
+
+**实现流程**:
+```typescript
+1. 接收 PDF 生成请求
+2. 获取目标 ID
+3. 进入 Playwright 路由上下文
+4. 调用 pw.pdfViaPlaywright()
+5. 生成 PDF 文件
+6. 保存媒体文件 (saveBrowserMediaResponse)
+7. 返回保存的文件路径
+
+#### 3.4 操作执行 (`/act`)
+
+**支持的操作类型**:
+
+##### 点击操作 (`kind=click`)
+```typescript
+{
+  ref?: string;           // 元素引用 ID
+  button?: string;        // 按钮标识 (left/right/middle)
+  doubleClick?: boolean;  // 是否双击
+  timeoutMs?: number;    // 超时时间 (毫秒)
+  modifiers?: string[];  // 修饰符 (ctrl, shift, alt, meta)
+}
+```
+
+**支持的按钮标识**:
+- `left` - 左键按钮
+- `right` - 右键按钮
+- `middle` - 中间按钮
+
+**支持的修饰符**:
+- `ctrl` - Control 键
+- `shift` - Shift 键
+- `alt` - Alt 键
+- `meta` - Meta 键
+
+##### 输入操作 (`kind=type`)
+```typescript
+{
+  ref?: string;           // 元素引用 ID
+  text?: string;         // 要输入的文本
+  submit?: boolean;      // 是否触发表单提交
+  slowly?: boolean;     // 是否慢速输入
+  timeoutMs?: number;    // 超时时间 (毫秒)
+}
+```
+
+##### 按键操作 (`kind=press`)
+```typescript
+{
+  ref?: string;           // 元素引用 ID
+  key?: string;          // 要按的键
+  delayMs?: number;     // 按键延迟 (毫秒)
+}
+```
+
+##### 悬停操作 (`kind=hover`)
+```typescript
+{
+  ref?: string;           // 元素引用 ID
+  timeoutMs?: number;    // 悬停超时 (毫秒)
+}
+```
+
+##### 滚动操作 (`kind=scroll`)
+```typescript
+{
+  ref?: string;           // 元素引用 ID
+}
+```
+
+### 4. Playwright 集成
+
+**位置**: `src/browser/pw-ai.ts`
+
+**功能**:
+- 创建 Playwright 客户端连接到 Chrome/Edge
+- 提供 CDP (Chrome DevTools Protocol) 接口
+- 管理浏览器会话和标签页
+- 提供截图、PDF、导航等高级功能
+
+**核心 API**:
+
+```typescript
+// 导航
+await pw.navigateViaPlaywright({
+  cdpUrl,
+  targetId,
+  url,
+  ...navigationPolicy
+});
+
+// 截图
+await pw.pdfViaPlaywright({
+  cdpUrl,
+  targetId
+});
+
+// 点击
+await pw.clickViaPlaywright({
+  cdpUrl,
+  targetId,
+  ref,
+  button,
+  doubleClick,
+  modifiers
+});
+
+// 输入
+await pw.typeViaPlaywright({
+  cdpUrl,
+  targetId,
+  ref,
+  text,
+  submit,
+  slowly
+});
+
+// 按键
+await pw.pressKeyViaPlaywright({
+  cdpUrl,
+  targetId,
+  key,
+  delayMs
+});
+
+// 悬停
+await pw.hoverViaPlaywright({
+  cdpUrl,
+  targetId,
+  ref,
+  timeoutMs
+});
+```
+
+### 5. 配置系统
+
+**浏览器配置位置**: `src/browser/config.ts`
+
+**配置项**:
+
+```typescript
+interface BrowserConfig {
+  enabled: boolean;          // 是否启用浏览器控制
+  headless: boolean;         // 是否无头模式
+  controlPort: number;       // 控制服务器端口
+  cdpUrl?: string;          // CDP 端点 URL
+  token?: string;            // CDP 认证 token
+  password?: string;          // CDP 认证密码
+  sandboxed?: boolean;       // 是否沙盒模式
+}
+```
+
+**会话状态管理**:
+
+```typescript
+interface BrowserServerState {
+  server: Server;           // HTTP 服务器实例
+  port: number;            // 监听端口
+  profiles: Map<string, ProfileStatus>;  // 浏览器配置文件集合
+}
+```
+
+**Profile 状态**:
+
+```typescript
+interface ProfileStatus {
+  name: string;            // Profile 名称
+  cdpPort: number;         // CDP 端口
+  cdpUrl: string;           // CDP URL
+  color: string;            // 浏览器颜色标识
+  running: boolean;          // 是否正在运行
+  tabCount: number;          // 打开的标签页数量
+  isDefault: boolean;        // 是否为默认 profile
+  isRemote: boolean;         // 是否为远程 profile
+}
+```
+
+### 6. 媒体存储
+
+**位置**: `src/media/store.js`
+
+**功能**:
+- 保存截图和 PDF 文件
+- 管理媒体文件目录
+- 限制单个文件大小
+- 支持文件大小统计
+
+**媒体类型**:
+- PNG 图片 (`.png`)
+- JPEG 图片 (`.jpeg`)
+- PDF 文档 (`.pdf`)
+
+**路径规则**:
+- 截图: `/media/browser/`
+- PDF: `/media/browser/`
+
+### 7. 错误处理
+
+**错误类型**:
+1. **配置错误** - 浏览器未启用、认证配置无效
+2. **连接错误** - CDP 连接失败、浏览器未启动
+3. **操作错误** - 元素未找到、操作失败
+4. **超时错误** - 操作执行超时
+5. **存储错误** - 文件保存失败、磁盘空间不足
+
+**错误响应格式**:
+```json
+{
+  "ok": false,
+  "error": "错误描述"
+}
+```
+
+### 8. 安全特性
+
+**认证安全**:
+- Token 认证使用配置文件中的安全 token
+- Password 认证使用环境变量或安全存储
+- 认证失败时拒绝操作
+
+**沙盒隔离**:
+- 支持沙盒模式运行浏览器
+- 限制文件系统访问
+- 隔离不同 Profile 的会话
+
+### 9. CLI 命令使用
+
+**查看浏览器状态**:
+```bash
+openclaw browser status
+```
+
+**导航到 URL**:
+```bash
+openclaw browser navigate --url https://example.com
+```
+
+**截图**:
+```bash
+openclaw browser screenshot
+# 全屏截图
+```
+
+**生成 PDF**:
+```bash
+openclaw browser pdf --url https://example.com
+```
+
+**执行操作**:
+```bash
+# 点击按钮
+openclaw browser act --kind click --button submit
+
+# 输入文本
+openclaw browser act --kind type --text "Hello, World!"
+
+# 按键
+openclaw browser act --kind press --key Enter
+
+# 悬停元素
+openclaw browser act --kind hover
+```
+
+**指定 Profile**:
+```bash
+openclaw browser --profile my-chrome-profile navigate --url https://example.com
+```
+
+### 10. 扩展性
+
+**支持的浏览器**:
+- Google Chrome
+- Microsoft Edge
+- Chromium (通过 CDP)
+
+**多 Profile 支持**:
+- 同时管理多个浏览器配置
+- 每个 Profile 独立的会话
+- 支持远程和本地 Profile
+
+**插件系统**:
+- 支持浏览器扩展安装
+- 通过 hooks 系统扩展功能
+
+## 使用示例
+
+### 示例 1: 自动化表单填写
+
+```bash
+# 1. 导航到表单页面
+openclaw browser navigate --url https://example.com/form
+
+# 2. 等待页面加载 (在代码中添加延迟)
+
+# 3. 输入名字
+openclaw browser act --kind type --text "John Doe"
+
+# 4. 输入邮箱
+openclaw browser act --kind type --text "john@example.com"
+
+# 5. 提交表单
+openclaw browser act --kind click --button submit
+
+# 6. 截图确认
+openclaw browser screenshot
+```
+
+### 示例 2: 生成 PDF 报告
+
+```bash
+# 1. 导航到报告页面
+openclaw browser navigate --url https://example.com/report
+
+# 2. 生成 PDF
+openclaw browser pdf
+
+# 3. PDF 文件保存到 /media/browser/report-20240313.pdf
+```
+
+### 示例 3: 页面交互
+
+```bash
+# 导航到页面
+openclaw browser navigate --url https://example.com/dashboard
+
+# 点击刷新按钮
+openclaw browser act --kind click --ref refresh-button
+
+# 等待页面加载完成
+# 截图确认新内容
+openclaw browser screenshot
+```
+
+## 技术细节
+
+### Playwright CDP 连接
+
+OpenClaw 使用 Playwright 的 CDP (Chrome DevTools Protocol) 连接方式与浏览器通信：
+
+```typescript
+const pw = new PwAi({
+    endpoint: config.cdpUrl,
+    token: config.cdpToken,
+    headless: config.headless
+});
+```
+
+**优点**:
+- 原生浏览器性能
+- 完整的 DevTools 支持
+- 支持所有现代浏览器特性
+- 更好的调试能力
+
+**要求**:
+- 浏览器必须支持远程调试
+- 需要正确的端点 URL 和认证信息
+
+### 状态管理
+
+浏览器控制服务器维护以下状态：
+
+1. **服务器状态** - HTTP 服务器是否运行
+2. **Profile 状态** - 每个 Profile 的连接和使用状态
+3. **会话状态** - 标签页、导航历史等
+4. **认证状态** - 当前使用的认证方式
+
+### 日志记录
+
+浏览器操作通过以下日志级别记录：
+
+1. **INFO** - 正常操作日志
+2. **WARN** - 警告信息 (认证失败、重试等)
+3. **ERROR** - 错误信息 (连接失败、操作失败等)
+4. **DEBUG** - 调试信息 (详细的请求/响应)
+
+日志子系统: `browser-server`
+
+## 故障排查
+
+### 常见问题
+
+**问题 1**: 浏览器无法连接
+```
+解决方案:
+1. 检查浏览器是否支持远程调试
+2. 验证 CDP 端点 URL 和端口
+3. 确认认证信息正确
+4. 检查浏览器是否正在运行
+```
+
+**问题 2**: 操作超时
+```
+解决方案:
+1. 增加 timeoutMs 参数
+2. 检查网络连接稳定性
+3. 确认目标页面已加载完成
+```
+
+**问题 3**: 元素未找到
+```
+解决方案:
+1. 检查选择器表达式是否正确
+2. 使用 ref 参数引用正确的元素
+3. 等待页面完全加载后再操作
+```
+
+### 性能优化
+
+1. **并发控制**: 限制同时进行的浏览器操作数量
+2. **缓存**: 缓存浏览器连接和会话
+3. **懒加载**: 按需加载 Playwright 模块
+4. **资源清理**: 及时清理不再使用的媒体文件
+
+## 安全考虑
+
+1. **认证保护**: Token 和 Password 不应在日志中明文显示
+2. **输入验证**: 所有用户输入必须经过验证
+3. **CSRF 防护**: 跨站请求需要适当保护
+4. **文件大小限制**: 防止过大的媒体文件占用磁盘
+5. **沙盒隔离**: 不同 Profile 之间的操作应该隔离
+
+## API 参考
+
+详细的 API 文档请参考源代码中的类型定义：
+
+- `src/browser/server.ts` - 服务器配置和启动
+- `src/browser/routes/dispatcher.ts` - 路由分发
+- `src/browser/routes/agent.ts` - Agent 操作处理
+- `src/browser/pw-ai.ts` - Playwright 集成
+- `src/browser/client.ts` - 客户端类型和状态
+- `src/browser/routes/types.ts` - 路由类型定义
+
+## 更新日志
+
+本文档描述了 OpenClaw 浏览器操作架构的主要组件和数据流。如有更新，请参考源代码中的最新实现。

package/extensions/googlechat/node_modules/.bin/openclaw

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../openclaw/openclaw.mjs" "$@"

package/extensions/memory-core/node_modules/.bin/openclaw

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.11_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules/openclaw/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openclaw@2026.3.13_@napi-rs+canvas@0.1.96_@types+express@5.0.6_node-llama-cpp@3.16.2_typescript@5.9.3_/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../openclaw/openclaw.mjs" "$@"

package/extensions/memory-lancedb/node_modules/.bin/openai

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.27.0_ws@8.19.0_zod@4.3.6/node_modules/openai/bin/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.27.0_ws@8.19.0_zod@4.3.6/node_modules/openai/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.27.0_ws@8.19.0_zod@4.3.6/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.29.0_ws@8.19.0_zod@4.3.6/node_modules/openai/bin/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.29.0_ws@8.19.0_zod@4.3.6/node_modules/openai/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.29.0_ws@8.19.0_zod@4.3.6/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.27.0_ws@8.19.0_zod@4.3.6/node_modules/openai/bin/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.27.0_ws@8.19.0_zod@4.3.6/node_modules/openai/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.27.0_ws@8.19.0_zod@4.3.6/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.29.0_ws@8.19.0_zod@4.3.6/node_modules/openai/bin/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.29.0_ws@8.19.0_zod@4.3.6/node_modules/openai/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/openai@6.29.0_ws@8.19.0_zod@4.3.6/node_modules:/Users/zhoujinyu/Documents/projects/repo/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../openai/bin/cli" "$@"

package/extensions/page-action-cache/dist/actions-executor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Actions Executor
+ * 操作执行器 - 执行缓存的原子化操作
+ */
+import type { AtomicAction, ExecutionResult, PwAi, VariableMap } from "./types.js";
+/**
+ * 操作执行器
+ */
+export declare class ActionsExecutor {
+    private pw;
+    private cdpUrl;
+    constructor(cdpUrl?: string);
+    /**
+     * 设置 Playwright 客户端
+     */
+    setPlaywrightClient(pw: PwAi): void;
+    /**
+     * 设置 CDP URL
+     */
+    setCdpUrl(cdpUrl: string): void;
+    /**
+     * 执行单个操作
+     */
+    execute(action: AtomicAction, variables?: VariableMap): Promise<ExecutionResult>;
+    /**
+     * 批量执行操作
+     */
+    executeBatch(actions: AtomicAction[], variables?: VariableMap, options?: {
+        fromIndex?: number;
+        toIndex?: number;
+        atomic?: boolean;
+    }): Promise<ExecutionResult[]>;
+    private executeNavigate;
+    private executeClick;
+    private executeType;
+    private executePress;
+    private executeHover;
+    private executeScreenshot;
+    private executeEvaluate;
+    /**
+     * 应用变量到操作
+     */
+    private applyVariables;
+    /**
+     * 替换操作中的模板变量
+     */
+    private replaceTemplateVariables;
+    /**
+     * 格式化操作列表
+     */
+    formatActions(actions: AtomicAction[]): string;
+    /**
+     * 格式化单个操作
+     */
+    private formatAction;
+    /**
+     * 格式化执行结果
+     */
+    formatExecutionResults(results: ExecutionResult[]): string;
+}
+export declare function getActionsExecutor(cdpUrl?: string): ActionsExecutor;
+//# sourceMappingURL=actions-executor.d.ts.map