安装
安装 OmniScout、验证浏览器并启动 daemon。
系统要求
- Python 3.11+ — 使用
python --version检查 - 基于 Chromium 的浏览器 — Chrome、Brave、Edge、Vivaldi、Opera、Arc 或 Chromium
- macOS 或 Linux — 桌面自动化（
computer）目前仅支持 macOS
安装
pip install omniscout验证安装：
omniscout --version
omniscout --help设置浏览器
OmniScout 通过两种方式驱动真实浏览器：
| 后端 | 说明 | 适用场景 |
|---|---|---|
| Patchright（默认） | OmniScout 使用持久 profile 启动自带 Chromium | 零配置、隔离的自动化 |
| Extension（可选） | 驱动你已有的浏览器，使用真实登录态 | 需要已登录站点的场景 |
检查已安装的浏览器并验证 Chromium 可用性：
omniscout settings browsers
omniscout install如需驱动已有浏览器，请将 OmniScout 指向该浏览器并加载扩展：
omniscout setup --browser dia该命令会下载扩展并打开浏览器的扩展管理页。选择 Load unpacked，选中打印出的文件夹，并确认弹窗显示 Daemon: connected。后端差异见工作原理。
启动 daemon
daemon 是常驻后台进程，让浏览器保持热启动，使每个操作都在亚秒级完成：
omniscout daemon start
omniscout daemon status只需执行一次 — 后续命令 CLI 会自动启动 daemon。端口、日志与生命周期见 Daemon 与会话。
预热模型
首次搜索或问答会下载本地 embedding 模型（之后缓存）。提前预加载，避免在任务中途等待：
omniscout warmup安装 Agent 技能（可选）
如果将由 AI agent 驱动 OmniScout，请安装技能文件，让 Claude Code、Cursor、Codex 和 Gemini CLI 自动发现：
omniscout install --skill完整 agent 配置见与 AI agent 配合使用。
更新与卸载
pip install --upgrade omniscout # update
pip uninstall omniscout # remove the package清除所有本地状态（profile、缓存、索引、记忆）：
rm -rf ~/Library/Application\ Support/omniscout/ # macOS
rm -rf ~/.local/share/omniscout/ # Linux或用 OMNISCOUT_DATA_DIR 覆盖位置。见配置。