Skip to content

kernel: 推荐筛选不再无声吞掉投影异常(留一行诊断),并给全量投影热路径钉规模测试 #3406 第 9/11 项 - #3418

Merged
ranxianglei merged 2 commits into
masterfrom
fix/kernel-observability
Oct 17, 2026
Merged

ranxianglei merged 2 commits into
masterfrom
fix/kernel-observability

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

ai: zhipuai-lb/glm-5.3

kernel-change: screenRecommendedUnits 吞错加可观测性(行为不变)—— 推荐筛选里的 catch 把编程错误无声吞成「单元被筛掉」,排查极难;按 Kernel Boundary 流程(声明 + 版本 bump + 双层测试)在本 PR 内修。

Fixes #3406 第 9/11 项

修了什么(人话版)

第 9 项 —— 吞错的 catch 加上痕迹,行为一字不变

第 11 项 —— 给 O(n·m) 热路径钉一张规模底片,只加测试不做优化

  • 新增 kernel/tests/issue3406-screen-scale.test.ts:n=2000 消息(10 消息一轮的用户/推理/工具调用/工具结果混合形态,40 个活跃 tier-1 块盖住前 800 条,覆盖「已覆盖」与「全新」两条投影路径),m=10/40/120 单元梯度 + 真实链路(buildCompressibleRanges → mergeRangesToThreshold → screenRecommendedUnits)。
  • 每档取 3 次测量的最小值(噪声只会增加耗时),断言在宽松上限内:小档 750ms、大档/真实链路 1000ms —— 约为记录基线(本机热态:m=10 ≈7.5ms、m=40 ≈24ms、m=120 ≈63ms、真实链路 ≈54ms)的 10 倍以上,再垫绝对下限,慢 CI 机器也不会 flake;真正的数量级退化(比如多一层全数组扫描)在任何机器上都拦得住。
  • 每次运行把当前耗时打进测试输出留档(#3406 scale record: ...)。
  • 优化本身按 issue 约定另立项,本 PR 不做。

测试

  • 第 9 项回归:kernel/tests/issue3406-screen-observability.test.ts —— 4 例:非法 ref(非 BoundaryNotFound 类)触发恰好一条 warn 且单元仍被筛掉;未知端点/已消费端点保持静默;健康单元照常通过且无输出。
  • npm --prefix kernel test:1285 pass / 0 fail(含新增 6 例)。
  • 根仓库(worktree 内)npm run typecheck:0 错误。
  • 根仓库定向测试(recommend/compress/nudge 相关 7 个文件,47 例)+ tests/wire-contract.test.ts(golden ledger,20 例)全绿。
  • npm --prefix kernel run build 成功。
  • kernel 0.0.127 → 0.0.128(src 变更,版本纪律);kernel/package-lock.json 与根 package-lock.json 已同步再生(kernel: 已消费但非重折叠的压缩单元不再被推荐——推荐端与执行端对同一形状意见一致 #3381 的 lock-sync 教训)。

不在范围

  • golden ledger(tests/golden/wire-contract/kernel.json)未动——本 PR 不改任何被钉住的行为面(defaultConfig/prompts/工具表/wire markers)。
  • state.stats 计数通道、screenRecommendedUnits 签名/返回值:未动。

…3406 第 11 项)

第 9 项:screenRecommendedUnits 的 catch 把所有投影异常吞成静默
return false——单元被筛掉无任何痕迹。现在 BoundaryNotFoundError
(死的/已消费端点,#3371 的正常 false)保持静默,其余异常(编程错误)
先 console.warn 一行带单元端点与错误摘要再 return false。行为不变,
只加可观测性(与 processTurn 的 config 校验 warn 同通道)。

第 11 项:新增 kernel/tests/issue3406-screen-scale.test.ts——n=2000
消息、m=10/40/120 单元梯度 + 真实 recommend 链路全量投影,断言耗时
在宽松上限内(基线约 10 倍 + 绝对下限,防 CI flake),当前耗时打印进
测试输出留档。不做任何优化。

kernel 0.0.127 → 0.0.128(内核 src 变更,CI 版本纪律)。
@github-actions

github-actions Bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: fix/kernel-observability (2b69489)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.4085-pr.3418.c5663e8

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Option B — Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr3418.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

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

查重: 不重复。 检索 open+closed issue/PR 均无同类改动(screenRecommendedUnits 吞错可观测性 / #3406 第 9·11 项);本 PR 自身即 #3406 第 9/11 项的实现,无并列重复工作。

审核要点(CI 判不了的部分)

① 原 issue 方向 — 成立。 根因抓得准:catch 无差别 return false,把「预期的端点不可解析」和「意外的编程错误」混为一谈。修法是分流错误类型(疏,不是堵)——没去改写 payload 掩盖症状,是在决策点补一条诊断。第 11 项只钉规模曲线不做优化,严格守在 issue 约定范围内。

② 回归审查 — 无回归。 逐个既有行为过了一遍:

  • 判定不变:两分支都 return false;健康单元照常通过、死/已消费端点照常静默筛掉(观测测试把这两半都钉死了)。
  • 无新增抛错路径:console.warn 对字符串参数不抛;err instanceof Error ? err.message : String(err) 兜住非 Error throw;unit.startRef/endRef 在 CompressibleRange 上恒有值。
  • 无循环依赖(我专门查了):boundaries.ts 只 import state/prune/ccr/refs/types,不回指 recommend.ts;新增的直接 import 安全。
  • 调用方 compress.ts / report.ts 行为不变。
  • 高危模式逐项:语义漂移(无)/ fail-fast 变吞错(反而更透明)/ 阈值·时序·输出格式漂移(无,仅在原本静默的非预期路径多一行 stderr 日志)。

③ 代码审查 — 正确且克制。 instanceof BoundaryNotFoundError 这道闸精确隔离了唯一预期抛错类:我核对了 boundaries.ts——不可解析 ref 走普通 Error(:88-92),unknown/consumed 走 BoundaryNotFoundError(:185/220/226/235/259/265);而 projectUnit 的 zone/split fatal 是返回结构化值(catch 之后由 projection.fatal !== null 处理),根本不进这条 catch。所以非 BNFE 分支确实只会被真正的编程错误触发,健康运行下不会刷屏。未动 state.stats 的理由(筛选路径被只读消费方调用,避免持久化副作用)成立。

④ 测试有效性 — 真测试,断言有牙。

  • 观测测试 4 例同时钉住「判定」和「诊断」两半:非预期异常恰好 1 条 warn(含端点+错误摘要)且单元仍被筛掉;未知/已消费端点保持静默;健康路径通过且无输出。删掉 warn 或改动判定都会让它变红,不是恒真断言。
  • 规模测试有个关键的反空洞守卫:assert.equal(out.length, m) 保证计时只在单元真的跑完全量投影(kept===m)时才有意义,堵住了「提前丢弃→假快」这种假通过;min-of-3 + ~10× 宽松上限 + 绝对下限,防 flake 的同时仍能拦住数量级退化;每次打印实测耗时留档。设计到位。

⑤ diff 整洁度 / ⑤b 代码整洁 — 干净。 6 文件全是本 PR 目的相关(recommend.ts 一处 catch + 两个新测试 + 版本号 + 两处 lock 同步再生),无跑题/空行重排。命名达意、注释讲为什么(且与代码事实一致)、风格跟仓库既有、无死代码、无新依赖。外部提交从严清单全项通过。

一个相邻观察(非本 PR 引入,非阻塞): report.ts:444/:453 的 acp_status 视图 flagFor 对 projectUnit 异常也是裸 catch,统一归因成 ⚠ not foldable: refs unresolvable。但它产出的是用户可见的 ⚠ flag(不是无声消失),所以没有第 9 项那个核心痛点;只是编程错误会被误标成「ref 不可解析」。它与本 PR 属同一机制族(投影错误处理),按同症状/同机制归并原则——若要精确化,建议并入 #3406 清单跟踪,不单开 issue,也不塞进本 PR(scope 纪律)。留给你定夺。

结构化八问

  1. 是什么问题:推荐筛选的 catch 把 projectUnit 抛出的所有异常无声吞成「单元被筛掉」,编程错误也会让单元从推荐里凭空消失且无任何痕迹,排查极难;另缺一条 O(n·m) 热路径的规模底片。
  2. 什么原因导致的:catch 无差别 return false,未按错误类型区分「预期端点不可解析」与「意外编程错误」。
  3. 影响范围与严重程度:触发面极窄——仅当 projectUnit 抛非 BoundaryNotFoundError 异常时多打一行 stderr 诊断(健康运行不发生)。纯可观测性增强,无功能/判定/用户可见输出变化,严重度低。
  4. 怎么修复的:catch 内分流错误类型——BoundaryNotFoundError(唯一预期抛错类)保持静默 false;其余异常补一条带单元端点+错误摘要的 [acp-kernel] warn 后再 false。通道沿用 kernel 唯一既有先例(compress.ts processTurn config 校验的 console.warn、同前缀),不动 state.stats。
  5. 是否有回归问题:无。判定不变、无新增抛错路径、无循环依赖、调用方不变;高危模式(语义漂移/fail-fast 变吞错/阈值·时序·输出格式)逐项过均无。
  6. 是否破坏缓存:不涉及(纯诊断日志,不碰 prefix cache/重试/增量游标/去重键)。
  7. 是否改了设计方向:不涉及。仍在 kernel 内守零宿主依赖契约(console.warn 而非宿主 logger 正是为此);golden ledger 未动。
  8. 是否引入了新的配置:不涉及(无新 env/config/默认值)。

合并判定

技术面无阻塞:CI 全绿(ubuntu/windows × node 22/24 全部 test shard + 独立 npm --prefix kernel test,以及 kernel-guard / version-guard / lock-sync / static-gates / config-surface-guard 等门禁皆 success),版本纪律(kernel 0.0.127→0.0.128)与 lock 同步合规,双层测试齐备。

但这是 kernel/** 变更,按 Kernel Boundary rule 3 恒为 human-only、不可 auto-merge——请 owner 人工合入。 PR 当前 mergeable_state: behind(无冲突),合前建议 rebase 到最新 master 作卫生。

(本地未重复跑全量——权威全量判定以已绿的远程 CI 为准;以上为逐文件通读的定向核查结论。)

@ranxianglei
ranxianglei merged commit c1c4be0 into master Oct 17, 2026
22 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.503-master.c1c4be0 (rolling master tag).

npm install -g billion-context@0.0.503-master.c1c4be0  # this exact build
npm install -g billion-context@master  # always the newest merged build

npm view billion-context@master prints the current version at any time.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

区间审查(#3331)残留 11 项中小问题集中修:守卫旋钮、存储竞态、静默丢参、CI 触发残角等

1 participant