Skip to content

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 #3917

Closed

Description

@vegetable86

问题

会话详情页只有一行行压缩块(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

  1. changed the title [-]Web UI: ???????????????(tier ? + ????/token/??)[/-] [+]feat(web): session detail 压缩结构 tab — tier tree, graph view and lazy originals[/+] on Oct 20, 2026
  2. ranxianglei commented on Oct 20, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    (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 改动、零新配置,纯读路径 + 前端渲染,符合你给的数据源约束。开始实现,方案:

    1. 树视图:detail 响应的 blockDetails 补 children(directBlockIds),前端按 parent 关系建树;节点显示 blockId / T{n} / topic / compressedTokens / mNNNNN 区间 / active 与 ⚡ext 徽标;
    2. 懒加载原文:新增只读端点按需取单块原文(mode=one|full 对应 BlockContent 的两级视图),2 MiB 截断保护,展开状态页内保留;
    3. mNNNNN 定位:输入 ref/raw id → 精确回答属于哪些块(走真实 id 集合而非 span 数值猜测),树中高亮并展开;
    4. 导出:当前视图(摘要 + 已加载原文)导出 JSON 下载。

    做完带 PR 回复。

  3. changed the title [-]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[/+] on Oct 20, 2026
  4. ranxianglei commented on Oct 20, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    (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 互补。

    结构化八问

    1. 是什么问题:会话详情页此前只有扁平的「压缩块」列表——看不到 tier 父子结构、看不到块内原文、无法反查某条 mNNNNN 属于哪个块、也无法导出视图。本 issue 要求一个「压缩结构」视图。
    2. 什么原因导致的:非缺陷,功能缺失。一个设计约束值得说明:kernel 的 CompressionBlock 没有 parentBlockId 字段,树的父子边只能从 directBlockIds(子块列表)反向推导——所以 detail 载荷给每个块加了 children 边。
    3. 影响范围与严重程度:仅 /__bili/ 监控面板(scope/ui,p3);对代理/压缩/wire 协议零影响。使用场景:调试压缩行为时查看消息被折到哪一层、原文是什么、结构是否如预期。
    4. 怎么修复的:纯只读增量——
      • detail 载荷的 blockDetails 每项增加 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;
      • 前端新增「压缩结构」卡片:树 + 懒加载按钮 + mNNNNN/raw-ID 定位(命中高亮、沿 root→owner 链自动展开)+ 当前视图导出 .json。
    5. 是否有回归问题:逐项审过既有行为——buildSessionDetail 的会话解析逻辑抽成 resolveSessionForWeb(逻辑逐行不变,存量测试全绿);blockDetails.children 为纯附加字段;admin.ts 两条新路由是独立 GET 条件,不触碰既有路由匹配;顺带修掉一个潜在崩溃:缺少 directBlockIds 的稀疏/legacy 块记录会让整个详情页渲染抛错,现在降级为叶子节点。wire/配置/持久化/kernel 均未触碰。本地 typecheck + 定向测试 38/38 绿(含真实 client IIFE 执行测试与 i18n 一致性套件),全量回归交 CI。
    6. 是否破坏缓存:不涉及——未触碰任何缓存/重试/增量游标/去重逻辑;detailInFlight 并发去重保持原样。
    7. 是否改了设计方向:无。完全沿用既有 sessions-data → admin 路由 → client 卡片的模式,纯增量。
    8. 是否引入了新的配置:无新 env/配置项/CLI 参数;2 MiB 截断阈值是内部常量(BLOCK_CONTENT_MAX_CHARS),未暴露为配置。

    行为变更披露(Deliverables 规则 4):本 PR 全部变更为增量——两个新只读 HTTP 端点(位于既有 loopback/trusted-origin 门禁之后)、detail JSON 一个新字段、页面一个新卡片;既有输出格式与语义零变化。

    结论:可合并,等 CI 全绿 + 人工审核。

  5. ranxianglei commented on Oct 21, 2026

    @ranxianglei
    Owner

    关闭:compression-structure tab(tier tree / graph view / lazy originals)已由 #3924 实现并合并,随 release v0.1.203 发布;architecture.md 的引用也已修正指向本 issue。早期实现 #3942 已被 #3924 取代关闭。(孤儿扫描交叉核验)

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions