YeqingTang/dsh-session-flow

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

中文 | English

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

界面一览

功能

安装

# 插件市场搜索 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/* 命名空间。

权限与数据边界

• 不收集遥测、不上报使用数据；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