Repository navigation
更新readme 尤其是opencodev2使用方式,尤其是v2版本 #985
Description
更新readme 尤其是opencodev2使用方式,尤其是v2版本
https://github.com/ranxianglei/opencode-acp
这里的readme也更新 v2版本推荐https://github.com/ranxianglei/billion-context 注意中英文都改.
更新readme 尤其是opencodev2使用方式,尤其是v2版本
https://github.com/ranxianglei/opencode-acp
这里的readme也更新 v2版本推荐https://github.com/ranxianglei/billion-context 注意中英文都改.
Activity
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 收到 #985。计划:
README.md/README.zh-CN.md:核对并更新 OpenCode 2.x(V2)部分 —— 以当前代码(src/agent/opencode-v2.ts/opencode-native.ts)实际行为为准,补齐 v2 推荐用法(原生插件 / 启动器 / 纯代理三条路径)。README.md/README.zh-CN.md:在合适位置加 v2 说明 —— OpenCode 2.x 下 opencode-acp(V1-only)不加载,推荐使用billion-context(bili)。中英文都改。先通读两边 README 与当前实现,稍后提交 PR 并回帖链接。
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 已完成,两个仓库各一个 PR(中英文都改了):
1. billion-context → PR #986:#986
README.md + README.zh-CN.md 的 OpenCode 2.0 章节重写,共三处(双语同步):
bili opencode(启动器,最省事)或bili plugin install opencode(自拉起原生插件,免启动器);两条路径均已在@opencode/cli2.0.3 上端到端验证。ctx.catalog.model.list(),60s 刷新)读取 context-window / max-output 并以 runtime-info 上报([native] runtime-info protocol: plugins report real model config (model / contextWindow / maxOutput) to the proxy #955)。editor.add的 2.0.x 稳定版上插件会注册/acp状态命令(合成非模型消息、面板优先,与acp_status工具一致);旧形状上保持惰性,acp_status工具仍是宿主内等价手段。2. opencode-acp → PR #441:ranxianglei/opencode-acp#441
README.md + README.zh-CN.md 三处(双语同步):
bili opencode/bili plugin install opencode);本扩展在 1.x 上继续完整可用。opencode一行拆成opencode 1.x(opencode-acp)和opencode 2.0+(billion-context)。check-pr.sh全部通过。所有表述均已对照当前代码核实(
src/agent/opencode-v2.ts、opencode-native.ts、launcher.ts)。纯文档改动,零源码变更。两个 PR 请人工合并。ranxianglei commentedon Sep 19, 2026
这个重写,本来readme乱七八糟 到处都是opencode 上面一块下面一块 重写阅读 整合 删除合并大部分opencode相关
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 收到。PR #986 目前只是三处定点修改,没有解决你说的结构问题——OpenCode 相关内容散落在客户端表格、native/standalone 说明、legacy lane、Option 1、启动器表、1.x 小节、2.0 小等多处,确实乱。我现在按"重写整合"处理:把分散的 OpenCode 内容合并成一个连贯的 OpenCode 章节(版本→选路→用法→注意事项),删除/并入其余散落段落,中英文同步,继续推到 PR #986。完成后回贴。
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 重写整合已完成,推到 PR #986(commit
54d1ee6,分支2026-09-19_readme-opencode-v2)。做了什么(中英文同步):
## OpenCode章节(放在 Quickstart 之后、Running the proxy 之前):### OpenCode 1.x(22 行)、### OpenCode 2.0(112 行)两个小节,以及 "Which do I need?" 下面重复的 legacy-lane 段落 → 合并为一个连贯章节:路径选择表(Launcher / Native / Pure proxy)+ 启动器 + 原生免启动器 + 纯代理 +/acp/acp_status状态说明 + 旧 opencode-acp 会话(opencode v1: keep opencode-acp legacy sessions working after switching to bili #920)+ 注意事项。bili opencode的长注释都缩成一句 + 指向新章节。ZH 表格里重复的裸opencode行直接删掉。#### dsh孤儿地挂在 OpenCode 小节下面,已提升为### dsh(中英文)。内容没有丢:legacy 会话机制、V1
.server()/V2setup()双形态、纯代理兜底、所有注意事项都保留在新章节内,只是不再散落。净效果 EN 约 -150 行散段 → 一个可读的指南;diff hunk 只落在预期区域,无无关改动。一个插曲:推送时发现分支上多了一个别的会话推的 typo 修复(
d85ce19,情→惰)。我 rebase 保留了它——被修复的那行已被重写整体替换,新文本用的是正确写法,不冲突。PR 现有 3 个 commit:42763ff(第一轮定点修改)→d85ce19(typo fix)→54d1ee6(本次整合重写)。验证:两文件标题结构已核对(新章节及其子节齐全)、全文无 "OpenCode 1.x"/"OpenCode 专属说明" 残留引用、splice 处无多余空行(仅存一处 zh 原有空行)。纯文档改动,不动代码/配置/wire。
请人工 review 后合并 PR #986(opencode-acp 侧的推荐文案在 PR #441,不受本次重写影响)。
ranxianglei commentedon Sep 19, 2026
方式 1 —— 原生插件(native,bili plugin install pi / opencode / dsh)
这里给的都是bili plugin install ,实际上还有另外的安装方式 就是原生安装
另外ci冲突
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 收到两点:1) 方式 1 目前只写了
bili plugin install,漏了各客户端自己的原生安装方式(dsh 侧dsh plugin --profile … add billion-context;opencode/npm 裸包名等)——我去核对代码里实际支持的路径后补进中英文;2) CI 冲突——我把分支 rebase 到最新 master 解决。稍后回贴结果。docs: consolidate OpenCode guide + document client-native install pat…
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 两点都已处理,PR #986 已更新(分支已 rebase 到当前 master
409b397,单 commitdac9b8a,CI 冲突消除):1. 原生安装方式(方式 1) —— Option 1 不再只给
bili plugin install,现在明确列出客户端自己的原生安装通道:dsh plugin --profile <name> add billion-context—— 正是安装器按 profile 驱动的那条命令,终态一致,经同一通道卸载;"plugin": ["billion-context"]直接写进真实配置 —— 包发布exports["./server"]→dist/agent/opencode-native.js,opencode 用自己的 Npm.add 机制加载,自拉起行为与 bili 安装的形态完全一致。附两个安装器会替你做的事的提醒:需自己设"compaction": { "auto": false }(已核对代码:V1/V2 插件只上报 compaction boundary,从不在运行时关 auto-compaction),并先备份配置文件;bili plugin install <client>代写。2. CI 冲突 —— 分支原来基于旧 master(#966/#971/kimi/omp/claude 落地前),现已重做:在最新 master 上重新执行整合(单 commit,非堆叠),合并冲突自然消失。
顺带(同属"整合"范畴):被移走的 OpenCode 内容原本把
#### dsh、#### Kimi Code两节挂在 Quickstart 下,整合后顺手提升为###,层级恢复一致。中英文 README 同步。请人工合并:#986
ranxianglei commentedon Sep 19, 2026
暂时合并了,现在这个也有问题
这个 Runtime-info 协议(#955) 不应该放在三种方式中间,本来就是技术文档,专门立一个文档吧 还有很多技术细节解释的都立一个文档.
三种使用方式保持简介.这块新开pr重构
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 收到。方案:新开 PR 做技术细节外移重构——
Runtime-info 协议(#955)整节、注入优先级(#535)整节,以及原生插件自拉起/看门狗等机制细节;开始做,完成后回帖 PR 链接。
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 技术细节外移重构已完成,新 PR:**https://github.com/ranxianglei/billion-context/pull/996**(基于刚合并后的最新 master
95451f2,单 commit7d75e89,中英文同步)新建独立技术文档
TECHNICAL-NOTES.md+TECHNICAL-NOTES.zh-CN.md,收纳原先夹在三种方式中间的机制类内容(逐字搬移,无内容丢失):README 三种方式使用区保持简洁(Quickstart → Option 1/2/3 之间不再有任何机制小节):
#### Runtime-info 协议小节换成一句结论 + 链接;claude 注释条目同样缩成几句 + 链接顺手修了连带引用:
CONFIGURATION.md/CONFIGURATION.zh-CN.md里有两处指向 README 已删除的「注入优先级」小节的引用,已改为指向 TECHNICAL-NOTES。纯文档改动,零源码/wire/配置影响;diff 干净(6 文件 +149/−99)。请人工 review 后合并 PR #996。
ranxianglei commentedon Sep 19, 2026
验证
代理跑着、配置保存了之后,确认它能应答,并且第一个真实请求在日志里显示压缩活动:
这个是不是有问题 在客户端下面?是不是属于proxy模式的部分?
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 你说得对,这段放错了位置。
「验证」小节开头写的是「代理跑着、配置保存了之后」——这正是方式 3(改url,纯代理)的流程描述(只有这种方式需要你保存改过的 baseURL);但它现在排在 dsh / Kimi Code 两个客户端小节后面,读起来就像客户端内容的一部分。
处理:把整个「验证」块挪进方式 3的结尾作为收尾步骤(文字本身不用改,和该流程完全吻合),不再作为独立小节挂在客户端后面。中英文同步。追加到未合并的 PR #996(同一块 Quickstart 结构整理),完成后回帖。
docs: move mechanism details out of Quickstart into TECHNICAL-NOTES (#…
docs: move Verify step into Option 3 (URL change) where its precondit…
ranxianglei commentedon Sep 19, 2026
[bot] 🏷 已修好,追加到 PR #996(#996):
**验证。**引导段)——它的前提「配置保存了之后」正是这条流程独有的;文字一字未改,中英文同步。3859b97;README 一处冲突按并集解决(保留 master 新增的 Single-writer(native模式下自动更新问题需要解决 #991) 小节 + 本 PR 的缩写段落),最终 diff 仍只有 6 个文档文件、两个干净 commit。PR #996 现在包含两块:①技术细节外移到 TECHNICAL-NOTES;②验证步骤归位到方式 3。请人工 review 后合并。
Merge pull request #996 from ranxianglei/2026-09-19_readme-tech-docs-…