安全与隐私
哪些内容会离开你的机器,以及 ocra 如何做隔离。
本页说明各项机制;恶意 PR 能拿它们怎么办、哪些风险仍由你承担,见威胁模型。
会发送给模型供应商的内容
- 审查员的指令、变更的标题和描述,以及被审查文件的 diff。
AGENTS.md和匹配的.ocra/rules.json规则。- 审查员通过工具请求的文件内容和搜索结果。
.ocra/memory.json里与被审查文件有关的已接受问题。- 核查时,每个文件的问题连同它的 diff 和问题附近的代码;裁决时,所有问题以及变更的标题和描述。
供应商就是模型链里写的那个,或在 providers 下声明的供应商的 baseUrl(模型供应商)。审查时,opencode 运行时只访问模型链里的供应商和 OpenCode 的价格目录 models.opencode.ai;direct 运行时只访问模型链里声明的端点。OpenCode 尝试的 npm 安装(启动时的插件包、它没有自带的供应商代码,见模型供应商)都指向本机上一个直接拒绝的 registry,所以不会下载代码,也不会发送 npm 令牌。有一个测试在拒绝所有其他地址的情况下运行 OpenCode。
除此之外不会附加任何内容:你本机的 OpenCode 全局配置、已安装的 skill 和项目指令文件都被关闭,你本机的信息不会进入提示词。
隔离
- OpenCode 运行时只监听
127.0.0.1,每次运行使用随机端口和随机密码,状态存放在临时目录里,结束后删除。 - OpenCode 在它自己的空目录里运行,而不是你的代码目录,并关闭了项目配置,所以提交在被审查代码里的插件、自定义工具和设置(
.opencode/、opencode.json)都不会加载;有测试分别检查这两道防护。 - 审查工具由 ocra 自己的进程在
127.0.0.1上提供,需要随机生成的 bearer token 才能访问。 - 运行时只拿到系统基础变量和模型链中供应商的凭据,而不是你的全部环境变量。
- 所有内置 agent 工具(shell、编辑文件、访问网络)都被关闭,审查员只能读取被审查的那个版本。
- 模型请求的路径被限制在仓库之内。从不跟随符号链接:链接读出来是它指向的路径(和 git 存储的一样),所以
notes.txt -> .env暴露不了.env。工作区里的文件只按它确切的文件名读取:大小写不敏感的文件系统(macOS 默认如此)也能打开的其他写法读不到任何内容。 - 审查员无法读取、查看 diff 或搜索疑似密钥文件(
.env、私钥、证书、云服务和镜像仓库凭据、Terraform 变量和状态文件)、从这类文件名重命名而来的文件,以及.git/下的任何内容,换成哪种写法(大小写、Unicode 大小写变体、不可见字符)都一样,无论提示词怎么要求。同一套规则也把这些文件排除在审查之外。 - 会话日志和
--output文件永远不会通过被审查代码树里预置的符号链接写到别处。
不可信的输入
PR 的文字、diff、仓库文件、规则、仓库指南、工具返回的结果、用 --import-sarif 传入的 SARIF 日志、对问题的回复,以及模型针对它们写出的一切(问题、审查计划、重新定位的引用)都是数据,其中的指令永远不会被执行。
- ocra 自己的分段标签以
<ocra_…>开头。数据中可能拼成这种标签的文本(包括形似的尖括号和字母、全角等兼容写法、空格、大小写和不可见字符)会被改写成‹ocra_…,字段末尾的<也会改成‹,两个字段相接处拼不出标签:数据既跑不出自己的分段,也冒充不了另一条问题。被审查代码里普通的 HTML 和 XML 原样保留。 - PR 标题和描述有长度上限;每个审查任务最多报告 50 条问题,文字长度也有上限。
- 终端输出(问题、commit 信息、错误)中的控制字符、转义序列和双向文本覆盖符都会被替换,改动无法借此改写你的屏幕、藏起问题或写入你的剪贴板。JSON 输出(
--format json、会话报告和日志)会转义同样的字符。 --resume只复用本机 ocra 用你自己的密钥封存过的结果,密钥存放在所有仓库之外,所以随改动提交进来的会话无法冒充一次早先的审查。它读取会话日志时不跟随符号链接,且只读到大小上限为止。
结论不是安全门禁
共享配置
extends 只通过 https 获取设置和规则,从不获取插件,并且可以用 #sha256= 固定内容。审查 PR 时,它和其他配置一样从 base 提交读取。
密钥
供应商 key 只从环境变量读取,绝不会写入配置、日志或会话文件。仓库里的密钥文件对审查员不可读(隔离),因此其内容不会进入提示词、报告或会话文件。
CI
- 把 key 存为 CI 的 secret。
ocra review --pr、GitHub Action 和ocra review --mr从 base 提交读取.ocra/config.json、.ocra/rules.json和AGENTS.md,并且从不加载仓库插件(GitHub、GitLab)。- 来自 fork 的 PR 运行在
pull_request_target上,会把你的 secret 交给 job:之所以可以接受,只是因为 ocra 不运行 PR 里的任何东西,所以绝不要加会运行 PR 代码的步骤。
审查不信任的代码
.ocra/config.json 可以列出插件,而插件会执行代码。ocra review --no-repo-config 忽略这个文件,模型改从 OCRA_MODEL_* 读取。.ocra/memory.json(它可以压掉问题)、.ocra/rules.json 和 AGENTS.md 在使用 --from/--to 时从 --from 提交读取,其他情况下不使用。ocra-eval 总是带上这个开关。
报告漏洞
请通过 GitHub 私下报告,不要发公开 issue:SECURITY.md 说明了哪些属于漏洞,以及之后会发生什么。