使用说明
甲骨文🧿 — 向硅圣人低语你的代币
Oracle为您的代理提供了一种简单可靠的方法 将提示和正确的文件捆绑在一起，并将其交给另一个AI它目前使用GPT-5.1和GPT-5 Pro；专业跑可能需要长达十分钟的时间，并且通常会得到非常有力的答案。
两个引擎，一个CLI
- API引擎 -调用OpenAI响应API。需求
OPENAI_API_KEY. - 浏览器引擎 --在Chrome中自动运行ChatGPT，以便您可以直接使用Pro帐户。切换至
--engine browser；不需要API密钥。
如果你忽略了 --engine，当 OPENAI_API_KEY 存在；否则，它将回退到浏览器模式。显式切换 -e, --engine {api|browser} 当你想覆盖自动选择时。其他一切（提示汇编、文件处理、会话日志）保持不变。
快速开始
# One-off (no install)
OPENAI_API_KEY=sk-... npx -y @steipete/oracle -p "Summarize the risk register" --file docs/risk-register.md docs/risk-matrix.md
# Browser engine (no API key)
npx -y @steipete/oracle --engine browser -p "Summarize the risk register" --file docs/risk-register.md docs/risk-matrix.md
# Globs/exclusions
npx -y @steipete/oracle -p "Review the TS data layer" --file "src/**/*.ts" --file "!src/**/*.test.ts"
# Mixed glob + single file
npx -y @steipete/oracle -p "Audit data layer" --file "src/**/*.ts" --file README.md
# Inspect past sessions
oracle status --clear --hours 168 # prune a week of cached runs
oracle status # list runs; grab an ID
oracle session <id> # replay a run locally
我该如何整合它？
- CI中有一个衬垫 —
OPENAI_API_KEY=sk-... npx -y @steipete/oracle --prompt "Smoke-check latest PR" --file src/ docs/ --preview summary（作为非阻塞报告步骤添加到您的管道中）。 - 包脚本 --In
package.json:"oracle": "oracle --prompt \"Review the diff\" --file ."然后运行OPENAI_API_KEY=... pnpm oracle.
亮点
- 捆绑一次，在任何地方重复使用 --Prompt+文件成为模型可以引用的markdown包。
- 灵活的文件选择 --球状图案和
!excludes允许您在不编写脚本的情况下抓取或跳过文件。 - 专业友好 --GPT-5 Pro后台运行通过重新连接+令牌/成本跟踪保持活跃约10分钟。
- 两条路径，一个UX -API或浏览器，相同的标志和会话日志。
- 默认情况下搜索 --该模型可以用新的引用作为答案的基础。
- 文件安全 --每个文件的令牌会计和大小保护；
--files-report准确显示您发送的内容。 - 可读预览 —
--preview/--render-markdown让你在消费前检查一下这个包裹。
您实际使用的标志
| 标志 | 目的 |
|---|---|
-p, --prompt <text> |
必填提示。 |
-f, --file <paths...> |
附加文件/dir（支持globs和 ! 排除）。 |
| `-e, --engine <api | browser>` |
-m, --model <name> |
gpt-5-pro （默认）或 gpt-5.1. |
--files-report |
按文件打印令牌使用情况。 |
| `--preview [summary | json |
--render-markdown |
打印组装好的 [SYSTEM]/[USER]/[FILE] 捆绑。 |
-v, --verbose |
额外的日志记录（还显示高级标志 --help). |
更多旋钮(--max-input浏览器模式的cookie同步控件等） oracle --help --verbose.
会话和后台运行
每次非预览运行都会写入 ~/.oracle/sessions/<slug> 使用情况、成本提示和日志。使用 oracle status 列出会话， oracle session <id> 重播，以及 oracle status --clear --hours 168 修剪。集 ORACLE_HOME_DIR 重新定位存储。
测试
pnpm test
pnpm test:coverage
如果您正在寻找更强大的上下文管理工具，请查看https://repoprompt.com
灵感来源于：https://ampcode.com/news/oracle
