用途：Oracle 将提示词与选定文件打包成一次性的“one-shot”请求，让另一个模型基于真实仓库上下文作答，可通过 API 或浏览器自动化执行。输出属于建议性质，需对照代码与测试验证。
主要能力：支持 --file 附加文件、目录与 glob，可多次传入或逗号分隔；支持排除模式（如 --file "!**/.test."）；默认忽略 node_modules、dist、coverage、.git 等目录，遵循 .gitignore，不跟随符号链接，默认过滤点文件，拒绝大于 1 MB 的文件。支持 --dry-run 预览载荷与 token 消耗，--files-report 查看文件报告。引擎可选 api 或 browser：设置 OPENAI_API_KEY 时自动选 api，否则选 browser；浏览器模式仅支持 GPT 与 Gemini，Claude/Grok/Codex 或多模型需用 --engine api。
使用方式：查看帮助用 oracle --help，未安装时用 npx -y @steipete/oracle --help。预览用 oracle --dry-run summary -p "<task>" --file "src/"。浏览器运行用 oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/"。手动粘贴回退用 oracle --render --copy -p "<task>" --file "src/**"。会话存于 ~/.oracle/sessions，可用 oracle status --hours 72 列出、oracle session <id> --render 重新接入；超时或分离时不要重跑，应重新接入。可用 --slug 命名会话，--force 强制新运行。远程浏览器主机用 oracle serve --host 0.0.0.0 --port 9473 --token <secret>，客户端加 --remote-host 与 --remote-token。
适用场景：需要模型结合仓库上下文做长思考、代码调查或方案建议时。
限制：Oracle 初始无项目知识，提示词需包含项目简介、目录结构、确切问题与错误文本、约束和期望输出。浏览器加 GPT-5.2 Pro 常需约 10 分钟至 1 小时。默认不要附加密钥文件，需脱敏。运行是一次性的，模型不记得先前运行。