SuperAPI AI 工具集

oracle

编程与开发

查看项目

更新于 10-16 06:43

技能介绍

用途:Oracle 把提示词与选定文件打包成一次性请求,让另一个模型基于真实仓库上下文作答,可走 API 或浏览器自动化。输出仅作参考,需结合代码与测试验证。

主要能力:支持 --file 传入文件、目录与 glob,可多次或逗号分隔;支持排除模式(如 --file "src/" --file "!src//.test.");默认忽略 node_modules、dist、coverage、.git 等目录,遵循 .gitignore,不跟随符号链接,点文件默认过滤,大于 1MB 的文件被拒绝。引擎可选 api 或 browser:设置了 OPENAI_API_KEY 时自动选 api,否则选 browser;浏览器仅支持 GPT 与 Gemini,Claude/Grok/Codex 或多模型需用 api。浏览器附件模式为 --browser-attachments auto|never|always。支持远程浏览器主机(oracle serve --host 0.0.0.0 --port 9473 --token <secret>)。会话存储在 ~/.oracle/sessions,可用 ORACLE_HOME_DIR 覆盖;可用 oracle status --hours 72 列出、oracle session <id> --render 重新附着,--slug 便于辨认。

使用方式:查看帮助用 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/"。浏览器+GPT‑5.2 Pro 常耗时约 10 分钟到 1 小时,若超时或脱离应重新附着会话而非重跑;存在重复提示防护,只有确实想新跑时才用 --force。提示词应包含项目简报、关键目录与入口、确切问题与报错原文、约束与期望输出。

限制与安全:Oracle 初始不了解项目,不会记住以往运行,每次都是全新请求;恢复上下文需用相同提示词与文件集重跑或附着仍在运行的会话。默认不要附带 .env、密钥或令牌等机密,应尽量脱敏。