用途：Oracle 将提示词与选定文件打包成一次性请求，让另一个模型基于真实仓库上下文作答，适合需要长思考的代码调查与方案咨询。输出属建议性质，须对照代码与测试验证。
主要能力：支持 --engine browser 与 --engine api；浏览器模式支持 GPT 与 Gemini，API 模式用于 Claude、Grok、Codex 或多模型。--file 接受文件、目录和 glob，可多次传入或逗号分隔，支持排除模式（如 --file "src/" --file "!/*.test.ts"），遵循 .gitignore，不跟随符号链接，默认忽略 node_modules、dist、coverage、.git 等目录，超过 1 MB 的文件被拒绝。会话存于 ~/.oracle/sessions，可用 ORACLE_HOME_DIR 覆盖。
常用命令：oracle --help；未安装时用 npx -y @steipete/oracle --help。预览不消耗 token：oracle --dry-run summary -p "<task>" --file "src/"；查看 token：oracle --dry-run summary --files-report -p "<task>" --file "src/"。浏览器运行：oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/"。手动粘贴：oracle --render --copy -p "<task>" --file "src/"。会话：oracle status --hours 72 列出，oracle session <id> --render 重连；用 --slug 命名。远程主机：oracle serve --host 0.0.0.0 --port 9473 --token <secret>，客户端加 --remote-host 与 --remote-token。
限制与注意：浏览器加 GPT-5.2 Pro 常需约 10 分钟至 1 小时，超时或分离时应重连而非重跑；存在重复提示保护，--force 才强制新运行。Oracle 无项目记忆，每次为一次性运行，恢复上下文需用相同提示与文件集重跑。默认不要附加密钥文件，须脱敏。