docs: README 增加「该选哪个?」一节,写清 opencode-acp / billion-context / billion-context-pi 何时选哪个

[ranxianglei]

背景:三个包(billion-context / billion-context-pi / opencode-acp)经常被一起问「我该怎么选」。billion-context 的 README 刚统一了一节「Which do I need? / 该选哪个?」(见 ranxianglei/billion-context#511)。建议 opencode-acp 的 README 也加同一节,跨仓库保持一致、方便用户互相跳转。

现状:opencode-acp README 目前没有这一节。建议放在「## Installation」之前(和 billion-context 的位置一致)。

下面可直接贴入(EN):

Which do I need?

Pick by your client:

Client	Use
pi	billion-context-pi (in-process extension)
opencode	opencode-acp (in-process extension)
omp	billion-context via bili omp (built-in plugin)
everything else (no context hook)	billion-context — bili <client> (launcher, preferred) or /bili/ prefix

若维护中文 README,ZH 版本:

该选哪个?

按客户端选:

客户端	用这个
pi	billion-context-pi(进程内扩展)
opencode	opencode-acp(进程内扩展)
omp	billion-context,bili omp(内置插件)
其余所有(没有上下文 hook)	billion-context —— bili <client>(启动器,优先)或 /bili/ 前缀

说明:每个项目都带各自 GitHub 链接;表格只回答「什么时候选什么」(pi / opencode / omp / 其余所有),不展开原理。

来源:ranxianglei/billion-context#511

[ranxianglei]

🤖 ework agent · qwen3.8-27b

[bot] 🏷 收到。这是纯文档改动:README.md(EN)+ README.zh-CN.md(ZH)各加一节「Which do I need? / 该选哪个?」,放在「## Installation」之前,内容与 billion-context#511 最终定稿的表格一致(每个项目带 GitHub 链接)。无重复 issue。我核对一下 billion-context PR #512 里落定的格式后直接开分支改 + 提 PR。

[ranxianglei]

🤖 ework agent · qwen3.8-27b

[bot] 🏷 已完成,PR:#363

改了什么

• README.md:在「## Proven at scale」与「## Installation」之间新增 「## Which do I need?」 节(按 issue 要求放在 Installation 之前)
• README.zh-CN.md:对应位置新增 「## 该选哪个?」 节
• devlog/2026-09-04_readme-which-do-i-need/:REQ.md + WORKLOG.md

表格就是 #511 里你定稿的那版四行选型表(pi → billion-context-pi / opencode → opencode-acp / omp → billion-context via bili omp / 其余所有 → billion-context),每个项目带各自 GitHub 链接。我通过 GitHub API 拉了 billion-context master 上已合入的同节做逐字比对,内容一致;只按本仓库排版习惯补了 --- 分隔线。

验证

• typecheck ✅ / build ✅ / test ✅(1077 pass, 0 fail 全量回归)
• scripts/ci/check-pr.sh 本地全过(branch name / devlog / changelog)
• 纯文档改动,不动 version、不涉及代码与状态格式

分支:2026-09-04_readme-which-do-i-need(commits 6fd6875 + 156660d)。等 CI 绿后麻烦你 merge。billion-context-pi 侧的同款改动在 ranxianglei/billion-context-pi#290,由那边处理。