OpenCode V1 集成(实验性){#opencode-v1-integration-experimental}¶
此适配器针对 OpenCode CLI 1.18.29,使用 V1 task 和 permission 接口。
它不针对 V2 subagent 或 permissions 接口。
安装检查不确立工作流或隔离支持。
维护者批准、实际工作流和隔离验证仍在 #146 中待处理。
拟议架构见附加 harness 设计。
安装¶
使用 Python 3.10+ 和带有符号链接的 POSIX 文件系统。 安装前选择一个固定的候选提交。将安装保留在其原始路径。 安装程序会复制完整的规范资源树。它不会更改全局或项目配置。 它会拒绝已存在的目标位置。为每个候选使用新的目标位置。
git rev-parse HEAD
python3 adapters/opencode/install.py /absolute/egm-opencode-candidate
opencode --version
启动前要求版本 1.18.29。如有必要,请安装该确切版本:
npm install --prefix /absolute/opencode-v1 opencode-ai@1.18.29
/absolute/opencode-v1/node_modules/.bin/opencode --version
使用前检查生成的 opencode.json 和 installation.json。
后者记录包标识和所有捆绑文件的 SHA-256 哈希值。
原生配置包含七个命令、八个审阅者和 egm 主代理。
原生技能别名使用规范的 frontmatter 名称,并链接到未更改的技能目录。
使用候选配置从项目目录启动 OpenCode:
模型调用需要单独的用户授权。安装和版本检查不需要模型调用。
在使用原生技能前选择 egm。其他主代理不会收到此适配器的调度指令。
对于审阅文本,请使用普通消息而不是斜杠命令。例如:
将材料粘贴到该普通消息中,或将其保存在文件中供代理读取。
生成的 /egm-brainstorm、/egm-draft 和 /egm-review 命令保留 OpenCode 的原生命令语法。它们的参数不是字面文本:OpenCode 在代理工具权限生效之前会求值 shell 标记(感叹号后跟反引号中的命令)。不要将不受信任的审阅材料粘贴到斜杠命令参数中。Markdown 围栏不会禁用此预处理。
要卸载,请停止会话并仅删除此候选目录,同时移除其环境覆盖项。
路径与调度¶
在生成的提示词中使用绝对捆绑根目录。
相对于该根目录解析 agents/、resources/ 和 docs/。
在解析其别名后,相对于规范技能目录解析 references/。
相对于项目目录解析用户文件。绝不用项目文件替换捆绑的角色(persona)。
使用 V1 task 工具直接从 egm 调度审阅者。
将 subagent_type 设置为角色的规范 frontmatter 名称。
提供 description 和 prompt。省略 task_id 以创建新会话。
使用前台任务。不要启用后台调度或复用审阅者会话。
主代理执行综合并撰写报告;未安装嵌套的合成器适配器。
Bootstrap 工作人员和侦察员(scout)的委派不在该适配器的范围内。虽然所有七个技能都可发现,但任务允许列表仅包含八种审阅者类型。如果 bootstrap 需要编排器(orchestrator)或侦察员,请停止;不要替换审阅者或模拟缺失的工作人员。
为角色、目标、标准和选定的来源传递绝对路径。
不要传递父级历史、私有推理或记忆。
仅在规范阶段要求时提供先前报告路径,例如步骤 8(Intermediate Zoom Out)的 zoom_out_report.md。
仅当先前报告被明确提供且规范阶段要求时才读取它们。
不要检索未经请求的历史、记忆或早期审阅者的发现。
在综合之前,要求完成所有指定的读取且任务实际完成。
将缺失的起始、完成、必需读取或格式错误的结果报告为不完整。
如果原生委派不可用,请停止。绝不要在父级对话中模拟 Goldfish 审阅者。
当头脑风暴(brainstorm)先于草案(draft)时,首先完成全部七个头脑风暴审阅者。
在起草前将其发现综合到 concepts_brief.md 中。
对于审阅,请在开始下一阶段之前写入每个已完成的阶段报告。
在步骤 8 之前,验证 zoom_out_report.md 是否存在于工件目录中。
将其绝对路径传递给审阅者。如果报告缺失,请停止。
审阅者拒绝除 read 和 glob 之外的所有工具。
grep 被拒绝,因为其搜索会绕过主机的按文件 read 规则,包括 .env 排除项。请使用允许的文件读取来获取审阅上下文。
V1 将 MCP 资源读取和资源列表映射到 read 权限。
审阅者的 read 规则允许本地读取,然后拒绝 mcp:*。
这会拒绝 mcp:<server>:<uri> 读取以及 mcp:<server>:* 资源或模板列表。
MCP 资源工具名称可以保持可见。其资源访问在权限检查时被拒绝。
适配器的外部目录例外仅涵盖已安装的捆绑包。
OpenCode 还会在解析后的代理配置中添加对其工具输出目录的访问。
Shell 命令、编辑、网络工具、MCP 工具、技能和委派仍然被拒绝。
主代理对其他工具(包括写入)请求权限。
对于外部目标,请将 fixture 移入项目,或单独审阅一个狭窄的权限更改。
遵循用户提示词或已加载指令中的 EGM artifact directory: <path>。
相对于项目目录解析相对输出目录。否则保留规范的输出文件名和工作目录默认值。
保留每个就绪、章节和阶段的审批关卡。当原生提问工具不可用时,提出一个纯文本问题。
等待用户的回答。缺少工具和经过的时间不构成批准。
验证限制¶
OpenCode 会合并自定义、全局、项目与托管配置。在运行之前检查有效配置;后续设置可能覆盖这些权限。使用干净的配置文件(profile)和一次性项目进行验证。分别检查继承的指令、插件、MCP 服务、内存(memory)和共享文件。只读工具配置并不等同于进程或文件系统隔离。仅凭一个新的子会话不能证明 Goldfish 隔离。
运行离线检查:
这些测试检查安装、资源身份、原生配置以及拒绝覆盖文件的行为。它们不模拟宿主完成记录,也不证明宿主会强制执行。常规 CI 中不会运行实时模型测试。
受限的 OpenCode 原生探针使用脚本化的本地模型,而非实时模型。它检查原生子会话分发、单个父标记,以及拒绝对合成 .env 的读取。它需要固定的 OpenCode 1.18.29 Linux x64 可执行文件。
npm ci --ignore-scripts --prefix tests/integration/opencode-ci
python tests/integration/opencode_native_probe.py \
--source . \
--opencode tests/integration/opencode-ci/node_modules/opencode-linux-x64/bin/opencode \
--output /tmp/egm-opencode-probe-new
选择不存在的输出路径。探针通过并不代表实时模型行为、完整工作流或一般性审查者隔离已得到证实。
2026-10-24,OpenCode 1.18.29 通过 debug config 和 debug agent egm-style 接受了生成的配置。历史审查工具集启用了 read、glob 和 grep。当前候选版本拒绝 grep 以保留 .env 读取限制。debug skill 命令从已安装的候选路径中发现了全部七个技能。这些命令未发起任何模型调用。这一结果不能证明任务执行或运行时权限强制。分离的 XDG 目录并未阻止发现主目录下的技能。干净的验证配置也必须考虑这些位置。此历史说明未指明所测试的 EGM 提交或已安装包(bundle)的校验和。在依赖该候选版本之前,请针对固定的候选版本重复发现操作。
在提出支持声明之前,请明确授权并完成以下检查:
- 记录候选 SHA、已安装哈希、宿主版本、模型标识符、界面和日期。
- 在真实的人工审批暂停(pause)下运行 brainstorm、draft 和 review。
- 保留原生审查者的启动、完成、必需读取及生成的工件(artifacts)。
- 针对一次性文件探测写入拒绝,并检查有效的子会话权限。
- 仅在父会话中放置随机标记,并检查子会话上下文和输出。
- 分别报告安装、工作流和隔离结果。将缺失的证据标记为“未验证”。
对于 OpenCode 1.18.29,离线验证器会检查一个导出的子会话与其父级 JSONL 跟踪记录。请提供每个必需的绝对 POSIX 文件路径:
opencode export <child-session-id> > child.json
python tests/integration/opencode_trace_verifier.py \
--parent-trace parent.jsonl --child-export child.json \
--require /absolute/path/to/agents/zoom_out.md \
--require /absolute/path/to/target.md \
--require /absolute/path/to/standard.md
验证器会匹配原生子会话与父会话身份、任务完成与时间窗口、审查者类型,以及每次工具调用的消息 ID 和会话 ID。它要求一个不含 task_id 的新任务。它要求对每个提供的路径在子会话最终响应之前执行非空的成功文件读取。它将该响应与父任务结果匹配。缺失、冲突、格式错误或不支持的证据会导致失败。父级 JSONL 记录按字面 LF 分割,而不是 Unicode 分隔符。除非调用者提供路径,否则不会验证每个必需路径。它不能证明整个文件的覆盖、会话记录的真实性、上下文隔离,或运行中的工作流是否因缺失证据而停止。不要将父级摘要或缺失标记视为充分的隔离证据。
接口来源¶
审查日期:2026-10-24。以下版本化源定义了该适配器的接口:
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model