@optima-chat/optima-agent 0.8.47 → 0.8.49
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.
|
@@ -17,8 +17,20 @@ description: "Browser automation for web interactions. Use when user needs to op
|
|
|
17
17
|
- 简单网页抓取 → 使用 WebFetch
|
|
18
18
|
- 已有专用 skill 的任务(如 scout、tiktok、instagram、shein 等)
|
|
19
19
|
|
|
20
|
+
## 脚本优先原则
|
|
21
|
+
|
|
22
|
+
每次执行浏览器任务前,**先检查是否有现成脚本**:
|
|
23
|
+
|
|
24
|
+
1. `browser-cli scripts` — 查看已有脚本(显示名称、描述、步骤)
|
|
25
|
+
2. 如果有匹配的脚本 → 直接用 `browser-cli runscript <name> --param ...`
|
|
26
|
+
3. 如果没有 → 手动探索完成任务,然后生成脚本并提交
|
|
27
|
+
|
|
28
|
+
脚本执行零 token 消耗,比手动操作快 10 倍以上。
|
|
29
|
+
|
|
20
30
|
## 命令
|
|
21
31
|
|
|
32
|
+
### 基础命令
|
|
33
|
+
|
|
22
34
|
```bash
|
|
23
35
|
# 会话管理
|
|
24
36
|
browser-cli launch [--url <url>] [--force] # 启动浏览器(--force 先关闭已有会话)
|
|
@@ -36,6 +48,7 @@ browser-cli input <index> <text> [--no-clear] # 输入文本(--no-clear 追
|
|
|
36
48
|
browser-cli select <index> <option> # 选择下拉选项
|
|
37
49
|
browser-cli scroll <up|down> [--pages <n>] # 滚动页面(默认 1 页)
|
|
38
50
|
browser-cli keys <key> # 键盘操作(Enter、Tab 等)
|
|
51
|
+
browser-cli upload <index> <file...> # 上传文件到 file input(路径自动转换)
|
|
39
52
|
|
|
40
53
|
# 页面检查
|
|
41
54
|
browser-cli dom # 获取当前 DOM 状态
|
|
@@ -49,6 +62,23 @@ browser-cli switch <tab_id> # 切换标签页
|
|
|
49
62
|
browser-cli close-tab <tab_id> # 关闭标签页
|
|
50
63
|
```
|
|
51
64
|
|
|
65
|
+
### 脚本命令
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# 查看与管理
|
|
69
|
+
browser-cli scripts # 列出所有脚本(含描述和步骤)
|
|
70
|
+
browser-cli script-code <name> # 查看脚本源码
|
|
71
|
+
browser-cli delete-script <name> # 删除脚本
|
|
72
|
+
|
|
73
|
+
# 提交
|
|
74
|
+
browser-cli submit-script --name <name> --code-file <path> # 提交脚本(新建或覆盖)
|
|
75
|
+
|
|
76
|
+
# 执行
|
|
77
|
+
browser-cli runscript <name> --param key=value [...] # 执行脚本(自动轮询到完成)
|
|
78
|
+
browser-cli runscript <name> --param key=value --no-poll # 执行但不等待
|
|
79
|
+
browser-cli script-task <task-id> # 查询执行状态
|
|
80
|
+
```
|
|
81
|
+
|
|
52
82
|
## DOM 索引格式
|
|
53
83
|
|
|
54
84
|
每个操作都会返回当前 DOM 状态,格式如下:
|
|
@@ -62,105 +92,326 @@ browser-cli close-tab <tab_id> # 关闭标签页
|
|
|
62
92
|
- 每次操作后索引会**重新分配** — 务必使用最新的索引
|
|
63
93
|
- 使用这些索引来执行 `click`、`input` 和 `select` 命令
|
|
64
94
|
|
|
65
|
-
##
|
|
95
|
+
## 登录与 Profile
|
|
66
96
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
-
|
|
97
|
+
浏览器自动为每个用户保持一个持久化的 Chrome Profile。所有平台的登录态(cookies、session)保存在同一个 Profile 中。
|
|
98
|
+
|
|
99
|
+
- **首次登录**:需要用户提供账号和验证码,登录后自动保存
|
|
100
|
+
- **后续使用**:自动恢复登录态,无需重新登录
|
|
101
|
+
- **多平台**:小红书、抖音、微博等登录态共存于同一个 Profile
|
|
102
|
+
|
|
103
|
+
无需任何参数或命令来管理 Profile,完全自动。
|
|
104
|
+
|
|
105
|
+
## 文件路径
|
|
106
|
+
|
|
107
|
+
浏览器后端可以直接读取用户工作空间的文件(通过共享 EFS)。传文件路径时直接使用你看到的路径即可,后端会自动转换:
|
|
108
|
+
|
|
109
|
+
```
|
|
110
|
+
~/images/photo.jpg → 自动转换 ✓
|
|
111
|
+
/home/aiuser/images/photo.jpg → 自动转换 ✓
|
|
112
|
+
/mnt/efs/{userId}/images/... → 自动转换 ✓
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
不需要上传文件,不需要手动转换路径。
|
|
116
|
+
|
|
117
|
+
## 操作流程
|
|
118
|
+
|
|
119
|
+
### 流程一:有脚本(常见)
|
|
72
120
|
|
|
73
|
-
|
|
121
|
+
```bash
|
|
122
|
+
# 1. 检查脚本
|
|
123
|
+
browser-cli scripts
|
|
124
|
+
# 输出:
|
|
125
|
+
# xiaohongshu-image-note — 在小红书创作者平台发布图文笔记
|
|
126
|
+
# [1] navigate — 打开小红书发布页
|
|
127
|
+
# [2] switch_tab — 切换到上传图文模式
|
|
128
|
+
# [3] upload — 上传图片 {images}
|
|
129
|
+
# ...
|
|
130
|
+
|
|
131
|
+
# 2. 直接执行
|
|
132
|
+
browser-cli runscript xiaohongshu-image-note \
|
|
133
|
+
--param title="今日分享" \
|
|
134
|
+
--param body="内容..." \
|
|
135
|
+
--param 'images=["~/images/photo1.jpg", "~/images/photo2.jpg"]'
|
|
136
|
+
# 输出: ✓ Script completed
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### 流程二:无脚本(首次)
|
|
74
140
|
|
|
75
141
|
```bash
|
|
76
|
-
# 1.
|
|
77
|
-
browser-cli
|
|
142
|
+
# 1. 检查脚本 — 没有匹配的
|
|
143
|
+
browser-cli scripts
|
|
144
|
+
# 输出: No scripts registered.
|
|
145
|
+
|
|
146
|
+
# 2. 手动探索
|
|
147
|
+
browser-cli launch --url https://creator.xiaohongshu.com
|
|
148
|
+
# → 如果需要登录,向用户询问手机号和验证码
|
|
149
|
+
browser-cli input 11 "18500400810"
|
|
150
|
+
browser-cli click 33 # 发送验证码
|
|
151
|
+
# (用户提供验证码)
|
|
152
|
+
browser-cli input 12 "123456"
|
|
153
|
+
browser-cli click 38 # 登录
|
|
154
|
+
# → 登录成功,继续操作...
|
|
155
|
+
browser-cli dom # 分析页面
|
|
156
|
+
browser-cli click 1880 # 点击"上传图文"
|
|
157
|
+
browser-cli dom # 找到 file input
|
|
158
|
+
browser-cli upload 1092 ~/images/photo.jpg # 上传图片
|
|
159
|
+
browser-cli input 2905 "标题" # 填写标题
|
|
160
|
+
browser-cli input 3432 "正文内容" # 填写正文
|
|
161
|
+
browser-cli click 2814 # 点击发布
|
|
162
|
+
# → 任务完成
|
|
163
|
+
|
|
164
|
+
# 3. 生成 Python 脚本
|
|
165
|
+
# 根据上面的探索轨迹,生成脚本文件,必须包含:
|
|
166
|
+
# - DESCRIPTION: 脚本描述
|
|
167
|
+
# - STEPS: 语义步骤列表(StepDef)
|
|
168
|
+
# - run(ctx): 异步执行函数
|
|
169
|
+
# 写到本地文件
|
|
170
|
+
|
|
171
|
+
# 4. 提交脚本
|
|
172
|
+
browser-cli submit-script \
|
|
173
|
+
--name xiaohongshu-image-note \
|
|
174
|
+
--code-file /tmp/xiaohongshu_image_note.py
|
|
175
|
+
|
|
176
|
+
# 5. 关闭浏览器
|
|
177
|
+
browser-cli close
|
|
178
|
+
```
|
|
78
179
|
|
|
79
|
-
|
|
80
|
-
browser-cli click 15 # 点击按钮
|
|
81
|
-
browser-cli input 22 "hello" # 输入文本
|
|
82
|
-
browser-cli keys Enter # 按回车
|
|
180
|
+
### 流程三:脚本失败(Fallback)
|
|
83
181
|
|
|
84
|
-
|
|
182
|
+
```bash
|
|
183
|
+
# 1. 执行脚本
|
|
184
|
+
browser-cli runscript xiaohongshu-image-note --param ...
|
|
185
|
+
# 输出:
|
|
186
|
+
# ⚠ Script needs fallback
|
|
187
|
+
#
|
|
188
|
+
# ✓ Completed:
|
|
189
|
+
# [1] navigate — 打开小红书发布页
|
|
190
|
+
# [2] switch_tab — 切换到上传图文模式
|
|
191
|
+
#
|
|
192
|
+
# ✗ Failed at step [3] upload: file input not found
|
|
193
|
+
#
|
|
194
|
+
# → Remaining steps:
|
|
195
|
+
# [3] upload — 上传图片 ["~/photo.jpg"]
|
|
196
|
+
# [4] fill_title — 填写标题'测试'
|
|
197
|
+
# [5] fill_body — 填写正文'内容'
|
|
198
|
+
# [6] publish — 点击发布按钮
|
|
199
|
+
# [7] verify — 确认发布成功
|
|
200
|
+
#
|
|
201
|
+
# Session is still open — use browser-cli dom/click/input to continue
|
|
202
|
+
|
|
203
|
+
# 2. 接管完成剩余步骤(Session 仍然打开,不需要重新 launch)
|
|
204
|
+
browser-cli dom # 查看当前页面
|
|
205
|
+
browser-cli click 15 # 继续操作
|
|
206
|
+
browser-cli input 22 "测试"
|
|
207
|
+
browser-cli click 30
|
|
208
|
+
# → 任务完成
|
|
209
|
+
|
|
210
|
+
# 3. (可选) 更新脚本以修复问题
|
|
211
|
+
# 重新生成脚本,覆盖旧版本
|
|
212
|
+
browser-cli submit-script \
|
|
213
|
+
--name xiaohongshu-image-note \
|
|
214
|
+
--code-file /tmp/xiaohongshu_image_note_v2.py
|
|
215
|
+
|
|
216
|
+
# 4. 关闭浏览器
|
|
85
217
|
browser-cli close
|
|
86
218
|
```
|
|
87
219
|
|
|
88
|
-
##
|
|
220
|
+
## 脚本代码规范
|
|
221
|
+
|
|
222
|
+
### 基本结构
|
|
223
|
+
|
|
224
|
+
每个脚本必须包含 `DESCRIPTION`、`STEPS` 和 `async def run(ctx)`:
|
|
225
|
+
|
|
226
|
+
```python
|
|
227
|
+
"""脚本描述。"""
|
|
228
|
+
from __future__ import annotations
|
|
229
|
+
import asyncio
|
|
230
|
+
import json
|
|
231
|
+
from app.scripts.base import ScriptContext, ScriptResult, StepDef, render_steps
|
|
232
|
+
|
|
233
|
+
DESCRIPTION = "一句话描述脚本功能"
|
|
234
|
+
|
|
235
|
+
STEPS = [
|
|
236
|
+
StepDef(id="step_id", description="步骤描述,支持 {param} 占位符"),
|
|
237
|
+
]
|
|
238
|
+
|
|
239
|
+
PAGE_SETTLE = 2 # 页面操作后等待秒数
|
|
240
|
+
|
|
241
|
+
async def run(ctx: ScriptContext) -> ScriptResult:
|
|
242
|
+
bs = ctx.browser_session
|
|
243
|
+
steps = render_steps(STEPS, ctx.params)
|
|
244
|
+
completed: list[StepDef] = []
|
|
245
|
+
|
|
246
|
+
try:
|
|
247
|
+
# 逐步执行,每完成一步 append
|
|
248
|
+
# ...
|
|
249
|
+
return ScriptResult(status="completed", output={...}, completed_steps=completed)
|
|
250
|
+
except Exception as e:
|
|
251
|
+
remaining = [s for s in steps if s not in completed]
|
|
252
|
+
snapshot = await _capture_snapshot(bs)
|
|
253
|
+
return ScriptResult(
|
|
254
|
+
status="needs_fallback",
|
|
255
|
+
completed_steps=completed,
|
|
256
|
+
remaining_steps=remaining,
|
|
257
|
+
error=str(e),
|
|
258
|
+
snapshot=snapshot,
|
|
259
|
+
)
|
|
260
|
+
|
|
261
|
+
async def _capture_snapshot(bs) -> dict:
|
|
262
|
+
try:
|
|
263
|
+
state = await bs.get_browser_state_summary(include_screenshot=False)
|
|
264
|
+
dom = state.dom_state.llm_representation() if state and state.dom_state else ""
|
|
265
|
+
except Exception:
|
|
266
|
+
dom = ""
|
|
267
|
+
return {"dom": dom}
|
|
268
|
+
```
|
|
89
269
|
|
|
90
|
-
|
|
270
|
+
### 浏览器操作 API
|
|
91
271
|
|
|
92
|
-
|
|
272
|
+
```python
|
|
273
|
+
# 导航
|
|
274
|
+
action = ctx.action_model(navigate={"url": "https://example.com"})
|
|
275
|
+
await ctx.controller.act(action, bs)
|
|
276
|
+
await asyncio.sleep(PAGE_SETTLE)
|
|
93
277
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
browser-cli edit-workflow <name> --auto-clean # 自动清理冗余步骤
|
|
110
|
-
|
|
111
|
-
# 执行与监控
|
|
112
|
-
browser-cli run-workflow <name> [--param key=value ...] [--force] # 执行(--force 自动关闭已有 session)
|
|
113
|
-
browser-cli workflow-status <task_id> # 查询执行状态
|
|
114
|
-
browser-cli workflow-input <task_id> --var key=value # 提供变量值
|
|
115
|
-
browser-cli workflow-input <task_id> --value <val> # 提供值(仅单变量时)
|
|
116
|
-
browser-cli workflow-input <task_id> --confirm # 确认敏感操作
|
|
117
|
-
browser-cli workflow-cancel <task_id> # 取消执行
|
|
118
|
-
|
|
119
|
-
# 降级接管(workflow 失败后用 --session 继续操作)
|
|
120
|
-
browser-cli --session <session_id> dom # 查看降级 session 的页面
|
|
121
|
-
browser-cli --session <session_id> click 5 # 在降级 session 上操作
|
|
122
|
-
browser-cli --session <session_id> close # 完成后关闭
|
|
278
|
+
# 点击(通过 DOM index)
|
|
279
|
+
action = ctx.action_model(click={"index": idx})
|
|
280
|
+
await ctx.controller.act(action, bs)
|
|
281
|
+
|
|
282
|
+
# 输入文本
|
|
283
|
+
action = ctx.action_model(input={"index": idx, "text": "内容"})
|
|
284
|
+
await ctx.controller.act(action, bs)
|
|
285
|
+
|
|
286
|
+
# 获取当前 DOM(每步操作前刷新)
|
|
287
|
+
state = await bs.get_browser_state_summary(include_screenshot=False, cached=False)
|
|
288
|
+
sm = state.dom_state.selector_map or {}
|
|
289
|
+
|
|
290
|
+
# 获取当前 URL
|
|
291
|
+
page = await bs.get_current_page()
|
|
292
|
+
url = await page.get_url()
|
|
123
293
|
```
|
|
124
294
|
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
295
|
+
### 元素查找(语义匹配,不要硬编码 index)
|
|
296
|
+
|
|
297
|
+
DOM index 每次页面变化后会重新分配,脚本中**不能硬编码 index**。
|
|
298
|
+
必须通过语义属性动态查找:
|
|
299
|
+
|
|
300
|
+
```python
|
|
301
|
+
# 按文字内容查找(如按钮、标签页)
|
|
302
|
+
def _find_by_text(sm, text, tag=None):
|
|
303
|
+
for idx, node in sm.items():
|
|
304
|
+
node_tag = (getattr(node, "tag_name", "") or "").lower()
|
|
305
|
+
if tag and node_tag != tag:
|
|
306
|
+
continue
|
|
307
|
+
try:
|
|
308
|
+
node_text = node.get_all_children_text().strip() if hasattr(node, "get_all_children_text") else ""
|
|
309
|
+
except Exception:
|
|
310
|
+
node_text = ""
|
|
311
|
+
if text in node_text:
|
|
312
|
+
return idx
|
|
313
|
+
return None
|
|
314
|
+
|
|
315
|
+
# 按 placeholder 查找(如输入框,支持 shadow DOM)
|
|
316
|
+
def _find_by_placeholder(sm, placeholder_contains):
|
|
317
|
+
for idx, node in sm.items():
|
|
318
|
+
attrs = getattr(node, "attributes", {}) or {}
|
|
319
|
+
if placeholder_contains in attrs.get("placeholder", ""):
|
|
320
|
+
return idx
|
|
321
|
+
# Shadow DOM fallback
|
|
322
|
+
if not attrs:
|
|
323
|
+
try:
|
|
324
|
+
llm = node.llm_representation() if hasattr(node, "llm_representation") else ""
|
|
325
|
+
if placeholder_contains in llm:
|
|
326
|
+
return idx
|
|
327
|
+
except Exception:
|
|
328
|
+
pass
|
|
329
|
+
return None
|
|
330
|
+
|
|
331
|
+
# 按 role 查找(如 contenteditable 编辑器)
|
|
332
|
+
def _find_by_role(sm, role, tag=None):
|
|
333
|
+
for idx, node in sm.items():
|
|
334
|
+
node_tag = (getattr(node, "tag_name", "") or "").lower()
|
|
335
|
+
if tag and node_tag != tag:
|
|
336
|
+
continue
|
|
337
|
+
attrs = getattr(node, "attributes", {}) or {}
|
|
338
|
+
if attrs.get("role") == role:
|
|
339
|
+
return idx
|
|
340
|
+
if attrs.get("contenteditable") and role == "textbox":
|
|
341
|
+
return idx
|
|
342
|
+
return None
|
|
343
|
+
|
|
344
|
+
# 按文件类型查找 file input(如图片上传)
|
|
345
|
+
def _find_image_file_input(bs, sm):
|
|
346
|
+
for idx, node in sm.items():
|
|
347
|
+
if not bs.is_file_input(node):
|
|
348
|
+
continue
|
|
349
|
+
attrs = getattr(node, "attributes", {}) or {}
|
|
350
|
+
accept = attrs.get("accept", "")
|
|
351
|
+
if any(ext in accept for ext in [".jpg", ".jpeg", ".png", ".webp"]):
|
|
352
|
+
return idx
|
|
353
|
+
for idx, node in sm.items():
|
|
354
|
+
if bs.is_file_input(node):
|
|
355
|
+
return idx
|
|
356
|
+
return None
|
|
357
|
+
```
|
|
128
358
|
|
|
129
|
-
###
|
|
359
|
+
### 文件上传
|
|
130
360
|
|
|
131
|
-
|
|
361
|
+
上传文件需要 `FileSystem` 和 `available_file_paths`:
|
|
132
362
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
- 用 `--add-input` 声明 input_schema
|
|
138
|
-
- 如果 workflow 需要返回数据(如查价格、查状态),根据保存时看到的 DOM 结构添加 extract 步骤(用 CSS selector 指定要提取的字段);纯执行型 workflow(如发帖)可不加 extract
|
|
139
|
-
- 对支付、删除等敏感操作,用 `--update-step N --requires-confirmation` 标记
|
|
140
|
-
4. 确认 workflow 可用:`browser-cli workflow-info '操作名称'`
|
|
363
|
+
```python
|
|
364
|
+
from browser_use.filesystem.file_system import FileSystem
|
|
365
|
+
from app.services.file_upload import UPLOAD_TEMP_BASE
|
|
366
|
+
import secrets as _secrets
|
|
141
367
|
|
|
142
|
-
|
|
368
|
+
# 创建临时目录
|
|
369
|
+
fs_dir = UPLOAD_TEMP_BASE / f"script_{_secrets.token_hex(4)}"
|
|
370
|
+
fs_dir.mkdir(parents=True, exist_ok=True)
|
|
371
|
+
file_system = FileSystem(base_dir=str(fs_dir), create_default_files=False)
|
|
143
372
|
|
|
144
|
-
|
|
373
|
+
# 上传每个文件
|
|
374
|
+
images = json.loads(ctx.params.get("images", "[]"))
|
|
375
|
+
file_idx = _find_image_file_input(bs, sm)
|
|
376
|
+
for img_path in images:
|
|
377
|
+
action = ctx.action_model(upload_file={"index": file_idx, "path": img_path})
|
|
378
|
+
await ctx.controller.act(action, bs, available_file_paths=images, file_system=file_system)
|
|
379
|
+
```
|
|
145
380
|
|
|
146
|
-
|
|
147
|
-
2. `browser-cli run-workflow '名称' --param key=value` — 启动执行
|
|
148
|
-
3. `browser-cli workflow-status <task_id>` — 每 3-5 秒轮询一次状态
|
|
149
|
-
4. 根据状态处理:
|
|
150
|
-
- `needs_input` → 检查输出中的字段:
|
|
151
|
-
- 有 `Missing: xxx` → 缺少变量值,向用户询问后用 `workflow-input --var xxx=值` 提供
|
|
152
|
-
- 有 `Confirmation: xxx` → 敏感操作待确认,告知用户后用 `workflow-input --confirm` 确认
|
|
153
|
-
- `failed` → 用 `--session` flag 接管当前 session 完成任务(见降级接管)
|
|
154
|
-
- `completed` → 返回 Output 给用户
|
|
381
|
+
文件路径由引擎自动转换(~/xxx → /mnt/workspaces/{userId}/xxx),脚本直接用 `ctx.params` 中的路径即可。
|
|
155
382
|
|
|
156
|
-
###
|
|
383
|
+
### 等待页面变化
|
|
157
384
|
|
|
158
|
-
|
|
385
|
+
页面操作后(导航、上传、点击)需要等待,用轮询模式:
|
|
159
386
|
|
|
160
|
-
```
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
387
|
+
```python
|
|
388
|
+
# 简单等待
|
|
389
|
+
await asyncio.sleep(PAGE_SETTLE)
|
|
390
|
+
|
|
391
|
+
# 轮询等待某个元素出现(如上传后等编辑模式)
|
|
392
|
+
target_idx = None
|
|
393
|
+
for attempt in range(10):
|
|
394
|
+
await asyncio.sleep(PAGE_SETTLE)
|
|
395
|
+
state = await bs.get_browser_state_summary(include_screenshot=False, cached=False)
|
|
396
|
+
sm = state.dom_state.selector_map or {}
|
|
397
|
+
target_idx = _find_by_placeholder(sm, "填写标题")
|
|
398
|
+
if target_idx is not None:
|
|
399
|
+
break
|
|
400
|
+
if target_idx is None:
|
|
401
|
+
raise RuntimeError("等待超时:目标元素未出现")
|
|
164
402
|
```
|
|
165
403
|
|
|
166
|
-
|
|
404
|
+
### 完整示例
|
|
405
|
+
|
|
406
|
+
参考系统内置脚本 `xiaohongshu-image-note`(通过 `browser-cli script-code xiaohongshu-image-note` 查看完整源码)。
|
|
407
|
+
|
|
408
|
+
## 注意事项
|
|
409
|
+
|
|
410
|
+
- **脚本优先**:每次操作前先 `browser-cli scripts`,有脚本就用脚本
|
|
411
|
+
- **DOM 自动返回**:每个操作会自动返回 DOM 状态 — 无需单独调用 `browser-cli dom`
|
|
412
|
+
- **避免不必要的截图**:截图消耗 token,日常导航用 DOM 输出即可
|
|
413
|
+
- **5 分钟超时**:无操作 5 分钟后会话自动关闭
|
|
414
|
+
- **登录自动保持**:登录一次后自动持久化,无需重复登录
|
|
415
|
+
- **文件路径自动转换**:直接传你看到的路径(~/xxx),后端自动处理
|
|
416
|
+
- **务必关闭**:操作完成后运行 `browser-cli close` 释放资源
|
|
417
|
+
- **Fallback 后更新脚本**:如果脚本频繁失败,重新生成并 submit-script 覆盖
|
|
@@ -25,7 +25,7 @@ commerce product create \
|
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
### 场景2:多规格商品上架
|
|
28
|
-
**流程**: 创建主商品 → 创建所有变体 →
|
|
28
|
+
**流程**: 创建主商品 → 创建所有变体 → 关联图片(共享+变体专属)
|
|
29
29
|
```bash
|
|
30
30
|
# 1. 创建主商品
|
|
31
31
|
commerce product create --name "T恤" --price 99
|
|
@@ -34,10 +34,18 @@ commerce product create --name "T恤" --price 99
|
|
|
34
34
|
# 2. 创建所有变体
|
|
35
35
|
commerce variant create --product-id prod_123 --sku "TSHIRT-RED-S" \
|
|
36
36
|
--attributes '{"颜色":"红色","尺寸":"S"}' --price 99 --stock 50
|
|
37
|
-
|
|
38
|
-
--attributes '{"颜色":"红色","尺寸":"M"}' --price 99 --stock 50
|
|
37
|
+
# 获得 variant_id: var_red_s
|
|
39
38
|
commerce variant create --product-id prod_123 --sku "TSHIRT-BLUE-S" \
|
|
40
39
|
--attributes '{"颜色":"蓝色","尺寸":"S"}' --price 99 --stock 50
|
|
40
|
+
# 获得 variant_id: var_blue_s
|
|
41
|
+
|
|
42
|
+
# 3. 关联共享图片(所有变体都能看到)
|
|
43
|
+
commerce product add-images --id prod_123 --media-id media_front,media_back
|
|
44
|
+
|
|
45
|
+
# 4. 关联变体专属图片(选择该变体时显示)
|
|
46
|
+
commerce variant add-images --product-id prod_123 --variant-id var_red_s --url "https://cdn.../red.jpg"
|
|
47
|
+
commerce variant add-images --product-id prod_123 --variant-id var_blue_s --url "https://cdn.../blue.jpg"
|
|
48
|
+
# 也可以用已有 media_id:--media-id media_red
|
|
41
49
|
```
|
|
42
50
|
|
|
43
51
|
### 场景3:批量商品导入
|
|
@@ -216,6 +224,8 @@ commerce product create --name "T恤" --price 99 --stock 50 # 确保真实有50
|
|
|
216
224
|
- "创建促销商品,价格79,划线价99" → `commerce product create --name XX --price 79 --original-price 99`
|
|
217
225
|
- "上传商品图片" → `commerce upload image --path ./photo.jpg`
|
|
218
226
|
- "添加商品变体" → `commerce variant create --product-id XX --sku YY`
|
|
227
|
+
- "给变体加图片" / "变体图片" / "变体显示图片" → `commerce variant add-images --product-id XX --variant-id YY --url/--media-id`
|
|
228
|
+
- "把已有图片指定给变体" → `commerce variant add-images --product-id XX --variant-id YY --media-id ZZ`
|
|
219
229
|
- "更新商品价格" → `commerce product update --id XX --price YY`
|
|
220
230
|
- "设置商品原价/划线价" → `commerce product update --id XX --original-price YY`
|
|
221
231
|
- "给商品打标签" → `commerce product update --id XX --tags "featured,new"`
|
|
@@ -237,11 +247,13 @@ commerce product create --name "T恤" --price 99 --stock 50 # 确保真实有50
|
|
|
237
247
|
- `commerce variant list` - 查看变体列表
|
|
238
248
|
- `commerce variant update` - 更新变体信息
|
|
239
249
|
- `commerce variant delete` - 删除变体
|
|
250
|
+
- `commerce variant add-images` - 给变体关联图片(支持 URL/本地文件/media_id)
|
|
240
251
|
|
|
241
252
|
**图片管理**:
|
|
242
253
|
- `commerce upload image` - 上传图片
|
|
243
|
-
- `commerce product add-images` -
|
|
254
|
+
- `commerce product add-images` - 关联图片到商品(所有变体共享)
|
|
244
255
|
- `commerce product remove-images` - 移除商品图片
|
|
256
|
+
- `commerce variant add-images` - 关联图片到特定变体(变体专属)
|
|
245
257
|
|
|
246
258
|
## 详细示例
|
|
247
259
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,
|
|
1
|
+
{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CA6KxC"}
|
|
@@ -130,7 +130,15 @@ export function getSystemPrompt() {
|
|
|
130
130
|
|
|
131
131
|
用户的工作目录(\`/home/aiuser/\`)就是 workspace,用户可以在 Web UI 的文件管理器中直接查看和下载里面的文件。
|
|
132
132
|
|
|
133
|
-
|
|
133
|
+
**默认行为**:生成或下载文件后,使用可点击的文件链接告诉用户:
|
|
134
|
+
|
|
135
|
+
\`[文件名](action://reveal-file?path=/home/aiuser/实际路径)\`
|
|
136
|
+
|
|
137
|
+
示例:
|
|
138
|
+
- 文件已保存:[product-banner.png](action://reveal-file?path=/home/aiuser/attachments/product-banner.png)
|
|
139
|
+
- 报告已生成:[月度报告.pdf](action://reveal-file?path=/home/aiuser/docs/月度报告.pdf)
|
|
140
|
+
|
|
141
|
+
用户点击链接后,文件管理器会自动定位到该文件。
|
|
134
142
|
|
|
135
143
|
**生成分享链接**:仅当用户明确要求"给我链接"、"发给别人"、"分享链接"时,才调用签名链接 API:
|
|
136
144
|
\`\`\`bash
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;;;aASI,OAAO,IAAI,OAAO
|
|
1
|
+
{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;;;aASI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsJ9B,CAAC;AACF,CAAC"}
|