在 DeepSeek Harness (DSH) Web 界面进行智能体开发或调试时,面对长对话上下文,定位具体的用户提问与助手回复往往需要手动滚动,操作成本较高。dsh-conversation-navigator 插件通过在聊天界面左侧增加导航栏,实现了对话回合的快速定位与预览。
这是一个由 wang122818 维护的客户端插件。它为 DSH Web 的聊天流程左侧添加了一个基于回合的导航栏,帮助开发者快速在对话历史中跳转。
核心功能¶
- 导航栏显示:在聊天流左侧增加导航轨道。
- 回合标记:每个标记对应一条用户消息及其后续的助手回复,构成 DSH 的完整对话回合边界。
- 视口高亮:自动高亮与视口中心相交的标记。
- 悬停预览:鼠标悬停在标记上时,会显示用户消息的开头内容。
- 点击跳转:点击标记可平滑滚动到对应的对话回合。
- 属性读取:插件读取 DSH 聊天流已发出的稳定属性,包括
data-conversation-scroll、data-chat-flow-kind和data-chat-anchor-key。
安装与启用¶
在终端中执行以下命令安装插件:
dsh plugin --profile web add D:\dsh-locateHistory
安装完成后,需要重启现有的 DSH Web 进程,并在浏览器中刷新 http://127.0.0.1:3080 以使插件生效。
典型用法¶
- 在左侧导航栏查看对话回合列表。
- 将鼠标悬停在某个标记上,查看该回合对应的用户消息开头。
- 点击对应的标记,页面会平滑滚动到该对话回合的位置。
适用场景与注意事项¶
该插件专为 DSH Web 客户端设计。
- 移动端适配:当视口宽度小于 900px 时,导航栏会自动隐藏,以避免与移动端聊天布局重叠。
- 未完成对话:对于尚未收到助手回复的新用户消息,系统仍将其显示为当前开放的回合。
- 权限与安全:作为插件,它在当前 DSH 进程权限下运行。安装前建议查看源码与许可证(MIT)。
总结¶
dsh-conversation-navigator 通过读取 DSH 内置的稳定属性并注入导航交互,降低了长对话上下文的定位成本。更多技术细节与源码,可参考 GitHub 仓库。