前言¶
DeepSeek Harness (DSH) 采用插件化架构。在长会话中,用户难以快速定位到特定的节点或消息簇。dsh-sctrk 插件提供了一个可视化的会话轨迹条,通过界面右侧的悬浮轨道映射整个会话内容。
插件定位¶
这是一个 DSH 客户端插件,由 He2way 维护,采用 MIT 许可证。它通过界面右侧的悬浮「会话轨迹条」解决长会话导航问题。该插件将当前会话的每个聊天节点(用户消息、助手回复、工具调用等)映射到轨道上的一个刻度;密集节点会自动聚合成渐变簇点。
核心功能¶
-
8px 轨道映射与着色
轨道宽 8px,映射整个会话。单节点按类型着色(莫兰迪低饱和色板),密集节点聚合为渐变簇点。 -
悬停磁吸与预览
鼠标移入轨道交互带,最近的刻度/簇点会伸长并颜色加深,明确标示可点击。同时弹出毛玻璃浮窗,显示簇内构成(如用户×5 · 助手×4)及各节点的内容预览。 -
点击跳转与拖动滚动
点击刻度、簇点、浮窗条目或浮窗与刻度之间的区域,可精确跳转到对应节点。点击轨道本体或按住拖动,可按比例滚动会话。 -
主题自适应
浮窗与轨道样式跟随 DSH 主题,支持明暗模式切换。
安装与启用¶
需要 DSH profile(默认为 web)。插件声明了 dsh.bundle,dsh plugin 命令会自动将其加入 profile 的 bundle 列表,无需手动修改 patch。
安装命令¶
dsh plugin --profile web add dsh-sctrk
注意事项¶
- 若使用 pnpm 安装 git 源依赖时遇到构建阻止,需在
$DSH_HOME/profiles/web/pnpm-workspace.yaml的allowBuilds下添加对应 key。 - 安装后需重启
dsh web进程(或重新加载 profile),并强制刷新浏览器页面(Ctrl+Shift+R)。
使用步骤¶
- 鼠标移到轨道(右侧 8px 竖条)或其左侧交互带内,最近的刻度/簇点会伸长、变深,浮窗弹出。
- 点击刻度 / 簇点 / 浮窗条目 / 浮窗与刻度之间的区域,跳转到对应节点。
- 点击轨道本体或按住拖动,按比例滚动会话。
技术细节¶
- 无构建步骤,
lib/client.js即源码即产物(ModuleLoader 格式)。 - 依赖 React ^18.2.0。
- 使用 ResizeObserver 和 MutationObserver 自动响应窗口变化与新消息到达。
资源¶
- GitHub: https://github.com/He2way/dsh-sctrk
- 生态目录: https://www.skillhub.cn/plugins/He2way/dsh-sctrk