@roll-agent/browser-use-agent 0.7.6 → 0.8.0
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.
- package/SKILL.md +8 -2
- package/dist/index.js +1 -1
- package/dist/native-mouse-motion.d.ts +55 -0
- package/dist/native-visual-activity-session.d.ts +4 -5
- package/dist/pages/zhipin/native-page.d.ts +42 -6
- package/dist/tools/zhipin-exchange-wechat.d.ts +1 -1
- package/dist/tools/zhipin-filter-recommend-candidates.d.ts +1 -1
- package/dist/tools/zhipin-open-chat-page.d.ts +1 -3
- package/dist/tools/zhipin-open-chat.d.ts +1 -1
- package/dist/tools/zhipin-open-recommend-page.d.ts +1 -3
- package/dist/tools/zhipin-say-hello.d.ts +1 -1
- package/dist/tools/zhipin-scroll-view.d.ts +5 -0
- package/dist/tools/zhipin-select-recommend-job.d.ts +47 -0
- package/dist/tools/zhipin-send-reply.d.ts +1 -1
- package/package.json +3 -3
- package/references/zhipin-workflows.md +23 -3
package/SKILL.md
CHANGED
|
@@ -14,7 +14,7 @@ metadata:
|
|
|
14
14
|
- 先启动 `browser-use-agent` HTTP 常驻服务；浏览器 session 跨调用持久。
|
|
15
15
|
- 完整 `inputSchema` 以 `roll agent tools browser-use-agent --json` 为准。
|
|
16
16
|
- 页内反馈默认开启：
|
|
17
|
-
- `BROWSER_VISUAL_CURSOR
|
|
17
|
+
- `BROWSER_VISUAL_CURSOR`：native CDP 点击/拖拽/滚动前显示同源虚拟鼠标轨迹和点击波纹；简历弹窗等 Playwright-backed 工具仍使用旧虚拟指针。
|
|
18
18
|
- `BROWSER_VISUAL_ACTIVITY`：读取、识别、提取等操作显示状态胶囊和区域高亮。
|
|
19
19
|
- 需要关闭反馈时，将对应环境变量设为 `false`。
|
|
20
20
|
|
|
@@ -34,7 +34,7 @@ metadata:
|
|
|
34
34
|
| --- | --- |
|
|
35
35
|
| `attach_browser_session()` | 只在调试时显式执行一次 `connectOverCDP()`，用于验证“仅 attach”是否触发风控。 |
|
|
36
36
|
| `zhipin_diagnose_browser_state(phase?, targetPageId?, watchMs?, networkEventLimit?)` | 分阶段定位 BOSS 页面在 native CDP、Playwright attach、evaluate、storage/cookie 读取时的回退/风控触发点。 |
|
|
37
|
-
| `zhipin_scroll_view(surface, direction?, steps?, distance?, settleMs?)` | native CDP
|
|
37
|
+
| `zhipin_scroll_view(surface, direction?, steps?, distance?, settleMs?)` | native CDP 滚动或检查 `chat-list`、`chat-history`、`recommend-list` 内部动态列表；`steps=0` 只返回 `atTop` / `atBottom` / `canScrollUp` / `canScrollDown` / `position`。 |
|
|
38
38
|
|
|
39
39
|
诊断细节见 `references/zhipin-diagnostics.md`。正常业务路径不要默认调用 `zhipin_diagnose_browser_state()`。
|
|
40
40
|
|
|
@@ -59,6 +59,7 @@ metadata:
|
|
|
59
59
|
| Tool | Backend | 说明 |
|
|
60
60
|
| --- | --- | --- |
|
|
61
61
|
| `zhipin_open_recommend_page()` | native CDP | 点击左侧导航切到「推荐牛人」。 |
|
|
62
|
+
| `zhipin_select_recommend_job(jobValue?, jobName?, index?, searchKeyword?, useSearch?)` | native CDP | 切换推荐页顶部招聘岗位筛选；优先传 `jobValue`，其次 `jobName`，`index` 只作当前下拉快照兜底；返回 `current` / `selected` / `options`。 |
|
|
62
63
|
| `zhipin_filter_recommend_candidates(ageMin?, ageMax?, gender?, activity?)` | native CDP | 只设置年龄、性别、活跃度；未传维度重置为 `不限`，年龄默认 `16-不限`。 |
|
|
63
64
|
| `zhipin_get_candidate_list(maxResults?, autoScroll?, maxScrolls?)` | native CDP | 读取推荐候选人卡片；默认滚动并按 `candidateId` / `data-geek` 去重。 |
|
|
64
65
|
| `zhipin_say_hello(indices)` | native CDP | 按当前推荐列表 DOM `index` 批量点击「打招呼」。 |
|
|
@@ -84,6 +85,10 @@ metadata:
|
|
|
84
85
|
5. 发送回复只能调用 `zhipin_send_reply(signedEnvelope)`；不要构造裸文本发送路径。
|
|
85
86
|
6. `zhipin_send_reply` 会校验 envelope 的 `conversationId + candidateId + recruiterBinding`，当前页面目标或招聘者不一致时拒绝。
|
|
86
87
|
7. `preferredBrand` 只来自 `zhipin_get_candidate_info` 对 `communicationPosition` 的连字符格式解析；不要用通用岗位名或候选人公司名伪造。
|
|
88
|
+
8. 推荐页岗位筛选的稳定主键是 `zhipin_select_recommend_job` 返回的 `options[].value`；已知岗位 `value` 时必须优先传 `jobValue`。
|
|
89
|
+
9. 推荐岗位只知道标题时传 `jobName`；`index` 只表示当前岗位下拉快照，不要在搜索、筛选、刷新或跨步骤后复用。
|
|
90
|
+
10. `zhipin_select_recommend_job` 返回 `status:"selected"` 或 `status:"already_selected"` 都表示目标岗位已生效。
|
|
91
|
+
11. `zhipin_select_recommend_job` 返回 `status:"not_found"` 时不要盲目重试；先读取返回的 `options`，选择最接近岗位并复用其 `value` 作为 `jobValue`。
|
|
87
92
|
|
|
88
93
|
## 典型链路
|
|
89
94
|
|
|
@@ -98,6 +103,7 @@ zhipin_read_messages
|
|
|
98
103
|
|
|
99
104
|
推荐候选人:
|
|
100
105
|
zhipin_open_recommend_page
|
|
106
|
+
-> zhipin_select_recommend_job(jobValue | jobName)
|
|
101
107
|
-> zhipin_filter_recommend_candidates(...)
|
|
102
108
|
-> zhipin_get_candidate_list(maxResults?, autoScroll=true)
|
|
103
109
|
-> zhipin_say_hello(indices)
|