jev-browser-skilllisted
Install: claude install-skill sageri/agent-skills
# jev-browser-skill
**你规划,Jev 判断,代码执行,最终验证归你。** Jev 只回答类型化的选择题(是/否、选一个,带概率),百毫秒级,不写文本、不做多步规划。所以要输入的文字由你给,步骤顺序由你定;页面由 Jev 读,你只读脚本回传的一行 JSON 或筛过的原文。浏览器、session、`@eN` 的语义归 [browser-skill](../browser-skill/SKILL.md)。
三个脚本,都在 `scripts/` 下,都需要 `TYPESAFE_API_KEY`,旗标与退出码见各自 `--help`:
| 脚本 | 做什么 | 回传给你 |
|---|---|---|
| `loop.mjs` | 朝一个结果循环:observe → Jev 选操作和目标 → bsk 执行 | 末行 JSON:`status` / `reason` / `session_id` / `candidates`… |
| `check.mjs` | 对当前页问一个是/否问题 | `p_yes` 与 `verdict`(yes / no / unsure) |
| `read.mjs` | 按问题从全文里筛出相关原文块 | 页面原文(≤ `--max-chars`)+ 末行统计 |
## 工作流
1. **一次一个可验证结果**:`node loop.mjs --url <url> --goal "<结果>" [--values k=v,…] [--expect-url <regex> | --expect-text <str>]`。「登录」「把 X 加入购物车」各一次;后续步骤用 `--resume <session_id>` 在同一页接着跑,**不从 URL 重跑**。
2. **看 `status`**:`done` 往下走,其余见下表。
3. **有副作用的步骤之后**:`node check.mjs --session <id> --question "<该变的变了 / 不该变的没变>"`。`unsure` 时自己用 bsk 看。
4. **信息类目标**:loop 加 `--keep-session` 把页面留着,再 `node read.mjs --session <id> --question "<要找什么>"`;短页面整页返回、不调 Jev。
5. **收尾**:任务结束 `bsk session stop <id>`;`bsk session list` 不应再有它。
## 写目标
- 要输入的字符串放进 `--values`,键名写清含义(`email`、`postal_code`):Jev 只看到键名,看不到值。也可在 `--goal` 里用引号写出(`"…"`、`「…」`),引号内文本会作为候选值发给 Jev。
- 有先后的多个子目标("加两条、完成一条、清空已完成")拆成多次调用;开放式目标("往下多加载些")改写成能断言的("直到出现至少 3 条新结果")。
- 配 `--expect-url` / `--expect-text` 才可能拿到 `done`:断言未过时 Jev 的 DONE 被驳回、改执行次高操作(至多 2 次);没配断言时 DONE 只能落到 `likely_done`。
- 横向比较(排序对不对、恰好变了一处)、看图、文字内容的好坏,留给你自己判断,不写进 goal 或 check。
- Git Bash 会把参数里的 `\.` 改写成 `/.`(MSYS 路径