Skip to content

feat: 分层压缩触发阈值 compress.tierNudgeTokens(T1/T2/T3 独立设置) - #2378

Merged
ranxianglei merged 9 commits into
masterfrom
2026-10-08_tier-nudge-thresholds
Oct 8, 2026
Merged

ranxianglei merged 9 commits into
masterfrom
2026-10-08_tier-nudge-thresholds

Conversation

@ranxianglei

@ranxianglei ranxianglei commented Oct 8, 2026 •

Copy link
Copy Markdown
Owner

Closes #2376

kernel-change: decideNudge 的三层 token-mass 触发仲裁在 kernel 内,host 无法在不加 kernel 旋钮的情况下表达「每层独立阈值」——新增可选 nudge.tierGrowthTokens.{t1,t2,t3},未设置时回退到既有派生默认值(T1=增长步长,T2/T3=×multiplier),行为与日志逐字节不变。

What

Issue #2376:T1/T2/T3 nudge 目前共用一个统一数值,T1 升 T2 后长任务仍可能不够用。本 PR 让三层各自可单独钉住触发阈值:

  • kernel (nudge.tierGrowthTokens.{t1,t2,t3}, acp-kernel 0.0.105 → 0.0.106):decideNudge 里每层 token-mass 判定先取该层覆盖值、再回退派生默认;validateConfig 拒绝非正数/非有限值。
  • host (compress.tierNudgeTokens):parseCompressSettings 解析校验(非法值整块拒绝)、三级层级按子字段合并、applyCompressSettings 映射到 kernel config。
  • web:快速设置区新增 T1/T2/T3 三个输入框(按 owner 反馈改为预填当前派生默认值、±5000 步进按钮、仅把改动项写入配置、清空自愈回派生值),zh/en 文案齐全;PUT /__bili/config 复用 parseCompressSettings 自动支持。
  • docs:CONFIGURATION.md / .zh-CN.md 新增 tierNudgeTokens 条目;kernel README 同步。

config surface

