在 CI 里以无头模式运行 AI 编程助手
安装 oharness 包,然后运行 oharness-headless "<task>":它每行向 stdout 输出一个 JSON 事件,运行失败时以 1 退出。CI 里没人能回应权限确认,所以任何需要询问的操作都会被拒绝——请用规则或 --permission-mode 预先授权要做的事。
更新于
命令
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"提示词可以来自参数,也可以来自 stdin(echo "task" | oharness-headless)。-C <dir> 设置工作目录,-r <id> 继续一个会话,--permission-mode 可取 default、acceptEdits、plan、auto 或 bypassPermissions。
输出什么
stdout 只输出 JSONL,所以可以直接用管道交给 jq;诊断信息写到 stderr。事件流以一个 done 事件结束,其中包含停止原因、用量、费用和轮数:
{"type":"session","id":"20260808_...","model":"deepseek-v4-flash","cwd":"/repo"}
{"type":"tool_start","toolCallId":"c1","toolName":"grep","title":"grep(build)","input":{...}}
{"type":"text_delta","text":"The build entry point is "}
{"type":"done","stopReason":"end_turn","usage":{...},"costUsd":0.004,"turns":2}没有人在场时的权限
如果运行时悄悄批准一切,无人值守就会比有人值守更危险,所以无头模式反其道而行:需要确认的工具调用会被拒绝,并以 permission_result 事件报告。在项目的 .oharness/settings.json 里放行这个任务需要的操作,这样它在仓库里可以被审查:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny 优先于所有模式,包括 bypassPermissions。agent 本来要问用户的问题会立即返回,并附带一条指示:选一个合理的默认值并说明。这些问题仍会以 question_request 和 question_result 出现在事件流里。
CI 里的凭据
把厂商的 key 变量设为 CI secret——DEEPSEEK_API_KEY、ANTHROPIC_API_KEY、OPENAI_API_KEY 等。使用托管方案时,在网站上创建的 key 放进 OHARNESS_API_KEY,OHARNESS_TEAM 则把这次运行计入某个团队的账单。设置了 CI 时,更新检查会自动关闭。
一个 GitHub Actions 步骤
- run: npm install -g oharness
- run: oharness-headless --permission-mode acceptEdits "run npm test and fix failures" > run.jsonl
env:
DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
- run: jq -r 'select(.type=="done") | .stopReason' run.jsonl常见问题
怎样以非交互方式运行编程 agent?
在 OHarness 里,运行 oharness-headless "<task>"。它把 agent 的事件以 JSONL 打印到 stdout,把诊断信息写到 stderr,运行失败时以退出码 1 退出。
无头模式下的权限确认会怎样?
会被拒绝,并以 permission_result 事件报告,因为没有人在场回应。用 .oharness/settings.json 里的权限规则放行任务需要的工具,或者选一个 --permission-mode。
哪些模型可以无头运行?
OHarness 能连接的任何模型:Anthropic、OpenAI、Gemini、DeepSeek、任意 OpenAI 兼容端点,或者 runner 能访问到的本地服务器。用 -m provider/model 指定。