xusuyang030218/dsh-session-viz

README 摘要

DSH Session Log Visualizer 将 DSH（DeepSeek Harness）的会话日志（zstd 压缩的 JSONL）解析并可视化为 在线可浏览的网页。 需求文档见 REQUIREMENTS.md。 界面设计依据 UI IMPROVEMENT.md 与 PRODUCT REDESIGN.md（三层渐进式信息架构）。 插件模式（推荐，随 harness 启动） 本仓库同时是一个 DSH web 插件 ：安装后在会话头部（右上角） 「Session log」下载按钮 左侧 新增 ◈ AgentTrace（智能体轨迹） 按钮， 点击直接在当前页面打开全屏查看器。查看器采用 三层渐进式 设计： 层 视图 面向用户 内容 第一层 📋 摘要 所有人 执行摘要卡片：用户需求、轮次/步骤/耗时、工具使用 Top（图标+中文名）、审批结果、 文件变更记录（可展开查看修改 diff / 新增内容） 、Token 用量，无技术术语 第二层 📖 故事线 管理者 叙事式时间线：人类语言描述（「📖 AI 读取了 REQUIREMENTS.md」「⚠️ 请求审批 → ✅ 已批准」），推理折叠为摘要，点击展开 第三层 🔬 事件树 开发者 turn → step → 合并事件组 树形结构，按 14 组配色着色，搜索框 + 分组类型下拉，毫秒级/相对时间， 右侧事件详情（请求参数 JSON / 返回值 / 错误 / meta / 原始行） 四层进度体系 （PROGRESS AND NAME.md）： 进度条 位置 内容 ① 全局进度 窗口底部 3px 细条 每个 Turn 一个彩色分段（宽度按事件数比例），白色指示器标记当前浏览位置，hover 显示「Turn N · xx%」，点击跳转到对应 Turn ② Turn/Step 链 事件树左侧列表顶部 Turn 色块链（当前高亮）+ 当前 Turn 内 Step 进度 + 活动类型标签 ③ 单步进度 右侧详情面板 圆环（Step 在会话中的位置百分比）+ 事件类型占比横条（推理/输出/工具流/助手/事件）+ 总计与耗时 ④ 加载进度 首次打开全屏 环形进度 + 线性进度双重展示，分阶段（解析事件→生成摘要→构建故事线）实时更新 开发者模式（默认关闭） ：普通用户只看到「摘要 + 故事线」两层人话视图， 隐藏所有内部细节。点击顶栏 🛠 开发者 开关后额外显示： - 🔬 事件树视图（turn/step/事件类型/原始 JSON/JSONL） - 内部字段：seq、行号、callId、commandId、retryId、完整本地路径、token 明细等 隐藏项 普通用户 开发者模式 事件树 / 原始 JSON / JSONL ❌ 隐藏 ✅ 显示 文件完整路径 仅文件名 完整路径 seq / line / 事件类型名…

分类