用途:Oracle 把提示词与选定文件打包成一次性请求,让另一个模型在真实仓库上下文下作答,用于调试、重构、设计检查等评审。输出仅供参考,需结合代码库与测试验证。
主要能力:支持 API 与浏览器两种引擎;浏览器引擎支持 GPT 与 Gemini,API 用于 Claude/Grok/Codex 或多模型;可用 --file 传入文件、目录与 glob,支持 ! 前缀排除;默认忽略 node_modules、dist、coverage、.git 等目录,遵循 .gitignore,不跟随符号链接,默认过滤点文件,超过 1 MB 的文件被拒绝。
使用方式:查看帮助 npx -y @steipete/oracle --help;预览 npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/";浏览器运行 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 重新接入;超时不要重跑,应重新接入。
适用场景:需要第二模型评审代码、排查错误、检查设计或重构方案时。
限制:浏览器 + GPT-5.2 Pro 可能耗时约 10 分钟到 1 小时;API 运行会产生费用并需用户明确同意;建议总输入控制在约 196k token 以内;不要默认附带密钥等敏感文件。