会话档案流 YeqingTang/dsh-session-flow

dsh-session-flow — DSH 会话回顾与归档插件

把 DSH 会话的原始消息流重构成「可折叠的信息流 + 会话级汇总」：每个会话变成一张档案卡，跨工作区回顾、检索、导出。官方会话视图（Trajectory / Chat）擅长正在发生的微观检查，本插件补足事后回顾 / 归档 / 洞察这一层。

界面一览

| 总览工作台 | 会话流标签页 |
| 总览工作台 | 会话流标签页 |
| 会话卡片墙：标题、状态、结论摘要行、首个任务；hover ✎ 行内重命名 | 原生会话页内嵌「会话流」标签：当前会话直接回顾 |

| 轮次悬浮条 | 跨会话全文检索 |
| 轮次悬浮条 | 跨会话全文检索 |
| 对话页左侧轮次导航：收拢短横条 ⇄ 展开条目卡，一键跳转任意轮次 | 总览自由文本搜索触发全文模式：跨工作区召回，命中直达定位 |

| 详情并入右栏 | 折叠详情页 |
| 详情并入右栏 | 折叠详情页 |
| 详情并入官方右侧面板：主对话与会话流并行，拖拽调宽 | 回合默认折叠，展开按真实时间序；右侧四标签导航 |

功能

| 能力 | 说明 |
| 总览工作台 | 会话卡片（状态/错误/耗时）+ 结论摘要行；排序、筛选、工作区 tabs |
| 结构化搜索 | tool: file: err: 前缀 + 自由文本 |
| 折叠详情页 | 回合折叠成「用户发言+结论」，展开按真实时间序；按需加载 |
| 四标签导航 | 用户发言 / 工具 / 错误 / 检索，点击定位高亮 |
| 血缘树 | 子代理派生关系树（离线档案 + 运行时实时双通道） |
| 双模式摘要 | 规则摘要（零开销实时组装）+ LLM 摘要（落盘复用、新对话提示重生成） |
| 实时跟踪 | 运行中会话 3 秒轮询，呼吸高亮 + 生成标志 |
| ZIP 导出 | 概览 + 时间线分卷 Markdown 报告 |
| 会话重命名 | 与官方标题同一数据源（log-backed），双向实时同步，随时改名 |
| 健康监控 | 活跃 / 工具执行中 / 静默中 / 疑似卡死四级分类；总览徽标 + 详情实时条 |
| 头部健康芯片 | 会话页顶栏模式标识右侧，竖条收拢 ⇄ 悬浮展开状态卡，点击直达详情 |
| 会话流标签页 | 原生会话页内嵌标签，与工作台互跳 |
| 轮次悬浮条 | 对话页左侧轮次跳转（仅对话页显示） |
| 跨会话全文检索 | 内容级召回，命中直达会话流标签页定位 |
| 详情并入右栏 | 与主对话双视角并行 |
| 缓存管理 | 索引/时间线缓存查看与清理（不影响 DSH 数据） |

安装

插件市场搜索 dsh-session-flow，或：
dsh plugin add dsh-session-flow
dsh plugin add github:YeqingTang/dsh-session-flow

安装后重启 DSH Web 服务并硬刷新浏览器（Ctrl+Shift+R），侧边栏出现「会话流」入口即成功。

环境要求：DSH Web GUI（最新稳定版）；Node.js ≥ 22.19（内置 zstd 解码，零第三方依赖）。

使用

- 总览：侧边栏「会话流」→ 全部会话卡片。搜索支持 tool: / file: / err: 前缀；自由文本 ≥2 字符自动追加跨会话全文检索结果。
- 详情：点卡片进入。回合默认折叠，点回合头展开；右侧四标签导航定位；顶部可生成 LLM 摘要、导出 ZIP、并入右栏、查看血缘。
- 原生会话页：会话顶部「会话流」标签直接回顾当前会话；对话页左侧轮次悬浮条跳转任意轮次；标题 hover ✎ 重命名（与官方标题实时同步）。
- 健康状态：顶栏模式标识右侧的健康芯片（竖条：绿=活跃 / 黄=工具执行中 / 红=疑似卡死），悬浮展开看详情，点击直达会话流详情页；总览卡片与详情实时条同步显示徽标。
- 实时：运行中会话点「实时」，3 秒自动刷新。

