前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在超长对话场景下，快速定位历史提问是智能体开发中的常见需求。dsh-query-jump 是由社区开发者 SocFeng 提供的一个轻量级插件，旨在解决长会话中查找特定提问的问题。
它在对话区右侧边缘绘制一条淡色短横线，通过悬停交互展示历史提问列表，并提供平滑滚动定位功能。
核心功能¶
- 仅收录真实用户提问：列表中仅包含用户发送的 Query，附带日期与时间，不包含注入消息或工具事件。
- 平滑跳转：点击列表条目，页面会平滑滚动至对应的对话气泡。
- 当前位置高亮：当前正在阅读的条目会以浮起样式高亮显示。
- 低调轨道设计：平时几乎不占据视觉空间，仅当鼠标悬停时才展开列表。
- 自定义前缀：支持自定义列表前缀，例如使用符号或序号。
- 设置页集成：提供完整的配置界面。
- 同步历史提问：安装后，插件会尝试从会话日志中补全安装前未记录的历史提问。
- 删除会话：提供永久删除会话的入口（可通过设置开关），这是对官方未暴露能力的补充。
- 缓存同步：在删除会话、删除工作区或分叉操作时，缓存会自动对齐。
- 持久化：重启 WebUI 或更新插件后，列表状态通常会保留。
安装¶
使用以下命令通过 DSH CLI 安装插件：
dsh plugin --profile web add github:SocFeng/dsh-query-jump
安装完成后，建议重启 dsh web 进程，并在浏览器中执行硬刷新（Ctrl + F5）以加载最新资源。
使用方法¶
- 打开任意会话，观察对话区右侧边缘的淡色短横线。
- 将鼠标移动到短横线区域，列表会自动展开，显示该会话中的历史提问。
- 点击列表中的某一项，页面会平滑滚动至对应的提问气泡。
- 点击完成后，列表保持展开状态，移开鼠标后列表会自动收起。
配置¶
进入 DSH WebUI 的 设置 -> 插件 -> Query 定位 页面进行配置。
可用选项包括：
- 启用面板：总开关。
- 同步历史提问：是否按时间线补全未记录的 Query。
- 显示删除会话：控制标题栏垃圾桶图标与侧栏删除入口的显示。
- 自定义符号 / 序号：设置列表前缀样式。
- 符号内容：最多 8 个字符，默认为 🤗。
配置也可写入 profile 文件：
config:
enable: true
markerStyle: emoji
markerSymbol: "🤗"
syncHistoricalQueries: true
showDeleteSession: true
适用场景与注意¶
该插件适合需要频繁在超长对话中回溯上下文的智能体开发场景。
需要注意以下几点：
- 建议在本地 127.0.0.1 访问 WebUI。
- 遇到很早的历史提问时，系统会先自动加载更早的内容，稍等片刻即可。
- 安装时若出现 peer 依赖的 WARN 提示，通常可以忽略。
- 插件不收录注入消息或工具事件。
- 它可以与其他插件（如 Trajectory）共存。
结语¶
dsh-query-jump 通过极简的右缘轨道设计，解决了长对话中的导航痛点。对于习惯在 DSH 中进行多轮调试的开发者，这是一个提升效率的实用工具。
