上下文快照栏luoshuai990529/dsh-context-snapshot-bar

简体中文 · English · 日本語

dsh-context-snapshot-bar

让 DeepSeek Harness 的当前上下文看得见：查看运行时快照、消息轨迹，以及最近一次压缩保留了什么。

插件作用

- 运行时快照节点：每次运行时快照在消息轨迹中独立成节点（琥珀色），轮次收起仍可见；每条记录使用自己的摘要，历史记录不会借用最新快照的摘要。
- 上下文快照：展示最新记录的规则、来源和时间，区分仍在上下文、已清除和已被替换。
- 对话轨迹：按轮次查看用户消息、助手工具调用与结果，并对照最近一次压缩摘要及其替换的消息。
- 接入位置：输入框上方提供入口，右侧上下文栏通过标签切换两种视图。

插件读取已提交的 Session 事件，不写入会话日志，不修改 DSH 的 AgentLoop 或压缩策略。快照可选用模型生成辅助摘要；未配置模型路由时仍可查看原始记录。

支持版本

| 项目 | 版本 |
| --- | --- |
| 已有安装与运行验证的 DSH | 0.1.5-rc.2（Host + Web） |
| 插件当前版本 | 0.3.1（源码；npm 已发布 0.2.0） |
| Session / Projection 依赖声明范围 | >=0.1.5-rc.2 =24.0.0 |

依赖范围不等于已验证范围，其他 DSH 版本尚未完成兼容验证。具体构件和检查记录见兼容说明。

快速安装

已安装 DSH 后，可直接从 npm 安装，无需下载源码或手动构建：

dsh plugin --profile web add dsh-context-snapshot-bar@0.2.0
dsh --profile web --dump-config

确认输出包含 dsh-context-snapshot-bar 配置层后，重启对应 Web 服务：

dsh --profile web

若该服务正在运行，先停止旧进程再启动；使用启动器新输出的地址打开 Web。进入会话后，点击输入框上方的快照入口打开右侧栏。

使用自定义 Web profile 时，将命令中的 web 替换为实际名称。需要修改或从源码构建时，参见开发指南。

其他说明

- 实时范围：提交事件后更新，不是逐 Token 流式显示；最新快照也可能已离开当前模型上下文。
- 摘要调用：配置模型路由后会产生额外请求，发送卡片持有的段落文本。关闭方式及显示上限见配置与开发指南。
- 从 npm 安装：上面的命令安装的是 npm 上已发布的 0.2.0；含运行时快照节点的 0.3.0 当前仅在源码中，发布后可改用 @0.3.0。
- 长会话与动画：超出上限时标注省略数量；当前版本展示压缩对照，尚未实现旧消息组收拢动画。
- 卸载：执行下面命令并重启对应服务，会话数据保留。

dsh plugin --profile web remove dsh-context-snapshot-bar

配置与排障 · 兼容记录 · 验收记录 · 变更记录 · MIT License