@optima-chat/browser-cli 0.5.3 → 0.5.4

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

@@ -43,23 +43,30 @@ owner_repo: Optima-Chat/optima-browser-use
 
 ### 紫鸟浏览器（跨境电商多店铺管理）
 
-当用户提到紫鸟、多店铺、反指纹浏览器、或需要操作特定店铺时：
+当用户提到紫鸟、多店铺、反指纹浏览器、TikTok Shop 店铺、或需要操作特定店铺时，按以下步骤操作：
 
 ```bash
-# 设置紫鸟凭证（首次使用）
-browser-cli ziniao set --company "公司名" --username "用户名" --password "密码"
-
-# 查看紫鸟配置
+# 1. 检查紫鸟凭证是否已配置
 browser-cli ziniao show
 
-# 使用紫鸟指定店铺启动浏览器
-browser-cli launch --connector ziniao --ziniao-profile <profile_id> --url <url>
+# 2. 如果未配置，设置凭证（需要用户提供）
+browser-cli ziniao set --company "公司名" --username "用户名" --password "密码"
+
+# 3. 查看可用的紫鸟店铺列表（需要 Desktop app 在线）
+browser-cli ziniao profiles
+# 输出示例：
+#   27774259938707  迪士尼授权林总店铺
+#   27772540507986  Gigilli-US
+#   27732948017158  马来本土店3SAVEZO
 
-# 普通启动（自动选择模式）
-browser-cli launch --url <url>
+# 4. 用店铺 profile 启动浏览器（根据用户描述匹配店铺名）
+browser-cli launch --connector ziniao --ziniao-profile 27774259938707 --url https://seller.tiktokshopglobalselling.com/homepage --force
 ```
 
-**紫鸟 profile_id** 需要从 Desktop app 的 capabilities 获取，或者用户直接提供。
+**重要**：
+- 用户说"迪士尼店铺"、"林总店铺"等 → 先 `ziniao profiles` 查列表，按名称模糊匹配找到 profile_id
+- 用户说"打开紫鸟"但没指定店铺 → 先列出 profiles 让用户选
+- 紫鸟需要 Desktop app 在线 + 紫鸟 WebDriver 模式已启动
 
 ## 命令
 

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.3",
+  "version": "0.5.4",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {