在 DeepSeek Harness Web 的开发过程中,长对话往往导致上下文冗长,快速定位用户输入的指令变得繁琐。为了解决这个问题,社区开发了导航辅助工具。下面介绍 DSH User Message Minimap,它通过在对话左侧显示用户消息导航轨,让快速定位指令变得简单。
插件简介¶
DSH User Message Minimap(用户消息导航轨)是一个可随时安装和卸载的 Web 客户端插件。它会在长对话左侧显示一个紧凑的导航轨,映射用户消息的位置,方便开发者快速辨认当前轮次并跳回之前的指令。
核心功能¶
- 导航轨显示:对话中至少有 4 条用户消息时,左侧会显示导航轨。
- 标记对应:每条用户消息对应一个标记,顺序与对话内容一致。
- 交互定位:点击标记或使用键盘,可跳转到对应的用户消息。
- 智能滚动:
- 距离不超过 5 条消息时使用短距离平滑滚动。
- 更远距离和拖动导航时保持即时定位。
- 高亮与动效:到达目标后使用当前 DSH 主题色突出消息,并尊重系统的“减少动效”设置。
- 连续浏览:拖动导航轨时可连续浏览长对话。
安装与启用¶
使用以下命令将插件安装到 DSH Web profile,然后启动 Web 客户端:
dsh plugin --profile web add dsh-user-message-navigation
dsh web
如果使用的 profile 不是 web,请将命令中的 web 替换为实际名称。
使用方式¶
- 打开一段至少包含 4 条用户消息的 Chat 对话。
- 在对话左侧找到竖向的消息标记。
- 悬停可查看对应消息的文本预览。
- 点击标记即可定位;也可以沿导航轨拖动,连续浏览不同轮次。
注意事项与兼容性¶
- 依赖实现细节:插件依赖现有 DOM 属性(
data-chat-flow、data-chat-flow-kind、data-chat-anchor-key、data-conversation-scroll)。这些是 DSH Web 的实现细节,不是稳定的第三方插件接口。 - 版本兼容:插件当前面向 DeepSeek Harness
0.1.1-rc.2。 - 故障排查:升级 DSH 后如果导航轨不再显示或无法定位,建议先停用插件。
获取与反馈¶
更多细节和源码请访问 GitHub Repository。