Repository navigation
[PR] docs: size sessions.residentMaxBytes for concurrent large sessions (#4893) - #4895
ranxianglei wants to merge 11 commits into
Conversation
…4893) The permanent compress-refusal path already tells users to raise sessions.residentMaxBytes above ~weight+otherBytes, but the main docs never gave concurrency-scenario sizing advice. Add it to the sessions table row and the Detail paragraph, en+zh mirrored.
📦 Built Package ArtifactBranch: Latest build — install this exact versionnpm install -g billion-context@0.0.9243-pr.4895.8642e0dThis exact version is immutable and reproducible. The rolling Recent builds (commit → version)
Download artifact
tar xzf billion-context-pr4895.tgz
npm install -g packageInstall instructions are refreshed on each push. |
…ig seed The hand-edited table rows in CONFIGURATION.md/.zh-CN.md were overwritten by tools/gen-config-docs.mjs generate (docs-sync gate), because the wording never reached the seed of record in website/config-reference/process.yaml. Move the #4893 concurrency-sizing guidance into sessions.residentMaxBytes desc_en/desc_zh so regeneration reproduces the intended rows byte-for-byte.
(ai: vllm-qwen/qwen3.8-27b) CI 自动修复车道 1/2:docs-sync 红已修,新 head 查重:非重复 —— PR-local 红(master 绿,与 #4599 在册继承红簇零交集),已在 #4599 留一行记录。 八问:
收工判定:修复已推送( |
(ai: vllm-qwen/qwen3.8-27b) 补一行确认:新 head |
(ai: vllm-qwen/qwen3.8-27b) 查重: 不重复(open+closed 全量检索 residentMaxBytes / CONFIGURATION docs sizing 无其他命中;本单是 #4893 决策请求拆出的独立文档项,#4893 floor 3 已记录由 agent 开出本 PR)。 标签: dsh、scope/docs、p3(字段证据出自 DSH desktop 车道;纯文档面;无代码/配置面/行为变更)。 这是 #4893 车道的自有 PR(#4893 floor 3 记录),按「识别自己的 PR」纪律不重做,改为核对 + 修 CI:
完整八问结论待 CI 转绿后发在本帖。 |
(ai: vllm-qwen/qwen3.8-27b) 结论:ready-to-merge(等 owner 合并)并发说明(重要):我接单期间另一个 daemon 会话( PR 实际 diff(对 master,三点):3 文件 6+/6- —— CONFIGURATION.md / CONFIGURATION.zh-CN.md(表行 + sessions Detail 段)+ website/config-reference/process.yaml(种子 desc_en/desc_zh)。两个非 merge commit。 八问
CI(head c0ed8c8)全绿:CI 主矩阵 ✅(含此前红的 docs-sync ✅)、e2e 各车道(fake-codex / local-registry / native-pi / codex-persona / native-dsh / native-opencode / pi-codex-ws / windows-codex-overlay)✅。列表里的 cancelled 项是同一 SHA 上重复 pull_request 事件波产生的影子运行——每个被取消的运行在同波都有成功兄弟运行,非失败。 PR 状态:open、mergeable、 |
# Conflicts: # CONFIGURATION.md
# Conflicts: # CONFIGURATION.zh-CN.md # website/config-reference/process.yaml
(ai: vllm-qwen/qwen3.8-27b) Two more "dirty/conflict" triggers arrived back-to-back; both verified stale again — nothing to push. Evidence: ls-remote shows master@44067a5bc and ci-fixes@67f8e8940 unchanged since my last sync, and |
(ai: vllm-qwen/qwen3.8-27b) CI 自动修复车道 2/2 收工:本轮 4 个红分片全部归因为 master 级在档继承家族,分支侧已无动作可做,停手。 查重:不重复 —— run 41063977043 @ head 9b40210 的 4 个失败 job 逐一拉日志核对,无一新家族,全部在 #4599 台账在册(详见下方归因);按 owner policy 2026-10-24,CI 问题不开新 issue,状态收敛到 #4599(已留分账记录);#5140 家族的决策单 #5217 亦已在档。 归因(job 日志实读):
八问:
判定:本 PR 侧收工,等 #4599 裁决落地(合并 PR #5208 + #5140 家族裁决 + resident-minimal/Windows 两项收敛)后下次运行即有望全绿;若期间再收到同签名转发,将按同样方式报账后停手。 |
(ai: vllm-qwen/qwen3.8-27b) 收工确认(CI 自动修复车道 2/2,run 41063977043 @ 9b40210):4 个红分片逐一拉日志归因,全部为 master 级在档继承家族(inc-canonical-pointers 冷重建 409 = #5140 同族实例;issue4788-resident-minimal born-red;issue4739/issue5103 Windows 项;wire-exit abort),与本 PR diff 零因果。分支已验证 = master@44067a5bc ∪ ci-fixes@67f8e8940,无新同步可推、不重跑失败 job(同签稳定复现);#4599 已留分账,等 #5208 合并与 floor 535/567/601/616 的裁决落地后下轮即有望全绿。完整八问见上一条评论。 |
Resolve the three conflicts caused by master's docs move (#5920) and the #5779 residentMaxBytes default change: - root CONFIGURATION.md / CONFIGURATION.zh-CN.md: keep master's redirect stubs - re-target the #4893 residentMaxBytes sizing guidance into docs/configuration.md + docs/configuration.zh-CN.md (table row via the generator, sessions section description hand-written) - website/config-reference/process.yaml: merge master's 4 GiB default (#5779) wording with the #4893 concurrent-sessions sizing guidance (en + zh) - regenerate the config-docs marked blocks (tools/gen-config-docs.mjs; website/main.js + website/docs/index.html unchanged)
(ai: vllm-qwen/qwen3.8-27b) Merge conflict resolved and pushed. Merged Why the conflict existed — master made two changes after this PR branched that collide with its edits:
Resolution (mechanical only, no design decision needed):
Live-verified this run: PR is now CI: the mirror check cache was still stale (last fetched 2026-10-30 against old head 七问(CI 冲突解决 run,PR #4895):
结论:冲突已解决,PR 可合并( |
(ai: vllm-qwen/qwen3.8-27b) Verification run — no branch change needed. Re-checked all live sources this run:
No push, no edits, no labels this run — the branch is already in its resolved state. 七问(本轮 = 状态复核 run,PR #4895):
结论:冲突保持已解决状态,等待镜像缓存刷新 + |
[ework] CI fix verified green ✓ |
(ai: vllm-qwen/qwen3.8-27b) Final status — CI green, PR mergeable. Nothing left for the CI lane.
The PR is ready for a human merge (agents never merge PRs): #4895 七问(CI 车道收官,PR #4895):
结论:CI 车道工作完毕,PR 可合,等待人工合并。 |
(ai: vllm-qwen/qwen3.8-27b) Nudge acknowledged — my final report is already in this thread (one comment above, posted 05:07Z). One-line verdict: CI on head |
[ework] CI fix verified green ✓ |
1 similar comment
[ework] CI fix verified green ✓ |
Refs #4893 — the standalone doc item from that decision request (independent of the A/B/C/D outcome).
What
The permanent compress-refusal path (
src/stream.ts) already tells users to raisesessions.residentMaxBytesabove ~weight+otherBytes, but the main docs never gave concurrency-scenario sizing advice. Field data in #4893 (Windows + DSH desktop, bili 0.1.208): at the 512 MiB default only ~3–4 of ~136 MiB sessions fit while inFlight normally reaches ~7 — the pool saturates, and every touch of an evicted session pays a synchronous cold load that can block the event loop for seconds (heavy-load median 1482 ms, max ~11.5 s), which is what trips the attach health probe.Change (docs only, en+zh mirrored)
CONFIGURATION.md/CONFIGURATION.zh-CN.md:sessions.residentMaxBytestable row + sessions Detail paragraph — add guidance: with several large sessions open concurrently, size the budget above their combined weight (e.g. seven ~136 MiB sessions want ≥1 GiB); the permanent-refusal log names the exact target value.No code change. No config-surface change (no new key/default/env var). No behavior change.