用 opencode run 生成报告,脚本还要检查什么
opencode run --format json 输出逐行事件,脚本需同时检查退出状态、错误事件和报告内容;standalone、审批与会话续接也会影响自动化结果。

opencode run 可以不打开交互界面,直接把任务交给 OpenCode。加上 --format json 后,得到的是逐行 JSON 事件,不是一个完整报告对象;自动化脚本需要同时判断进程是否成功、事件里有没有失败,以及报告是否满足任务要求。
本文于 2026 年 11 月 21 日核对 v2.3.2 CLI 命令文档及非交互运行实现。下面的事件提取器用公开合成输入验收,未运行带认证模型任务。已有 API 配置继续按 OpenCode 接入说明维护,不在这篇重复安装教程。
从一个不改文件的报告任务开始
先让自动化读取公开演示目录,产出检查报告。不要第一次就让它修改仓库、提交、发消息。V2 可以定义一个单独的主 Agent:
{
"$schema": "https://opencode.ai/config.json",
"agents": {
"public-report": {
"description": "Read public Markdown and text files and return a review report",
"mode": "primary",
"permissions": [
{ "action": "*", "resource": "*", "effect": "deny" },
{ "action": "read", "resource": "*.md", "effect": "allow" },
{ "action": "read", "resource": "*.txt", "effect": "allow" }
]
}
}
}
这里拒绝其余工具动作,只开放所需的文件读取;本例指定了文件名,不需要目录遍历和内容搜索工具。通配符跨目录匹配;请从只包含公开演示资料的目录运行,别把后缀白名单当成私人文件分类器。运行用户的系统权限仍应独立限制。
先确认 opencode --version 与 opencode run --help,再在演示目录执行:
opencode run --standalone --agent public-report --format json \
"Read README.md and report unclear setup steps. Cite each relevant heading; do not invent test results." \
> events.jsonl 2> run.log
模型使用你已经配置并验证的选择;需要固定模型时,再按帮助加入 --model provider/model。events.jsonl 和日志可能包含文件内容、路径与工具输入,应放在私有临时位置,不自动提交 Git。
standalone 解决的是哪一层问题
它让这次运行使用私有服务,便于隔离共享后台服务的环境。官方 CI 示例明确使用 --standalone,让私有服务接收到该作业提供的凭据。已经启动的共享服务不一定会获得你刚在终端设置的新变量。
standalone 不等于文件系统或网络沙箱,也不会自动限制模型能力。输出重定向更不会限制工具副作用;需要看刚才的 Agent 权限和操作系统环境。认证问题先走连接基础,不要靠关审批来修。
没有人守着时,审批怎么处理
v2.3.2 的非交互实现会拒绝需要人工决定的权限请求,反馈模型继续其他可行操作;普通追问会取消。其他无法回答的输入请求可能让运行失败。
--auto 会对没有被明确拒绝的权限请求自动允许;它不会覆盖配置的 deny。不要为了避免自动化中断就加上这个开关:先把任务所需动作写清楚,再通过有顺序的权限规则给足必要范围。
工具被拒绝后,模型仍可能输出一段“无法读取”的文字,甚至完成这一轮。因此,“有文本”不能证明读过要求的文件,退出状态成功也不等于业务验收成功。
怎么把 JSONL 事件变成可检查的文本
V2.3.2 输出中可见 text、tool_use、step_start、step_finish、retry、background_wait 和 error 等事件。step_finish 结束的是模型步骤,不是整份业务任务;文本在 part.text。字段应随版本重新核对,不沿用旧博客里猜的结构。
下面保存为 collect_report.py:
import json
import sys
from pathlib import Path
chunks = []
for number, line in enumerate(Path(sys.argv[1]).read_text(encoding="utf-8").splitlines(), 1):
if not line.strip():
continue
try:
event = json.loads(line)
except json.JSONDecodeError:
raise SystemExit(f"Invalid JSON on line {number}")
if not isinstance(event, dict):
raise SystemExit(f"Expected an event object on line {number}")
if event.get("type") == "error":
raise SystemExit("Run emitted an error; inspect the private log")
part = event.get("part")
if event.get("type") == "tool_use" and isinstance(part, dict):
state = part.get("state")
if isinstance(state, dict) and state.get("status") == "error":
raise SystemExit("A tool failed; review the run before using its report")
if event.get("type") == "text":
if not isinstance(part, dict) or not isinstance(part.get("text"), str):
raise SystemExit(f"Invalid text event on line {number}")
chunks.append(part["text"])
report = "".join(chunks).strip()
if not report:
raise SystemExit("No report text found")
sys.stdout.write(report + "\n")
它采取保守策略:有任何工具失败就交给人看,即使模型后来恢复成功。它只拼接文本事件,可能包括中间说明,不会自动识别“最终答案”,也不判断引用是否真实。reasoning 和步骤结束事件不会被当成报告正文。
提取之前先检查原命令退出状态;自动化里可把上面的运行命令放进 if:
if opencode run --standalone --agent public-report --format json \
"Read README.md and report unclear setup steps with heading references." \
> events.jsonl 2> run.log; then
python3 collect_report.py events.jsonl > report.md
else
printf '%s\n' 'OpenCode failed; inspect the private run log.' >&2
exit 1
fi
本文从中英文最终代码块检查了正常文本片段拼接、错误事件、工具失败、非法 JSON、空输出和字段类型错误等合成输入。通过这些检查,只能证明提取器按规则拒绝或输出,不能证明模型报告正确。
重跑应该开新会话,还是继续旧会话
独立报告默认使用独立会话更容易对应输入。需要继续时,V2 支持 --session ses_...;--continue 使用最近会话,在多人或并行作业环境里容易接错对象。记录实际会话 ID,再决定续接。
近期 #64918 报告 Windows 2.3.2 的 run 保存提示后没有回复。机器人最初提出可能的流式原因,原作者随后将自己的案例归到大型未跟踪目录触发的 Git 快照步骤,并自报关闭项目快照后恢复。报告仍开放,本文未复现;不能把“没有回复”一律归因到 API,也不推荐所有人直接关闭快照。
最终验收至少核对:引用的标题确实存在、没有声称运行未执行的测试、没有漏掉指定文件、没有产生额外修改。如果以后接入有副作用的工具,还要先考虑重试是否重复执行;仅换一个会话 ID 不会撤回第一次的外部动作。长任务的连续性另见压缩后的信息保留。


