lwklbb/DSH-SessionGraph

DSH SessionGraph

SessionGraph 是一个给 DSH 用的小插件，用来把当前会话整理成导图。长会话里经常有很多调试、报错、反复修改的过程，最后真正有用的其实是结论、做了什么、还剩什么。所以这个插件会尽量过滤过程噪声，把会话压成一个可编辑、可复制的结构化大纲与导图。

SessionGraph UI showcase

能做什么

- 在会话输入框上方右侧增加一个 SessionGraph ▾ 按钮。
- 读取当前会话内容，提取目标、结论、关键点、决策、待办和文件产出。
- 过滤一些明显没必要进导图的内容，比如 stack trace、终端日志、debug 输出、重复试错过程等。
- 支持在弹窗里手动改节点、加子节点、删掉不想要的节点。
- 支持一键复制导出结果。

三种模式

| 模式 | 内容 | 适合场景 |
| --- | --- | --- |
| 默认导图 | 会话目标、最终结论、关键要点、决策与取舍、待办、文件/产出 | 平时整理一段会话 |
| 精简导图 | 只保留最终结论和待办 | 快速复盘、交接、写 commit 前看一眼 |
| 详细导图 | 默认导图 + 压缩后的时间线 | 会话比较长，想回头看过程时使用 |

导出格式

目前支持这些格式：

- Markdown 大纲
- Mermaid mindmap
- PlantUML mindmap
- XMind 缩进文本
- 待办清单简介

Markdown 大纲

下面用一个常见的开发场景举例：一次会话里完成了“订单列表批量导出 CSV”功能，中间可能经历了接口参数调整、字段映射修正、空状态处理和测试失败重跑。SessionGraph 会尽量把这些过程整理成最终可读的大纲。

SessionGraph：订单列表批量导出 CSV

- 会话目标
- 在后台订单列表增加批量导出 CSV 功能
- 支持按当前筛选条件导出，而不是只导出当前页
- 导出字段需要包含订单号、用户、金额、状态、下单时间
- 最终结论
- 前端已增加“导出 CSV”按钮，并复用订单列表当前筛选条件
- 后端新增 GET /api/orders/export 接口，返回 text/csv 文件流
- CSV 字段顺序已固定，金额统一按元展示，时间统一格式化为本地时间
- 空结果会导出只有表头的 CSV，不再直接报错
- 关键要点
- 导出请求不走分页参数，只传筛选条件和排序字段
- 前端使用 Blob 下载，文件名格式为 orders-yyyyMMdd-HHmm.csv
- 后端复用订单查询 service，避免复制一套筛选逻辑
- 大批量导出先限制为 5000 条，超过时返回明确提示
- 决策与取舍
- 暂时不做异步导出任务，当前版本先使用同步 CSV 下载
- 不在前端拼 CSV，避免字段权限和金额格式与后端不一致
- 状态字段导出中文文案，方便运营直接查看
- 待办 / 下一步
- 补一条超过 5000 条时的接口测试
- 和产品确认是否需要导出收货地址、优惠券字段
- 后续如果数据量继续变大，再改成异步导出中心
- 文件 / 产出
- src/pages/orders/OrderList.tsx
- src/api/orders.ts
- server/routes/orders.ts
- server/services/orderExport.ts

Mermaid

mindmap
root((SessionGraph：订单列表批量导出 CSV))
会话目标
后台订单列表增加批量导出 CSV
按当前筛选条件导出全部结果
字段包含订单号、用户、金额、状态、下单时间
最终结论
前端增加导出 CSV 按钮
后端新增 /api/orders/export 文件流接口
金额和时间格式已统一
空结果导出表头不报错
关键要点
导出请求不带分页参数
使用 Blob 下载 CSV
后端复用订单查询 service
单次导出上限 5000 条
决策与取舍
当前版本使用同步下载
CSV 在后端生成
状态字段导出中文文案
待办 / 下一步
补充超过 5000 条的接口测试
确认是否增加收货地址和优惠券字段
数据量变大后再做异步导出中心
文件 / 产出
src/pages/orders/OrderList.tsx
src/api/orders.ts
server/routes/orders.ts
server/services/orderExport.ts

PlantUML

