@optima-chat/browser-cli 0.5.2 → 0.5.4

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

@@ -29,12 +29,53 @@ owner_repo: Optima-Chat/optima-browser-use
 
 脚本执行零 token 消耗，比手动操作快 10 倍以上。
 
+## 浏览器模式
+
+系统支持三种浏览器模式，自动选择最优方案：
+
+| 模式 | 触发条件 | 说明 |
+|------|----------|------|
+| **Desktop + 紫鸟** | 用户安装了 Desktop app 且配置了紫鸟 | 通过紫鸟反指纹浏览器操作，保留多店铺登录态 |
+| **Desktop + Chrome** | 用户安装了 Desktop app | 通过用户本地 Chrome 操作 |
+| **Cloud** | 无 Desktop app | 后端 headless Chromium，无登录态 |
+
+**自动路由**：默认 `browser-cli launch` 会自动选择。如果用户安装了 Optima Browser Operator 桌面应用并在线，自动走 Desktop 模式。
+
+### 紫鸟浏览器（跨境电商多店铺管理）
+
+当用户提到紫鸟、多店铺、反指纹浏览器、TikTok Shop 店铺、或需要操作特定店铺时，按以下步骤操作：
+
+```bash
+# 1. 检查紫鸟凭证是否已配置
+browser-cli ziniao show
+
+# 2. 如果未配置，设置凭证（需要用户提供）
+browser-cli ziniao set --company "公司名" --username "用户名" --password "密码"
+
+# 3. 查看可用的紫鸟店铺列表（需要 Desktop app 在线）
+browser-cli ziniao profiles
+# 输出示例：
+#   27774259938707  迪士尼授权林总店铺
+#   27772540507986  Gigilli-US
+#   27732948017158  马来本土店3SAVEZO
+
+# 4. 用店铺 profile 启动浏览器（根据用户描述匹配店铺名）
+browser-cli launch --connector ziniao --ziniao-profile 27774259938707 --url https://seller.tiktokshopglobalselling.com/homepage --force
+```
+
+**重要**：
+- 用户说"迪士尼店铺"、"林总店铺"等 → 先 `ziniao profiles` 查列表，按名称模糊匹配找到 profile_id
+- 用户说"打开紫鸟"但没指定店铺 → 先列出 profiles 让用户选
+- 紫鸟需要 Desktop app 在线 + 紫鸟 WebDriver 模式已启动
+
 ## 命令
 
 ### 会话管理
 
 ```bash
-browser-cli launch [--url <url>] [--force]  # 启动浏览器（--force 先关闭已有会话）
+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                           # 查看当前会话状态
 ```
@@ -185,11 +226,19 @@ browser-cli close
 
 ## 需要用户登录态的任务
 
-当用户要求操作需要登录的平台（小红书、Instagram、微博、淘宝等社交/电商平台），在开始执行前先引导用户安装扩展：
+当用户要求操作需要登录的平台（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 分别操作，每个店铺独立登录态。
 
-"这个任务需要用到你在 [平台名] 的登录态。请安装 Optima Browser Operator Chrome 扩展，这样我可以直接用你已登录的浏览器来操作，不需要你提供密码。"
+**备选方案：Chrome 扩展**
 
-安装后用户回到聊天页面，扩展自动连接，直接执行任务。如果用户在该平台未登录，提示用户先在自己的 Chrome 里登录。
+安装 Optima Browser Operator Chrome 扩展，直接用 Chrome 已登录的账号操作。
 
 ## 注意事项
 

package/dist/index.js

@@ -187,6 +187,9 @@ var BrowserAPI = class {
   async deleteZiNiaoConfig() {
     return request("/api/user/ziniao-config", { method: "DELETE" });
   }
+  async getZiNiaoProfiles() {
+    return request("/api/user/ziniao-profiles");
+  }
   async closeSession(sessionId) {
     await request(`/api/sessions/${sessionId}`, { method: "DELETE" });
   }
@@ -849,6 +852,32 @@ function registerZiNiaoCommands(program2) {
       process.exit(1);
     }
   });
+  ziniao.command("profiles").description("List ZiNiao browser profiles (requires Desktop app online)").action(async () => {
+    try {
+      const result = await api.getZiNiaoProfiles();
+      if (!result.connected) {
+        console.log("Desktop app not connected. Start Optima Browser Operator first.");
+        process.exit(1);
+      }
+      if (!result.ziniao_available) {
+        console.log("ZiNiao not available on Desktop app. Start ZiNiao WebDriver mode first.");
+        process.exit(1);
+      }
+      if (result.profiles.length === 0) {
+        console.log("No ZiNiao profiles found.");
+        return;
+      }
+      console.log(`ZiNiao profiles (${result.profiles.length}):
+`);
+      for (const p of result.profiles) {
+        console.log(`  ${p.id}  ${p.name}`);
+      }
+      console.log("\nUse: browser-cli launch --connector ziniao --ziniao-profile <id> --url <url>");
+    } catch (err) {
+      console.error(formatError(err));
+      process.exit(1);
+    }
+  });
   ziniao.command("clear").description("Remove ZiNiao credentials").action(async () => {
     try {
       await api.deleteZiNiaoConfig();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/browser-cli",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {