适合，如果你

• 你用pi、OpenCode或dsh进行数天级编码会话，并受100K上下文限制。

  README的Why和核心描述写明可用100K上下文支撑days、month-long sessions及billions of tokens。
• 你希望原生接入客户端，不改URL、不设置环境变量，也不占用固定8787端口。

  README的Option 1说明原生插件无需launcher、环境变量、固定端口或URL编辑；bili start手动占用8787。
• 你使用OpenCode并能把compaction.auto设为false，避免原生压缩与billion-context叠加。

  README的OpenCode说明要求设置"compaction": { "auto": false }，否则会double-compress。
• 你需要查看缓存健康度，并能依据95–97%命中率和/acp或/acp-cache排查会话。

  README的Cache health at a glance给出95–97% prefix-cache命中率及/acp、/acp-cache诊断入口。

不适合，如果你

• 你必须同时保留原生插件和billion-context-pi或opencode-acp两个独立扩展。

  README明确说明Native mode与billion-context-pi、opencode-acp mutually exclusive，安装器会替换配置。
• 你使用codex但不能先启动bili，也不能自行设置HTTPS_PROXY。

  README的codex说明要求先运行bili start或客户端lane proxy；完整压缩还需要自行export HTTPS_PROXY。
• 你准备从Git checkout直接安装dsh或OpenCode插件，而不是使用npm发布包。

  README指出dsh和OpenCode的git checkout没有published entry，dsh还会因缺少dist/而无法加载bundle。
• 你只接受README明确列出的MIT等标准许可证，但项目元数据仅标为Other。

  项目基础信息中的许可协议为Other；提供材料没有给出完整许可证文本。

前置条件

• 需要npm；README给出的安装命令是npm install -g billion-context --prefix=~/.local。
• Linux/macOS推荐使用~/.local用户级prefix；Windows默认使用%APPDATA%\npm，均避免sudo。
• 原生插件支持pi、omp、OpenCode 1.x/2.x、dsh、kimi、hermes和zcode。
• dsh和OpenCode的原生安装要求npm发布形式；Git checkout没有published entry。
• codex需要bili代理可达；完整压缩还需要自行设置HTTPS_PROXY。

第一步命令（README 原文）

npm install -g billion-context --prefix=~/.local

要注意

• 安装原生插件会替换独立扩展配置，原配置快照保存在.bili-bak。

  README的Native mode说明写明installer swaps entries and snapshots the original config。
• pi原生安装默认启用acp_delegate、acp_delegate_wait和acp_delegate_cancel子代理。

  README的pi说明列出这三个built-in subagents，并另有禁用说明章节。
• OpenCode配置不关闭auto-compaction会发生double-compress。

  README的OpenCode原生安装说明明确要求设置compaction.auto为false。
• codex的MCP工具依赖可用代理；无可达实例时tools/list失败并返回-32003。

  README的codex说明列出BILI_MCP_PROXY、live-instance record、8787默认值及-32003错误。
• 手动bili start使用8787，自动lane从18787区域起步并在冲突时递增。

  README的Ports说明明确区分8787 user zone与18787 self-managed zone。

替代方案

• 主机内置summarizer：你只需要客户端自带的摘要功能，不需要billion-context的增量、可逆和prefix-cache机制。

  Why
• billion-context-pi：你已经采用pi的独立in-process extension，并且不准备切换到bili native mode。

  Option 1 — Native plugin
• opencode-acp：你已经采用OpenCode的独立in-process extension，并且需要保留该配置路径。

  Option 1 — Native plugin

材料未说明

• README节选没有说明支持的Node.js具体版本。
• README节选没有给出不同模型提供商、模型名称及其压缩质量差异。
• README节选没有提供压缩前后真实Token成本、延迟和吞吐基准。
• README节选没有说明运行代理所需的CPU、内存和磁盘规模。
• 项目许可元数据为Other，但提供材料没有给出完整许可证条款及其限制。
• README节选没有说明Windows上的完整安装、代理和客户端覆盖范围。
• 材料没有说明782颗星、weekly Trending上榜与具体功能、发布版本之间的因果关系。