在 DeepSeek Harness (DSH) Web GUI 中进行长对话调试时，快速定位用户的提问往往需要频繁滚动。dsh-question-nav 插件在对话列的左侧或右侧边缘提供了一条圆点迷你地图，用于快速定位。
插件定位¶
这是一个针对 DSH Web GUI 的会话内提问导航器。它由 AbelKeithsun 维护，通过在对话边缘嵌入一个垂直的圆点轨道，将用户的历史提问映射为可视化的节点。
核心功能¶
插件具备以下特性：
- 边缘对齐的迷你地图：圆点轨道位于对话列的左侧或右侧边缘（可在设置中切换），轨道嵌入在界面中，不预留额外宽度。
- 高度限制与滚动：轨道高度限制为对话高度的 60%，超出部分可在该区域内滚动查看。
- 提问映射：每个圆点代表一次提问，与 Trajectory 视图的回合编号严格对齐。
- 全历史持久化：记录所有历史提问，数据持久化，不通过扩展渲染窗口来展示内容。
- 悬停聚焦：悬停在圆点上时，圆点及其上下相邻的两个邻居会放大。同时，会在圆点旁展示一个垂直堆叠的卡片列表（共 5 个），显示完整提问文本和发送时间（同日显示 HH:MM，跨日显示 MM-DD HH:MM）。
- 点击跳转：点击圆点或对应的卡片，即可跳转到该提问在聊天窗口中的位置。
- 溢出控制：当提问数量较多超出 60% 高度限制时，轨道上方会出现 ▲ 按钮，下方会出现 ▼ 按钮。点击可翻页显示更多圆点，翻页大小可配置（默认 5 个）。
- 零依赖：客户端通过外部化调用 DSH Shell，不占用额外的运行时资源。
安装与启用¶
安装前需确保环境满足 Node.js 版本要求（Node.js >= 20）。
- 安装命令：
dsh plugin --profile web add @luziyang2026/dsh-question-nav
重启 Web GUI 后，插件将自动加载。
- 版本选择：
插件发布了两条版本线：- latest：稳定版，匹配 DSH SDK 0.1.1-rc.1 线，适用于大多数日常使用。
- alpha：Alpha 版，匹配 Alpha GUI 专用 SDK 线。
典型用法¶
- 查看详情：将鼠标悬停在边缘的圆点上，查看完整的问题文本和发送时间。
- 快速跳转：点击圆点或悬停时出现的上下文卡片，聊天窗口会自动滚动并定位到对应的提问消息。
注意事项¶
- Alpha GUI 兼容性：如果使用的是 Alpha GUI，必须安装
alpha版本线，否则功能会降级（仅显示投影点）。 - 空区域交互：轨道的空区域不会阻挡聊天交互，不影响正常的消息输入和阅读。
- 配置调整：可以通过设置菜单调整轨道对齐方式（左/右）以及单页显示的圆点数量（3/5/8/10）。
总结¶
dsh-question-nav 通过可视化的边缘导航，解决了长对话中定位用户提问繁琐的问题。它不改变聊天窗口布局，仅以轻量级的方式提供全历史的快速索引能力。
- GitHub 仓库：abelkeithsun/dsh-question-nav
- 插件目录：dsh-question-nav
