## 问题 会话详情页只有一行行压缩块(blockId / topic / T{n} / 摘要),看不到压缩结构:谁折叠了谁、T1/T2/T3 怎么叠、每块覆盖多少 token、压成多少、覆盖了哪些 `mNNNNN`、块里到底有什么。排查「这段为什么被压掉」「这个 T2 里包着哪几个 T1」只能翻 `bili.log` 或读会话 JSON。 ## 改动 会话详情页顶部加子标签 **概览 / 压缩结构 / 交接文档**。压缩结构读会话自身的 `state.blocks` 与 `blockContents`,不新增存储、不改 `kernel/`。 - **嵌套关系**:`parentBlockId`(由 `CompressionBlock.directBlockIds` 反推),根 = 未被任何块折叠的块,同级按创建顺序。 - **节点数据**:tier / 活跃或归档 / topic / 创建时间 / `mNNNNN` 区间 / 覆盖消息数 → 摘要 token(压缩比)/ 摘要字节 / 直属消息数。 - **块内容**:摘要 markdown 直接渲染;原文按需加载 —— `one`(压缩当时的视图:直属消息 + 子块摘要)、`full`(全部被覆盖消息原文),2 MiB 截断并如实标 `truncated`,没有快照/已被 prune 时返回 `no-content-snapshot` / miss 而不是猜。 - **消息叶子**:每个块下列出被它直接折叠的 `mNNNNN`(ref + 角色 + 单行预览),点一条才取那条消息的全文。 - **两种读法**:列表用于看具体消息;分层树图(父块在上、子块在下、贝塞尔连线)用于看整体形状,点节点跳回列表对应行并展开。 - 首屏 payload 只加元数据,绝不带原文。 ### 端点(admin 通道,沿用 loopback / trusted-origin 闸) - `GET /__bili/sessions/<id>/block-content?blockId=bN&view=one|full` - `GET /__bili/sessions/<id>/message?ref=mNNNNN` 两者都走 2 MiB 上限 + UTF-8 安全截断(不劈代理对),未知/无快照一律 404 带 `reason`。 ## 验证 - `npm run typecheck` 干净;`tests/web-blocks-tree.test.ts` 6 例 + `tests/web-sessions.test.ts` 26 例全绿。 - 真实服务器 + 真实浏览器(Edge/CDP)验证:种子会话 `b2`(T2) 正确嵌套 `b1`(T1);`原文(本层)` 返回 2 条消息 52 B,`原文(全部)` 返回 3 条 49 B;en 下 `Overview / Structure 2 / Handoff`;树图节点点击跳转正常;500px 窄视口 topic 不再竖排。 - 用真实会话目录回归:6 个会话 1000+ 条消息叶子,`missing` 为 0。 - 兼容旧块:缺 `directBlockIds` / `effectiveMessageIds` / `directMessageIds` 的历史块退化为叶子,不抛错(有专门用例)。
Activity
[-]Web UI: ???????????????(tier ? + ????/token/??)[/-][+]feat(web): session detail 压缩结构 tab — tier tree, graph view and lazy originals[/+]docs: correct stale issue ref in architecture.md (ranxianglei#3936 -> r…
ranxianglei commentedon Oct 20, 2026
(ai: vllm-qwen/qwen3.8-27b)
查重:不重复。 最近邻是 #3201 / PR #3337(会话详情页「上下文轨迹」视图)——同一页面、同一数据域,但机制不同:#3337 重建的是最近一轮出站上下文的消息级台账(system/工具/逐条消息),本 issue 要的是折叠块自身的层级结构(T1/T2/T3 tier tree、directBlockIds 父子关系、blockContents 原文懒加载、mNNNNN→所属块定位、JSON 导出)。两者互补不重叠:一个看「上一轮发了什么」,一个看「历史被折成了什么形状」。
标签: scope/ui + p3(面板展示层新功能请求;非缺陷、不涉及特定客户端;调试辅助面,按最小档计严重度)。
功能评估(合理性/契合度/耦合):成立且位置正——web 详情页现在只有
blockDetails平铺列表,看不到折叠层级(哪个 T2 吞了哪些 T1)、也看不到折叠原文(现有途径是 decompress,会改动会话状态,只读浏览没有出口)。数据全部已在手:state.blocks(directBlockIds/startRef/endRef/tier/compressedTokens)+session.blockContents(one/full 两级原文视图,懒加载落盘),零 kernel 改动、零新配置,纯读路径 + 前端渲染,符合你给的数据源约束。开始实现,方案:children(directBlockIds),前端按 parent 关系建树;节点显示 blockId / T{n} / topic / compressedTokens / mNNNNN 区间 / active 与 ⚡ext 徽标;做完带 PR 回复。
[-]feat(web): session detail 压缩结构 tab — tier tree, graph view and lazy originals[/-][+]feat(web): session detail compact structure tab — tier tree, graph view and lazy originals | feat(web): session detail 压缩结构 tab — tier tree, graph view and lazy originals[/+]ranxianglei commentedon Oct 20, 2026
(ai: vllm-qwen/qwen3.8-27b)
完成 — PR: https://github.com/ranxianglei/billion-context/pull/3942(Closes #3917)
标签:scope/ui + p3(监控面板纯新增功能,不动核心链路)
查重:不重复 —— #3201/#3337 是 context trace(出站消息账本),机制不同,与本 tab 互补。
结构化八问
children边。children(子块 id 数组),前端据此渲染 tier 树(节点显示 T{n} / topic / tokens / 时间 / ref 区间 / active·ext 徽标,展开看摘要 markdown);GET /__bili/sessions/:id/block-content?block=bN&mode=one|full懒加载单块原文(one=直接消息+嵌套子摘要,full=全部原文;二者字节相同时返回同一份拷贝并标记 identicalToFull;超 2 MiB 截断并标记 truncated),GET /__bili/sessions/:id/block-ref?q=m00042按每个块的 effectiveMessageIds 做精确成员判定(不做 ref 区间猜测),返回所有包含该消息的块(叶子+全部祖先)并标出最深的 owner;行为变更披露(Deliverables 规则 4):本 PR 全部变更为增量——两个新只读 HTTP 端点(位于既有 loopback/trusted-origin 门禁之后)、detail JSON 一个新字段、页面一个新卡片;既有输出格式与语义零变化。
结论:可合并,等 CI 全绿 + 人工审核。
ranxianglei commentedon Oct 21, 2026
关闭:compression-structure tab(tier tree / graph view / lazy originals)已由 #3924 实现并合并,随 release v0.1.203 发布;architecture.md 的引用也已修正指向本 issue。早期实现 #3942 已被 #3924 取代关闭。(孤儿扫描交叉核验)
fix(web): correct stale "light canvas" wording in the #3917 graph com…
web: persistent compression-tree tooltip + frozen-snapshot hydration …