Skip to content

[PR] feat(contrib): billion_context_native - #1790

Open
zhou1736948757-cpu wants to merge 24 commits into
ranxianglei:masterfrom
zhou1736948757-cpu:2026-10-01_claude-code-native-recall
Open

zhou1736948757-cpu wants to merge 24 commits into
ranxianglei:masterfrom
zhou1736948757-cpu:2026-10-01_claude-code-native-recall

Conversation

@zhou1736948757-cpu

@zhou1736948757-cpu zhou1736948757-cpu commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

中文

概述

本 PR 将原有独立贡献统一命名为 billion_context_native,提供 Claude Code、OpenCode 和 DSH 的原生 Recall 适配。三个适配器共享本地追加式归档,支持搜索和分页读取宿主已暴露并成功归档的历史内容。

适配器保留宿主原有的压缩和模型连接方式,不修改服务商地址、OAuth、全局 fetch、内核或 billion-context 的代理行为。OpenCode 和 DSH 适配需显式启用。旧配置、归档路径和定位符保留兼容。

审查意见处理

已撤销此前单独添加的 6 处测试夹具修改,并整合 #5718 中统一的 ci-fixes 修复。原有历史得到保留,未使用强制推送。

验证

  • Claude Code 2.1.318:以新名称安装,执行真实原生压缩,压缩后和新进程中通过模型搜索、分页读取,完整取回 12,957 字节。
  • OpenCode 2.2.5:以新名称运行,执行真实原生压缩,同一会话的原定位符在压缩后及新进程中完整取回 6,158 字节。
  • DSH 0.2.0-rc.2:以新名称运行,执行真实原生压缩,压缩后及新进程中完整取回 18,616 字节。该版本与 billion-context v0.1.212 的 DSH 测试基线一致;DSH 本身仍为候选版本。
  • 三端均使用 DeepSeek 官方模型和合成数据,分页结果及对应内容逐字节核对一致。一次 DSH 付费响应未执行预期测试工具,失败记录已保留;后续链路通过。
  • 187 项 Python 测试、DSH 14 项、OpenCode 8 项及其他适用检查通过;类型检查和构建通过。跨旧/新版本的归档与定位符读取也已验证。
  • 最新提交的 GitHub Actions:36 项成功、13 项按条件跳过、0 失败。跳过的检查不代表相应线上测试已执行。

限制

Recall 无法重建宿主未暴露、观察前被截断或适配器关闭时遗漏的内容。适配器不宣称能够阻止宿主原生压缩。测试不证明宿主已完全遗忘旧内容;Windows、macOS、其他宿主版本、自动压缩和长期高并发负载仍未全面验证。

归档在本地以明文保存历史内容。召回的历史内容应视为不可信数据,不得作为新指令或授权。

English

Summary

This PR renames the standalone contribution to billion_context_native and provides native Recall adapters for Claude Code, OpenCode and DSH. The adapters share a local append-only archive and support searching and paginated retrieval of history exposed by the host and successfully archived by Recall.

The adapters preserve each host’s native compaction and model connection. They do not change provider URLs, OAuth, global fetch, the kernel or billion-context proxy behavior. OpenCode and DSH integrations are opt-in. Compatibility is retained for existing configuration, archive paths and locators.

Review follow-up

The six independently added test-fixture changes have been reverted, and the canonical ci-fixes changes from #5718 have been integrated. Existing history was preserved without force-pushing.

Validation

  • Claude Code 2.1.318: installed under the new identity; real native compaction and model-driven search and paginated retrieval recovered 12,957 bytes after compaction and in a new process.
  • OpenCode 2.2.5: under the new identity, real native compaction was followed by complete retrieval of 6,158 bytes using the original locator in the same session and after restart.
  • DSH 0.2.0-rc.2: under the new identity, real native compaction was followed by complete retrieval of 18,616 bytes after compaction and in a new process. This matches billion-context v0.1.212’s DSH test baseline; DSH itself remains a release candidate.
  • All three used the official DeepSeek model and synthetic data. Paginated results and their corresponding content matched byte for byte. One paid DSH response did not invoke the expected test tool; the failure was retained, and the subsequent flow passed.
  • 187 Python tests, 14 DSH tests, 8 OpenCode tests and other applicable checks passed, along with type checking and build. Cross-version archive and locator retrieval was also verified.
  • GitHub Actions for the latest commit: 36 successful, 13 conditionally skipped, 0 failed. Skipped checks do not establish that the corresponding live tests ran.

Limits

Recall cannot reconstruct content the host did not expose, content truncated before observation, or content missed while an adapter was disabled. The adapters do not claim to block native compaction. These tests do not prove that all older content was forgotten by the host; Windows, macOS, other host versions, automatic compaction and long-running high-concurrency workloads have not been comprehensively verified.

Archives contain local plaintext history. Retrieved historical content must be treated as untrusted data, not as new instructions or authorization.

…-URL change)

Standalone Python plugin that brings acp-kernel's compression rules, nudges,
tiered summaries, rules and absorb hints to Claude Code using only hooks,
MCP and the transcript JSONL, without routing traffic through a proxy.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 Review started. Snapshot at first pass:

  • Scope: 14 new files, all under contrib/claude-code-native-recall/, 0 lines touched outside it — clean additive diff.
  • CI: version-guard, build-artifact, and all fake-upstream e2e lanes green; the 4 matrix test jobs still running.
  • No prior comments on the thread (fresh PR).

I'm pulling the branch locally to run the plugin's own test suite and walk the hooks/MCP/store code. Full structured review to follow.

ework-agent added 3 commits October 1, 2026 01:35
…P server

Stock macOS (and many Linux distros) ship no bare 'python' on PATH, so every hook and the MCP server would fail to start and the plugin would be silently inert. python3 resolves on macOS/Linux and on Windows with the official Python installer.
… fs-independent

The 55 pre-created old exports all land in the same mtime tick on filesystems with coarse granularity, making 'oldest exports are deleted first' depend on glob ordering (failed on Linux, passed on the original dev machine). Stamp explicit increasing mtimes.
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 ## Review 结论(结构化七问)— PR #1790 Claude Code native-recall 插件

