携带项目文件提问
将问题与选定文件一起提交给模型，使审查意见能够结合实际项目内容。
BAIZE AI RESOURCE
项目文件辅助审查工具
Oracle
Oracle 是面向开发者和编程智能体的命令行工具及 MCP 服务，可将问题与选定的项目文件一起交给 AI 模型审查。它让模型基于实际文件提供调试、重构或设计建议，并保存会话，方便之后查看结果。
资源介绍
Oracle 适合需要让另一款 AI 模型审查项目的开发者和编程智能体。使用时，先提出问题，再选择相关文件；oracle 会把两者组成请求，通过已配置的模型 API 或已登录的浏览器会话获取回答，并保存为可再次查看的会话。文件可按路径、目录或匹配规则选择，也能排除不相关内容，避免把整个项目都交给模型。正式发送前，可以先预览整理后的内容和文件统计；如果只想自行复制并提交给模型，也可以使用不连接模型的渲染模式。它还提供 MCP 服务，便于接入支持 MCP 的编程工具。模型给出的审查意见仍需结合项目和测试自行核实。
应用能力
控制提交范围
支持选择文件、目录及匹配路径，并通过排除规则去掉不相关文件；发送前可预览文件列表和输入量估算。
选择模型连接方式
可通过已配置的模型 API 请求回答，或使用已登录的 ChatGPT、Gemini 浏览器会话；也可仅渲染内容供手动提交。
保存并接续会话
运行结果保存为会话，可查看近期任务、重新连接运行中的任务，并在支持的对话中追加问题。
接入编程智能体
提供 oracle-mcp 服务和配套 Skill，供支持 MCP 或相应 Skill 的编程工具调用。
资源配置
应用版本
v0.21.4
运行环境
其他
安装方式
包管理器安装命令安装源码运行
依赖环境
Node.js浏览器
安装与使用
准备 Node.js 24 或更新版本；在 macOS 或 Linux 上可通过 Homebrew 安装，也可使用 npm 全局安装 @steipete/oracle。
用 oracle 的提问参数输入问题，并用 --file 选择需要审查的项目文件；先使用 --render 预览将提交的内容，此步骤无需模型凭证。
如需模型回答，配置所用服务的 API Key，或安装 Chrome 并完成浏览器登录；按需用 --engine api 或 --engine browser 指定连接方式。
提交请求后查看回答；需要回看时，可用 oracle status 查看近期会话。
使用案例
审查发布风险
使用场景开发者准备发布项目，想请模型检查软件包元数据。
提出审查问题并选择 package.json，先用 --render 检查将提交的内容，再通过已配置的连接方式获取建议。
排查代码并发问题
使用场景开发者怀疑某组代码存在竞态条件。
选择相关源码路径，并排除测试文件，让模型基于指定代码给出审查意见；开发者再结合项目测试核实。
包含内容
release-0-oracle-0.21.4.tgz
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt
常见问题
Oracle 的 --render 会向模型发送文件吗？
不会。--render 只在本地输出整理后的问题和文件内容，不需要模型凭证，也不会联系模型。
Oracle 需要什么运行环境？
需要 Node.js 24 或更新版本。可通过 npm 全局安装；macOS 和 Linux 也提供 Homebrew 安装方式。
不配置 API Key 可以让 oracle 获取模型回答吗？
可以选择浏览器模式，但需要安装 Chrome，并完成所用服务的登录流程。仅使用 --render 预览内容则不需要登录或 API Key。
Oracle 能排除不想提交的文件吗？
可以。--file 支持文件、目录和匹配规则；给匹配规则加上 ! 前缀即可排除对应文件，提交前还可预览文件列表。
相关资源
