用途：Oracle（CLI）把提示词与选定文件打包成“一次性”请求，交给第二个模型结合仓库真实上下文回答，用于代码评审、调试、重构与设计咨询。运行是一次性的，模型不会记住先前的运行。
主要能力：--file 支持文件、目录与 glob，可多次传入或逗号分隔，用 ! 前缀排除，例如 --file "src/" --file "!/*.test.ts"。默认忽略 node_modules、dist、coverage、.git、.turbo、.next、build、tmp，遵守 .gitignore，不跟随符号链接，点文件默认被过滤，超过 1 MB 的文件默认拒绝。可先预览：--dry-run summary/full、--files-report 查看 token 消耗。
引擎与用法：自动选择时若有 OPENAI_API_KEY 则用 api，否则用 browser。浏览器引擎仅支持 GPT 与 Gemini；Claude/Grok/Codex 或多模型需用 --engine api，且 API 运行需用户明确同意，会产生费用。常用命令示例：npx -y @steipete/oracle --help；npx -y @steipete/oracle --engine browser --model gpt-5.5-pro -p "<task>" --file "src/**"；手动粘贴回退：--render --copy（--copy 是 --copy-markdown 的隐藏别名）。远程浏览器主机：oracle serve --host 0.0.0.0 --port 9473 --token <secret>，客户端用 --remote-host 与 --remote-token。
会话：浏览器运行可能耗时 10 分钟到 1 小时并可能脱离。若 CLI 超时不要重跑，应重新接入已存会话：oracle status --hours 72、oracle session <id> --render，可用 --slug 让会话 ID 可读。会话存于 ~/.oracle/sessions。
限制与安全：建议总输入保持在约 196k token 以内；不要默认附上密钥，需大量脱敏，只提供必要上下文。API 运行前可用 oracle doctor --providers 等检查。输出的建议需自行验证。