用途：Oracle 把提示词与指定文件打包成一次性请求，让另一个模型带着真实仓库上下文作答，可用 API 或浏览器自动化。结果仅作建议，需对照代码与测试核实。
主要能力：--file 支持文件、目录与 glob，可多次传参或逗号分隔，支持排除（如 --file "src/" --file "!src//*.test.ts"）；默认忽略 node_modules、dist、coverage、.git 等目录，遵循 .gitignore，不跟随符号链接，点文件默认过滤，超过 1 MB 的文件被拒绝。引擎可选 api 或 browser；设置了 OPENAI_API_KEY 时自动选 api，否则选 browser。浏览器仅支持 GPT 与 Gemini，Claude/Grok/Codex 或多模型需用 --engine api。浏览器附件用 --browser-attachments auto|never|always。支持远程浏览器主机：服务端 oracle serve --host 0.0.0.0 --port 9473 --token <secret>，客户端加 --remote-host 与 --remote-token。会话存于 ~/.oracle/sessions（可用 ORACLE_HOME_DIR 覆盖），用 oracle status --hours 72 列出、oracle session <id> --render 重新接入；可用 --slug 命名，重复提示有防护，仅在确需全新运行时用 --force。
使用方式：帮助 oracle --help，未安装时用 npx -y @steipete/oracle --help（此处避免 pnpx，因 sqlite 绑定）。预览不耗 token：oracle --dry-run summary -p "<task>" --file "src/"；oracle --dry-run full -p "<task>" --file "src/"；token 估算加 --files-report。浏览器运行：oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/"。手动粘贴：oracle --render --copy -p "<task>" --file "src/"（--copy 是 --copy-markdown 的隐藏别名）。
适用场景与提示：适合让模型基于少量关键文件做长思考型分析。Oracle 初始没有项目知识，提示词需包含项目简介（技术栈、构建/测试命令、平台约束）、目录与入口说明、确切问题、已尝试内容与原始错误文本、约束条件、期望输出。若运行分离或超时，应重新接入已存会话而非重跑。安全上默认不要附带 .env、密钥文件或认证令牌等秘密，应尽量脱敏。
限制：浏览器模式仅支持 GPT 与 Gemini；运行时长可能很长；文件大小与目录过滤有上述约束；其余收费、价格等信息资料未提供。