SuperAPI AI 工具集

oracle

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

Oracle 把提示词与选定文件打包成一个一次性请求,交给另一模型基于真实仓库上下文回答(走 API 或浏览器自动化)。输出仅作参考,需用代码与测试核实。

主要用途:默认工作流为 --engine browser 搭配 ChatGPT 中的 GPT-5.2 Pro,属于常见“长时间思考”路径,约 10 分钟到 1 小时属正常,会留下可重连的存储会话。

推荐默认:引擎 browser(--engine browser),模型 GPT-5.2 Pro(--model gpt-5.2-pro 或 --model "5.2 Pro")。黄金路径:选最小但含真相的文件集;用 --dry-run 与 --files-report 预览载荷与 token 消耗;常规用 browser,明确需要时才用 API;若运行脱离或超时,重连已存储会话而非重跑。

常用命令:oracle --help;未安装时 npx -y @steipete/oracle --help(此处避免 pnpx,因 sqlite 绑定)。预览(不耗 token):oracle --dry-run summary -p "<task>" --file "src/" --file "!/.test.";oracle --dry-run full -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/"(--copy 是 --copy-markdown 的隐藏别名)。

附加文件:--file 接受文件、目录和 glob,可多次传参,条目可用逗号分隔。包含示例:--file "src/"、--file src/index.ts、--file docs --file README.md;排除示例:--file "src/" --file "!src//*.test.ts" --file "!/*.snap"。默认行为:忽略 node_modules、dist、coverage、.git、.turbo、.next、build、tmp(除非显式作为字面目录或文件传入);展开 glob 时遵循 .gitignore;不跟随符号链接;点文件默认过滤,除非通过模式显式启用(如 --file ".github/**");大于 1 MB 的文件被拒绝。

引擎:设置 OPENAI_API_KEY 时自动选 api,否则 browser。browser 仅支持 GPT 与 Gemini;Claude/Grok/Codex 或多模型运行需用 --engine api。浏览器附件:--browser-attachments auto|never|always(auto 时约 60k 字符以内内联粘贴,超出则上传)。远程浏览器主机:主机端 oracle serve --host 0.0.0.0 --port 9473 --token <secret>;客户端 oracle --engine browser --remote-host host:port --remote-token <secret> -p "<task>" --file "src/**"。

会话与 slug:存储在 ~/.oracle/sessions(可用 ORACLE_HOME_DIR 覆盖)。运行可能脱离或耗时很长;CLI 超时不要重跑,应重连。列表:oracle status --hours 72;附加:oracle session <id> --render;用 --slug "<3-5 words>" 让会话 ID 可读。存在重复提示词防护,只有确实需要全新运行时才用 --force。

提示词模板要点:Oracle 初始对项目零知识,不要假设模型能推断技术栈、构建工具、约定或“显而易见”的路径。需包含:项目简报(技术栈 + 构建/测试命令 + 平台约束)、关键位置(目录、入口、配置文件、边界)、确切问题 + 已尝试内容 + 原始错误文本、约束(如“不要改 X”“必须保留公开 API”)、期望输出(如“返回补丁计划 + 测试”“给 3 个方案及权衡”)。

安全:默认不要附加密钥(.env、密钥文件、认证 token),要激进脱敏,只分享必要内容。“详尽提示词”恢复模式:对长期调查,写出可独立使用的提示词与文件集,以便数日后重跑,包括 6–30 句项目简报与目标、复现步骤与确切错误及已尝试内容、附上所需上下文文件(入口、配置、关键模块、文档)。Oracle 运行为一次性,模型不记得此前运行;“恢复上下文”即用相同提示词与 --file 集重跑(或重连仍在运行的存储会话)。