用途:Oracle 把提示词与选定文件打包成一次性请求,让另一个模型在真实仓库上下文下作答,用于调试、重构、设计检查等。输出仅供参考,需对照代码库与测试验证。
主要能力:支持 API 与浏览器两种引擎。默认浏览器路径配合 ChatGPT 的 GPT-5.2 Pro,属人在回路流程,可能耗时约 10 分钟至 1 小时,会话可重新挂接。--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/" --file "!/.test.";浏览器运行 npx -y @steipete/oracle --engine browser --browser-manual-login --browser-keep-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 便于识别。
限制:浏览器引擎仅支持 GPT 与 Gemini,Claude/Grok/Codex 或多模型需 --engine api;API 运行会产生用量成本,需用户明确同意。建议总输入控制在约 196k token 以内,用 --files-report 观察。不要附带密钥等敏感文件。安装:/install-skill https://github.com/steipete/oracle/tree/main/skills/oracle。