新增配置键 compress.tierNudgeTokens:object { t1?: number, t2?: number, t3?: number },每个值 ≥1 token。为什么现有面表达不了:nudgeGrowthTokens 拍平的是单一增长步长,三层阈值都从它派生(T2/T3 = ×1.5),无法只调其中一层。已考虑的方案:providers 表(按 provider 而非按层切分,不适用)、三级 compress 层级(直接沿用——本键就走 global→provider→model 三级,且是子字段级合并)。兼容:不设置或空对象 = 与旧参数完全一致(无迁移);未加新 env var(#2030 纪律,纯 config-file key)。

Behavior change disclosure

新增 opt-in 旋钮,默认路径零变化:三层均未设置时,触发条件、reason 日志字符串、诊断 breakdown 全部逐字节一致(wire-contract golden pin 15/15 通过证明 defaultConfig 输出不变;既有 arbitration 测试未改动且全绿)。计数触发(tier2Trigger/tier3Trigger)、节奏 floor、first-sight bypass、压力路由均不受影响。

Verification

  • kernel suite: 1260/1260 pass(含 4 个新测试:降 t2 提前触发 T2、抬 t1 抑制 T1、单层钉住其余层保持派生、validateConfig 拒绝非法值)
  • bili targeted: compress-settings + web-routing 53/53(含 4 个新 host 测试)、wire-contract 15/15(golden 未变)
  • typecheck clean、build OK
  • kernel/package.json 0.0.105 → 0.0.106(CI version discipline);package-lock.json 仅 acp-kernel file-dep 版本行同步

披露补充(review 2026-10-08)

  1. 上文「逐字节一致」需一处更正:三层均未设置时,触发条件与 reason 日志确实逐字节一致(触发语义零变化),但诊断 breakdown(ready/blocked 列表)里 T2/T3 的比较基准由统一 nudgeGrowthTokens 改为各层自身阈值(默认 ×1.5)——当 T2/T3 pending mass 落在 [X, 1.5×X) 区间时诊断行措辞会变化(旧代码把该区间标为 mass-ready,实际触发阈值是 1.5×X;新代码不再误标)。这是诊断精度修正(与既有代码注释「old fixed string lied」的意图一致),不影响任何注入决策;golden pin 覆盖的是 defaultConfig 输出而非运行时日志,故 15/15 通过不涵盖此项。
  2. 分支同步 master 后(merge commit a5bedc6),master 侧 分析缓存泄露问题又一个日志 #2302 已占用 acp-kernel 0.0.106,本 PR 的版本增量被吸收——kernel-guard 版本纪律会失败。已补 commit 将 kernel/package.json 重新 bump 到 0.0.107,package-lock.json 与四处「acp-kernel >= 0.0.10x」文档/注释引用同步更新。

awork added 2 commits October 8, 2026 09:40
Each tier's token-mass trigger in decideNudge now resolves from an
optional nudge.tierGrowthTokens.{t1,t2,t3} before falling back to the
derived defaults (T1 = growth step, T2/T3 = multiplier x growth step),
so long-task sessions can pin T1/T2/T3 independently (#2376). Count
triggers, cadence floor, first-sight bypass and pressure routing are
untouched; unset values keep byte-identical behavior including log
strings. validateConfig rejects non-positive/non-finite values.
Host-side surface for the kernel's nudge.tierGrowthTokens: config key
compress.tierNudgeTokens {t1?,t2?,t3?} parsed/validated by
parseCompressSettings, merged sub-field-wise across the three-level
hierarchy, mapped onto the kernel config by applyCompressSettings, and
exposed as three inputs in the web quick settings (blank = derived
default). Absent or empty object preserves legacy behavior exactly.
CONFIGURATION en+zh documented.
@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-08_tier-nudge-thresholds (c9be406)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.2615-pr.2378.f646400

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-pr2378.tgz
npm install -g package

Install instructions are refreshed on each push.

Merging master into this branch absorbed #2302's own 0.0.106 bump, which
erased this PR's kernel version diff against origin/master — the kernel-guard
version-discipline job (SRC_CHANGED without BUMPED) would fail. Re-bump to
0.0.107 so the tierGrowthTokens change keeps its own version increment, and
sync the acp-kernel >= 0.0.10x doc/comment references.
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 Review 结论(结构化七问)

1. 是什么问题:功能需求(#2376)——T1/T2/T3 三层压缩提醒的 token-mass 触发阈值共用一套派生值(T1=增长步长、T2/T3=×1.5),长任务想单独调某一层时表达不了;本 PR 让三层各自可钉住独立阈值(配置 + web 快速设置)。

2. 什么原因导致的:非缺陷,是能力缺口——decideNudge 的阈值派生硬编码在 kernel 内,host 侧没有任何旋钮能表达「每层独立阈值」,不加 kernel 字段无解(kernel-change: 声明成立)。

3. 怎么修复的:机制层——kernel 新增可选 nudge.tierGrowthTokens.{t1,t2,t3},每层判定「先取覆盖值、未设回退派生默认」,validateConfig 拒绝非正/非有限值;host compress.tierNudgeTokens 走既有三级层级、子字段级合并(与 absorb 同类模式)、解析校验非法整块拒绝、映射到 kernel config;web 快速设置区三个输入框(留空=跟随派生默认);CONFIGURATION.md zh/en + kernel README 同步。

4. 是否有回归问题:逐项审过既有行为——计数触发(tier2Trigger/tier3Trigger)、节奏 floor、first-sight 质量旁路、压力/紧急路由全部不受影响;wire-contract golden 15/15 未变证明 defaultConfig 输出逐字节不变;既有 arbitration 测试未改动且全绿。一处披露更正:诊断 breakdown(ready/blocked 列表)里 T2/T3 的比较基准由统一 X 改为各层自身阈值(默认 1.5X)——三层均未设置且 T2/T3 pending mass 落在 [X, 1.5×X) 区间时,诊断行措辞会变化(旧代码把该区间误标为 mass-ready,实际触发线是 1.5X;新代码不再误标)。不影响任何注入决策,属诊断精度修正,但原描述「诊断 breakdown 全部逐字节一致」说过头了,已在 PR body 追加披露补充。kernel 部分按 Kernel Boundary 需人工 review(不可 auto-merge)。

5. 是否破坏缓存:不涉及——只影响 nudge 注入时机;未设置时判定结果与旧逻辑完全一致,前缀缓存/重试/增量游标策略均不受影响。

6. 是否改了设计方向:没有。沿既有三级 compress 层级与子字段合并模式扩展,无架构转向。

7. 是否引入了新的配置:是——compress.tierNudgeTokens {t1?, t2?, t3?},每个值 ≥1 token;不设置/空对象 = 与老参数完全兼容,无迁移;未加新 env var(#2030 纪律)。


review 期间发现并处理的问题:

  • 阻塞项(已修):作者会话 01:42Z 已把 master 合入分支(a5bedc6d1),但 master 侧 分析缓存泄露问题又一个日志 #2302 已占用 acp-kernel 0.0.106——本 PR 的版本增量被吸收,相对 origin/master 变成「kernel/src 有变更但版本行无 diff」,CI kernel-guard 版本纪律必红(本地按 ci.yml 原命令模拟验证:SRC_CHANGED=1 BUMPED=0)。已补 commit 0e94e1a25:kernel/package.json → 0.0.107、package-lock.json 同步、四处「acp-kernel >= 0.0.10x」文档/注释引用更新;修复后模拟 SRC_CHANGED=1 BUMPED=1 ✓,已推送到 PR 分支。
  • 本地定向验证(merged + 修复后的 head):kernel/tests/nudge.test.ts 44/44(含 4 个新分层阈值测试)、tests/compress-settings.test.ts 45/45(含 4 个新 host 测试)、tests/wire-contract.test.ts 15/15(golden 未变)、typecheck clean、kernel build OK。
  • 合并集成核对:master 新增的 externalSummary 链与本 PR 在 src/config.ts / src/compress-settings.ts / web / docs 的交叠处语义整合干净,无重复条目、无冲突残留。

判定:可合——待新 head 0e94e1a25 的 CI 全绿 + kernel 部分人工 review(Kernel Boundary 人工门禁)。CI 结果出来我会跟进,红了定向排查。

awork added 3 commits October 8, 2026 09:53
… and T2 long-project note

Per owner feedback on #2376: the quick-settings tier row now shows the
current derived defaults (T1 = growth step, T2/T3 = x1.5) instead of
blank placeholders, each input gets -/+ 5000 stepper buttons, only
values that differ from the derived default are persisted (unchanged
tiers stay out of the config), emptied fields self-heal back to the
derived value, and a description line explains each tier's role
including that T2/T3 count lower-tier summary tokens (default 75K at
~10:1 ratio carries ~750K raw per T2 block; raise T2 for longer
projects).
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 Review 后续:首轮回复后跟踪 CI,发现两处独立根因导致 CI 红,均已修复并推送(新 head b852058a5)。

根因 1 — npm test 四条矩阵腿全挂(#1024 i18n guard)
tests/web-i18n.test.ts 用正则 \bt\("([\w.]+)" 从 src/web/client.ts 收集 i18n key;原实现 inp.title = t("cfg.q_tiers_tip_" + k) 被捕获为假 key cfg.q_tiers_tip_ → 断言 "referenced key missing from zh catalog"。作者本地验证跑了 web-routing 但漏了 web-i18n,所以本地没暴露。修复 f89fee4d4:改为三条字面引用(client.ts 是内嵌纯 JS,不能带 TS 标注,首版尝试加类型注解被 WEB_CLIENT 解析测试抓出后已回退)。本地定向验证:web-i18n + web-routing 14/14、typecheck clean。

根因 2 — docs-sync artifact drift
CONFIGURATION.md/.zh-CN.md 的索引表由 tools/gen-config-docs.mjs 从 website/config-reference/*.yaml seed 生成(只重写标记块),PR 手写了索引行但没加 seed → CI 重新生成后漂移失败。修复 b852058a5:在 website/config-reference/compress.yaml 补 compress.tierNudgeTokens 条目(id cw.tnt、render compress-row,位置紧随 nudgeGrowthTokens)并重新生成。结果:英文 CONFIGURATION.md 逐字节一致(无可见变化,证明手写行与生成器输出吻合);中文版 Default 列被归一为生成器格式「派生值(…)」→「derived (T1 = nudgeGrowthTokens, T2/T3 = ×1.5)」——与表内其他行「展示字面值」的惯例一致,属外观归一;website/main.js 与 docs/index.html 自动获得 cw.tnt 条目(EN/ZH 各 230 key,i18n 校验通过)。

并发变更说明:review 期间作者 session 按 owner 反馈推了 20cb4747f(输入框预填当前派生默认值 + ±5000 步进按钮 + T2 长项目说明行),把 web 语义从「留空=跟随派生默认」变为「预填、仅改动项写入配置」。上述两个修复已在其之上重新应用并 fast-forward 推送(无冲突),PR 描述的 web 条目已同步更新。该行为变更本身是 owner 拍板的方向,不改变本 PR 的 kernel/host 逻辑。

新 head b852058a5 的 CI 重跑中(截至发稿 6/12 lane 已绿,主 CI lane 进行中),全绿后我再确认一次。首轮 review 结论不变:可合(CI 全绿后;kernel 部分按 Kernel Boundary 需人工 review)。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 CI 确认:新 head b852058a5 全绿(12/12 lane success)——主 CI lane(npm test ubuntu/windows × node 22/24 四腿、docs-sync、kernel-guard、version-guard、lane-guard、docs-coverage、unused-exports)与全部 e2e 真实客户端 lane(real codex、fake codex、persona、native opencode/pi/dsh、local registry、pi-codex ws)、ci-image、Windows codex overlay、PR Build Artifact 全部通过。

分支最终修复链:原 2 commit → a5bedc6d1 master 同步 → 0e94e1a25 kernel 版本重 bump(master #2302 已占用 0.0.106,否则 kernel-guard 挂)→ 20cb4747f owner 反馈的 web 预填+步进按钮 → f89fee4d4 i18n 字面 key 修复 → b852058a5 config-reference seed 补全+重新生成。

最终判定:可合。 剩余门禁均为人工项:① PR 合并按系统规则只能由人执行;② kernel/** 变更按 Kernel Boundary 需人工 review(改动本身是纯增量可选旋钮,默认路径行为零变化,golden wire-contract 未动)。无其他待办。

@ranxianglei

Copy link
Copy Markdown
Owner Author

冲突

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 冲突已解决:master 在上次同步后又前进了约 30 个合并(含 release v0.1.188/#2377、model-decided nudge #2228/#2243、pi-subagents vendor #2384、runaway-enumeration gate #2346 等),与 PR 分支在 7 个文件冲突。已把 origin/master(a5e7af11b)合入 PR 分支并全部解掉,新 head c9be40656 已推送,CI 重跑中。

结构化八问:

  1. 是什么问题:PR 分支与目标分支冲突不可合并(⚠️ merge_conflict),不是代码缺陷。
  2. 什么原因导致的:两条特性线在同一位置插入——本 PR 的 tierNudgeTokens 与 master 新落的 nudgeModelDecided/nudgeDecisionMaxTokens(新功能:增加模型完全决策的压缩时机nudge触发 #2228)都往 CompressSettings 类型、parseCompressSettings、COMPRESS_SETTING_FIELDS、config-reference seed yaml、CONFIGURATION 索引表/详情节、website 产物里加相邻字段/行,git 无法自动归并。纯位置冲突,无语义冲突。
  3. 影响范围与严重程度:仅本 PR 的合并性;不影响任何用户或线上行为。
  4. 怎么修复的:merge master 入 PR 分支,7 个冲突文件逐一按 union 解(两侧内容全保留);另发现 master 的 release v0.1.188 #2377 发布已消耗 kernel 版本号 0.0.107(与上次同型陷阱),故再 bump 到 0.0.108 并同步全部引用点(kernel/package.json、package-lock.json、src/config.ts、src/compress-settings.ts、CONFIGURATION.md/.zh-CN.md 共 6 处);gen-config-docs 重新生成(234 seed、i18n 232 key EN/ZH 集合一致)。
  5. 是否有回归问题:逐项过——master 带入的新功能(model-decided nudge、CJK billed status、runaway gate 等)在合并后原样保留且其新增测试全部纳入本地执行并通过;本 PR 默认路径仍零变化(wire-contract golden 未动)。语义交互核查:nudgeModelDecided 作用于 host「T1 武装后做什么」,tierNudgeTokens 作用于 kernel「每层何时武装」,层次正交无耦合。定向验证 131/131(kernel nudge、compress-settings、web-i18n、web-routing、wire-contract、nudge-decide、nudge-model-decided)、typecheck clean、build OK。
  6. 是否破坏缓存:不涉及——会话持久化格式、前缀缓存策略、更新节流均未触碰。
  7. 是否改了设计方向:不涉及,纯合并同步。
  8. 是否引入了新的配置:本次合并不引入;随 master 带入的 nudgeModelDecided/nudgeDecisionMaxTokens 在其各自 PR 合并时已披露。

判定不变:可合(CI 全绿后 + kernel 部分人工 review)。CI 结果出来我再确认一次。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 CI 确认:冲突解决后的新 head c9be40656 全绿(12/12 lane success)——主 CI(npm test 四矩阵腿、docs-sync、kernel-guard、version-guard、lane-guard、docs-coverage、unused-exports)+ 全部 e2e 真实客户端 lane + ci-image + Windows codex overlay + PR Build Artifact 均通过。分支状态干净可合并,剩余门禁不变:人工合并 + kernel 部分人工 review。无其他待办。

@ranxianglei
ranxianglei merged commit b7c3d1d into master Oct 8, 2026
26 checks passed
@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

📦 Merged Build Published

This merge to master was published as 0.0.145-master.b7c3d1d (rolling master tag).

npm install -g billion-context@0.0.145-master.b7c3d1d  # 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.

ranxianglei pushed a commit that referenced this pull request Oct 8, 2026
master independently consumed 0.0.108 (#2378); recut so the branch's kernel/src changes carry a version delta vs master (Kernel Boundary rule 2).
ranxianglei pushed a commit that referenced this pull request Oct 8, 2026
master independently consumed 0.0.108 (#2378); recut so the branch's kernel/src changes carry a version delta vs master (Kernel Boundary rule 2).
@github-actions github-actions Bot mentioned this pull request Oct 9, 2026
@ranxianglei
ranxianglei deleted the 2026-10-08_tier-nudge-thresholds branch October 15, 2026 05:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

拆分设置t1 t2 t3 nudge大小

1 participant