用途：Oracle 将提示词与选定文件打包成一次性请求，让另一个模型在真实仓库上下文下作答，用于调试、重构、设计检查等。输出属建议性质，需对照代码库与测试核实。
主要能力：支持 API 与浏览器两种引擎。浏览器引擎仅支持 GPT 与 Gemini，默认工作流为 --engine browser 配合 GPT-5.2 Pro，属人在回路路径，可能耗时约 10 分钟至 1 小时，会保存可重新接续的会话。未设置 OPENAI_API_KEY 时自动选浏览器，设置后自动选 API；API 运行会产生用量成本，需用户明确同意。
使用方式：查看帮助 npx -y @steipete/oracle --help；预览不消耗 token：npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/" --file "!/.test."；浏览器运行：npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/"；手动粘贴回退：npx -y @steipete/oracle --render --copy -p "<task>" --file "src/"。--file 接受文件、目录与 glob，可多次传入或逗号分隔，前缀 ! 表示排除。默认忽略 node_modules、dist、coverage、.git、.turbo、.next、build、tmp，遵循 .gitignore，不跟随符号链接，点文件需显式包含，超过 1 MB 的文件被拒绝。建议总输入控制在约 196k token 以内，可用 --files-report 或 --dry-run json 观察。会话存于 ~/.oracle/sessions，可用 oracle status --hours 72 列出、oracle session <id> --render 接续；超时不要重跑，应重新接续。可用 --slug 命名会话。远程浏览器主机：oracle serve --host 0.0.0.0 --port 9473 --token <secret>，客户端加 --remote-host 与 --remote-token。
适用场景：需要第二模型基于真实仓库上下文做审查、调试、重构或设计检查时。
限制：Oracle 初始无项目知识，提示词需包含技术栈、构建测试命令、目录结构、确切问题与错误原文、约束与期望输出。不要默认附带密钥（.env、密钥文件、令牌），应脱敏。浏览器引擎不支持 Claude/Grok/Codex 或多模型运行，这些需 --engine api。其余细节暂未提供。