外部依赖与运行条件

- 运行环境：DSH Web GUI（0.1.2-rc.1 ~ 0.2.1-rc.2，逐版本兼容声明见 package.json 的 dsh.compatibility.dshReleases）；Node.js ≥ 22.19（使用 Node 内置 zstd 解码，无第三方解码库）。
- 运行依赖：仅 @deepseek-ai/schemastery（DSH 官方同源 schema 库；用于设置表单 schema 与 .volatile() 热更新）。
- 无生命周期脚本：不声明 preinstall / install / postinstall / prepare，安装过程不执行任何脚本。
- 以 Bundle Patch 方式挂载：cordis.patch.yml 只插入本插件自身条目，不禁用、替换或遮蔽任何官方组件。
- 独立第三方项目，非 DeepSeek 官方组件；包名不使用 @deepseek-ai/ 命名空间。

权限与数据边界

| 访问范围 | 用途 | 边界 |
| 读 ~/.dsh/sessions/ | 解析会话存档（zstd/JSONL）生成索引与时间线 | 只读，不修改、不删除会话文件 |
| 写 ~/.dsh/session-flow/* | 插件私有索引、时间线缓存、重命名映射 | 只写此目录；缓存管理面板只清理这里 |
| 本机 POST /api/session-flow | 索引 / 详情 / 检索 / 导出 / 健康检查 | 注册在 DSH 自带 webServer 上，沿用宿主登录鉴权；服务端不主动对外发起网络请求 |
| 读官方会话列表投影（sessions.list） | 列表标题、重命名同步 | 只读；不修改官方状态 |
| 宿主 llm 服务（可选） | LLM 摘要 | 只经宿主已配置的模型调用，不引入额外供应商 |

- 不收集遥测、不上报使用数据；ZIP 导出为本地文件。
设置保存写入 DSH profile patch（~/.dsh/profiles/<profile>/cordis.patch.yml），与官方设置同一存储。

已知限制与风险

- 会话存档是宿主实现细节：dsh 每次存档代际迁移（v1→v2→v3→v4）都可能改变读取口径。本插件按「代际号最大」自适应，并为 v4 的 isError 变化做了双口径兼容，但不保证未来全新格式零改动。
- 索引为增量缓存：首次安装 / 升级后首次打开会全量扫描一次；数百 MB 的超大会话首扫较慢，不影响宿主数据。
- 「详情并入右栏」依赖官方右栏标签页体系（dsh ≥ 0.1.5）或旧 details 列（≤ 0.1.4）；自定义外壳两者都没有时，按钮会禁用并提示原因。
- LLM 摘要需要你已在 DSH 中配置可用模型；未配置时仅规则摘要可用。
- DOM 级增强（轮次悬浮条 / 官方 rail 增强 / 健康芯片）通过 DOM 观察实现（官方未提供扩展槽位）；宿主大版本若调整 DOM 结构可能静默失效，需随版本适配。
- 不接管、不修改任何官方 UI 行为；与第三方皮肤 / 布局插件共存时，可能因布局差异需要额外适配。

致谢

- DeepSeek Harness (dsh) —— 运行基础。
- @deepseek-ai/dsh-session-persistence-jsonl —— zstd 多帧扫描算法（lib/archive.js 借鉴，MIT 许可）。
- dsh-web-ui（@linxin666 全家桶） —— 侧边栏入口与面板挂载模式参照，未复制代码。
- dsh-webui-market-plugin —— 插件市场机制与分发渠道。

本插件遵循 Apache-2.0 许可，使用第三方代码时保留其原始许可声明。

许可

Apache-2.0