@startmindmap
* SessionGraph：订单列表批量导出 CSV
** 会话目标
*** 后台订单列表增加批量导出 CSV
*** 按当前筛选条件导出全部结果
*** 字段包含订单号、用户、金额、状态、下单时间
** 最终结论
*** 前端增加导出 CSV 按钮
*** 后端新增 /api/orders/export 文件流接口
*** 空结果导出表头不报错
** 关键要点
*** 导出请求不带分页参数
*** 使用 Blob 下载 CSV
*** 后端复用订单查询 service
** 待办 / 下一步
*** 补充超过 5000 条的接口测试
*** 确认是否增加收货地址和优惠券字段
@endmindmap

XMind 文本

XMind 文本是 tab 缩进的大纲，复制后可以粘到支持缩进导入的工具里：

SessionGraph：订单列表批量导出 CSV
会话目标
后台订单列表增加批量导出 CSV
按当前筛选条件导出全部结果
字段包含订单号、用户、金额、状态、下单时间
最终结论
前端增加导出 CSV 按钮
后端新增 /api/orders/export 文件流接口
空结果导出表头不报错
关键要点
导出请求不带分页参数
使用 Blob 下载 CSV
后端复用订单查询 service
决策与取舍
当前版本使用同步下载
CSV 在后端生成
待办 / 下一步
补充超过 5000 条的接口测试
确认是否增加收货地址和优惠券字段

待办清单简介

待办清单简介

结论摘要
- 前端已增加“导出 CSV”按钮，并复用订单列表当前筛选条件。
- 后端已新增 GET /api/orders/export 接口，返回 CSV 文件流。
- 空结果会导出只有表头的 CSV，不再直接报错。

待办
- [ ] 补一条超过 5000 条时的接口测试。
- [ ] 和产品确认是否需要导出收货地址、优惠券字段。
- [ ] 后续如果数据量继续变大，再改成异步导出中心。
提取规则

lib/extractor.js 里是主要的解析逻辑。现在是本地规则，不依赖额外模型。大致会做这些事：

1. 从当前 ConversationSnapshot 里读取用户消息和助手消息。
2. 默认跳过 reasoning/thinking 内容。
3. 对每一行做清理，过滤：
- stack trace / traceback；
- stdout、stderr、exit code；
- npm err、pnpm err、warning/debug/verbose 日志；
- 终端提示符和大段命令输出；
- 明显重复的内容。
4. 优先保留最后几条助手回复里的结论。
5. 额外识别 结论、总结、完成、结果、决定、待办、下一步、TODO、Decision、Summary 这些关键词。
6. 从文本里抓取疑似文件路径，放到“文件 / 产出”节点里。

这个规则不是为了完整记录所有过程，而是为了快速得到一份“现在还能用的信息”。

安装

在插件目录里执行：

dsh plugin --profile web add .

如果是在本地 DSH 源码树里安装：

dsh -- plugin --profile web add D:\desktop\plugins-test\DSH-SessionGraph

安装后重启或刷新 DSH，打开一个已有内容的会话，就能看到 SessionGraph ▾ 按钮。

项目结构：

DSH-SessionGraph/
├─ cordis.patch.yml
├─ lib/
│  ├─ index.js        # host 侧入口，目前保持 no-op
│  ├─ client.js       # 浏览器 UI 和 slot 注册
│  └─ extractor.js    # 会话解析、导图生成、格式导出
├─ test/
│  └─ extractor.test.mjs
├─ docs/
│  └─ sessiongraph-showcase.png
├─ package.json
├─ LICENSE
└─ README.md

DSH 接入方式

插件通过 conversation.input.dock slot 加入一个按钮，不接管原来的输入框，也不修改会话持久化文件。

lib/index.js 是 host 侧入口，目前只是空实现；真正的功能都在浏览器侧完成。这样做的好处是安装风险比较低，SessionGraph 只读当前页面已经有的会话快照。

核心函数在 lib/extractor.js：

- extractMessages(snapshot)：从会话快照提取可用消息。
- summarizeSession(snapshot, mode)：按模式生成导图树。
- exportGraph(tree, format)：把导图树导出为 Markdown / Mermaid / PlantUML / XMind / TODO brief。

License

MIT © 2026 lwklbb