查重:按关键词(claude / recall / contrib / no-proxy)检索了全部 open+closed issues/PR,无重复项。与既有 bili claude(proxy 路线,#964 系)机制不同——本 PR 明确不碰 ANTHROPIC_BASE_URL、不走代理,是独立的新通道,不是重复实现。

1. 是什么问题:无法/不愿把 Claude Code 流量路由到本地代理的用户(典型:订阅制、担心请求被改写的用户)没有任何 acp-kernel 压缩通道;而 Claude Code 自带 compaction 是有损且不可找回的。本 PR 用 hooks + MCP + transcript JSONL 给这条人群补上"可找回的压缩"。

2. 什么原因导致的(约束层):hook 机制决定了插件只能"观察 transcript + 注入 additionalContext + 拦截 PreCompact",不能改写请求体——所以折叠单位只能是整段会话、prefix cache 每次压缩必重置、range folding/reasoning drop/cache_control 等全部不可行。PR 正文的 "What it cannot do without a proxy" 一节对这一边界表述诚实完整,方向成立:host compaction 保持唯一折叠机制,插件只做 gate + 供料 + 存档召回。

3. 怎么修复的(机制):PreCompact exit 2 门控自动压缩直到模型真实调用 compact_ready(只认真实 tool_use,文本提及不算,hard ceiling 强制放行,manual 恒放行)→ 压缩前全量存档(逐轮原文 + 摘要 + rules + todos)→ SessionStart(compact) 分 9 个 ~9.5k 字符块补回 → MCP 提供跨会话 search/get/recall。摘要 tier-2/3 digest、rule 语义(含 id 不复用)、absorb 提示均移植自 kernel。我逐条核对了 verbatim 声明:把 acp-kernel v0.0.99 tag 的 7 个源文件拉下来与 prompts.py 的 17 个常量做了片段级比对,全部一致,NOTICE 的版本号与 MIT+署名条款也准确(与仓库 LICENSE 附加条款相符)。适配处(turn refs、compact_ready)均有注释标注。

4. 是否有回归问题:无。diff 为纯新增(14 文件全在 contrib/claude-code-native-recall/,0 个既有文件改动),bili 自身行为零触碰;CI 矩阵(build/typecheck/test×4/fake-e2e 全 lane)覆盖基线状态。唯一失败项 test (windows-latest) 中 1 个 case(#983 maybeRetry self-heals a base-less register after a failed respawn)是 bili 自己的 MCP register 重试测试——本 PR 未动任何 JS/TS,base..master 的 16 个新提交也没碰该测试,判定为 Windows 时序 flake,与 PR 无关(rebase 后重跑即可)。插件自身 26 个测试是真测试(子进程驱动 hook/MCP + 合成 transcript,断言有牙:exit code、事件日志、restore 块内容、clip→offset 往返),我在本地跑过。

5. 是否破坏缓存:bili 侧不涉及(无任何改动)。插件侧:prefix cache 每次 compaction 重置——这是 hook 架构的固有代价,PR 已显式声明,非回归。

6. 是否改了设计方向:新增一条非代理 Claude Code 通道,与现有 proxy 路线互补而非替代(README 已说明两者差异);代码完全隔离在 contrib/ 下,不进 dist/、不被 src/ 引用,不污染边界。仓库已有 paper/、advisories/ 这类非运行时内容在树的先例。我的建议:保留在树内(contrib/),理由:单一署名/许可锚点、README "Which do I need?" 表可以稳定链接、kernel 文本漂移在树内可见可 diff(prompts.py 钉死 v0.0.99,kernel 升级时需人工同步——这一点建议在 README 写明)。作者若最终想拆出去也随时可以,但我不认为有必要。

7. 是否引入了新的配置:billion-context 配置面零新增(符合 Configuration Surface Discipline;PR 正文有 Config surface 一节)。插件自有 env(RECALL_SOFT/STEP/HARD/HOME/PROJECTS)自包含,不与 BILI_* 命名空间冲突,无迁移问题。


我已直接在分支上修掉的 3 个小问题(已 push:f745fbef..52e51e14,3 个标注 commit)

  1. python → python3(hooks.json ×10 + .mcp.json ×1,commit db8ce5c4):stock macOS 和多数 Linux 发行版 PATH 里没有裸 python(只有 python3),原样合入会导致整个插件在主力平台上静默失效(hooks 启动即失败)。python3 在 mac/linux 和 Windows 官方安装器下均可解析。
  2. flaky 测试(commit 10d57564):test_get_range_verbatim_and_large_range_exported_to_file 在本环境(Linux)实际失败——测试预建 55 个旧导出文件时 mtime 落在同一时间粒度上,_export() 按 st_mtime 淘汰时"最老的是谁"取决于 glob 顺序(数量断言过、身份断言挂)。违反仓库 §7.2 确定性测试规则。修法:测试里用 os.utime 打显式递增 mtime(纯测试改动,不动产品逻辑)。修后 26/26 通过。
  3. serverInfo 版本漂移(commit 52e51e14):mcp_server.py 报 0.2.0,plugin.json/marketplace.json 是 0.2.1,已同步。

需要作者决定的 3 件事(建议合并前至少处理第 1 件)

  1. 【重要】默认 RECALL_HARD=300k 对 200K 窗口模型不可达:README 要求 autoCompactWindow = RECALL_SOFT(150k),门控会一直 block 到 ready/≥HARD/manual;但标准 200K 窗口的模型在 ~200K 处 API 就开始拒绝请求了——模型若一直没调 compact_ready,会话会在 200K–300K 之间死于 prompt-too-long,hard ceiling 根本到不了。作者的 live 验证用的是 lowered thresholds,恰好绕开了这个坑。建议:README 加一行"RECALL_HARD 必须小于你所用模型的最大输入 token(200K 窗口请设 ~190000)",或代码里做 clamp/warn。
  2. turn-ref 可见性缺口:移植后的 HOW TO COMPRESS 仍要求"引用用户原话必须带 turn ref"、open objectives 带 (turn ref)——但 #N 编号是在 precompact 存档时才分配的,模型写 compact_ready 摘要时看不到任何轮次编号(bili 里每条消息都挂着 mNNNNN tag,所以原文成立)。模型要么编造编号要么过度转述。建议把那两处适配成描述性锚点(或在 nudge 里注入当前 epoch 的轮次编号区间提示)。
  3. README 缺首次安装步骤:只有更新/卸载流程,没有 claude plugin marketplace add <path> + 首次 install 的命令;顺带建议补 Python 3 依赖说明、存档为明文本地存储的提示(目前无 GC/清理策略,长会话 turns.jsonl 无限增长——bili 有 opt-in GC 先例,插件侧至少值得写一句)。

次要观察(不阻塞):recall_search/recall_get 不带 session_id 时默认取 RECALL_HOME 下全局最近存档(跨项目,文档只提了同项目多会话的情形);hooks.json 注册 9 个 restore slot 与 KEEP_TURNS=5 隐式耦合(改常量需同步改 hooks.json,值得加注释);precompact 对缺失 trigger 字段 fail-open(视为 manual 放行)——权衡后可接受,存档数据不受损;README/模型面文本纯中文(仓库文档惯例是中英双语,是否补齐由 owner 定)。

判定

暂不可合并:方向认可、代码质量过关、verbatim/署名合规、回归零风险;我 push 的 3 个修复消除了两个硬伤(macOS 静默失效 + flaky 测试),CI 会在新 head 重跑(含那个无关的 Windows flake)。剩余卡点是上面第 1 件(HARD 默认值 vs 模型窗口,属产品决策,须作者/owner 拍板)+ 第 2、3 件建议一并处理。作者回应后我来复核收工。合并操作留给人类:#1790

@ranxianglei ranxianglei mentioned this pull request Sep 30, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

重新叙述这个是啥问题 卡到哪里了

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 一句话:这是外部用户(@zhou1736948757-cpu)提的 PR,给"不走代理的 Claude Code 用户"加一个独立的 Python 插件(contrib/claude-code-native-recall/),用 Claude Code 自带的 hooks + MCP + transcript 实现 acp-kernel 式压缩——模型自己择机写摘要、压缩前全量存档、压缩后补回最近 5 轮原文,之后可用 recall_search/recall_get 找回任何被压掉的内容。不碰 ANTHROPIC_BASE_URL、不走代理、不改 billion-context 任何一行代码(纯新增 14 个文件)。

为什么需要它:现有 bili claude 是代理路线,必须改 base URL;订阅制/担心请求被改写的用户走不了那条路,而 Claude Code 自带 compaction 是有损且找不回来的——这个插件给这部分人补上可找回的压缩。代价(hook 架构决定):只能整段折叠、prefix cache 每次压缩重置、做不了 range folding 等——PR 里自己列得很清楚。

审查进度:已经审完并验证过——

卡在哪:卡在等作者回应 3 件事,其中只有第 1 件是真卡点:

  1. 【真卡点】默认 RECALL_HARD=300k 对 200K 窗口模型不可达:门控会 block 自动压缩直到模型调 compact_ready 或 ctx≥300k,但 200K 窗口的模型 ~200K 就开始 API 报错了——模型若一直不主动调工具,会话死在 200K–300K 之间,强制线永远到不了。作者实测时用的是调低的阈值,恰好绕开了。这属于产品决策(默认值怎么定),得作者/你拍板:要么文档写明"RECALL_HARD 必须小于你的模型窗口",要么代码里 clamp。
  2. 【建议】移植后的压缩规则仍要求模型引用 "turn ref (#N)",但轮次编号是压缩存档时才分配的,模型写摘要时看不到编号——会诱发编造或过度转述,建议把那两处文案改成描述性锚点。
  3. 【建议】README 缺首次安装命令(只有更新/卸载流程),顺带补 Python 3 依赖说明和"存档是明文本地存储、无 GC"的提示。

作者回复第 1 件(最好连 2、3 一起)我就复核收工;合并操作留给你:#1790

… refs; README install

Addresses review on ranxianglei#1790:
1. Hard line is per model: Haiku 180k (RECALL_HARD_HAIKU), others 300k (RECALL_HARD).
   A 'Prompt is too long' API error lets the next auto-compaction through, so a
   200K-window model can never be stuck below the hard line; that error entry's
   zero usage no longer reads as an empty context.
2. Reminders name the actual turn range (#a-#b, current turn) so summaries can cite real refs.
3. README: install commands, Python 3, plaintext/no-GC archive note.
Also: python3 alone breaks on stock Windows (Store alias / non-executable shim).
Hooks now try ${RECALL_PYTHON:-python3} and fall back to python; the MCP server
uses ${RECALL_PYTHON:-python3}, documented for Windows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@zhou1736948757-cpu

Copy link
Copy Markdown
Contributor Author

感谢审查,也谢谢顺手修的 3 处(已保留)。新提交 d79b1264 处理了提到的 3 点:

  1. 300k 强制线对 200K 窗口模型不可达:同意,已修,两层处理:
    • 按模型设强制线:取最新一轮主对话的模型,名字含 haiku 时强制线为 180k(施压 135k、紧急 171k),其他模型保持 300k。可分别用 RECALL_HARD_HAIKU / RECALL_HARD 覆盖。
    • 超长报错兜底(对应 billion 的 overflow 自愈思路):transcript 里本压缩周期内最近一条主链 assistant 记录如果是 "Prompt is too long" 合成报错(isApiErrorMessage),PreCompact 直接放行,日志 reason 记为 overflow。这样 200K 窗口的 Sonnet/Opus 用默认 300k 也不会死锁。顺带修了一个旧 bug:这类合成报错的 usage 全是 0,之前会把上下文用量读成 0,现在计算用量时跳过它们。
    • 说明:transcript 里的模型名没有 [1m] 后缀,插件判断不出实际窗口,所以没有照搬 billion 按窗口比例算阈值的做法。兜底的判定逻辑有单测覆盖;"报错后 Claude Code 会再触发一次自动 PreCompact" 这一点还没有端到端实测,手动 /compact 始终放行,可以作为退路。
  2. 轮次编号:提醒文本里直接给出本段的真实范围,例如 #4–#5 (#5 is the current turn),和压缩后 recall_get 的编号一致。只读到 transcript 尾部、算不准编号时,退回原来的描述性写法。
  3. README:补了首次安装命令、Python 3 依赖、"存档以明文保存在本地、不会自动清理"的说明。

另外一点:hook 和 MCP 直接调用 python3,在不少 Windows 机器上会碰到应用商店占位程序或无法执行的 shim,插件会静默失效。现在 hook 先试 python3,不行就退回 python;MCP 的 command 改成 ${RECALL_PYTHON:-python3},Windows 用户在 settings 的 env 里设 RECALL_PYTHON=python 即可,README 已写明。

测试 30/30 通过,含 Haiku 强制线、超长报错放行、压缩后轮次编号等新用例。麻烦再复核。

@ranxianglei
ranxianglei force-pushed the 2026-10-01_claude-code-native-recall branch from a566043 to 1da03a4 Compare October 3, 2026 03:49
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 复核完成(d79b1264):三点全部落实并验证,CI 全绿,可以合并。

按七问逐项:

  1. 是什么问题:上轮我提的阻塞项——默认 RECALL_HARD=300k 对 200K 窗口模型不可达,模型若不主动调 compact_ready,会话会死在 API 报错与强制线之间——外加两个建议项(轮次编号、README)。本轮复核你的修复提交。
  2. 什么原因导致的:门控放行条件只有 ready / ≥HARD / manual 三条,而小窗口模型的 HARD 超出其窗口,三条都到不了(API 先报 prompt-too-long)→ 死锁。根因是阈值按代理侧假设设定、未对齐实际模型窗口。
  3. 怎么修复的(策略层面):两层——① 按最新一轮主对话的模型选强制线(haiku→180k,其余 300k,RECALL_HARD_HAIKU/RECALL_HARD 可覆盖);② overflow 兜底:本压缩周期内最近一条主链回复若是 "Prompt is too long" 合成报错就直接放行(reason=overflow),顺带修掉合成报错零 usage 把上下文用量读成 0 的旧 bug。轮次编号改为算得准时给真实范围 #4–#5 (#5 is the current turn)、算不准退回描述性写法。判定逻辑双门槛(isApiErrorMessage 且文本含 too long),限流类报错不会误触发;边界后旧报错即失效——都有单测钉住。
  4. 是否有回归问题:逐项过过——block 语义不变(manual 恒放行;auto 仍需 ready/hard/overflow);nudge 三层优先级不变;archive/restore/digest/rule/todos 逻辑未动;版本号 0.3.0 在 plugin.json / marketplace.json / serverInfo 三处一致;无 fail-fast 变吞错模式。唯一语义变化是「新增 overflow 放行 + 阈值动态化」,均为有意的闸门放松且已披露(events reason 枚举新增 overflow,README 同步)。diff 纯新增于 contrib/(15 文件 +2016,主包零改动)→ 对 billion-context 本体回归面为零。CI 13/13 全绿(含上轮撞 [dsh] native proxyEnvOrigin() 把临时 origin 冻结进 BILLION_CONTEXT_PROXY,绕过 ensureProxyRunning() 的 instance 验活;工具调用全部 fetch failed,需重启宿主 #983 无关 flake 的 windows-22)。
  5. 是否破坏缓存:不涉及——PR 不触碰任何请求路径,bili 的 prefix cache 机制原样;插件侧本就无保缓存能力(整段折叠),与上轮结论一致。
  6. 是否改了设计方向:没有。仍是 hooks+MCP+transcript、无代理;RECALL_HARD_HAIKU/RECALL_PYTHON 是既有机制参数化,不是新配置体系。
  7. 是否引入新配置:RECALL_HARD_HAIKU(默认 180000)、RECALL_PYTHON(默认 python3)——都是插件自有 env var,不进 billion-context 配置面,README 已写明。

我这边的独立验证:

  • 本地 python3 -X utf8 -m unittest discover -s tests:30/30 通过(含 4 个新用例)。
  • 查了 Claude Code 官方文档确认两处平台语义:.mcp.json 支持 ${VAR:-default} 语法(未设 → python3,成立);hook 命令走 shell form = sh -c(mac/linux) / Git Bash(PowerShell 仅当没装 Git Bash)(Windows)。后者意味着你新写的 POSIX 回退语法在无 Git Bash 的 Windows 上会解析失败——不是回归(旧的裸命令在那类机器上同样跑不起来),但我在 README 补了一句说明(见下)。
  • 一个观察(不阻塞,保持现状即可):Haiku 下 pressure 线 135k < SOFT 150k,growth 层(完整规则文本)对 haiku 实际永不触发,135k 起一直是 pointer 式提醒——完整规则仍在 compact_ready 工具描述里,信息没丢;200K 窗口下更早更急合理,且有测试覆盖此行为。
  • 记录在案:你自己注明的「报错后 Claude Code 会自动再触发一次 PreCompact」尚未 e2e 实测;手动 /compact 恒放行是退路,风险可接受。

顺手直接修的两处(已推分支,head 现为 1da03a48):

  • a29d36ff:d79b1264 里误提交的 5 个 __pycache__/*.pyc 构建产物从 git 移除 + 加 .gitignore(diff 整洁度);
  • 1da03a48:README Windows 段补一句 hook 需要 POSIX shell(Git Bash),MCP 不受影响。

判定:可合并。 合并操作留给你:#1790

@ranxianglei

Copy link
Copy Markdown
Owner

这个pr我看了 但是还是不理解场景是啥 现在bili提供外部压缩服务 是不是配置cc自己压缩自己即可?

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 好问题,把场景说透:

「配置 CC 自己压缩自己」= Claude Code 内置的 auto-compaction,它本来就开着、不需要任何配置。 插件不是替代它——恰恰相反,它是唯一保留 CC 自带折叠作为折叠机制的方案。问题在于内置压缩是单向有损的:压掉的内容变成一段模型摘要,原文永久找不回来(没有 recall)。这个插件干的事就是在内置压缩外面包一层:压缩前全量存档 → 模型择机写摘要而不是等系统硬切 → 压缩后补回最近 5 轮原文 → 之后随时 recall_search/recall_get 找回任何被压掉的内容。

所以三条路线的取舍是:

纯 CC 内置 bili 代理(bili claude) 本插件
改 ANTHROPIC_BASE_URL 不改 必须改 不改
压缩质量 系统硬切、无门控 acp-kernel 全套(range folding、保缓存、reasoning drop…) acp-kernel 式门控+摘要,但只能整段折叠
压掉的内容能找回吗 不能 能(decompress) 能(recall_*)
适用人群 不在乎历史可找回性 接受流量过本地代理的用户 不想/不能过代理、又想要可找回压缩的用户

bili 覆盖不了的那块就是「必须改 base URL」这个硬前提:订阅制(Pro/Max)用户把流量指到本地第三方代理有账号风险顾虑,还有一类用户就是不接受请求被中间层改写/转发。作者定位的就是这批人——PR 里也明说了代价:凡是需要改写请求才能做的事(range folding、prefix cache 保持、图片剥离等)都做不了,这是 hook 架构的物理上限,不是偷懒。

一句话:如果「CC 自己压缩自己」对你够用(即你能接受压了就找不回),那确实不需要这个;它的存在只为「不过代理 + 要可找回」这个交集。场景是真实的但偏窄——如果你觉得窄到不值得进主树,作者开头就主动提了可以挪去独立仓库、README 只留链接,两条路都通,你拍板即可。

@zhou1736948757-cpu

Copy link
Copy Markdown
Contributor Author

我之前用过类似的对话流量经过本地服务,期间账号被封过,但不确定是网络问题还是中转方式的原因,所以我想保留 cc原本的请求链路,尽量减少额外的中间环节。减少c被封号的风险
我的理解是,bili 的外部压缩服务仍需要主对话流量接入 bili,而这个 PR 通过 hooks、MCP 和本地 transcript 做归档与召回,不改 ANTHROPIC_BASE_URL,也不代理主请求。
即“不经过 bili 中转,但仍然需要在压缩后召回历史原文”,和bili的完整效果有差距,但更安全。

@ranxianglei ranxianglei changed the title feat(contrib): Claude Code native recall plugin — acp-kernel compression via hooks + MCP, no base-URL change [PR] feat(contrib): Claude Code native recall plugin — acp-kernel compression via hooks + MCP, no base-URL change Oct 22, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 你的理解完全准确,和我们的分析一致:

  • 网络面:插件全程零新增网络环节——hooks/MCP 只读本地 transcript JSONL 和本地存档,模型请求一个字节都不经过它;「保留 CC 原本请求链路」是字面成立的。相比之下代理路线里每个请求(含 TLS 握手特征)都从本地服务重新发起,确实是多出来的变量——你账号被封那次具体归因虽然不确定,但减少中间环节降低被检测面的逻辑是站得住的。
  • 能力面:「不中转但可召回」与 bili 完整效果的差距就是 PR 开头列的那张清单(range folding、prefix cache 保持、reasoning drop、图片剥离、system anchor 等),全部因为需要改写请求才做得了。这个取舍在 README 里写明了。

补一个对称的提醒,让取舍完整:不中转换来的是本地磁盘暴露面——存档(对话原文+摘要+规则)以明文存在 ~/.claude/recall/,不会上传但任何能读该目录的进程都能读到(README「存储与隐私」一节已注明)。即风险从「网络侧被看到」挪到了「本机侧被看到」,对多数个人用户这是更小的暴露面,但对高敏感场景值得知情。

场景定位到这里没有分歧了,剩下的是放置问题(进主树 contrib/ vs 独立仓库+README 链接),等 @ranxianglei 拍板即可。

@zhou1736948757-cpu

Copy link
Copy Markdown
Contributor Author

还有就是,我看到有人说 cc 的桌面端改不了 url,我这个因为是原生的,所以桌面端也可以用

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 这个点我查了官方文档,基本成立,而且比「能用」还多一层含义:

  1. 桌面端是订阅制专属入口:官方 quickstart 写明 Code tab 需要 Pro/Max/Team/Enterprise 订阅、用 Anthropic 账号登录——也就是说桌面端用户恰好就是你前面说的「担心中转导致封号」的那批人,这个插件的目标人群和桌面端人群高度重合。
  2. 桌面端确实没有改请求地址的入口:CLI 侧 ANTHROPIC_BASE_URL 是走环境变量注入的,桌面端 GUI 的文档里找不到任何对应设置项(你说的「有人说改不了」与文档现状一致)。所以代理路线在桌面端本地会话上根本没有接入点,原生插件是唯一选项。
  3. hook 和插件在桌面端都生效:hooks 参考文档明确「Claude Code 在所有运行面(终端、IDE、桌面应用、云端)触发相同的 hook 事件」,桌面端也支持安装带 skills/MCP servers 的插件——本插件的 hooks + MCP 两个组件都有落点。

一个精确性备注:这只覆盖桌面端的本地会话;如果会话被发到 Cloud/SSH 环境跑,那些环境不读本机的 settings/hooks,插件不生效(本地存档和召回仍然可用,只是门控不在)。

至此场景证据链齐了:订阅用户 + 桌面端无 base-URL 入口 + 要可找回压缩 → 只有这条路线通。放置问题仍等 @ranxianglei 拍板(进主树 vs 独立仓库)。

@ranxianglei

Copy link
Copy Markdown
Owner

这个pr可以合并 ework需要处理下冲突 并且需要把这个方案做的通用化一点 做完一个任意客户端都可选的一个方案

…s acp-kernel 0.0.166 (branch had stale 0.0.165 ci-fixes sync)
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重:不重复 —— 本车道即此 PR 的冲突处理任务;检索 open+closed 无平行的 recall/native-recall 冲突工作项。
标签:claude-code / scope/wiring / p3(功能类客户端车道新增,opt-in contrib 插件,对既有用户零影响)。

冲突已解决 —— GitHub 确认 mergeable=True(head 4764afdef)

1. 是什么问题:PR 分支与 master 冲突、无法合并(merge state dirty);13:14Z 报出的 kernel-guard 红(floor 28)是同一陈旧状态的副作用。
2. 什么原因导致的:两个独立写入方各改了两份 lockfile 里同一批「记录版本」行——凌晨 help-merge sweep(#4599 floor 262)把 ci-fixes 的 dfadc21b3(记录 acp-kernel 0.0.165)合进了本分支,而 master 已经通过 #4807 独立把 lockfile 再生成到 0.0.166;双方相对共同基 cdac1c0 以不同值改了同一行 → package-lock.json + kernel/package-lock.json 文本冲突。PR 自身新增的 contrib/ 15 个文件与 master 零冲突(纯新增)。
3. 影响范围与严重程度:仅 CI 级(阻塞合并);用户面零影响。解决后 diff vs master = 只剩 contrib/ 下 15 个新文件(+2016 行)。
4. 怎么修复的:merge master 341e76c28 进分支,两份 lockfile 冲突均取 master 侧(较新的记录版本胜出,与 #4599 lock-sync 收敛同纪律)。说明:并行 ci-worker 车道(ci-check)已于 13:27Z 先行推送了内容完全相同的解法(merge commit 4764afdef);我本地独立复现了同一 merge,结果树与其逐字节一致(diff = 0),故以交叉验证收口、未重复推送制造冗余提交。
5. 是否有回归问题:无。合并后树 = master + contrib/ 纯新增,全部既有文件与 master 逐字节相同(git diff 核实:contrib/ 之外零改动、lockfile 对 master delta = 0 字节)。插件自身测试套件在合并后树上本地跑 30/30 绿。另:先前转发的 kernel-guard 红随之自愈——diff vs master 不再触碰任何 kernel/** 文件,Rule 1 不触发,无需补声明。
6. 是否破坏缓存:不涉及。
7. 是否改了设计方向:不涉及。
8. 是否引入新配置:不涉及。

预期残余红(非本 PR 引入):截至 13:03Z master 自身 test lanes 红(#4599 floor 299,哨兵已接管、修复收敛 ci-fixes);新 head 的 test 分片若按那些在册签名红,按继承失败对待、去 #4599 比对签名,不在本 PR 内重复排查。

floor 25 的通用化要求已立项跟踪:#4858(把无代理召回压缩方案通用化为任意客户端可选方案;正文含 owner 原话引用、#1790 五件套机制拆解、待拍板的设计问题与建议方向)。本车道只负责冲突收口,通用化按该 issue 另行推进。

合并操作留给人工:#1790

Keep both hosts on the shared append-only archive and stable paginated MCP reader.
Include Claude Code v0.3.2 schema compatibility fix, complete scoped tests,
and explicit native-validation limits. Preserve the original PR history.
Declare the main persona in six DSH test fixtures after the generic
single-shot sidecar gate was added upstream. Keep all BLOCKED-ref,
request-count, cross-wire fold, and watermark assertions unchanged.

Validated the six failing cases on both the PR merge tree and upstream,
then passed 48 related tests with explicit main markers, typecheck,
and build. Preserve the original Recall contribution unchanged.

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(ai: vllm-qwen/qwen3.8-27b)

Full-diff review (60 files, +8104/−5) plus local run of the plugin suite. Code quality is high — positives at the bottom. One blocking item.

Blocking: unrelated master-level CI fix bundled into this PR

Commit bb373ae4b (“fix: mark DSH regression fixtures as main requests”) modifies six repo-root test files outside contrib/:

  • tests/issue2419-dsh-skill-catalog.test.ts:220
  • tests/issue2446-dsh-mcp-catalog.test.ts:246
  • tests/issue2447-dsh-workspace-instructions.test.ts:231
  • tests/issue2481-dsh-runtime-context.test.ts:243
  • tests/issue2817-crosswire-persona-fold.test.ts:122
  • tests/issue5403-watermark-fastpath.test.ts:158

Those fixtures failed on master after #5687 added the generic single-shot sidecar gate (isDshSingleShotSidecar, src/server/side-request.ts:203) — an inherited red every open PR carries. The canonical fix for exactly this red already exists on origin/ci-fixes (0470bec62, “test(ci): realign five dsh regression pins to the #5656 sidecar residual (#4599)”). Per AGENTS.md CI-coordination policy, master-level fixes must converge on ci-fixes; carrying a second, differently-shaped fix inside a feature PR will collide textually when ci-fixes lands and scatters one failure domain across two places.

Fix: drop bb373ae4b from the branch (git revert bb373ae4b or rebase it out), then git merge origin/ci-fixes and push. The PR diff then stays scoped to contrib/claude-code-native-recall/.

Non-blocking

  1. PR description is stale on scope. The body describes only the Claude Code plugin, but 9631c55 also adds a full OpenCode V2 native adapter (opencode/index.js, opencode_bridge.py, archive.append_native, tools/opencode-native-validation/). Please update the body (or narrow the scope).
  2. PR description says “26 tests”; the suite is 162 (README.md:5 and VALIDATION.md both say 162; local run: Ran 162 tests ... OK).
  3. Informational: opencode/index.js:119 hard-pins OpenCode V2.2.5 and throws otherwise — intentional fail-fast and documented, just noting every host upgrade breaks activation until the plugin ships. Separately, mcp_server.py’s stdin loop parses each line unguarded; one malformed line would kill the MCP process (low risk — hosts send well-formed JSON-RPC).

What I verified (positives)

  • No changes under kernel/, no package.json/lockfile/version changes, no config-surface changes, nothing in src/ beyond the six test files above. Pure addition under contrib/claude-code-native-recall/.
  • License: NOTICE carries MIT + attribution crediting acp-kernel v0.0.99. Spot-checked the vendored prompt text against the in-repo kernel (now 0.0.169): COMPRESS_PHILOSOPHY, EMERGENCY_HEADER, the open-objectives carry-forward rule, absorb minToolTokens=4000, rule limits 50/300 — all match verbatim.
  • Local run of the plugin suite: 162/162 pass (stdlib-only, ~62s).
  • Engineering quality is strong: atomic writes with fsync + dir sync and flock; symlink rejection across all path handling; session-id validation; bounded responses (64 KiB cap with wire reserve); env scrubbing for bridge spawns; bridge stderr dropped (private data); hooks fail-open so they never veto host execution; the OpenCode adapter is strictly opt-in (explicit projects/sessions lists, project re-check on every capture); honest completeness/conflict labels instead of invented turns or receipts.
  • Behavior disclosure: none — bili itself is untouched; no old→new drift in any existing behavior.

@ranxianglei

Copy link
Copy Markdown
Owner

(ai: vllm-qwen/qwen3.8-27b)

Review 结论(结构化八问)— PR #1790 当前 head bb373ae4b

查重:不重复——本车道即此 PR 的专职 review 任务;前两轮审查(9/30、10/3)与 owner 在 floor 25 对当时 head 4764afdef 的合并批准都在本线程内,无平行工作项。本轮是对 4764afdef 之后新增内容(OpenCode 适配器 + 存档强化 + bb373ae4b)的独立复审,不复读前轮结论。

1. 是什么问题:owner 已在 4764afdef 状态批准合并;此后分支新增了两块内容——9631c5596(OpenCode V2 原生召回适配器 + CC 存档强化,属 floor 25 要求的通用化方向,立项 #4857/#4858)和 bb373ae4b(六处 dsh 回归测试补 main header)。本轮审的是新状态能否合并。

2. 什么原因导致的:PR 自身代码无缺陷需要修。唯一问题是流程性的:bb373ae4b 修的是 master 继承红(#5687 的 single-shot sidecar gate 让六个 dsh fixture 变单发侧车形状而红),同一红的 canonical 修复已在 origin/ci-fixes / PR #5718(0470bec62)。按 CI 协调政策,master 级修复必须收敛到 ci-fixes,不得在各 PR 分支各带一份不同形状的修法——否则 #5718 合入时文本冲突、一个失败域散落在两处。

3. 影响范围与严重程度:仅阻塞本 PR 合并路径;用户面零影响。代码本身纯新增于 contrib/claude-code-native-recall/,bili 本体零触碰面。

4. 怎么修复的:从分支去掉 bb373ae4b(revert 或 rebase 掉),再 git merge origin/ci-fixes(内容即 #5718)并推送;diff 收敛回 contrib/ 纯新增。CI 随之重跑即绿。

5. 是否有回归问题:逐项清点过——无 kernel/ 改动、无 package.json/lockfile/version 改动、无 src/ 改动(除那六个测试文件)、无配置面改动 → 对既有行为回归面为零。插件侧独立验证:本地全套 162/162 通过(stdlib-only,~62s);verbatim 声明对当前 in-repo kernel(0.0.169)逐段抽查全部一致(COMPRESS_PHILOSOPHY、EMERGENCY_HEADER、open-objectives carry-forward、absorb minToolTokens=4000、rule limits 50/300);NOTICE 的 MIT+署名条款准确。工程质量过关:原子写+fsync+flock、全路径 symlink 防御、session-id 校验、出站有界(64KiB cap)、bridge spawn env 白名单、bridge stderr 丢弃(隐私)、hooks fail-open 永不阻塞宿主、OpenCode 适配器严格 opt-in(显式 projects/sessions、逐次捕获复查项目归属、V2.2.5 验证版本钉死)、诚实的完整性/冲突标注而非编造轮次或回执。

6. 是否破坏缓存:不涉及——不触碰任何请求路径。

7. 是否改了设计方向:没有。OpenCode 适配器是沿 owner floor 25 通用化要求的新增客户端适配层,仍守「零网络依赖 + 严格 opt-in」边界。

8. 是否引入了新的配置:billion-context 配置面零新增。插件自有 env(RECALL_SOFT/STEP/HARD/HARD_HAIKU/PYTHON/HOME/PROJECTS/CC_VERSION)自包含,README 已写明。

其他发现(非阻塞):① PR 正文范围过时——只描述 Claude Code 插件,全文零次提到新增的 OpenCode 适配器,请更新正文(或收窄范围);② 正文写「26 tests」,实际套件 162 项(README.md:5 与 VALIDATION.md 均已写 162,与本地运行一致);③ opencode/index.js:119 钉死 OpenCode V2.2.5、不匹配即 throw——有意 fail-fast 且有文档,仅提示宿主升级后插件激活会断到插件更新为止;④ mcp_server.py stdin 循环解析无守卫,一行畸形输入会杀掉 MCP 进程(宿主发规范 JSON-RPC,风险低)。

判定:REQUEST_CHANGES(正式 review 已提交,id 5782867946)——唯一阻塞项是 bb373ae4b 按政策收敛到 ci-fixes/#5718;修掉后代码本身可过,合并操作留给人工:#1790

This reverts commit bb373ae.

Address PR ranxianglei#1790 review 5782867946: remove the branch-specific main-header fixture repair before integrating the canonical ci-fixes change from ranxianglei#5718. Preserve the complete Recall contribution and existing commit history.
Merge the canonical 0470bec fix after reverting the duplicate main-header repair, addressing PR ranxianglei#1790 review 5782867946. Keep the Recall subtree byte-identical (8702851), preserve all contribution history, and leave upstream PR merging to maintainers.

Validated the integrated tree: 49 targeted DSH regression tests; 162 Recall tests; 7 OpenCode adapter, 12 guard, 5 native-test-plugin, and 10 structured-checker checks; repository typecheck and build. Full repository verdict remains the remote CI on this new head.
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 Review 车道收工报告(PR #1790,head bb373ae4b):

判定:REQUEST_CHANGES(正式 review id 5782867946,完整八问结论见上一条镜像评论)。

zhou1736948757-cpu and others added 3 commits November 5, 2026 19:44
Keep archive identity and legacy configuration compatible across Claude Code, OpenCode and DSH. Preserve semantic tool names and use a protocol-safe Claude Code MCP namespace.
…rding

Review round-2 spot fixes (strings only, no behavior change):
- README.md: remove pointer to review/CC_GAP_AUDIT.zh-CN.md, which is not
  present anywhere in this branch or master (dead link).
- archive.py append_native(): docstring and three ValueError messages still
  said OpenCode after b352543 generalized the path to opencode+dsh hosts.

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(ai: vllm-qwen/qwen3.8-27b)

第二轮审核(head a676135,顺手修后 8dade69)

第一轮唯一阻塞项已解决

  • bb373ae(六个根级 dsh 测试夹具)已 revert 并合入 origin/ci-fixes:当前 head 的六个测试文件与规范修复 0470bec62(#5718)逐字节一致;PR head 与 origin/ci-fixes 在 contrib/ 之外 diff 为零。master 级继承红不再在 PR 内重复维护。

本轮新增代码(DSH 车道 + 产品改名)通过审核

  • DSH 适配器(dsh/index.mjs、dsh_bridge.py、dsh_read.py):与 OpenCode 车道同一纪律——显式 enabled+projects+sessions opt-in、宿主版本钉 0.2.0-rc.2 不符即抛、SAFE_ENV 隔离、bridge ACK 校验(durable/host/session_id)、degraded 闩锁仅由成功全量快照清除、stderr 丢弃、低信任封套注入。append_native 由硬编码 opencode 泛化为 host 参数,identity 覆写保护保留。
  • 改名(→ billion_context_native):manifest/MCP/hooks/文档全部一致,无旧引用残留(仅 MIGRATION.md 有意保留历史名);env 新名优先 + RECALL_* 回退(含显式空值语义);存储路径不变;CC MCP key 缩短为 native 以避开 64 字符工具名上限。
  • 测试有效性:真断言非恒真——test_rename_compat.py 钉 env 优先级矩阵、旧档案跨前缀切换字节级不变、locator 可读回;test_plugin_identity.py 钉 manifest 一致性 + 64 字符上限 + 真实 MCP spawn。本地全套 187 tests OK(上轮 162);顺手修后定向复跑 37 例 OK。
  • 镜像 CI:a676135c1 上 30/30 绿(顺手修 commit 仅字符串改动,将在 8dade69 重跑)。

非阻塞备注(作者侧,建议合并前处理)

  1. 标题/正文过时:标题仍写 Claude Code only;正文未提 OpenCode/DSH,仍写 "26 tests pass"(实际 187),安装命令仍指向旧路径 contrib/claude-code-native-recall。建议合并前同步,让合并记录与实际内容一致。(按仓库规则我不代改标题/正文。)
  2. 宿主版本硬钉(OpenCode V2.2.5 / DSH 0.2.0-rc.2 不符即抛)——文档已声明为有意的 fail-fast,可接受;知悉宿主升级需插件跟进即可。
  3. mcp_server.py main() 对 stdin 的 json.loads 无保护——单条畸形行会杀掉整个 MCP 进程(宿主发送格式良好的 JSON-RPC,风险低)。属协议层行为选择,不动,仅记录。

已顺手修:README 死链(指向本分支与 master 均不存在的 review/CC_GAP_AUDIT.zh-CN.md)+ append_native 泛化后仍写 OpenCode 的 docstring 与三个错误消息改为 host 中性措辞(纯字符串,无测试依赖)+ commit 8dade69

八问结论

  1. 是什么:外部贡献者在 contrib/ 下新增 opt-in 本地原文归档召回插件(CC/OpenCode/DSH 三车道),不改 bili 主仓任何行为。
  2. 原因:功能类,无缺陷;第一轮阻塞项是继承性 master 红(#5687 sidecar gate)被重复修复,现已收敛到 ci-fixes 规范修复。
  3. 影响范围与严重程度:既有用户零影响(各车道默认关闭、须显式 opt-in);bili 本体零影响(纯新增 contrib/ 目录 + 六个与 ci-fixes 一致的测试文件)。
  4. 怎么修复的:本轮验证 DSH 车道与改名完整性;两处小字符串问题当场修掉。
  5. 回归:未发现——六个测试文件与 ci-fixes 逐字节一致、contrib/ 外零 diff、kernel/版本号/配置面/wire 均未触碰;本地 187 OK + CI 30/30 绿。
  6. 缓存破坏:不涉及(插件不触碰 bili 缓存/持久化,自有档案为独立 events.jsonl)。
  7. 设计方向:不变;通用化方向符合 owner 指示,核心取舍仍在 #4857/#4858 待决策。
  8. 新配置:仅插件自身 env(BILLION_CONTEXT_NATIVE_* + RECALL_* 兼容回退),文档齐全,不进入 bili 配置面。

判定:APPROVE —— 审核侧无阻塞;合并由你决定。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 第二轮审核完成(head a676135 → 顺手修后 8dade69),判定 APPROVE,review 已提交(#pullrequestreview-5784784510)。

  • 第一轮阻塞项已解决:bb373ae4b(六个根级 dsh 测试夹具)已 revert 并合入 ci-fixes;当前 head 六个测试文件与规范修复 0470bec62([PR] test(ci): converge master red — realign five dsh pins to the #5656 single-shot sidecar residual (#4599) #5718)逐字节一致,contrib/ 之外 diff 为零。
  • 本轮新增代码通过:DSH 适配器(显式 opt-in、宿主版本钉 0.2.0-rc.2 fail-fast、SAFE_ENV 隔离、ACK 校验、degraded 闩锁、低信任封套)与产品改名(manifest/MCP/hooks/文档全一致、env 新名优先 + RECALL_* 回退、存储路径不变)均达标。
  • 测试有效性:真断言非恒真——改名兼容钉 env 优先级矩阵 + 旧档案字节级不变 + locator 可读回;身份测试钉 manifest 一致性 + 64 字符工具名上限 + 真实 MCP spawn。本地全套 187 tests OK(上轮 162),镜像 CI 30/30 绿。
  • 已顺手修:README 死链(指向不存在的 review/CC_GAP_AUDIT.zh-CN.md)+ append_native 泛化后仍写 "OpenCode" 的 docstring 与三个错误消息改为 host 中性措辞(纯字符串,无行为变化)→ commit 8dade6995 已推回 PR 分支。
  • 留给作者的非阻塞项:标题/正文过时(仍写 Claude Code only、"26 tests"、旧安装路径),建议合并前同步;宿主版本硬钉为文档声明的有意 fail-fast;mcp_server.py stdin 解析无保护(低风险,仅记录)。

回归面:kernel/版本号/bili 配置面/wire 均未触碰,未发现回归。合并权在 owner。

@zhou1736948757-cpu zhou1736948757-cpu changed the title [PR] feat(contrib): Claude Code native recall plugin — acp-kernel compression via hooks + MCP, no base-URL change [PR] feat(contrib): billion_context_native Nov 5, 2026

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(ai: vllm-qwen/qwen3.8-27b)

第三轮审核(head 8dade69)——确认轮,无新代码

当前 head 即第二轮我审毕后推回的顺手修 commit(纯字符串:README 死链 + append_native host 中性措辞),此后作者无新提交。本轮复核:

  • ci-fixes 对齐仍成立:六个 dsh 测试文件与 0470bec62 逐字节一致;contrib/ 之外 diff 为零;ci-fixes tip 未变。
  • 作者已处理第二轮备注:标题更新为 billion_context_native,正文补齐 OpenCode/DSH 范围、187 tests、新安装路径——上一轮非阻塞项全部关闭。
  • 镜像 CI:本 head 上 29/30 绿,仅 windows(node22, shard3) 一个标准套件分片仍在跑;顺手修只动 contrib/ 内字符串(不在 bili 测试路径内),不影响该分片结果。
  • 无 kernel/ 触碰、无 kernel-change 声明、版本号未动、配置面未动。

第二轮的完整八问结论与代码评估(review id 5784784510)继续有效。

判定:APPROVE —— 维持,可合并(合并权在 owner)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 第三轮审核完成(head 8dade69),判定维持 APPROVE(review id 5786446315)。

本轮为确认轮——head 即第二轮我审毕后推回的顺手修 commit(纯字符串改动),作者此后无新提交。复核结果:

  • ci-fixes 对齐仍成立:六个 dsh 测试文件与规范修复 0470bec62 逐字节一致,ci-fixes tip 未变,contrib/ 之外 diff 为零。
  • 第二轮备注已关闭:作者更新了标题(billion_context_native)并补齐正文的 OpenCode/DSH 范围、187 tests、新安装路径。
  • CI:镜像缓存显示本 head 上 29/30 绿,仅一个 windows 标准套件分片在跑(顺手修只动 contrib/ 内字符串,不在 bili 测试路径内)。
  • 无 kernel/ 触碰、无 kernel-change 声明、版本号与配置面未动。

第二轮完整八问结论(review id 5784784510)继续有效。可合并(合并权在 owner)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

CI 自动修复车道 attempt 1/3 收工:两条红分片均为负载型 flake(非本 PR 引入),rerun 后全矩阵转绿,分支零代码改动。

处置链:逐一取证两条失败 job → 判定 flake(证据见第 3 问)→ 对两个失败 job 发 rerun(HTTP 201)→ run 42025471606 终态 conclusion=success,30/30 check 全绿。head 保持 8dade6995,未推任何 commit——没有可修的代码缺陷,推空提交只会污染 diff。

八问:

  1. 是什么问题:CI 两条 test 分片红——test (ubuntu-latest, 24, 2) 与 test (windows-latest, 22, 3),各挂一个与本 PR 无关的既有测试文件,其余 ~28 条 check 全绿。
  2. 什么原因导致的:两个都是时序竞态在 CI 高负载下的翻转,不是代码缺陷。① ubuntu 侧 tests/msgid-lane-flow.test.ts:139(3 !== 4,「an edit lands as a FRESH row」)= CI Control Center: Centralized CI Failure Handling & Status Sync (Comment all CI issues here; do not open new issues) | CI 总控: CI 失败集中处理与状态同步(所有 CI 问题在此评论, 勿开新 issue) #4599 在册的 settle-race flake 家族(今日多个 PR 同签名,重跑即绿);② windows 侧 tests/external-summary.test.ts:216(expected 'success' actual 'failed')= 显式计时用例(Atomics.wait 主线程阻塞 20ms vs targetTimeoutMs: 5ms),Windows runner 负载下超时判定翻转;该签名首见于本家族,已在 CI Control Center: Centralized CI Failure Handling & Status Sync (Comment all CI issues here; do not open new issues) | CI 总控: CI 失败集中处理与状态同步(所有 CI 问题在此评论, 勿开新 issue) #4599 报备供哨兵跟踪。
  3. 影响范围与严重程度:仅本 PR 检查矩阵的信号级问题,无用户侧影响。flake 判定四重证据:两测试文件均不在 PR diff 内(PR 只新增 contrib/** + 六处 dsh 回归钉对齐,零 src/ 改动);被测代码与 master 逐字节相同且 master 常绿;同一 run 里执行同文件的其余 shard 全绿;本地在 PR head 树上定向复跑各 3/3 全绿(msgid-lane-flow 6 子测 ×3、external-summary 18 子测 ×3)。
  4. 怎么修复的:不改代码,按今日多车道先例(CI Control Center: Centralized CI Failure Handling & Status Sync (Comment all CI issues here; do not open new issues) | CI 总控: CI 失败集中处理与状态同步(所有 CI 问题在此评论, 勿开新 issue) #4599 floor 979/981/985)直接 rerun 失败 job;ubuntu job 转绿、run 落定后再触发 windows job(GitHub 限制 run 进行中不能二次发起 rerun)。
  5. 是否有回归问题:不涉及——本轮零代码改动,无任何行为面变化。
  6. 是否破坏缓存:不涉及。
  7. 是否改了设计方向:没有。
  8. 是否引入了新的配置:没有。

结论:CI 面已全绿(run 42025471606 success @ 8dade69),无遗留动作;合入判定以 review 车道为准(review-worker 已于本 head 给出 APPROVE)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[ework] CI fix verified green ✓

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

CI 自动修复车道 attempt 1/3 收工:唯一红分片为在册 flake(非本 PR 引入),rerun 后全矩阵转绿,分支零代码改动。

处置链:拉取失败 job 日志取证 → 判定为 #4599 在册的 settle-race flake 家族 → 本地在新 head 上定向复跑验证 → rerun 失败 job(HTTP 201)→ run 42263654719 终态 conclusion=success,30/30 check 全绿。head 保持 eb6f52373,未推任何 commit——没有可修的代码缺陷。

八问:

  1. 是什么问题:CI 唯一红条 test (ubuntu-latest, 24, 1),挂的是既有测试 tests/msgid-lane-flow.test.ts 的一个子用例,其余 29 条 check(含全部静态门禁、kernel-guard、其余 10 个 test 分片)全绿。
  2. 什么原因导致的:负载型时序竞态,不是代码缺陷。失败签名与 CI Control Center: Centralized CI Failure Handling & Status Sync (Comment all CI issues here; do not open new issues) | CI 总控: CI 失败集中处理与状态同步(所有 CI 问题在此评论, 勿开新 issue) #4599 在册的 settle-race flake 家族逐字一致(msgid-lane-flow.test.ts:139:16,an edit lands as a FRESH row,3 !== 4,expected 4 / actual 3)——同一签名近期已在多个 PR 复现且重跑即绿,本 PR 上一 head(8dade69)也命中过同一家族。
  3. 影响范围与严重程度:仅本 PR 检查矩阵的信号级问题,无用户侧影响。判定依据:本 PR 对当前 master 的增量是纯 contrib/billion_context_native/**(已 merge 最新 master),失败测试文件及其依赖的 src//kernel/ 与常绿 master 逐字节相同;本地在 head eb6f523 树上定向复跑 3/3 全绿(6 子测 ×3)。
  4. 怎么修复的:不改代码,按既有先例直接 rerun 失败 job;ubuntu shard 重跑约 7 分钟完成,run-ci-tests.mjs success。
  5. 是否有回归问题:不涉及——本轮零代码改动,无任何行为面变化。(本 PR 自身引入的 master merge 与 contrib 变更由 review 车道负责审,不在 CI 车道职责内。)
  6. 是否破坏缓存:不涉及。
  7. 是否改了设计方向:没有。
  8. 是否引入了新的配置:没有。

结论:CI 面已全绿(run 42263654719 success @ eb6f523),无遗留动作。

@ranxianglei ranxianglei left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(ai: vllm-qwen/qwen3.8-27b)

APPROVE — head a3fa4eeab(master 合并 + 4 个 contrib 提交)。代码本体干净;唯一保留意见是 CI 观测面(见下),不影响代码判定。

审核独立性说明

本轮独立重读:四-dot 范围核对、四个新提交逐段精读(store.py/mcp_server.py/hooks.json/docs/tests)、本地全套回归。未复用前轮结论。

① 方向关

owner floor 25 拍板「可合并 + 通用化」;通用化已立项 #4857/#4858(独立决策线,不阻塞本 PR)。本轮四个提交全部在该方案内收敛,无方向漂移。第一轮阻塞项(bb373ae4b 六个根级测试)保持已解决状态:与 ci-fixes 0470bec62(#5718)逐字节一致,ci-fixes tip 未变。

② 回归审查(既有行为清点)

  • PR 对 master 的净贡献 = 仅 contrib/billion_context_native/:git diff --name-only origin/master...a3fa4eeab 在 contrib/ 之外为零文件。kernel/、src/、tests/、package*.json、AGENTS.md 的全部变化都是 453ce1c 合入 master c3dfbe6b2 带来的(#5758/#5719/#5540 等),非本 PR 内容。PR 自身未触碰 kernel/(四个作者提交逐一核对无 kernel/ 路径),正文也无 kernel-change 声明——硬规则不触发。
  • 行为变更披露(旧值→新值):规则 ID 方案变更——旧:顺序 ruleN(回放按位置推导);新:live 调用铸造 rule<十进制UUID>(bfe2d37f0,mcp_server.py rule_id=f'rule{uuid.uuid4().int}'),回放以成功确认文本中的 ID 为准(ack-based,store.py replay_rules 重写)。原因:并行调用基于滞后视图可同时成功,位置推导会错绑归属;UUID 使每个确认唯一可绑定。旧 ruleN 由 ack 回放保持兼容,删除后不复用(kernel id-never-reused 语义保持)。README + VALIDATION『Update review』均已披露,含「删除时原样使用返回值,不要推算编号」的使用指引。判定:有意变更、已披露、语义更诚实,非回归。
  • 冲突挂起语义(a3fa4eeab):历史中不同调用确认同一 ID → 规则整体挂起 + rule_conflict 提示,仅「唯一完成且明确成功」的 clear 可解除(RULE_RESET_ACK 精确匹配或精确 legacy Cleared N rules.),旧 ID 保持占用,归档原文不删不改。宁可挂起不可猜归属——与插件既有低信任纪律一致。status() 在冲突时仍返回其余指标(不再整调用报错)。
  • hooks.json 引号修复(bbc0571a7):全部 14 条命令 P=...; "$P" ...——含空格解释器路径(Windows 常见)此前会断词,纯 shell 健壮性修复,无行为面扩大(不引入新 env 别名,文档已声明)。
  • _live 先 sync events.jsonl(mcp_server.py):读 transcript 前先拉 hook 观察事实,规则/状态读取更完整;sync 失败走既有 deferred 语义。
  • 高危模式逐项过:fail-fast 变吞错——无(冲突是显式报错不是静默);阈值漂移——无(SOFT/STEP/HARD 等常量未动);输出格式——规则 ID 格式已披露;缓存/游标——事件账本 seq/offset 机制未动。

③ 代码审查

ack-based 回放逻辑逐行读过:ack 解析 Recorded \[(rule[1-9]\d*)\] (.+) 与 apply_rule 返回格式匹配(含 UUID 大整数与 DOTALL 多行文本);回显文本比对用 strip 后输入(与服务端 .strip() 一致,无误报);rejected/failed 结果不计入变更;无 ack 的 legacy 调用走位置回退但跳过已占用编号(while 循环保 id 不复用);current_rule_state 三级来源(归档有规则调用→归档;否则 transcript;否则 rules.json 存档,含冲突态保存恢复)。质量达标:命名达意、错误带上下文、无死代码、注释讲为什么。

④ 测试有效性

test_rule_ids.py 17 个用例是真断言且钉住回归:并行双成功确认保留两条、同 ID 冲突不猜归属、拒绝结果不重放、legacy 删除后编号空洞跳过、归档冲突跨源压缩存活、late restore 不重注入过期投影、清除需唯一正证据……每个都对应一类真实失败模式,bug 复发时抓得住。hook 引号回归用含空格路径 + 无回退解释器的合成环境钉住全部 14 条命令。

本地验证

python3 -X utf8 -m unittest discover -s tests(a3fa4eeab)→ Ran 205 tests, OK(~94s),与作者 VALIDATION 声称的 205(含 17 项规则身份/恢复)一致。

CI 观测(如实报告)

镜像缓存(本 head a3fa4ee):18/30 绿;11 个核心 test 分片 + red-signal 为 completed/cancelled,未见替代运行。分支 tip 未移动过(排除被新推送取代)。因本 PR 在 contrib/ 之外零贡献,bili 根套件内容与 master c3dfbe6 字节一致(其 CI 已绿),cancelled 分片不构成新的未验证面;但取消本身值得哨兵看一眼——已在 #4599 留一行。建议合并前如分片仍未补齐,重跑一次套件即可。

结构化八问

  1. 是什么问题:continuation PR——通用化 native recall 插件的第四轮更新(master 合并 + 规则身份修复 + Windows 验证 + hook 引号)。
  2. 什么原因导致的(各提交):规则 ID 位置推导在并行滞后视图下会错绑归属(根本缺陷);含空格解释器路径断词;旧重复 ID 历史无恢复通道。
  3. 影响范围与严重程度:仅插件用户;规则冲突挂起只影响已有损坏历史的会话(显式提示 + clear 出口);ID 方案变更对所有新增规则可见但已披露且有兼容层。体验级,无数据丢失(归档原文永不改写)。
  4. 怎么修复的:身份从「位置推导」改为「确认绑定」(ack 即身份,位置仅作 legacy 回退且避让已占用 ID);冲突显式化 + 受控重置;shell 引号。
  5. 是否有回归问题:无。kernel/bili 配置面/wire 未触碰;ci-fixes 对齐保持;id-never-reused 语义在新旧两路都保住。
  6. 是否破坏缓存:不涉及(事件账本 offset/digest 机制未动)。
  7. 是否改了设计方向:否——在 owner 批准的通用化方案内收敛;核心通用化待 #4857/#4858 决策。
  8. 是否引入新配置:否(无新 env/config;RECALL_PYTHON 沿用)。

判定:可合(合并权在 owner)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 第四轮审核完成(head a3fa4ee = master 合并 + 4 个 contrib 提交),判定 APPROVE,review 已提交(#pullrequestreview-5804985870)。

  • 范围核对:PR 对 master 的净贡献仍仅 contrib/billion_context_native/——kernel/、src/、tests/、版本文件的全部变化都是合入 master c3dfbe6b2 带来的,四个作者提交均未触碰 kernel/,正文无 kernel-change 声明;ci-fixes 六文件对齐保持(tip 0470bec 未变)。
  • 本轮新增代码通过:规则身份从「位置推导」改为「确认绑定」(ack-based replay:以成功确认文本中的 ID 为准,并行滞后视图不再错绑归属;旧 ruleN 兼容、删除不复用)+ 损坏历史的显式冲突挂起与受控 clear 恢复 + hooks.json 全部 14 条命令的解释器路径引号修复(含空格路径)。行为变更(新规则 ID 从顺序 ruleN 变为 rule<十进制UUID>)已在 README/VALIDATION 披露。
  • 测试有效性:test_rule_ids.py 17 个用例是真断言且逐类钉住失败模式(并行双确认、同 ID 冲突不猜归属、拒绝结果不重放、归档冲突跨压缩存活等);本地全套 205 tests OK,与作者声称一致。
  • 已顺手修:本轮未发现需要顺手修的机械问题。
  • CI 保留意见(不影响代码判定):镜像显示 18/30 绿,11 个核心 test 分片 + red-signal 为 cancelled 且无替代运行(分支 tip 未移动,非被新推送取代);因根级内容与 master 字节一致不构成新的未验证面,已在 CI Control Center: Centralized CI Failure Handling & Status Sync (Comment all CI issues here; do not open new issues) | CI 总控: CI 失败集中处理与状态同步(所有 CI 问题在此评论, 勿开新 issue) #4599 留一行请哨兵确认取消原因,建议合并前如仍未补齐则重跑一次套件。

回归面:kernel/bili 配置面/wire 均未触碰,未发现回归。合并权在 owner。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants