用途：Oracle 将提示词与选定文件打包为一次性（one-shot）请求，交给模型基于真实仓库上下文回答，支持 API 或浏览器自动化。输出属建议性质，须对照代码与测试核实。
主要能力与默认路径：常用 --engine browser 搭配 GPT‑5.2 Pro（--model gpt-5.2-pro），属长时间思考路径，约 10 分钟至 1 小时属正常，会保存会话可重新连接。引擎自动选择：设置 OPENAI_API_KEY 时用 api，否则用 browser；浏览器仅支持 GPT 与 Gemini，Claude/Grok/Codex 或多模型需 --engine api。
用法：帮助 oracle --help，未安装可 npx -y @steipete/oracle --help。预览不耗 token：oracle --dry-run summary -p "<task>" --file "src/" --file "!/.test."；oracle --dry-run full -p "<task>" --file "src/"；用 --files-report 检查 token。正式运行：oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/"。手动粘贴：oracle --render --copy -p "<task>" --file "src/**"。文件通过 --file 传入，支持文件、目录、glob，可多次或逗号分隔；用 ! 排除。默认忽略 node_modules、dist、coverage、.git、.turbo、.next、build、tmp，遵循 .gitignore，不跟随符号链接，点文件默认过滤，超过 1 MB 拒绝。
会话：存于 ~/.oracle/sessions，可用 ORACLE_HOME_DIR 覆盖。运行可能脱离或超时，应重连而非重跑：oracle status --hours 72 列表；oracle session <id> --render 连接；用 --slug "<3-5 words>" 便于识别；重复提示有守卫，--force 才新跑。远程浏览器：服务端 oracle serve --host 0.0.0.0 --port 9473 --token <secret>，客户端加 --remote-host、--remote-token。
限制与安全：Oracle 无项目先验知识，提示需含技术栈、构建测试命令、目录入口、具体问题与报错、约束与期望输出。不要默认附加密钥（.env、key、token），应尽量脱敏。运行是一次性的，模型不记忆上次运行，恢复上下文需用同一提示与 --file 集合重跑，或重连仍在运行的会话。其他细节暂未提供。