Repository navigation
Closed
Labels
Description
来源: ranxianglei/opencode-acp#395 (ranxianglei/opencode-acp#395) 分析「OpenCode 2.0 插件 API 支持」时发现/决策移交。
背景
OpenCode 2.0 发布全新插件 API(@opencode/plugin、Plugin.define({ id, setup })、领域 Hook/Transform、JSON Schema 工具参数、结构化结果、有序权限规则)。官方明确警告 V1 插件实现不能在 V2 下运行(opencode.ai/v2/docs/build/plugins/migrate-v1/)。
opencode-acp(V1 插件,npm latest 1.18.0)因此在 OpenCode 2.0 下不可用。经 #395 讨论决定:不在 opencode-acp 内移植 V2(它是 kernel 化之前的独立实现,移植会延续第二套分叉),V2 支持走 billion-context:
- 纯代理模式(provider baseURL 指向
/bili/)——wire 层、与宿主插件 API 版本无关,理论上对 V2 开箱可用,需实测确认; - 新增 OpenCode V2 启动器模式(对标
bili pi/bili codex)——acp-kernel + V2 胶水,提供宿主内原生工具体验。
opencode-acp#395 保持打开做追踪;opencode-acp 仓库维持 V1-only。
请求范围
① 验证纯代理模式在 OpenCode 2.0 下的表现
- provider baseURL 指向
/bili/的完整链路:认证、请求解析、流式响应改写、4 个工具(compress/decompress/search_context/acp_status)注入与执行; - 若 V2 的 baseURL/auth 机制有差异导致不兼容,记录具体差异并修复。
② 新增 OpenCode V2 启动器模式
- 基于 acp-kernel(pi/dsh 适配器同款「kernel 原样复用 + 宿主薄胶水」模式);
- 先例参考:
billion-context-opencode(已废弃的 acp-kernel 版 opencode V1 适配器,bili_前缀工具)可作结构参考; - 提供宿主内原生工具:compress / decompress / search_context / acp_status(+ 可选 absorb);
- 文档:OpenCode 2.0 安装配置(
"plugins": [...]、"compaction": {"auto": false})。
验收标准(对应原 issue #395 第 9 项,适配后)
- 插件加载(出现在活动插件列表,ID/来源可查);
- 工具注册与执行(JSON Schema 参数、结构化结果);
- System Prompt 与消息上下文处理(context hook 内
event.system/event.messages可变性实测); - 会话恢复与 Fork;
- 模型切换及上下文窗口识别(catalog 域);
- 权限 allow / ask / deny(有序规则);
- 插件卸载与重新加载(subscription 清理、无泄漏);
- 关闭内置自动压缩(
compaction.auto: false)后的完整运行。
V2 API 关键事实(已在 #395 中核实,供接手者参考)
核实来源:官方迁移指南(opencode.ai/v2/docs/build/plugins/migrate-v1/)+ @opencode/plugin@2.0.2 类型定义(npm 已发布)。
| V1(opencode-acp 现状) | V2 |
|---|---|
experimental.chat.system.transform |
ctx.session.hook("context", e => e.system.push(...)) —— system 为可变 SystemPart[] |
experimental.chat.messages.transform |
ctx.session.hook("context", ...) —— messages 为可变 Message[];在 agent 模型请求前一刻运行;需覆盖 primary/compaction/title/generate 各 kind 时分别注册 |
experimental.text.complete |
无直接对应(官方明示),需对照 session/event API 重新评估用途 |
command.execute.before |
ctx.command.transform(e => e.add({ name, description?, execute(input: {sessionID, prompt, delivery}) })) —— 有原生 execute 处理器 |
event |
ctx.event.subscribe({ signal }) 异步迭代器;从 setup 返回的 cleanup 里 abort |
config(全局可变对象) |
无全局可变 config;按域 transform:ctx.agent / catalog / command / tool / permission / … |
tool map(tool() helper) |
ctx.tool.transform(editor => editor.add({ name, description, input: <JSON Schema>, execute(input) => ({ content }) }));editor 回调须同步、廉价、可重放 |
| 权限平铺 map | 有序规则:ctx.permission(list/get/reply/rules + hook("evaluate", e => e.effect = ...)) |
其他要点:
- 入口:
export default Plugin.define({ id, async setup(ctx) {} })(from@opencode/plugin);如需同包兼容 V1,对象形{ ...Plugin.define(...), async server() {...} }自 OpenCode 1.18.29 起受支持(更早版本需独立包/入口)。 - 存储:
ctx.storage(按插件 ID 作用域的持久 JSON);模型/供应商元数据:ctx.catalogtransform(provider.list()/get/update,Provider.Info可变)。 ctx.location描述插件实例的加载位置,不是每个会话/事件的位置——跨会话逻辑要读事件数据本身。
Activity
ranxianglei commentedon Sep 12, 2026
收到,已接手开工。两部分计划如下:
① 纯代理模式验证(OpenCode 2.0)
provider baseURL 指向
/bili/的完整链路实测:认证、请求解析、流式响应改写、4 个工具(compress/decompress/search_context/acp_status)注入与执行;若 V2 的 baseURL/auth 机制有差异导致不兼容,记录具体差异并修复。② 新增 OpenCode V2 启动器模式
先做一个架构澄清:issue 写「基于 acp-kernel(kernel 原样复用 + 宿主薄胶水)」,但当前 master 的 pi/omp/opencode/dsh 插件已全部演进为纯协议客户端——插件内零 acp-kernel import,proxy 是唯一压缩权威,插件只做 manifest 拉取 + tool execute 转发 + status 读取(见
src/agent/shared.ts头注释)。这比 billion-context-opencode 旧方案(插件内嵌 AcpRuntime)更新,且消除 kernel 版本漂移这一类 bug。建议 ② 按现行 protocol-client 模式实现(结构与 pi.ts 相同,仅适配 V2 API surface);如果你确实想要内嵌 kernel 版本,告诉我再调整。已从
@opencode/plugin@2.0.2类型定义核实的关键 V2 事实:Plugin.define是 identity 函数 → 插件可以做成零运行时依赖的{ id, setup(ctx) }对象(构建产物不 import 任何宿主包);ctx.tool.transform(editor => editor.add({ name, description, input: <JSON Schema>, execute })),editor 回调必须同步 → manifest 需在 setup() 异步预取,就绪后ctx.tool.reload()重放;ctx.session.hook("model.request", e => { e.headers[...] })可打x-bili-plugin/x-bili-plugin-conversation(对应 pi 的 before_provider_headers 路径);ctx.command.transform(e => e.add({ name, execute(input: { sessionID, prompt, delivery }) }))有原生 execute 处理器,比 V1 的 prompt-injection hack 干净;ctx.catalog域(对应验收标准「模型切换及上下文窗口识别」)。Launcher 侧:
bili opencode已生成临时 opencode.json(不动用户真实配置),V2 需写plugins键(V1 是plugin)并在其中设compaction.auto = false。接下来:装 OpenCode 2.0 实测 ① → 实现 ②(新 agent 模块 + launcher 接线 + 测试 + README/devlog)→ PR。进展会持续在本线程汇报。
ranxianglei commentedon Sep 12, 2026
[bot] 🏷 进展汇报(① 纯代理验证 + ② V2 启动器,进行中)
① 纯代理模式 — 已验证可用 ✅
provider(单数)、options.baseURL指向/bili/、npm:provider 包、agent.title.model、compaction:{auto:false}—— 完整链路(认证 / 请求解析 / SSE 流式改写)round-trip 通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — 代码完成,正在做最终 live e2e
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。正在进行
最后的 live e2e:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool X executed via plugin(plugin mode 生效、wire 不再重复注入工具)。通过后我会补 README 文档(OC2 安装配置)、提交 PR 并在此更新链接。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 12, 2026
进展汇报
ranxianglei commentedon Sep 13, 2026
[bot] 🏷 当前进展(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — 代码完成,正在做最终 live e2e
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。正在进行:最后的 live e2e——真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool X executed via plugin(plugin mode 生效、wire 不再重复注入工具)。通过后我会补 README 文档(OC2 安装配置)、提交 PR 并在此更新链接。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
[bot] 🏷 进展更新(① 纯代理 + ② V2 启动器)
① 纯代理模式 — 已验证通过 ✅
provider(单数)、options.baseURL: http://127.0.0.1:<port>/bili/http://<upstream>/v1、npm:provider 包、agent.title.model、compaction:{auto:false}。认证 / 请求解析 / SSE 流式改写 round-trip 全部通过。@ai-sdk/openai-compatibleprovider 强制要求 apiKey(即使本地 sglang),缺省会直接拒连;配置里加"apiKey": "sk-test"即可绕过。compaction容忍 → launcher 无需版本探测即可无条件合并compaction.auto:false。② OpenCode V2 启动器模式 — live e2e 已通过 ✅
新增
src/agent/opencode.tsV2 分支(与 V1server()双形态共存,单文件默认导出对象{ id, setup, server },≥1.18.29 兼容):src/compress-tool.ts),同步注册(实测 OC2 无ctx.tool.reload(),必须同步)。session.hook("model.request")注册成功但从不触发;真正的拦截点是session.hook("http.request")(每次出站 provider 请求触发,e.request是标准 fetch Request,改headers能到 wire——已用探针端到端确认)。插件据此在请求上打x-bili-plugin: opencode+ 会话 ID + 上下文窗口(窗口来自ctx.catalog.model.list()缓存刷新)。session.compaction.ended→ 通知 proxy archive(对应 fix: archive blocks across omp native compaction instead of silently deactivating them (#395) #421 路径)。prepareOpencodeHttpRewrite追加合并compaction:{auto:false}。tests/opencode-v2.test.ts(9 用例,覆盖双导出形态、schema parity、惰性激活、kill switch、header 时序、tool 转发、compaction 边界、cleanup dispose)+ launcher 测试断言。全量 1243/1244(唯一失败是沙箱环境既有的 codex 路径问题,与本改动无关)。typecheck / build 通过。Live e2e 结果:真实 OC2 二进制 + 构建产物插件跑完整会话,验证
[plugin] tool acp_status executed via plugin(plugin mode 生效、wire 不再重复注入工具)。README 正在补 OpenCode 2.0 安装配置文档,随后提交 PR。已知限制(会写进文档):OC2 的 command editor 只暴露 list/get/update/remove,插件无法新增命令,所以 V2 下没有
/acp命令——acp_status原生工具是其等价物。ranxianglei commentedon Sep 13, 2026
状态
ranxianglei commentedon Sep 13, 2026
状态汇报:开发已全部完成,**PR 已开 → https://github.com/ranxianglei/billion-context/pull/754**(分支
2026-09-13_opencode-v2)。说明:上次会话在 live e2e 完成后被回复熔断打断,改动一直未提交。本次唤醒后接手收尾:
npm test1451/1453 通过、0 失败(2 skipped;之前沙箱里那个 codex 路径失败在新 master 上已不存在)。src/agent/opencode.ts(V2setup(ctx)分支,与 V1server()双形态共存)、src/agent/shared.ts、src/launcher.ts(合并compaction.auto:false)、tests/opencode-v2.test.ts(9 用例)、launcher 测试断言、README OpenCode 2.0 章节、devlog。apiKey,即使本地端点);② V2 启动器模式实测真插件模式生效——模型调用原生acp_status工具,bili 日志[plugin] tool acp_status executed via plugin、零[acp-loop]wire 注入。关键运行时发现:OC2 中session.hook("model.request")注册成功但从不触发,实际拦截点是session.hook("http.request");无ctx.tool.reload(),工具必须同步注册;command editor 只读不可新增命令(故 V2 无/acp,acp_status原生工具为等价物)。待办只剩人工合并 PR #754(按规范我不合并)。opencode-acp#395 的追踪项可随本 PR 合并后关闭。
一句话中文摘要:OpenCode 2.0 支持(纯代理验证 + V2 启动器模式)开发完成并已在 PR #754 提交,rebase 到最新 master 后全量测试通过,等待人工合并。
jensenojs commentedon Sep 14, 2026
一条指针,关于本 issue 的第 ② 项(原生 V2 适配器 + V2 胶水)。
PR #754 那轮把"V2 下插件改不了上下文"这个前提逐条复测,四条 runtime facts 在 opencode 2.0.1 上都不成立,证据和复现脚本在 #754 (comment) 。
结论层面:
context(messages/system/tools 可变)、model.request(baseURL/headers 可变)、http.response(响应体未被消费,可读可替换,SSE 也算)在插件进程内都生效——请求侧和响应侧都能改。ctx.tool有reload,ctx.command.transform可以新增命令(editor 只有add,新增的会进ctx.command.list())。所以第 ② 项不是"技术上存疑",是取舍问题:进程内做完整闭环没有技术障碍,薄壳从"只能这样"降级为"选择这样"。
ranxianglei commentedon Sep 14, 2026
收到指针。结论先说:接受这个更正——四条 runtime facts 确实是 next-17444 pre-release 的构建特定观察,不是 V2 一般行为;第 ② 项定性为「取舍而非技术存疑」成立。对应修正已在 PR #754 落地,这里把证据评估和取舍立场说清楚。
证据评估(为何接受)
…202609132139/…202609140717),结果互相矛盾(一个只走 V1server()、另一个ctx.session整个缺失)——2.x 插件 API 面确实在逐日漂移,这同时解释了 next-17444 观测与 2.0.1 的差异;@opencode/cli。已复核npm view @opencode/clidist-tagslatest=2.0.3、bin 字段与你的输出一致。你标注的二进制 hash 保留合理,但既然 API 面按构建漂移,精确复现直接对@opencode/cli@2.0.1发布版做即可,不依赖你本机的具体文件。#754 上已落地(commit
80f631c)setup({})干净返回的测试。对取舍的立场(明确建议)
建议维持 protocol-client 薄壳为默认形态,进程内完整闭环至多作为可选扩展、不作默认。理由:
contexthook 可变性的设计,等于把正确性绑在一个移动靶上;薄壳方案只依赖稳定的 HTTP 语义 + 一个 header seam,seam 消失时优雅降级(已实测)。也就是说「API 天天变」本身就是压缩权放代理侧的论据。原生工具(compress/decompress/search_context/acp_status)两种设计下都是宿主侧注册,宿主内体验不受此选择影响;差异只在压缩由谁执行。若 owner 想要进程内模式,可以后续做成 opt-in(环境变量开关),但建议在 OC2 API 面稳定之前不默认启用。
剩余收口项(跟踪在 #754 线程,此处不重复开工)
@opencode/cli@2.0.1原样跑三模式探针(facts/ctx/url)+ 一轮 Live ② 回归(期望[plugin] tool … executed via plugin+ 零[acp-loop]);editor.add()能进注册表,但run "/acp-probe"未走到 execute——若确认可调用(TUI 或某种 run 形态),V2 下恢复/acp是值得做的小跟进,收口后另行提议。一句话中文摘要:接受「四条 runtime facts 在 2.0.1 上不成立」的更正(独立证据支持 API 面按构建漂移),#754 已将文档改为按构建标注并把设计论证改基为单一压缩权威 + kernel 漂移消除(
80f631c,代码因 inert-safe 降级无需改动);明确建议维持薄壳为默认,精确复现与命令调用链收口在 #754 线程进行。Merge pull request #754 from ranxianglei/2026-09-13_opencode-v2
feat: OpenCode 2.0 support — V2 launcher mode + pure-proxy validation (…