前言¶
DeepSeek Harness (DSH) 的会话历史通常以流水账形式呈现。dsh-history 是一个 DSH 客户端插件，由 konanzheng 维护。它读取当前会话的历史事件，把每一轮交互组织成卡片，用一条蓝→紫→粉渐变的能量连线按 S 形串起来，并从工具调用中归纳过程洞察。
核心功能¶
- S 形能量轨迹与布局：轮次卡片按 boustrophedon（犁田式）排列，使用蓝→紫→粉渐变能量连线连接卡片中心。支持 Ctrl/Cmd + 滚轮缩放画布（0.4× – 2.5×），光标锚定缩放。
- 过程洞察与归纳：从工具调用中归纳模式，如定位（多次 grep/glob）、读写（多次 read/write）、验证（bash）或报错。卡片展示意图标签与里程碑标记（⚠ 首次报错 / 🔧 修复 / ⚡ 重点动作）。
- 逻辑链与详情：可视化因果逻辑链（如 读→改→验），点击卡片头部弹出详情窗口，包含完整对话、过程归纳、逻辑链、最终总结及文件操作明细。
安装与启用¶
- 前提：需要本地 DSH 开发环境。插件按 cordis 插件包方式装配。
- 依赖注入：需要在
package.json的dsh.client.inject中声明以下模块（由宿主提供）：@deepseek-ai/dsh-client-runtime：用于获取当前会话ctx.sessions.list.current。@deepseek-ai/dsh-client-ui-slots：UI 扩展。@deepseek-ai/dsh-client-connection：用于读取事件历史connection.api.sessions.history。
- 装配方式：
cordis.patch.yml已内置{ id: dsh-history, name: dsh-history }的注册，随 DSH profile 装配时自动加载 client bundle。
典型用法¶
- 打开一个有历史消息的会话。
- 切到 轨迹 视图，时间轴会自动打开。
- 自下而上浏览卡片：查看意图标签、逻辑链、问/答摘要、文件条。
- 点击卡片头部查看详情窗口（包含过程归纳、逻辑链、最终总结和文件明细）。
- 使用 Ctrl/Cmd + 滚轮缩放画布，按 ESC 逐层关闭详情或时间轴。
适用场景与注意¶
该插件需要本地 DSH 开发环境。安装前应检查源码与许可证（Apache License 2.0）。
结语¶
dsh-history 将原本杂乱的对话记录转化为可视化的能量轨迹，帮助开发者快速定位 AI 的思考路径与操作逻辑。
