命令参考

使用 omniscout --help 查看所有命令，或使用 omniscout <command> --help（以及 omniscout browser <action> --help）查看选项。下面每个小节都链接到含完整 flag 与示例的指南。

顶层命令

命令	功能	指南
`answer`	带引用的问答（优先于 `search`）	搜索
`search`	带本地语义重排序的网页搜索（+ `ui`）	搜索
`map`	将站点抓取为 URL 地图（`--limit`、`--depth`）	搜索
`warmup`	在 daemon 中预加载 embedding / 问答模型	搜索
`extract`	URL / 查询 / 站点抓取 → Markdown 或结构化 JSON	提取
`research`	搜索 → 抓取 → 提取 → 重排序 → 总结	研究
`graph`	实体的结构化知识图谱	研究
`benchmark`	评估问答 / 检索 / 格式化模式	研究
`open`	在浏览器中打开 URL（或上次搜索的第 N 个结果）	工作流
`snapshot`	带 `@e` ref 的无障碍 snapshot（默认会话）	浏览器
`context`	显示工作流连续状态	工作流
`reset`	重置连续状态	工作流
`auto`	将输入路由到最佳命令	工作流
`browser`	完整的 Chromium 自动化词汇	浏览器
`computer`	原生桌面自动化（macOS）	Computer
`daemon`	启动 / 停止 / 状态 / 日志 / trace / replay / watch	会话
`session`	启动 / 列出 / 附加 / 终止常驻会话	会话
`profile`	创建 / 列出 / 删除持久 profile	会话
`settings`	show / browsers / engines / set	会话
`install`	验证本地 Chromium 可用（+ `--skill`）	安装
`setup`	选择浏览器、准备扩展后端	安装
`remember`	访问 URL 并存入浏览器记忆	记忆
`memory`	搜索 / 列出 / 笔记 / 删除记忆	记忆
`index`	管理本地搜索索引	记忆
`extract-jobs`	查看后台提取任务	记忆
`crawl`	运行并查看本地抓取任务	工作流
`record`	将 daemon 操作录制为命名 macro	工作流
`macro`	列出 / 运行已保存的 macro	工作流
`replay`	回放已记录的浏览器操作	工作流
`workflow`	导出 / 查看连续工作流	工作流
`monitor`	URL 内容变化时输出 JSON 行	工作流
`distill`	收集 / 准备 / 评估 / 训练蒸馏问答模型	—

全局选项

所有命令均支持：

--json — 向 stdout 输出机器可读的 JSON
--verbose、-v — 详细 stderr 日志
--version — 打印版本并退出

在环境中设置 OMNISCOUT_JSON=1 可将 JSON 输出设为默认。完整 JSON 约定与所有环境变量见配置。

浏览器命令

完整指南：浏览器自动化。

命令	功能
`browser navigate <url>` / `open`	打开 URL（`--profile`、`--session`、`--new-tab`、`--headful`、`--wait-until`、`--auto-captcha`）
`browser back/forward/reload`	历史导航
`browser snapshot [--refs-only]`	带 `@eN` ref 的可交互元素（`--overlay` 可视化）
`browser observe "<hint>"`	为自然语言指令查找候选 ref
`browser act "<instruction>"`	解析并执行页面操作（`--value`、`--dry-run`）
`browser click <ref>`	点击（`--button`、`--clicks`、`--mod`、`--coord`）
`browser fill <ref> <value>`	替换字段内容
`browser type <ref> <text>`	追加文本（`--delay-ms`）
`browser paste <ref> <text>`	在光标处插入
`browser select <ref> <option>`	原生 `<select>`
`browser scroll [up\|down]`	滚动页面 / 元素（`--amount`、`--ref`）
`browser key <combo>`	键盘快捷键（`Enter`、`cmd+s`……）
`browser hover <ref>`	鼠标悬停于元素 / 坐标
`browser upload <ref> <files>`	为 `<input type=file>` 附加文件
`browser is <ref> <state>`	visible / hidden / enabled / disabled / checked / editable
`browser get title/url/text/html`	读取页面属性
`browser eval <js>`	运行 JavaScript 并返回值
`browser extract-visible`	可见文本，可选 `--schema` 整形
`browser find-image`	在视口中定位图片模板
`browser screenshot [-o PATH]`	PNG / JPEG（`--full-page`、`--ref`、`--delay`、`--format`）
`browser pdf [-o PATH]`	渲染为 PDF（`--paper`、`--landscape`、`--scale`）
`browser wait …`	`text`、`selector`、`networkidle`、`url`（+ `--ms`、`--timeout-ms`）
`browser mouse scroll/move`	坐标级的原始鼠标输入
`browser tab list/close/switch`	会话内的标签页管理
`browser network start/stop/list/tail/detail`	请求 / 响应捕获
`browser console start/stop/list/tail`	控制台 + JS 错误捕获
`browser login <url>`	有界面登录，会阻塞（`--profile`、`--done`、`--success-pattern`）
`browser captcha`	检测 / 求解（`none\|2captcha\|capsolver\|manual`、`--detect-only`）
`browser close [--all]`	关闭单个会话或全部

电脑命令（macOS）

完整指南：Computer。

命令	功能
`computer navigate <target>`	打开应用、文件、目录或 URL
`computer type <text>`	向聚焦窗口输入
`computer key <combo>`	发送键盘快捷键
`computer wait <ms>`	休眠毫秒数
`computer screenshot`	截取屏幕
`computer clipboard`	`get` / `set` 系统剪贴板
`computer window list/activate/close`	窗口管理
`computer ui snapshot/click/drag/is`	原生 UI 的 `@eN` ref
`computer doctor`	诊断环境
`computer backend`	列出自动化后端

Daemon 命令

完整指南：Daemon 与会话。

命令	功能
`daemon start/stop/restart`	生命周期（启动幂等）
`daemon status`	健康、版本、活动会话
`daemon logs`	查看日志尾部
`daemon trace`	JSONL 历史（最近 10k 条命令）
`daemon replay`	重跑已记录的操作
`daemon watch`	实时事件流（SSE）

环境变量

变量	用途
`OMNISCOUT_JSON=1`	强制每条命令输出 JSON
`OMNISCOUT_DAEMON_AUTO_START=0`	不自动启动 daemon
`OMNISCOUT_DAEMON_PORT`	覆盖 daemon 端口（默认 7720）
`OMNISCOUT_DATA_DIR`	覆盖数据目录
`OMNISCOUT_BROWSER`	浏览器 id（覆盖配置）
`OMNISCOUT_EMBED_LOCAL_ONLY=0`	允许运行时从 Hugging Face 获取
`TWOCAPTCHA_API_KEY` / `CAPTCHA_API_KEY`	验证码求解器 key

完整列表（含配置键与数据布局）：配置。