Skip to content

[PR] fix(web): switch large-session compressed structure tree to vertical layout when too wide, no longer shrinking to sub-pi | fix(web): 大会话压缩结构树图过宽时转竖向布局,不再缩成亚像素 (#4173) - #4211

Closed
ranxianglei wants to merge 1 commit into
masterfrom
2026-10-22_web-graph-portrait-fallback

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

Fixes #4173

问题

大会话(dsh 主会话,180 块 / 161 片叶子)平铺宽度 21558px,fit-to-card 缩放系数 0.052——118×36 的方块被缩成 ~6px、文字 ~0.6px,完全不可读。

修法

  • blockGraphLayout(blocks, vertical) 支持双朝向:竖向 = 深度走 x 轴、兄弟沿 y 轴堆叠;横向路径与原实现逐字节等价(同一套坐标公式,只是轴互换)。
  • buildGraphSvg:先算横向布局,若 fit = min(1, 1120/W) < GRAPH_MIN_FIT (0.5) 则改用竖向布局且 fit=1(自然尺寸),svg 加 g-svg-natural 类——CSS max-width:none 豁免,防止被 .g-svg { max-width:100% } 二次缩小;在现有 .tree-graph 70vh 滚动容器内滚动查看。
  • i18n hint 文案改为方向中性表述(中英同步)。

行为变更(旧→新)

  • 旧:任何树都等比缩到 ≤1120px,无下限,宽树退化成色带。新:预计缩放系数低于 0.5 时转竖向自然尺寸布局。边界:单层树 16 片叶子 fit≈0.52 仍横向缩放,17 片叶子 fit≈0.49 转竖向。小/中树不受影响(测试钉住:10 片叶子仍横向 fit≈0.83 等比缩放,viewBox/width 与旧行为一致)。选 0.5 的依据:低于它 11px 标签 <5.5px 不可读,高于它等比缩小仍可用。

测试

tests/web-blocks-tree.test.ts 新增 3 例:

  1. 宽树(181 块,150 叶)转竖向:svg 带 g-svg-natural,viewBox 414×7216,180 条边、181 个节点,边路径坐标与手算一致(根 (0,3576) → C_0 (134,96),pad 14);
  2. 窄树(5 根)/中树(10 根)不回归:无 natural 类,横向 viewBox 与旧渲染一致;
  3. 边界双向:16 根 → 横向 width 1120;17 根 → 竖向 viewBox 146×832。

本地定向验证全绿:web-blocks-tree + web-i18n 21/21、upstream-alerts + web-sessions 34/34、typecheck clean;全量回归以 CI 为准。

仅触碰 Web UI 展示面(src/web/client.ts、styles.ts、i18n.ts + 对应测试),不涉及 wire/存储/内核。

…raph

#4173: a 180-block session lays out 21558px wide, and fit-to-card
shrank it to ~0.052x (blocks ~6px, labels ~0.6px, unreadable).
blockGraphLayout gains a vertical orientation (depth on x, siblings
stacked on y); buildGraphSvg falls back to it at natural size whenever
the landscape fit would drop below GRAPH_MIN_FIT (0.5), and the
g-svg-natural class exempts the SVG from the CSS max-width cap inside
the existing 70vh scroll container. Narrow trees render unchanged.
@ranxianglei ranxianglei changed the title fix(web): 大会话压缩结构树图过宽时转竖向布局,不再缩成亚像素 (#4173) [PR] fix(web): switch large-session compressed structure tree to vertical layout when too wide, no longer shrinking to sub-pi | fix(web): 大会话压缩结构树图过宽时转竖向布局,不再缩成亚像素 (#4173) Oct 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-22_web-graph-portrait-fallback (b0f6c65)

Option A — Install this exact build (recommended)

npm install -g billion-context@0.0.5005-pr.4211.7ce990e

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-pr4211.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,无其他条目触碰 Web 树图布局)。但发现一个平行 PR:#4174 修同一个 #4173(10-21 开,早于本 PR),处置建议见文末「平行 PR」。

标签:bug / dsh / scope/ui / p2 —— 缺陷修复;报告会话为 dsh 主会话;纯 Web UI 展示面;大会话树图不可读但列表模式与核心功能不受影响 → p2。

审查依据:diff 全量 4 文件(+147/-28)逐行读完,测试里的几何数字全部手算复核通过,既有行为逐项清点;CI head b0f6c65 共 42 个检查全 success/skipped(skipped 均为路径门控的 e2e 车道,web-only 改动下属预期);mergeable_state=blocked 是等人合并,不是 CI 红。

结构化八问

  1. 是什么问题:大会话(180 块 / 161 叶)时 Web UI「压缩结构」树图被等比缩小塞进卡片(缩放系数 0.052),方块变成 ~6px 像素点、文字 ~0.6px,完全不可读。
  2. 什么原因导致的:blockGraphLayout 的宽度由叶子数决定(161 叶 → ~21558px),而 buildGraphSvg 一律 fit=min(1,1120/W) 且没有下限——宽树必然被压成亚像素色带。渲染策略缺下限,不是数据问题。
  3. 影响范围与严重程度:仅 Web UI 会话详情页「树图」模式的展示面;触发条件 = 叶子数 >~16(fit<0.5),即中大会话;受影响会话里该视图不可用,但列表模式与核心代理功能不受影响 → p2。
  4. 怎么修复的:双朝向。先算横向 fit,低于 0.5 就改用竖向布局(深度走 x 轴、兄弟沿 y 轴堆叠)按自然尺寸渲染(fit=1),新类 .g-svg-natural 豁免 max-width:100% 二次缩小,在既有 70vh 滚动容器内滚动查看。横向路径与原实现共用同一套坐标公式只是轴互换——对 fit≥0.5 的树输出逐字节等价(手算验证:旧 width=cursor−GAP_X ≡ 新 extentS+NODE_W)。
  5. 是否有回归问题:无回归。逐项审过:① 小/中树 fit-to-card 缩放不变(测试钉住 10 叶 fit≈0.83,viewBox/width 与旧渲染一致);② 边界双向钉住(16 叶横向 width=1120 / 17 叶竖向 viewBox 146×832);③ 空树返回 "" 不变;④ 深度上限 40 不变;⑤ 列表模式、点击跳转、节点渲染逻辑未动(仅边路径分两朝向);⑥ i18n 中英同步。有意的行为变更已在 PR 描述披露:旧=任何树无下限缩小 → 新=低于 0.5 转竖向自然尺寸(依据:0.5 以下 11px 标签 <5.5px 不可读)。
  6. 是否破坏缓存:不涉及——纯前端渲染,与模型前缀缓存/压缩状态/存储无关。
  7. 是否改了设计方向:不涉及。纯展示层渲染策略调整,架构/边界/数据流未变。
  8. 是否引入了新的配置:不涉及。GRAPH_MIN_FIT=0.5 是前端常量,与既有 GRAPH_FIT_W=1120 等常量同级别,未暴露为配置项。

测试质量:3 个新用例经既有 runWebClient harness(另 4 个测试文件在用)跑真实 bundle,断言手算精确坐标(根 (0,3576)→C_0 (134,96) 的边 M132 3608 C140 3608 140 128 148 128)——真断言非恒真,能抓住旧 bug(旧代码产不出 g-svg-natural 类和竖向 viewBox)。seam 暴露(window.bili_blockGraphLayout/bili_buildGraphSvg)沿用既有惯例(window.bili_trajSvg 等)。门控双向覆盖(#3617 纪律)。

平行 PR 处置(需 owner 拍板):

无需补修。满足 §7.4 auto-merge gate 条件(纯 fix:、单模块、回归测试复现原 bug、CI 绿、不触碰承重区、diff 干净、Fixes #4173)。

结论:建议合并,人执行合并:#4211

@ranxianglei

Copy link
Copy Markdown
Owner Author

(ai: zhipuai-lb/glm-5.3)

目标 issue #4173 已关。列车审查确认不再需要,关单。

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

Labels

bug Something isn't working dsh p2 scope/ui

Projects

None yet

1 participant