会话导图 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