# Oracle (CLI) — 最佳使用 Oracle 将您的提示 + 选定的文件捆绑到一个“一次性”请求中，以便另一种模型可以使用真实的存储库上下文（API 或浏览器自动化）进行响应。将输出视为建议：根据代码库+测试进行验证。 ## 主要用例（浏览器、GPT-5.2 Pro）这里的默认工作流程：ChatGPT 中使用 GPT‑5.2 Pro 的“--engine browser”。这是“人在循环”路径：可能需要约 10 分钟到约 1 小时；期望您可以重新附加一个存储的会话。推荐默认值： * 引擎：浏览器（`--引擎浏览器`） * 型号：GPT‑5.2 Pro（`--model gpt-5.2-pro` 或 ChatGPT 选择器标签，如 `--model "5.2 Pro"`） * 附件：目录/glob + 排除；避免秘密。 ## 黄金路径（快速+可靠） 1. 选择一个紧密的文件集（仍然包含真相的最少文件）。 2. 预览您要发送的内容（需要时`--dry-run` \+ `--files-report`）。 3. 在浏览器模式下运行常规 GPT‑5.2 Pro ChatGPT 工作流程；仅当您明确需要时才使用 API。 4. 如果运行分离/超时：重新附加到存储的会话（不重新运行）。 ## 命令（首选） * 显示帮助（一次/会话）： * `npx -y @steipete/oracle --help` * 预览（无代币）： * `npx -y @steipete/oracle --dry-run 摘要 -p "" --file "src/**" --file "!**/*.test.*"` * `npx -y @steipete/oracle --dry-run full -p "" --file "src/**"` * 代币/成本理智： * `npx -y @steipete/oracle --dry-run 摘要 --files-report -p "" --file "src/**"` * 浏览器运行（主路径；长时间运行正常）： * `npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "" --file "src/**"` * 手动粘贴后备（组装捆绑包，复制到剪贴板）： * `npx -y @steipete/oracle --render --copy -p "<任务>" --file "src/**"` * 注意：`--copy` 是 `--copy-markdown` 的隐藏别名。 ## 附加文件（`--file`） `--file` 接受文件、目录和 glob。可以多次通过；条目可以用逗号分隔。 * 包括： * `--file "src/**"` （目录全局） * `--file src/index.ts` （文字文件） * `--file docs --file README.md` （文字目录 + 文件） * 排除（前缀为“!”）： * `--文件“src/**”--文件“!src/**/*.test.ts”--文件“!**/*.snap”` * 默认值（实现中的重要行为）： * 默认忽略的目录：`node_modules`、`dist`、`coverage`、`.git`、`.turbo`、`.next`、`build`、`tmp`（除非您明确将它们作为文字目录/文件传递，否则会跳过）。 * 扩展 glob 时遵循 `.gitignore`。 * 不遵循符号链接（全局扩展使用 `followSymbolicLinks: false`）。 * 点文件将被过滤，除非您明确选择使用包含点段的模式（例如 `--file ".github/**"`）。 * 硬上限：> 1 MB 的文件将被拒绝（分割文件或缩小匹配范围）。 ## 预算+可观察性 * 目标：将总输入保持在约 196k 代币以下。 * 使用“--files-report”（和/或“--dry-run json”）在支出前发现令牌消耗者。 * 如果您需要隐藏/高级旋钮：`npx -y @steipete/oracle --help --verbose`。 ## 引擎（API 与浏览器） * 自动选择：当设置了“OPENAI_API_KEY”时使用“api”，否则使用“browser”。 * 浏览器引擎仅支持GPT + Gemini；使用 `--engine api` 进行 Claude/Grok/Codex 或多模型运行。 * **API 运行在开始之前需要明确的用户同意**，因为它们会产生使用成本。 * 浏览器附件： * `--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/**"` ## 会话 + slugs（不要丢失工作） * 存储在`~/.oracle/sessions`下（用`ORACLE_HOME_DIR`覆盖）。 * 运行可能会断开或需要很长时间（浏览器 + GPT‑5.2 Pro 经常会出现这种情况）。如果 CLI 超时：不重新运行；重新连接。 * 列表：`oracle 状态 --72 小时` * 附加：`oracle session --render` * 使用 `--slug "<3-5 个单词>"` 保持会话 ID 可读。 * 存在重复的提示卫；仅当您真正想要重新运行时才使用“--force”。 ## 提示模板（高信号） Oracle 从**零**项目知识开始。假设模型无法推断您的堆栈、构建工具、约定或“明显”路径。包括： * 项目简介（堆栈+构建/测试命令+平台限制）。 *“事物所在的位置”（关键目录、入口点、配置文件、依赖边界）。 * 确切的问题+您尝试过的内容+错误文本（逐字）。 * 约束（“不要改变 X”、“必须保留公共 API”、“性能预算”等）。 * 期望的输出（“返回补丁计划+测试”、“列出风险假设”、“给出 3 个权衡选项”）。 ###“详尽提示”模式（用于以后恢复）当您知道这将是一项漫长的调查时，请编写一个稍后可以独立使用的提示： * 顶部：6-30 句项目简介+当前目标。 * 中：具体的重现步骤+确切的错误+您已经尝试过的内容。 * 底部：附加所需的_所有_上下文文件，以便新模型可以完全理解（入口点、配置、关键模块、文档）。如果稍后需要重现相同的上下文，请使用相同的提示符 + `--file …` 集重新运行（Oracle 运行是一次性的；模型不记得之前的运行）。 ## 安全 * 默认情况下不附加机密（`.env`、密钥文件、身份验证令牌）。积极地进行编辑；只分享需要的内容。 * 更喜欢“足够的上下文”：更少的文件+更好的提示胜过整个存储库转储。

甲骨文

包含技能