前言¶
在使用 DeepSeek Harness（DSH）进行智能体调试或对话开发时，对话上下文往往较长。在长对话中快速定位到特定的用户提问，通常需要手动滑动查找，效率较低。dsh-user-question-nav 插件在对话区域右侧提供一个胶囊轨道，允许用户通过悬停或点击快速跳转至对应位置，提供类似 ChatGPT 的导航体验。
安装与启用¶
该插件属于客户端插件，需要 DeepSeek Harness Desktop 环境支持。
1、确保 DeepSeek Harness Desktop 已安装并运行过一次。
2、在终端执行安装命令：
dsh plugin --profile desktop add dsh-user-question-nav
3、安装完成后，Cmd+Q 退出 DSH Desktop，重新打开即可生效。
核心功能¶
插件在对话区右侧悬浮显示一个胶囊轨道，包含上下箭头（⏫⏬）和刻度线。刻度线与对话中的用户问题一一对应。
胶囊轨道与抽屉¶
鼠标悬停在刻度区域并保持 1 秒后，贴边抽屉会自动滑出，展示所有用户问题列表。若鼠标快速扫过或提前离开，抽屉不会打开，避免误触。
抽屉内包含：
* 搜索框：输入关键词可实时筛选问题列表，计数文案在「共 N 条」与「筛出 N 条」间切换。
* 问题列表：每行显示「序号 · 问题原文」。
导航与跳转¶
- 一键平滑跳转：在抽屉中点击任意一行，对话区域会平滑滚动至对应问题位置。
- 刻度同步高亮：滚动对话时，胶囊轨道上的刻度会自动更新。当前问题对应的刻度会显示为品牌蓝色，鼠标悬停的刻度会加深显示。
边界处理与校准¶
- 边界气泡提示：到达第一条或最后一条问题时，对应的箭头会变灰但仍可点击。点击已变灰的箭头时，会弹出气泡提示「已经是第一个问题」或「已经是最后一个问题」，1.5 秒后自动消失。
- 位置漂移自动校准：对话区域因折叠/展开面板等操作产生整体位移时，低频定时器（1 秒间隔）会检测位置变化，若漂移超过阈值，会自动校准轨道与抽屉的位置。
- 会话自动重挂载：切换会话时，插件会自动检测并重新挂载到新的对话容器。
注意事项¶
- 交互逻辑：边界箭头仅变灰，不设为禁用状态。这是为了防止用户误以为功能已损坏，点击时通过气泡提示引导。
- 权限：插件以 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。
- 位置校准：如果遇到位置漂移，通常会在 1 秒内自动修正。
后记¶
该插件通过胶囊轨道与贴边抽屉的结合，解决了长对话中查找特定问题的痛点。经过校准与重挂载机制，保证了在复杂布局下的稳定性。
