示例与配方

常见任务的可复制配方。背后的概念：快速上手、浏览器自动化、提取。

快速参考

omniscout daemon start                              # 1. start the daemon
omniscout browser navigate https://example.com      # 2. drive the browser
omniscout browser snapshot --refs-only              # 3. find @eN refs
omniscout browser click '@e3'                       # 4. act on them
omniscout browser screenshot --out /tmp/out.png     # 5. capture state
omniscout browser close --all                       # 6. clean up

搜索与问答

# One-line factual answer (preferred for facts)
omniscout answer "who is the prime minister of india"
omniscout answer "what is the capital of france"
omniscout answer "latest stable Rust version" --depth deep --data

# Web search with ranked hits
omniscout search "AI agents 2026" --limit 5
omniscout search "query" --source memory   # your remembered pages only

从页面提取内容

omniscout extract https://example.com > /tmp/page.md
omniscout extract https://stripe.com/pricing --format structured --fields pricing
omniscout extract -q "SpaceX founder" --format structured --fields founder
omniscout extract https://example.com --depth 2 --out /tmp/site.md

研究主题

omniscout research "vector database benchmarks 2026" --results 10
omniscout research "quantum startups 2026" --depth 2 --probe-pro

构建知识图谱

omniscout graph "Cursor"
omniscout graph "cursor.com"          # site-only mode
omniscout graph "Cursor" -w cursor.com --data

导航与交互

omniscout browser navigate https://news.ycombinator.com
omniscout browser snapshot --refs-only
omniscout browser click '@e3'
omniscout browser screenshot --out /tmp/hn.png
omniscout browser close --all

先读后动

omniscout browser navigate https://example.com
omniscout browser get title
omniscout browser get text | head -40
omniscout browser snapshot --refs-only

填写表单

omniscout browser navigate https://duckduckgo.com
omniscout browser snapshot --refs-only
omniscout browser fill '@e2' "local-first AI agents"
omniscout browser key Enter
omniscout browser wait text "results"
omniscout browser get text | head -20

从 snapshot 输出中找到搜索框的 ref — 不要猜 @e 编号。（fill 替换；type 追加；paste 在光标处插入。）

正确等待

omniscout browser navigate https://example.com/app
omniscout browser wait networkidle
omniscout browser wait text "Dashboard"
omniscout browser snapshot --refs-only

登录并复用 profile

# Terminal A: opens browser, blocks
omniscout browser login https://github.com/login --profile work

# Terminal B (after you log in):
omniscout browser login --done

# Now reuse the profile
omniscout browser navigate https://github.com/notifications --profile work
omniscout browser screenshot --out /tmp/notifs.png

捕获网络请求

omniscout browser network start
omniscout browser navigate https://vercel.com/pricing
omniscout browser scroll down --amount 10
omniscout browser network stop
omniscout browser network list --filter "stripe|payment"
omniscout browser network detail 3

调试页面错误

omniscout browser console start
omniscout browser navigate https://example.com/app
omniscout browser console tail
omniscout browser console stop

整页截图

omniscout browser screenshot https://example.com --full-page --out /tmp/full.png

元素截图与 PDF

omniscout browser snapshot --refs-only
omniscout browser screenshot --ref '@e3' --out /tmp/element.png
omniscout browser pdf --out /tmp/page.pdf --paper letter

多标签页

omniscout browser navigate https://example.com --session multi
omniscout browser navigate https://news.ycombinator.com --new-tab --session multi
omniscout browser tab list --session multi
omniscout browser tab switch 0 --session multi

录制可复用的 macro

omniscout record start --name signup-flow
omniscout browser navigate https://example.com/signup
omniscout browser snapshot --refs-only
# ... interact ...
omniscout record stop signup-flow
omniscout macro run signup-flow

记住与召回

omniscout remember https://example.com/blog/post
omniscout memory "what did I read about rerankers?"
omniscout memory note "decision: use Probe Pro for evals"

桌面自动化（macOS）

omniscout computer navigate "Notes" --session notes
omniscout computer wait 300
omniscout computer type "Hello from OmniScout!" --session notes
omniscout computer screenshot --out /tmp/notes.png --session notes

Python 与 shell 集成

export OMNISCOUT_JSON=1

omniscout search "topic"          | jq '.hits[] | {title, url}'
omniscout browser snapshot        | jq '.refs[] | select(.role == "button")'
omniscout extract https://...     | jq '{title, word_count}'
omniscout research "topic"        | jq '.passages[0:3]'

import json, subprocess

def scout(*args):
    out = subprocess.run(
        ["omniscout", "--json", *args],
        capture_output=True, text=True, check=True,
    )
    return json.loads(out.stdout)

hits = scout("search", "local-first AI agents")["hits"]
print([h["url"] for h in hits[:3]])

面向 agent 的 JSON

export OMNISCOUT_JSON=1

omniscout search "topic"          | jq '.hits[] | {title, url}'
omniscout browser snapshot        | jq '.refs[] | select(.role == "button")'
omniscout extract https://...     | jq '{title, word_count}'
omniscout research "topic"        | jq '.passages[0:3]'

示例与配方

On this page