oracle

用途：Oracle 把提示词与选定文件打包成一个“一次性（one-shot）”请求，让另一个模型在具备真实仓库上下文的情况下回答问题，适用于调试、重构、设计或评审类检查。输出属于建议性质，应结合代码与测试自行验证。\n\n主要能力：通过 --file 传入文件、目录和 glob，可多次传入或逗号分隔；支持排除模式（如 --file "src/" --file "!src//*.test.ts"）。默认忽略 node_modules、dist、coverage、.git、.turbo、.next、build、tmp 等目录，展开 glob 时遵循 .gitignore，不跟随符号链接，默认过滤点文件（可用 .github/** 之类模式开启），超过 1MB 的文件会被拒绝。可用 --dry-run summary/full 预览载荷与 token 消耗，--files-report 查看文件报告，--render 渲染，--copy（--copy-markdown 的隐藏别名）复制内容作为手动粘贴回退。\n\n使用方式：常用命令包括 oracle --help；未安装时用 npx -y @steipete/oracle --help。默认工作流为浏览器模式加 GPT-5.2 Pro：oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"，长时间运行（约 10 分钟到 1 小时）属正常，会话会存储，超时后可重新附加而非重跑。若设置了 OPENAI_API_KEY 则自动选 api，否则用 browser；浏览器模式仅支持 GPT 与 Gemini，Claude/Grok/Codex 或多模型需用 --engine api。可用 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 才强制新跑。\n\n适用与限制：Oracle 初始不含项目知识，提示词需自行写明技术栈、构建与测试命令、目录与入口、确切问题、原始报错、约束与期望输出。不要默认附上密钥文件，须脱敏。为便于日后复现，可保存独立提示词与文件集重新运行，因为每次运行互不记忆。具体收费、价格与平台范围资料未提供。