no-mistakes opencode适配器SSE流、结构化输出与重试门【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakesno-mistakes是一款git push no-mistakes即触发 AI 校验流水线的本地 git 门控工具而它的opencode 适配器负责与 OpenCode 智能体协作启动常驻 HTTP 服务、通过SSE 流实时接收响应、以json_schema请求结构化输出并用一套谨慎的重试门决定何时重试、何时停下来等人做决定。本文带你快速看懂这套适配器的设计思路。一、背景no-mistakes 需要连接多种智能体no-mistakes 的核心玩法是把分支推给门控远程no-mistakes而不是直接推给origin它会在一次性的 worktree 中运行审查 → 测试 → 文档 → Lint → 推送 → PR → CI流水线全部绿灯后才放行。流水线里真正干活的是多种可替换的编码智能体claude、codex、opencode、grok、pi、copilot等。其中 OpenCode 比较特别——它不像别的 CLI 那样跑完就退出而是以常驻 HTTP 服务 事件流的方式工作。适配器源码位于 internal/agent/opencode.go官方文档在 agents 指南中有专门说明。二、适配器工作原理三步走1. 启动并复用常驻 HTTP 服务器首次调用时适配器执行opencode serve绑定到本机127.0.0.1的随机空闲端口见 opencode_http.go并轮询/global/health确认就绪。之后的每次调用都会复用同一个服务器避免反复冷启动。一个贴心的细节如果复用中的服务器拒绝连接适配器会把它丢弃、换新服务器再试recoverTransientRetry而不是让整个任务失败。 模型与推理强度不放在命令行参数里而是随每次会话消息发送。因为opencode serve遇到未知参数会直接退出命令行钉模型会拖垮整个服务器。2. 创建会话并发出消息每次任务都会新建一个会话目录 全量放行权限然后 POST 到/session/{id}/message发出提示词最后用defer确保会话被中止和删除不留垃圾。3. 并行消费 SSE 事件流发消息的同时适配器订阅/global/event的SSE 流opencode_stream.go边发边收直到收到session.idle为止。主要事件类型如下SSE 事件适配器的处理message.part.delta增量拼接文本实时回传给 TUI 展示message.part.updated更新完整文本块识别工具调用累计 token 用量message.updated区分用户/助手消息记录缓存读写 tokensession.idle本回合结束停止消费session.error识别思考模式冲突触发回退见下文解析时严格按sessionID过滤只处理自己会话的事件用户自己消息产生的文本块会被过滤掉避免把提示词当成回答。通用 SSE 解析器sse.go支持多行 data、\r\n分隔单行缓冲最大 256MB足够应对大事件。三、结构化输出json_schema 与优雅回退流水线的每个步骤审查结论、CI 修复判断等都需要机器可读的 JSON 结果。适配器在消息体里声明format: { type: json_schema, schema: {...}, retryCount: 2 }OpenCode 会把它实现为一次必须调用的 StructuredOutput 工具响应中的structured字段就是最终结果直接交给流水线使用。但有个坑部分开启思考模式thinking的模型会拒绝强制工具调用 思考的组合直接报错。适配器用正则识别这类冲突文本thinkingToolChoiceConflictPatterns一旦命中就触发回退门新开一个干净会话去掉原生format把 schema 直接写进提示词只回复符合该 schema 的 JSON拿到纯文本回答后再用同一个 schema 做 JSON 解析与校验finalizeTextResult。这个回退不是无条件的——如果失败的回合已经调用过工具比如已经改过文件、提过 commit重放提示词会造成二次副作用适配器会拒绝回退并如实报错把决定权交给人。四、重试门什么时候重试什么时候停手这是 opencode 适配器最讲究的部分opencode_failure.go retry.go。重试循环瞬时故障最多重试若干次采用指数退避1s → 4s → 16s…带 ±25% 抖动且尊重取消信号。判定能否重试的三道锁以 opencode 自己的isRetryable为准。它报不可重试如 400 请求非法就不再走通用的关键字猜测——不能因为错误文本里恰好出现了 rate limit 字样就盲目重发。工具证据三态门。重试是在全新会话里重放整个提示词没有记忆。如果失败回合已经跑过工具toolInvoked证据或无法证明它没跑过工具没看到不等于没发生重试被扣留并明确标注not retried: the failed turn already ran tools。流中断的取证流程。SSE 流中途断开时适配器会中止会话、限期等待消息响应落地用响应中列出的 parts 里有没有工具调用来回答这回合动过手没有而不是凭猜测放行重试。️ 设计哲学一句话沉默不是证据——无法验证没跑过工具的回合一律失败关闭fail-closed宁可停下问人也不静默重放可能产生副作用的操作。五、想深入阅读看这几个文件适配器主流程与结构化输出回退internal/agent/opencode.goSSE 事件解析与 token 用量累计internal/agent/opencode_stream.goHTTP 客户端、会话管理与消息体构造internal/agent/opencode_http.go失败分类、工具证据与重试门internal/agent/opencode_failure.go通用重试循环与退避策略internal/agent/retry.go项目总览README.md六、小结no-mistakes 的 opencode 适配器用三块拼图接住了 OpenCode 这种服务器 事件流形态的智能体SSE 流并行收发实时展示回答进度精确累计 token 与缓存用量结构化输出优先json_schema原生格式遇思考模式冲突自动降级为提示词内嵌 schema 事后校验重试门以 opencode 自身的可重试性裁决为准叠加工具副作用证据检查该重试时指数退避重试不该重放时干净利落地停手。这正是 no-mistakes 的理念缩影——自动化负责跑流水线人负责在关键处拍板。【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 no-mistakes opencode适配器：SSE流、结构化输出与重试门
no-mistakes opencode适配器SSE流、结构化输出与重试门【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakesno-mistakes是一款git push no-mistakes即触发 AI 校验流水线的本地 git 门控工具而它的opencode 适配器负责与 OpenCode 智能体协作启动常驻 HTTP 服务、通过SSE 流实时接收响应、以json_schema请求结构化输出并用一套谨慎的重试门决定何时重试、何时停下来等人做决定。本文带你快速看懂这套适配器的设计思路。一、背景no-mistakes 需要连接多种智能体no-mistakes 的核心玩法是把分支推给门控远程no-mistakes而不是直接推给origin它会在一次性的 worktree 中运行审查 → 测试 → 文档 → Lint → 推送 → PR → CI流水线全部绿灯后才放行。流水线里真正干活的是多种可替换的编码智能体claude、codex、opencode、grok、pi、copilot等。其中 OpenCode 比较特别——它不像别的 CLI 那样跑完就退出而是以常驻 HTTP 服务 事件流的方式工作。适配器源码位于 internal/agent/opencode.go官方文档在 agents 指南中有专门说明。二、适配器工作原理三步走1. 启动并复用常驻 HTTP 服务器首次调用时适配器执行opencode serve绑定到本机127.0.0.1的随机空闲端口见 opencode_http.go并轮询/global/health确认就绪。之后的每次调用都会复用同一个服务器避免反复冷启动。一个贴心的细节如果复用中的服务器拒绝连接适配器会把它丢弃、换新服务器再试recoverTransientRetry而不是让整个任务失败。 模型与推理强度不放在命令行参数里而是随每次会话消息发送。因为opencode serve遇到未知参数会直接退出命令行钉模型会拖垮整个服务器。2. 创建会话并发出消息每次任务都会新建一个会话目录 全量放行权限然后 POST 到/session/{id}/message发出提示词最后用defer确保会话被中止和删除不留垃圾。3. 并行消费 SSE 事件流发消息的同时适配器订阅/global/event的SSE 流opencode_stream.go边发边收直到收到session.idle为止。主要事件类型如下SSE 事件适配器的处理message.part.delta增量拼接文本实时回传给 TUI 展示message.part.updated更新完整文本块识别工具调用累计 token 用量message.updated区分用户/助手消息记录缓存读写 tokensession.idle本回合结束停止消费session.error识别思考模式冲突触发回退见下文解析时严格按sessionID过滤只处理自己会话的事件用户自己消息产生的文本块会被过滤掉避免把提示词当成回答。通用 SSE 解析器sse.go支持多行 data、\r\n分隔单行缓冲最大 256MB足够应对大事件。三、结构化输出json_schema 与优雅回退流水线的每个步骤审查结论、CI 修复判断等都需要机器可读的 JSON 结果。适配器在消息体里声明format: { type: json_schema, schema: {...}, retryCount: 2 }OpenCode 会把它实现为一次必须调用的 StructuredOutput 工具响应中的structured字段就是最终结果直接交给流水线使用。但有个坑部分开启思考模式thinking的模型会拒绝强制工具调用 思考的组合直接报错。适配器用正则识别这类冲突文本thinkingToolChoiceConflictPatterns一旦命中就触发回退门新开一个干净会话去掉原生format把 schema 直接写进提示词只回复符合该 schema 的 JSON拿到纯文本回答后再用同一个 schema 做 JSON 解析与校验finalizeTextResult。这个回退不是无条件的——如果失败的回合已经调用过工具比如已经改过文件、提过 commit重放提示词会造成二次副作用适配器会拒绝回退并如实报错把决定权交给人。四、重试门什么时候重试什么时候停手这是 opencode 适配器最讲究的部分opencode_failure.go retry.go。重试循环瞬时故障最多重试若干次采用指数退避1s → 4s → 16s…带 ±25% 抖动且尊重取消信号。判定能否重试的三道锁以 opencode 自己的isRetryable为准。它报不可重试如 400 请求非法就不再走通用的关键字猜测——不能因为错误文本里恰好出现了 rate limit 字样就盲目重发。工具证据三态门。重试是在全新会话里重放整个提示词没有记忆。如果失败回合已经跑过工具toolInvoked证据或无法证明它没跑过工具没看到不等于没发生重试被扣留并明确标注not retried: the failed turn already ran tools。流中断的取证流程。SSE 流中途断开时适配器会中止会话、限期等待消息响应落地用响应中列出的 parts 里有没有工具调用来回答这回合动过手没有而不是凭猜测放行重试。️ 设计哲学一句话沉默不是证据——无法验证没跑过工具的回合一律失败关闭fail-closed宁可停下问人也不静默重放可能产生副作用的操作。五、想深入阅读看这几个文件适配器主流程与结构化输出回退internal/agent/opencode.goSSE 事件解析与 token 用量累计internal/agent/opencode_stream.goHTTP 客户端、会话管理与消息体构造internal/agent/opencode_http.go失败分类、工具证据与重试门internal/agent/opencode_failure.go通用重试循环与退避策略internal/agent/retry.go项目总览README.md六、小结no-mistakes 的 opencode 适配器用三块拼图接住了 OpenCode 这种服务器 事件流形态的智能体SSE 流并行收发实时展示回答进度精确累计 token 与缓存用量结构化输出优先json_schema原生格式遇思考模式冲突自动降级为提示词内嵌 schema 事后校验重试门以 opencode 自身的可重试性裁决为准叠加工具副作用证据检查该重试时指数退避重试不该重放时干净利落地停手。这正是 no-mistakes 的理念缩影——自动化负责跑流水线人负责在关键处拍板。【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考