YeqingTang/dsh-session-flow

中文 | English

DSH 会话信息流重设计插件：把 DSH 会话的原始消息流重构成「可折叠的信息流 + 会话级汇总」——跨会话档案柜。

一句话：会话太多了，回看太慢？这个插件把 DSH 的每个会话变成一张「档案卡」——几秒看懂一次会话做了什么、干到哪一步、用过哪些工具、动过哪些文件，还能实时跟踪正在进行的会话。

DSH（DeepSeek Harness）是 AI 智能体工作台。它的官方会话视图（Trajectory / Chat）长于「正在发生时」的微观检查；本插件补足事后回顾 / 归档 / 洞察这一层：跨会话、跨工作区的历史视角。

---

它能做什么

能力	说明
🗂️ 会话总览工作台	所有会话卡片化展示：标题、工作区、状态（进行中/已结束/空会话/子代理）、错误数、耗时、创建时间；支持排序与筛选，一眼找到目标会话
🔍 结构化搜索	tool:pwsh 找用过某工具的会话、file:src/ 找动过某路径的会话、err: 找有错误的会话，或直接搜自由文本（标题/工具名/文件路径）
📜 折叠详情页	回合默认折叠成「用户发言 + 结论」两行摘要；展开后按真实时间序查看：思考 → 工具调用 → 回复，与发生顺序完全一致，不再被堆叠打乱
🧭 四标签导航	右侧面板：用户发言大纲 / 工具调用清单 / 错误列表 / 会话内全文检索——点击任意条目，正文区自动展开回合并滚动定位、高亮闪烁
🌳 子代理血缘树	主会话与子代理的派生关系树状展示；子代理详情复用折叠渲染；工具行「查看子代理」一键直达
📝 双模式摘要	每个会话自动生成摘要卡：规则模式（零开销，实时组装：任务数/首个任务/最近结论/工具 Top）+ LLM 模式（一键触发，调用 DSH 模型，按任务逐项概括；生成后落盘复用，有新对话自动提示重新生成）
⚡ 实时跟踪	进行中的会话点「实时」：3 秒自动刷新最新进展，运行中的回合呼吸高亮 + 「正在生成…」动态标志，无需刷新页面
📦 ZIP 分卷导出	一键把完整会话导出为可读 Markdown 报告（00-概览.md + 时间线分卷，单卷 ≤700KB），打包成 ZIP 下载——归档、分享、转给同事都方便
🧹 缓存管理	索引与时间线缓存可视化查看、分类清理（仅清理本插件缓存，不影响 DSH 数据）

安装

方式一：从插件市场安装（推荐）

打开 DSH Web GUI 侧边栏的「插件市场」，搜索 dsh-session-flow，点击安装即可。

方式二：通过 npm 安装

dsh plugin add dsh-session-flow

方式三：从 GitHub 安装

dsh plugin add github:YeqingTang/dsh-session-flow

方式四：本地源码安装（开发/调试）

git clone https://github.com/YeqingTang/dsh-session-flow.git
dsh plugin add link:/path/to/dsh-session-flow

安装后的生效步骤

任何安装方式完成后：重启 DSH Web 服务，然后浏览器硬刷新（Ctrl+Shift+R / Ctrl+F5）。 侧边栏出现「会话流」入口即安装成功。

环境要求

• DSH Web GUI（最新稳定版）
• Node.js ≥ 22.19（使用内置 zstd 解码，零第三方依赖）

使用指南

1. 进入总览

点击侧边栏「会话流」→ 所有会话卡片化展示。支持：

• 搜索：顶部搜索框，支持结构化前缀与自由文本混用：

  语法	作用	示例
  tool:xxx	用过该工具的会话	tool:pwsh
  file:xxx	动过该路径的会话	file:src/
  err:	有错误记录的会话	err:
  自由文本	标题/工作区/工具名/文件路径	会话流插件

• 工作区 tabs：按工作区筛选；排序：最近运行（默认）/最近创建/最早创建/工具最多/耗时最长

• 统计条：工具使用 Top 6 + 问题会话（有错误）一键筛选

2. 查看会话详情

点击任意会话卡片：

• 回合默认折叠：只显示「👤 用户发言 + ✅ 结论」摘要；点击回合头展开
• 展开后：按真实时间序查看思考（🧠）、工具调用（🛠️，含参数/结果/耗时/错误标记）、助手回复
• 右侧导航：用户发言 / 工具 / 错误 / 检索 四个标签，点击定位到正文对应位置（选中回合蓝色高亮）
• 会话摘要卡：顶部显示规则摘要；点「生成 LLM 摘要」获得智能摘要（按需消耗模型额度）

3. 跟踪实时会话

会话进行中时（头部显示「进行中」徽标）：

1. 点右上角「实时」按钮
2. 时间线自动刷新（3 秒一次），运行中回合绿色呼吸高亮 + 底部「正在生成…」动态标志
3. 点「退出实时」回到归档视图

4. 导出报告

详情页点「导出报告 (ZIP)」→ 下载 会话报告-<标题>.zip，解压即得：

00-概览.md            # 会话元信息 + 摘要 + 工具统计 + 产物清单 + 分卷指引
01-时间线-回合1-25.md  # 逐回合时间线（分卷，单卷 ≤700KB）
02-时间线-回合26-50.md # …

Markdown 报告可直接用任意编辑器/VSCode/Typora 打开。

5. 缓存管理

总览页 →「缓存管理」：查看缓存体积、按需清理（时间线缓存 / 全部）。清理后首次访问自动重建，不影响会话数据。

致谢

本插件站在 DSH 社区的肩膀上，感谢以下项目：

• DeepSeek Harness (dsh) —— DSH 智能体工作台与插件体系，本插件的运行基础。
• @deepseek-ai/dsh-session-persistence-jsonl —— 会话存档的 zstd 多帧扫描算法（lib/archive.js 中 scanZstdFrames 借鉴自该项目，MIT 许可）。
• dsh-web-ui（@linxin666 全家桶） —— 侧边栏入口与中栏面板的挂载模式参照（DOM 级注入 + 面板互斥协作），未复制代码；含 dsh-task-board / dsh-ssh 等。
• dsh-webui-market-plugin —— 插件市场机制与本插件的分发渠道。

版权归各自作者所有；本插件遵循 Apache-2.0 许可，使用第三方代码时保留其原始许可声明（见 lib/archive.js 注释）。

许可

Apache-2.0