用途：Oracle 把提示词与挑选的文件打包成一次性请求，交给另一个模型，在真实仓库上下文下作答，用于调试、重构、设计检查等；输出仅供参考，需结合代码库与测试核实。
主要能力：支持 API 与浏览器两种引擎。浏览器引擎支持 GPT 与 Gemini，常用为 ChatGPT 中的 GPT-5.2 Pro，带人工环节，耗时约 10 分钟至 1 小时，会保存会话以便重连；API 需设置 OPENAI_API_KEY 或显式指定，运行前需用户同意，因为会产生费用。
用法： 查看帮助：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/"
会话与附件：会话存于 ~/.oracle/sessions；可用 oracle status --hours 72 列出，oracle session <id> --render 重连；--slug 命名。--file 接受文件、目录、glob，可多次或逗号分隔，前缀 ! 排除；默认忽略 node_modules、dist 等目录，遵循 .gitignore，不跟随符号链接，点文件需显式包含，超过 1 MB 的文件被拒绝。建议总输入控制在约 196k token 内，用 --files-report 查看占用。
限制：Oracle 无项目先验知识，需在提示中说明技术栈、目录、错误与约束；浏览器引擎不支持 Claude/Grok/Codex，需改用 --engine api；不要附带密钥等敏感文件。