# oracle — 最佳使用 Oracle 将您的提示 + 选定的文件捆绑到一个“一次性”请求中，以便另一种模型可以使用真实的存储库上下文（API 或浏览器自动化）进行响应。将输出视为建议：根据代码+测试进行验证。 ## 主要用例（浏览器、GPT-5.2 Pro）这里的默认工作流程：ChatGPT 中使用 GPT‑5.2 Pro 的“--engine browser”。这是常见的“长期思考”路径：~10 分钟到~1 小时是正常的；期望您可以重新附加一个存储的会话。推荐默认值： * 引擎：浏览器（`--引擎浏览器`） * 型号：GPT‑5.2 Pro（`--model gpt-5.2-pro` 或 `--model "5.2 Pro"`） ## 黄金之路 1. 选择一个紧密的文件集（仍然包含真相的最少文件）。 2. 预览有效负载 + 代币支出（`--dry-run` \+ `--files-report`）。 3. 使用浏览器模式进行通常的 GPT‑5.2 Pro 工作流程；仅当您明确需要时才使用 API。 4. 如果运行分离/超时：重新附加到存储的会话（不重新运行）。 ## 命令（首选） * 帮助： * `oracle --帮助` * 如果未安装二进制文件：“npx -y @steipete/oracle --help”（此处避免使用“pnpx”；sqlite 绑定）。 * 预览（无代币）： * `oracle --dry-run 摘要 -p "<任务>" --file "src/**" --file "!**/*.test.*"` * `oracle --dry-run full -p "" --file "src/**"` * 代币理智： * `oracle --dry-run 摘要 --files-report -p "" --file "src/**"` * 浏览器运行（主路径；长时间运行正常）： * `oracle --engine browser --model gpt-5.2-pro -p "" --file "src/**"` * 手动粘贴后备： * `oracle --render --copy -p "<任务>" --file "src/**"` * 注意：`--copy` 是 `--copy-markdown` 的隐藏别名。 ## 附加文件（`--file`） `--file` 接受文件、目录和 glob。可以多次通过；条目可以用逗号分隔。 * 包括： * `--文件“src/**”` * `--文件 src/index.ts` * `--文件文档 --文件 README.md` * 排除： * `--文件“src/**”--文件“!src/**/*.test.ts”--文件“!**/*.snap”` * 默认值（实现行为）： * 默认忽略的目录：`node_modules`、`dist`、`coverage`、`.git`、`.turbo`、`.next`、`build`、`tmp`（除非明确作为文字目录/文件传递，否则会跳过）。 * 扩展 glob 时遵循 `.gitignore`。 * 不遵循符号链接。 * 除非通过模式选择加入，否则点文件将被过滤（例如 `--file ".github/**"`）。 * 文件 > 1 MB 被拒绝。 ## 引擎（API 与浏览器） * 当设置`OPENAI_API_KEY`时自动选择`api`；否则为“浏览器”。 * 浏览器仅支持 GPT + Gemini；使用 `--engine api` 进行 Claude/Grok/Codex 或多模型运行。 * 浏览器附件： * `--browser-attachments auto|never|always`（自动内联粘贴最多约 60k 个字符，然后上传）。 * 远程浏览器主机： * 主机：`oracleserve --host 0.0.0.0 --port 9473 --token <秘密>` * 客户端：`oracle --engine browser --remote-host <主机:端口> --remote-token <秘密> -p "<任务>" --file "src/**"` ## 会话 + 片段 * 存储在`~/.oracle/sessions`下（用`ORACLE_HOME_DIR`覆盖）。 * 运行可能会断开或需要很长时间（浏览器 + GPT‑5.2 Pro 经常会出现这种情况）。如果 CLI 超时：不重新运行；重新连接。 * 列表：`oracle 状态 --72 小时` * 附加：`oracle session --render` * 使用 `--slug "<3-5 个单词>"` 保持会话 ID 可读。 * 存在重复的提示卫；仅当您真正想要重新运行时才使用“--force”。 ## 提示模板（高信号） Oracle 从**零**项目知识开始。假设模型无法推断您的堆栈、构建工具、约定或“明显”路径。包括： * 项目简介（堆栈+构建/测试命令+平台限制）。 *“事物所在的地方”（关键目录、入口点、配置文件、边界）。 * 确切的问题+您尝试过的内容+错误文本（逐字）。 * 约束（“不要改变 X”、“必须保留公共 API”等）。 * 期望的输出（“返回补丁计划+测试”，“给出 3 个权衡选项”）。＃＃安全 * 默认情况下不附加机密（`.env`、密钥文件、身份验证令牌）。积极地进行编辑；只分享需要的内容。 ## “详尽提示”恢复模式对于长时间的调查，请编写一个独立的提示+文件集，以便您可以在几天后重新运行： * 6-30 句项目简介 + 目标。 * 重现步骤+确切的错误+您尝试过的内容。 * 附加所需的所有上下文文件（入口点、配置、关键模块、文档）。 Oracle 的运行是一次性的；该模型不记得之前的运行。 “恢复上下文”意味着使用相同的提示符 + `--file ...` 设置重新运行（或重新附加仍在运行的存储会话）。

甲骨文

包含技能