Skip to content

改造右侧 Inspector 为会话辅助面板 #4

Description

@JhihJian

背景

右侧 Inspector 原本以原始事件检查为中心,默认暴露大量 JSON 和低价值事件。对于阅读会话、判断关键上下文、定位工具调用或子代理行为来说,信息密度不合适,用户需要在大量调试细节中筛选真正有用的内容。

目标

将右侧 Inspector 调整为面向日常阅读和诊断的“会话辅助”面板:默认呈现会话概览、当前选中内容和关键事件,把完整原始 JSON 收纳到按需展开的调试区域。

已完成能力

会话概览

Inspector 顶部展示会话标题、数据源、模型、工作目录、时间范围、持续时间、Turn 数、工具数、错误数、子代理数、Token 和数据大小等高价值摘要,并提供复制会话 ID、数据路径和 Markdown 的快捷操作。

选中内容详情

阅读视图中的消息、工具调用、Trace 节点和关键事件都可以被选中,Inspector 会显示对应的类型、状态、时间、预览内容和上下文操作,降低查看细节时对原始 JSON 的依赖。

关键事件时间线

原始事件列表被收敛为按 Turn 分组的关键事件,默认保留用户请求、最终助手消息、Token 统计、错误、子代理和委派相关事件,减少长会话中的噪音。

调试 JSON 降级展示

完整事件 payload 仍然可以通过调试 JSON 区域按需读取和复制,但不再占据 Inspector 的默认注意力。

事件映射支持

轻量会话渲染模型为 compact item 增加 sourceIndex,前端可以从阅读项稳定映射回原始事件,支撑选中内容和调试 JSON 联动。

文档同步

README 已同步描述右侧 Inspector 的新定位、关键事件过滤和调试 JSON 行为。

验收标准

  • 打开页面后,右侧面板标题显示为“会话辅助”,不是原来的“详情 / 事件”。
  • 选择会话后,Inspector 默认展示会话概览和关键统计。
  • 点击阅读视图中的消息或工具调用后,“选中内容”区域展示对应摘要,并高亮当前阅读项。
  • 关键事件列表只展示高价值事件,并按 Turn 分组。
  • 完整 JSON 仍可通过“调试 JSON”折叠区查看和复制。
  • README 中对 Inspector、事件查看和 Markdown 导出的描述与当前行为一致。
  • npm test 通过。

验证记录

  • 本地运行 npm test,36 个测试通过。
  • 本地页面在 http://127.0.0.1:4897/ 上做过浏览器检查,长会话样例的关键事件收敛到 6 条,默认视图比原始事件列表更可读。

后续可继续观察

  • 不同 Codex 版本事件字段可能变化,关键事件筛选规则需要继续基于真实样本校准。
  • 如果后续引入更多事件类型,可以优先加入关键事件分类,而不是重新把完整 JSON 前置。

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions