@optima-chat/browser-cli 0.5.1 → 0.5.3

package/.claude/skills/browser/SKILL.md

@@ -0,0 +1,245 @@
+---
+name: browser
+description: "Browser automation for web interactions. Use when user needs to open/navigate to websites, login to platforms, fill forms, post content, test websites, or operate on third-party platforms without APIs. Uses 'browser-cli' commands. Do NOT use for simple web scraping (use WebFetch) or tasks that have dedicated skills (e.g. scout, tiktok, instagram, shein, etc.)."
+version: "1.0.0"
+owner_repo: Optima-Chat/optima-browser-use
+---
+
+# 浏览器自动化 Skill
+
+## 使用场景
+
+- 用户要求打开网站或访问某个 URL（如"打开 github"、"open youtube"）
+- 用户要求登录平台、填写表单或发布内容
+- 用户需要测试网站功能
+- 用户需要操作没有 API 的第三方平台
+- 用户要求自动化浏览器交互
+
+**不适用场景：**
+- 简单网页抓取 → 使用 WebFetch
+- 已有专用 skill 的任务（如 scout、tiktok、instagram、shein 等）
+
+## 脚本优先原则
+
+每次执行浏览器任务前，**先检查是否有现成脚本**：
+
+1. `browser-cli scripts` — 查看已有脚本（显示名称、描述、步骤）
+2. 如果有匹配的脚本 → 直接用 `browser-cli runscript <name> --param ...`
+3. 如果没有 → 手动用 browser-cli 命令完成任务
+
+脚本执行零 token 消耗，比手动操作快 10 倍以上。
+
+## 浏览器模式
+
+系统支持三种浏览器模式，自动选择最优方案：
+
+| 模式 | 触发条件 | 说明 |
+|------|----------|------|
+| **Desktop + 紫鸟** | 用户安装了 Desktop app 且配置了紫鸟 | 通过紫鸟反指纹浏览器操作，保留多店铺登录态 |
+| **Desktop + Chrome** | 用户安装了 Desktop app | 通过用户本地 Chrome 操作 |
+| **Cloud** | 无 Desktop app | 后端 headless Chromium，无登录态 |
+
+**自动路由**：默认 `browser-cli launch` 会自动选择。如果用户安装了 Optima Browser Operator 桌面应用并在线，自动走 Desktop 模式。
+
+### 紫鸟浏览器（跨境电商多店铺管理）
+
+当用户提到紫鸟、多店铺、反指纹浏览器、或需要操作特定店铺时：
+
+```bash
+# 设置紫鸟凭证（首次使用）
+browser-cli ziniao set --company "公司名" --username "用户名" --password "密码"
+
+# 查看紫鸟配置
+browser-cli ziniao show
+
+# 使用紫鸟指定店铺启动浏览器
+browser-cli launch --connector ziniao --ziniao-profile <profile_id> --url <url>
+
+# 普通启动（自动选择模式）
+browser-cli launch --url <url>
+```
+
+**紫鸟 profile_id** 需要从 Desktop app 的 capabilities 获取，或者用户直接提供。
+
+## 命令
+
+### 会话管理
+
+```bash
+browser-cli launch [--url <url>] [--force]  # 启动浏览器（自动选择模式）
+browser-cli launch --connector ziniao --ziniao-profile <id> [--url <url>]  # 指定紫鸟店铺
+browser-cli launch --connector chrome [--url <url>]  # 指定 Chrome
+browser-cli close                            # 关闭浏览器并释放资源
+browser-cli status                           # 查看当前会话状态
+```
+
+### 导航
+
+```bash
+browser-cli navigate <url>            # 跳转到 URL
+browser-cli back                      # 后退
+browser-cli refresh                   # 刷新页面
+```
+
+### 交互
+
+```bash
+browser-cli click <index>             # 按索引点击元素
+browser-cli input <index> <text> [--no-clear]  # 输入文本（--no-clear 追加而非替换）
+browser-cli select <index> <option>   # 选择下拉选项
+browser-cli scroll <up|down> [--pages <n>]     # 滚动页面（默认 1 页）
+browser-cli keys <key>                # 键盘操作（Enter、Tab 等）
+browser-cli upload <index> <file...>  # 上传文件到 file input（路径自动转换）
+```
+
+### 页面检查
+
+```bash
+browser-cli dom                       # 获取当前 DOM 状态
+browser-cli screenshot [file]         # 截图（默认：/tmp/screenshot.png）
+browser-cli search <pattern>          # 搜索页面文本
+browser-cli find <css_selector>       # 通过 CSS 选择器查询
+```
+
+### 标签页管理
+
+```bash
+browser-cli tabs                      # 列出所有标签页
+browser-cli switch <tab_id>           # 切换标签页
+browser-cli close-tab <tab_id>        # 关闭标签页
+```
+
+### 脚本
+
+```bash
+browser-cli scripts                                        # 列出所有脚本（含描述和步骤）
+browser-cli script-code <name>                             # 查看脚本源码
+browser-cli runscript <name> --param key=value [...]       # 执行脚本（自动轮询到完成）
+browser-cli runscript <name> --param key=value --no-poll   # 执行但不等待
+browser-cli script-task <task-id>                          # 查询执行状态
+browser-cli submit-script --name <name> --code-file <path> # 提交新脚本（新建或覆盖）
+browser-cli delete-script <name>                           # 删除脚本
+```
+
+### Profile 管理
+
+```bash
+browser-cli profiles                   # 列出浏览器 profile
+browser-cli delete-profile <id>        # 删除 profile
+browser-cli launch --profile <id>      # 用指定 profile 启动
+browser-cli runscript <name> --profile <id> --param ...  # 用指定 profile 执行脚本
+```
+
+## DOM 索引格式
+
+每个操作都会返回当前 DOM 状态，格式如下：
+
+```
+[N]<tag attributes />
+    content
+```
+
+- 索引号 (N) **不连续**（如 [7]、[20]、[30]）— 这是正常的
+- 每次操作后索引会**重新分配** — 务必使用最新的索引
+- 使用这些索引来执行 `click`、`input` 和 `select` 命令
+
+## 操作流程
+
+### 流程一：有脚本（常见）
+
+```bash
+# 1. 检查脚本
+browser-cli scripts
+
+# 2. 直接执行
+browser-cli runscript xiaohongshu-image-note \
+  --param title="今日分享" \
+  --param body="内容..." \
+  --param 'images=["~/images/photo1.jpg", "~/images/photo2.jpg"]'
+# 输出: ✓ Script completed
+
+# 小红书评论
+browser-cli runscript xiaohongshu-comment \
+  --param search_keyword="辞职做跨境电商" \
+  --param comment="写得好！"
+
+# 小红书数据采集
+browser-cli runscript xiaohongshu-data-collect
+
+# Instagram 发帖
+browser-cli runscript instagram-image-post \
+  --param 'images=["~/images/photo.jpg"]' \
+  --param body="Morning vibes ☕"
+```
+
+### 流程二：无脚本（手动操作）
+
+```bash
+# 1. 启动浏览器
+browser-cli launch --url https://example.com
+
+# 2. 查看 DOM，找到要操作的元素
+browser-cli dom
+
+# 3. 操作元素（用 DOM 返回的索引）
+browser-cli click 15
+browser-cli input 22 "内容"
+browser-cli keys Enter
+
+# 4. 完成后关闭
+browser-cli close
+```
+
+### 流程三：脚本失败（Fallback）
+
+```bash
+# 1. 执行脚本
+browser-cli runscript xiaohongshu-image-note --param ...
+# 输出: ⚠ Script needs fallback
+# → 显示已完成和剩余步骤
+
+# 2. Session 仍然打开 — 用手动命令继续完成剩余步骤
+browser-cli dom
+browser-cli click 15
+browser-cli input 22 "内容"
+
+# 3. 完成后关闭
+browser-cli close
+```
+
+## 文件路径
+
+浏览器后端可以直接读取用户工作空间的文件。传文件路径时直接使用你看到的路径即可，后端会自动转换：
+
+```
+~/images/photo.jpg              → 自动转换 ✓
+/home/aiuser/images/photo.jpg   → 自动转换 ✓
+/mnt/efs/{userId}/images/...    → 自动转换 ✓
+```
+
+## 需要用户登录态的任务
+
+当用户要求操作需要登录的平台（TikTok Shop、小红书、Instagram 等），需要用户的真实浏览器（有登录态）。
+
+**推荐方案：Optima Browser Operator 桌面应用**
+
+1. 用户下载安装桌面应用（Mac .dmg / Windows .exe）：https://github.com/Optima-Chat/optima-browser-use/releases
+2. 首次启动自动打开浏览器登录授权
+3. 授权后自动连接，后续 `browser-cli launch` 自动走 Desktop 模式
+
+**跨境电商用户（多店铺）**：推荐安装紫鸟浏览器 + Desktop app，可以按店铺 profile 分别操作，每个店铺独立登录态。
+
+**备选方案：Chrome 扩展**
+
+安装 Optima Browser Operator Chrome 扩展，直接用 Chrome 已登录的账号操作。
+
+## 注意事项
+
+- **脚本优先**：每次操作前先 `browser-cli scripts`，有脚本就用脚本
+- **DOM 自动返回**：每个操作会自动返回 DOM 状态 — 无需单独调用 `browser-cli dom`
+- **避免不必要的截图**：截图消耗 token，日常导航用 DOM 输出即可
+- **5 分钟超时**：无操作 5 分钟后会话自动关闭
+- **务必关闭**：操作完成后运行 `browser-cli close` 释放资源
+- **login_required 处理**：如果 runscript 返回 `login_required` 错误，说明该平台未登录。如果用户已安装 Extension 且 Extension 已连接，用户的 Chrome 通常已经登录了——让用户在自己的 Chrome 里手动登录该平台，然后重新 `runscript`。如果没有 Extension（走 Chromium），用 `browser-cli launch --url <平台URL>` 引导用户登录
+- **Fallback 后更新脚本**：如果脚本频繁失败，重新生成并 submit-script 覆盖
+- **Extension 模式**：标记了 `REQUIRES_USER_SESSION=True` 的脚本会自动使用用户的真实 Chrome（通过 Optima Browser Operator 扩展），未标记的脚本走 Chromium。这由后端自动判断，无需手动指定

package/dist/index.js

@@ -155,11 +155,13 @@ async function requestBinary(path) {
   return Buffer.from(arrayBuffer);
 }
 var BrowserAPI = class {
-  async createSession(url, profileId, force) {
+  async createSession(url, profileId, force, connector, ziniaoProfileId) {
     const body = {};
     if (url) body.url = url;
     if (profileId) body.profile_id = profileId;
     if (force) body.force = true;
+    if (connector) body.connector = connector;
+    if (ziniaoProfileId) body.ziniao_profile_id = ziniaoProfileId;
     return request("/api/sessions", {
       method: "POST",
       body: JSON.stringify(body)
@@ -173,6 +175,18 @@ var BrowserAPI = class {
       method: "DELETE"
     });
   }
+  async setZiNiaoConfig(company, username, password) {
+    return request("/api/user/ziniao-config", {
+      method: "PUT",
+      body: JSON.stringify({ company, username, password })
+    });
+  }
+  async getZiNiaoConfig() {
+    return request("/api/user/ziniao-config");
+  }
+  async deleteZiNiaoConfig() {
+    return request("/api/user/ziniao-config", { method: "DELETE" });
+  }
   async closeSession(sessionId) {
     await request(`/api/sessions/${sessionId}`, { method: "DELETE" });
   }
@@ -266,50 +280,6 @@ var BrowserAPI = class {
       body: JSON.stringify({ index, file_paths: filePaths })
     });
   }
-  // Workflow methods
-  async saveWorkflow(sessionId, name, description) {
-    return request("/api/workflows", {
-      method: "POST",
-      body: JSON.stringify({ session_id: sessionId, name, description })
-    });
-  }
-  async listWorkflows(name) {
-    const query = name ? `?name=${encodeURIComponent(name)}` : "";
-    return request(`/api/workflows${query}`);
-  }
-  async getWorkflow(workflowId) {
-    return request(`/api/workflows/${workflowId}`);
-  }
-  async updateWorkflow(workflowId, updates) {
-    return request(`/api/workflows/${workflowId}`, {
-      method: "PUT",
-      body: JSON.stringify(updates)
-    });
-  }
-  async deleteWorkflow(workflowId) {
-    await request(`/api/workflows/${workflowId}`, { method: "DELETE" });
-  }
-  async runWorkflow(workflowId, params = {}, force) {
-    return request(`/api/workflows/${workflowId}/run`, {
-      method: "POST",
-      body: JSON.stringify({ params, force: !!force })
-    });
-  }
-  async getTaskStatus(taskId) {
-    return request(`/api/workflow-tasks/${taskId}`);
-  }
-  async provideInput(taskId, values, confirm) {
-    return request(`/api/workflow-tasks/${taskId}/input`, {
-      method: "POST",
-      body: JSON.stringify({ values: values ?? null, confirm: confirm ?? null })
-    });
-  }
-  async cancelTask(taskId) {
-    return request(`/api/workflow-tasks/${taskId}/cancel`, {
-      method: "POST",
-      body: JSON.stringify({})
-    });
-  }
   // Script methods
   async submitScript(name, code) {
     return request(`/api/scripts`, {
@@ -445,67 +415,6 @@ function formatError(err) {
 function formatTabsInline(tabs) {
   return tabs.map((t) => `[${t.tab_id}] ${t.title}`).join(", ");
 }
-function formatWorkflowSaved(workflow) {
-  return `\u2713 Workflow '${workflow.name}' saved (id: ${workflow.id}, ${workflow.steps.length} steps)`;
-}
-function formatWorkflowList(workflows) {
-  if (workflows.length === 0) {
-    return "No workflows found.";
-  }
-  const lines = ["Workflows:", ""];
-  for (const wf of workflows) {
-    const desc = wf.description ? ` \u2014 ${wf.description}` : "";
-    lines.push(`  ${wf.name} (${wf.step_count} steps)${desc}`);
-  }
-  return lines.join("\n");
-}
-function formatWorkflowInfo(workflow) {
-  const lines = [];
-  lines.push(`Workflow: ${workflow.name}`);
-  lines.push(`ID: ${workflow.id}`);
-  if (workflow.description) lines.push(`Description: ${workflow.description}`);
-  lines.push(`Steps: ${workflow.steps.length}`);
-  lines.push(`Created: ${workflow.created_at}`);
-  lines.push("");
-  if (workflow.input_schema.length > 0) {
-    lines.push("Input variables:");
-    for (const v of workflow.input_schema) {
-      const req = v.required ? " (required)" : "";
-      lines.push(`  ${v.name}: ${v.type}${req}`);
-    }
-    lines.push("");
-  }
-  lines.push("Steps:");
-  for (let i = 0; i < workflow.steps.length; i++) {
-    const s = workflow.steps[i];
-    lines.push(`  ${i + 1}. [${s.step_type}] ${s.description}`);
-  }
-  return lines.join("\n");
-}
-function formatWorkflowTask(task) {
-  const lines = [];
-  const name = task.workflow_name ? ` (${task.workflow_name})` : "";
-  lines.push(`Task: ${task.id}${name}`);
-  lines.push(`Status: ${task.status}`);
-  lines.push(`Progress: ${task.current_step}/${task.total_steps}`);
-  if (task.session_id) lines.push(`Session: ${task.session_id}`);
-  if (task.missing_vars && task.missing_vars.length > 0) {
-    lines.push(`Missing: ${task.missing_vars.join(", ")}`);
-  }
-  if (task.pending_confirmation) {
-    lines.push(`Confirmation: ${task.pending_confirmation}`);
-  }
-  if (task.error) lines.push(`Error: ${task.error}`);
-  if (task.output) {
-    const entries = Object.entries(task.output).filter(([k]) => !k.startsWith("_")).map(([k, v]) => `${k}: ${v}`).join(", ");
-    if (entries) lines.push(`Output: ${entries}`);
-  }
-  if (task.completed_at) lines.push(`Completed: ${task.completed_at}`);
-  return lines.join("\n");
-}
-function formatWorkflowDeleted(name) {
-  return `\u2713 Workflow '${name}' deleted`;
-}
 function formatProfiles(result) {
   if (result.profiles.length === 0) {
     return "No browser profiles found.";
@@ -523,9 +432,9 @@ function formatProfileDelete(profileId) {
 
 // src/commands/lifecycle.ts
 function registerLifecycleCommands(program2) {
-  program2.command("launch").description("Launch a browser session").option("--url <url>", "Navigate to URL after launch").option("--profile <id>", "Use a named browser profile").option("--force", "Close existing session before launching").action(async (opts) => {
+  program2.command("launch").description("Launch a browser session").option("--url <url>", "Navigate to URL after launch").option("--profile <id>", "Use a named browser profile").option("--force", "Close existing session before launching").option("--connector <type>", "Browser connector: chrome or ziniao").option("--ziniao-profile <id>", "ZiNiao browser profile ID").action(async (opts) => {
     try {
-      const state = await api.createSession(opts.url, opts.profile, opts.force);
+      const state = await api.createSession(opts.url, opts.profile, opts.force, opts.connector, opts.ziniaoProfile);
       saveSessionId(state.session_id);
       console.log(formatLaunch(state));
     } catch (err) {
@@ -741,291 +650,6 @@ function registerTabCommands(program2) {
   });
 }
 
-// src/commands/workflow.ts
-function registerWorkflowCommands(program2) {
-  program2.command("save-workflow").argument("<name>", "Workflow name").description("Save current session actions as a workflow").option("--description <desc>", "Workflow description").action(async (name, opts) => {
-    try {
-      const sessionId = loadSessionId();
-      const workflow = await api.saveWorkflow(sessionId, name, opts.description);
-      console.log(formatWorkflowSaved(workflow));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("list-workflows").description("List saved workflows").action(async () => {
-    try {
-      const workflows = await api.listWorkflows();
-      console.log(formatWorkflowList(workflows));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("workflow-info").argument("<name>", "Workflow name").description("Show workflow details").action(async (name) => {
-    try {
-      const workflows = await api.listWorkflows(name);
-      if (workflows.length === 0) {
-        console.error(formatError(new Error(`Workflow '${name}' not found`)));
-        process.exit(1);
-      }
-      const workflow = await api.getWorkflow(workflows[0].id);
-      console.log(formatWorkflowInfo(workflow));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("run-workflow").argument("<name>", "Workflow name").description("Execute a saved workflow").option("--param <params...>", "Parameters as key=value").option("--force", "Force run even if another task is active").action(async (name, opts) => {
-    try {
-      const workflows = await api.listWorkflows(name);
-      if (workflows.length === 0) {
-        console.error(formatError(new Error(`Workflow '${name}' not found`)));
-        process.exit(1);
-      }
-      const params = {};
-      if (opts.param) {
-        for (const p of opts.param) {
-          const [k, ...rest] = p.split("=");
-          params[k] = rest.join("=");
-        }
-      }
-      const task = await api.runWorkflow(workflows[0].id, params, opts.force);
-      console.log(formatWorkflowTask(task));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("workflow-status").argument("<task_id>", "Task ID").description("Check workflow task status").action(async (taskId) => {
-    try {
-      const task = await api.getTaskStatus(taskId);
-      console.log(formatWorkflowTask(task));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("workflow-cancel").argument("<task_id>", "Task ID").description("Cancel a running workflow task").action(async (taskId) => {
-    try {
-      const task = await api.cancelTask(taskId);
-      console.log(formatWorkflowTask(task));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("workflow-input").argument("<task_id>", "Task ID").description("Provide input or confirmation to a waiting workflow task").option("--value <value>", "Provide a single value (only when one variable is missing)").option("--var <vars...>", "Provide named variables as key=value").option("--confirm", "Confirm a sensitive operation").action(async (taskId, opts) => {
-    try {
-      const values = {};
-      if (opts.value) {
-        const task = await api.getTaskStatus(taskId);
-        if (!task.missing_vars || task.missing_vars.length !== 1) {
-          console.error(formatError(new Error("--value can only be used when exactly one variable is missing. Use --var key=value instead.")));
-          process.exit(1);
-        }
-        values[task.missing_vars[0]] = opts.value;
-      }
-      if (opts.var) {
-        for (const v of opts.var) {
-          const [k, ...rest] = v.split("=");
-          values[k] = rest.join("=");
-        }
-      }
-      const hasValues = Object.keys(values).length > 0;
-      const result = await api.provideInput(taskId, hasValues ? values : void 0, opts.confirm);
-      console.log(formatWorkflowTask(result));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("delete-workflow").argument("<name>", "Workflow name").description("Delete a saved workflow").action(async (name) => {
-    try {
-      const workflows = await api.listWorkflows(name);
-      if (workflows.length === 0) {
-        console.error(formatError(new Error(`Workflow '${name}' not found`)));
-        process.exit(1);
-      }
-      await api.deleteWorkflow(workflows[0].id);
-      console.log(formatWorkflowDeleted(name));
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-  program2.command("edit-workflow").argument("<name>", "Workflow name").description("Edit a workflow").option("--set-var", "Set a step value as variable").option("--step <n>", "Step number (1-based)", parseInt).option("--name <varName>", "Variable name").option("--add-input <varName>", "Add an input variable").option("--type <type>", "Variable type", "string").option("--required", "Mark variable as required").option("--add-step <type>", "Add a step (extract, wait_for_element)").option("--selectors <json>", "CSS selectors for extract step").option("--screenshot", "Include screenshot in extract step").option("--selector <css>", "CSS selector for wait_for_element step").option("--timeout <seconds>", "Timeout for wait_for_element step", parseInt).option("--remove-step <n>", "Remove step N (1-based)", parseInt).option("--update-step <n>", "Update step N (1-based)", parseInt).option("--requires-confirmation", "Mark step as requiring confirmation").option("--no-requires-confirmation", "Unmark step confirmation requirement").option("--target-text <text>", "Update step target text").option("--auto-clean", "Auto-clean redundant steps").action(async (name, opts) => {
-    try {
-      const workflows = await api.listWorkflows(name);
-      if (workflows.length === 0) {
-        console.error(formatError(new Error(`Workflow '${name}' not found`)));
-        process.exit(1);
-      }
-      const workflow = await api.getWorkflow(workflows[0].id);
-      if (opts.setVar && opts.step && opts.name) {
-        const stepIdx = opts.step - 1;
-        if (stepIdx < 0 || stepIdx >= workflow.steps.length) {
-          console.error(formatError(new Error(`Step ${opts.step} out of range`)));
-          process.exit(1);
-        }
-        const step = workflow.steps[stepIdx];
-        if (step.step_type === "navigate" && step.url) {
-          step.url = `{${opts.name}}`;
-        } else if (step.value !== void 0 && step.value !== null) {
-          step.value = `{${opts.name}}`;
-        } else {
-          console.error(formatError(new Error(`Step ${opts.step} ([${step.step_type}]) has no value or url to parameterize`)));
-          process.exit(1);
-        }
-        await api.updateWorkflow(workflow.id, { steps: workflow.steps });
-        console.log(`\u2713 Step ${opts.step} value set to {${opts.name}}`);
-      } else if (opts.addInput) {
-        const inputVar = {
-          name: opts.addInput,
-          type: opts.type || "string",
-          description: "",
-          required: !!opts.required,
-          default: null,
-          sensitive: false
-        };
-        const schema = workflow.input_schema || [];
-        schema.push(inputVar);
-        await api.updateWorkflow(workflow.id, { input_schema: schema });
-        console.log(`\u2713 Input variable '${opts.addInput}' added`);
-      } else if (opts.addStep === "extract") {
-        const extractStep = {
-          step_type: "extract",
-          description: "Extract data",
-          extract_selectors: opts.selectors ? JSON.parse(opts.selectors) : {},
-          extract_screenshot: !!opts.screenshot
-        };
-        workflow.steps.push(extractStep);
-        await api.updateWorkflow(workflow.id, { steps: workflow.steps });
-        console.log(`\u2713 Extract step added`);
-      } else if (opts.addStep === "wait_for_element") {
-        const waitStep = {
-          step_type: "wait_for_element",
-          description: `Wait for ${opts.selector || "element"}`,
-          wait_selector: opts.selector || "",
-          wait_timeout: opts.timeout || 30
-        };
-        workflow.steps.push(waitStep);
-        await api.updateWorkflow(workflow.id, { steps: workflow.steps });
-        console.log(`\u2713 wait_for_element step added`);
-      } else if (opts.removeStep) {
-        const stepIdx = opts.removeStep - 1;
-        if (stepIdx < 0 || stepIdx >= workflow.steps.length) {
-          console.error(formatError(new Error(`Step ${opts.removeStep} out of range`)));
-          process.exit(1);
-        }
-        const removed = workflow.steps.splice(stepIdx, 1)[0];
-        await api.updateWorkflow(workflow.id, { steps: workflow.steps });
-        console.log(`\u2713 Step ${opts.removeStep} removed ([${removed.step_type}] ${removed.description})`);
-      } else if (opts.updateStep) {
-        const stepIdx = opts.updateStep - 1;
-        if (stepIdx < 0 || stepIdx >= workflow.steps.length) {
-          console.error(formatError(new Error(`Step ${opts.updateStep} out of range`)));
-          process.exit(1);
-        }
-        const step = workflow.steps[stepIdx];
-        let changed = false;
-        if (opts.requiresConfirmation === true) {
-          step.requires_confirmation = true;
-          changed = true;
-        } else if (opts.requiresConfirmation === false) {
-          step.requires_confirmation = false;
-          changed = true;
-        }
-        if (opts.targetText) {
-          step.target_text = opts.targetText;
-          changed = true;
-        }
-        if (!changed) {
-          console.log("Specify what to update: --requires-confirmation, --target-text <text>");
-          process.exit(1);
-        }
-        await api.updateWorkflow(workflow.id, { steps: workflow.steps });
-        console.log(`\u2713 Step ${opts.updateStep} updated`);
-      } else if (opts.autoClean) {
-        const before = workflow.steps.length;
-        const cleaned = autoCleanSteps(workflow.steps);
-        await api.updateWorkflow(workflow.id, { steps: cleaned });
-        const removed = before - cleaned.length;
-        console.log(`\u2713 Auto-clean: ${removed} step(s) removed (${before} \u2192 ${cleaned.length})`);
-      } else {
-        console.log("Usage:");
-        console.log("  edit-workflow <name> --set-var --step N --name varName");
-        console.log("  edit-workflow <name> --add-input varName --type T [--required]");
-        console.log("  edit-workflow <name> --add-step extract --selectors '{...}' [--screenshot]");
-        console.log("  edit-workflow <name> --add-step wait_for_element --selector '.css' [--timeout 30]");
-        console.log("  edit-workflow <name> --remove-step N");
-        console.log("  edit-workflow <name> --update-step N --requires-confirmation");
-        console.log("  edit-workflow <name> --update-step N --target-text 'new text'");
-        console.log("  edit-workflow <name> --auto-clean");
-      }
-    } catch (err) {
-      console.error(formatError(err));
-      process.exit(1);
-    }
-  });
-}
-function autoCleanSteps(steps) {
-  let result = [...steps];
-  result = cleanNavigateBackNavigate(result);
-  result = cleanConsecutiveInput(result);
-  result = cleanConsecutiveScroll(result);
-  result = cleanConsecutiveClick(result);
-  return result;
-}
-function cleanNavigateBackNavigate(steps) {
-  const result = [];
-  let i = 0;
-  while (i < steps.length) {
-    if (i + 2 < steps.length && steps[i].step_type === "navigate" && steps[i + 1].step_type === "go_back" && steps[i + 2].step_type === "navigate") {
-      i += 2;
-      continue;
-    }
-    result.push(steps[i]);
-    i++;
-  }
-  return result;
-}
-function sameElement(a, b) {
-  return !!a.target_text && a.target_text === b.target_text && a.element_tag === b.element_tag;
-}
-function cleanConsecutiveInput(steps) {
-  const result = [];
-  for (let i = 0; i < steps.length; i++) {
-    if (steps[i].step_type === "input" && i + 1 < steps.length && steps[i + 1].step_type === "input" && sameElement(steps[i], steps[i + 1])) {
-      continue;
-    }
-    result.push(steps[i]);
-  }
-  return result;
-}
-function cleanConsecutiveScroll(steps) {
-  const result = [];
-  for (let i = 0; i < steps.length; i++) {
-    if (steps[i].step_type === "scroll" && i + 1 < steps.length && steps[i + 1].step_type === "scroll" && steps[i].scroll_down === steps[i + 1].scroll_down) {
-      const amount = (steps[i].scroll_amount || 1) + (steps[i + 1].scroll_amount || 1);
-      steps[i + 1] = { ...steps[i + 1], scroll_amount: amount };
-      continue;
-    }
-    result.push(steps[i]);
-  }
-  return result;
-}
-function cleanConsecutiveClick(steps) {
-  const result = [];
-  for (let i = 0; i < steps.length; i++) {
-    if (steps[i].step_type === "click" && i + 1 < steps.length && steps[i + 1].step_type === "click" && sameElement(steps[i], steps[i + 1])) {
-      continue;
-    }
-    result.push(steps[i]);
-  }
-  return result;
-}
-
 // src/commands/script.ts
 import { readFileSync as readFileSync3 } from "fs";
 var POLL_INTERVAL_MS = 2e3;
@@ -1198,6 +822,44 @@ function registerProfileCommands(program2) {
   });
 }
 
+// src/commands/ziniao.ts
+function registerZiNiaoCommands(program2) {
+  const ziniao = program2.command("ziniao").description("Manage ZiNiao browser credentials");
+  ziniao.command("set").description("Set ZiNiao credentials").requiredOption("--company <company>", "ZiNiao company name").requiredOption("--username <username>", "ZiNiao username").requiredOption("--password <password>", "ZiNiao password").action(async (opts) => {
+    try {
+      const result = await api.setZiNiaoConfig(opts.company, opts.username, opts.password);
+      console.log(`\u2713 ZiNiao credentials saved (company: ${result.company}, user: ${result.username})`);
+    } catch (err) {
+      console.error(formatError(err));
+      process.exit(1);
+    }
+  });
+  ziniao.command("show").description("Show current ZiNiao config").action(async () => {
+    try {
+      const result = await api.getZiNiaoConfig();
+      if (!result.configured) {
+        console.log("No ZiNiao credentials configured. Use: browser-cli ziniao set --company ... --username ... --password ...");
+      } else {
+        console.log(`Company:  ${result.company}`);
+        console.log(`Username: ${result.username}`);
+        console.log(`Password: ********`);
+      }
+    } catch (err) {
+      console.error(formatError(err));
+      process.exit(1);
+    }
+  });
+  ziniao.command("clear").description("Remove ZiNiao credentials").action(async () => {
+    try {
+      await api.deleteZiNiaoConfig();
+      console.log("\u2713 ZiNiao credentials removed");
+    } catch (err) {
+      console.error(formatError(err));
+      process.exit(1);
+    }
+  });
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -1214,7 +876,7 @@ registerNavigationCommands(program);
 registerInteractionCommands(program);
 registerInfoCommands(program);
 registerTabCommands(program);
-registerWorkflowCommands(program);
 registerScriptCommands(program);
 registerProfileCommands(program);
+registerZiNiaoCommands(program);
 program.parse();

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@optima-chat/browser-cli",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
     "browser-cli": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    ".claude"
   ],
   "scripts": {
     "build": "tsup",