在 DeepSeek Harness 的 Web 界面开发中，上下文窗口的实时状态、消息压缩后的保留内容以及工具调用轨迹往往难以直观观测。已有做法通常需要通过日志或外部工具排查。下面介绍 dsh-context-snapshot-bar，这是一个用于观测 DeepSeek Harness Web 运行时上下文快照和上下文轨迹的 DSH UI 插件。
插件定位¶
该插件由 luoshuai990529 维护，开源协议为 MIT。它通过在输入框上方提供入口，将原本隐藏的 Session 事件以可视化形式展示在右侧栏，帮助开发者厘清模型当前的上下文构成。
核心功能¶
该插件主要提供三种观测能力：
- 运行时快照节点：每次运行时快照会在消息轨迹中独立成节点（通常为琥珀色），即使轮次收起也可见。每条记录拥有独立的摘要，历史记录不会借用最新快照的摘要。
- 上下文快照：展示最新记录的规则、来源和时间，并区分消息当前是在「仍在上下文」、「已清除」还是「已被替换」的状态。
- 对话轨迹：按轮次查看用户消息、助手工具调用与结果，并对照最近一次压缩摘要及其替换的消息。
安装与启用¶
- 安装插件
直接从 npm 安装，无需下载源码或手动构建。安装 npm 已发布的0.2.0版本：
dsh plugin --profile web add dsh-context-snapshot-bar@0.2.0
- 确认配置
执行以下命令检查输出中是否包含dsh-context-snapshot-bar配置层：
dsh --profile web --dump-config
- 重启服务
重启对应 Web 服务以应用配置：
dsh --profile web
若该服务正在运行，需先停止旧进程再启动。
- 使用插件
进入会话后，点击输入框上方的快照入口，右侧栏会打开。通过标签切换两种视图。
适用场景与注意事项¶
- 版本依赖：插件依赖 DSH 版本
0.1.5-rc.2（Host + Web），Node.js 版本需满足^22.19.0 || >=24.0.0。其他版本尚未完成兼容验证。 - 权限与行为：插件读取已提交的 Session 事件，不写入会话日志，不修改 DSH 的 AgentLoop 或压缩策略。它以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 实时范围与性能：实时范围指提交事件后更新，不是逐 Token 流式显示；最新快照也可能已离开当前模型上下文。配置模型路由后会产生额外请求，发送卡片持有的段落文本。
- 版本说明：npm 已发布
0.2.0，源码当前版本为0.3.1（包含运行时快照节点功能）。 - 长会话：超出上限时标注省略数量。
总结¶
该工具通过直观的快照和轨迹展示，解决了 DeepSeek Harness Web 开发中上下文状态不可见的痛点。如需查看源码或提交问题，可访问项目主页。
