@optima-chat/browser-cli 0.5.2 → 0.5.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -29,12 +29,46 @@ owner_repo: Optima-Chat/optima-browser-use
|
|
|
29
29
|
|
|
30
30
|
脚本执行零 token 消耗，比手动操作快 10 倍以上。
|
|
31
31
|
|
|
32
|
+
## 浏览器模式
|
|
33
|
+
|
|
34
|
+
系统支持三种浏览器模式，自动选择最优方案：
|
|
35
|
+
|
|
36
|
+
| 模式 | 触发条件 | 说明 |
|
|
37
|
+
|------|----------|------|
|
|
38
|
+
| **Desktop + 紫鸟** | 用户安装了 Desktop app 且配置了紫鸟 | 通过紫鸟反指纹浏览器操作，保留多店铺登录态 |
|
|
39
|
+
| **Desktop + Chrome** | 用户安装了 Desktop app | 通过用户本地 Chrome 操作 |
|
|
40
|
+
| **Cloud** | 无 Desktop app | 后端 headless Chromium，无登录态 |
|
|
41
|
+
|
|
42
|
+
**自动路由**：默认 `browser-cli launch` 会自动选择。如果用户安装了 Optima Browser Operator 桌面应用并在线，自动走 Desktop 模式。
|
|
43
|
+
|
|
44
|
+
### 紫鸟浏览器（跨境电商多店铺管理）
|
|
45
|
+
|
|
46
|
+
当用户提到紫鸟、多店铺、反指纹浏览器、或需要操作特定店铺时：
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# 设置紫鸟凭证（首次使用）
|
|
50
|
+
browser-cli ziniao set --company "公司名" --username "用户名" --password "密码"
|
|
51
|
+
|
|
52
|
+
# 查看紫鸟配置
|
|
53
|
+
browser-cli ziniao show
|
|
54
|
+
|
|
55
|
+
# 使用紫鸟指定店铺启动浏览器
|
|
56
|
+
browser-cli launch --connector ziniao --ziniao-profile <profile_id> --url <url>
|
|
57
|
+
|
|
58
|
+
# 普通启动（自动选择模式）
|
|
59
|
+
browser-cli launch --url <url>
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
**紫鸟 profile_id** 需要从 Desktop app 的 capabilities 获取，或者用户直接提供。
|
|
63
|
+
|
|
32
64
|
## 命令
|
|
33
65
|
|
|
34
66
|
### 会话管理
|
|
35
67
|
|
|
36
68
|
```bash
|
|
37
|
-
browser-cli launch [--url <url>] [--force] #
|
|
69
|
+
browser-cli launch [--url <url>] [--force] # 启动浏览器（自动选择模式）
|
|
70
|
+
browser-cli launch --connector ziniao --ziniao-profile <id> [--url <url>] # 指定紫鸟店铺
|
|
71
|
+
browser-cli launch --connector chrome [--url <url>] # 指定 Chrome
|
|
38
72
|
browser-cli close # 关闭浏览器并释放资源
|
|
39
73
|
browser-cli status # 查看当前会话状态
|
|
40
74
|
```
|
|
@@ -185,11 +219,19 @@ browser-cli close
|
|
|
185
219
|
|
|
186
220
|
## 需要用户登录态的任务
|
|
187
221
|
|
|
188
|
-
|
|
222
|
+
当用户要求操作需要登录的平台（TikTok Shop、小红书、Instagram 等），需要用户的真实浏览器（有登录态）。
|
|
223
|
+
|
|
224
|
+
**推荐方案：Optima Browser Operator 桌面应用**
|
|
225
|
+
|
|
226
|
+
1. 用户下载安装桌面应用（Mac .dmg / Windows .exe）：https://github.com/Optima-Chat/optima-browser-use/releases
|
|
227
|
+
2. 首次启动自动打开浏览器登录授权
|
|
228
|
+
3. 授权后自动连接，后续 `browser-cli launch` 自动走 Desktop 模式
|
|
229
|
+
|
|
230
|
+
**跨境电商用户（多店铺）**：推荐安装紫鸟浏览器 + Desktop app，可以按店铺 profile 分别操作，每个店铺独立登录态。
|
|
189
231
|
|
|
190
|
-
|
|
232
|
+
**备选方案：Chrome 扩展**
|
|
191
233
|
|
|
192
|
-
|
|
234
|
+
安装 Optima Browser Operator Chrome 扩展，直接用 Chrome 已登录的账号操作。
|
|
193
235
|
|
|
194
236
|
## 注意事项
|
|
195
237
|
|