DSH Message Navigator：DeepSeek Harness 消息导航插件

前言¶

在 DeepSeek Harness (DSH) 的对话场景中，随着上下文消息数量的增加，在长列表中定位到特定的历史节点通常需要繁琐的滚动操作。dsh-message-navigator 插件在左侧边栏右侧增加了一条导航条，通过索引消息来辅助定位，提供类似 ChatGPT 的导航体验。

核心功能¶

该插件主要解决消息导航与定位问题，具体能力如下：

• 消息索引与定位
  索引当前会话中可见的普通用户消息和插话，按会话顺序绘制标记。点击标记后，视图会平滑滚动到对应聊天节点，支持键盘操作和屏幕阅读器。

• 悬停预览与视觉样式
  导航标记始终贴在左侧边栏右侧，随侧栏展开、收起和拖动同步定位。

  • 标记样式：统一左对齐，2px 厚度；普通、当前、悬停标记的宽度比例为 1:1.5:4。
  • 间距处理：标记间距默认固定为 7px，仅在总高度超过聊天视图可用高度时动态压缩；悬停时相邻标记按距离依次缩短。
  • 内容预览：鼠标悬停或键盘聚焦标记时，会在原有气泡中显示本轮问答：用户消息支持多行半粗显示，助手回答使用灰色文字。支持纯文本、图片、文件和混合附件的稳定预览。

• 智能加载与适配
  聊天视图打开后，插件会自动按 DSH 正式分页接口加载更早历史，直到当前会话的所有用户消息进入导航。

  • 显示逻辑：仅在聊天视图存在可见消息锚点时显示，切换到其他会话视图会自动隐藏。
  • 主题与布局：使用 DSH 主题 token，兼容浅色和深色主题，并适配窄屏。它不替换会话视图，仅占用 conversation.session.header.utilities 增量 Slot。

安装与启用¶

使用 DSH CLI 安装最新稳定版（v1.0.2）：

dsh plugin --profile web add github:yx-yinhe/dsh-message-navigator#v1.0.2

安装后重启对应 Web Profile 即可生效。

典型用法¶

1. 打开聊天视图，左侧边栏右侧会出现消息导航标记。
2. 将鼠标悬停在标记上，或使用键盘聚焦，即可在原有气泡中查看本轮问答的预览内容。
3. 点击标记，视图会平滑滚动定位到对应的聊天节点。

注意事项¶

该插件依赖 DSH 聊天视图公开的语义锚点 data-chat-anchor-key。若 DSH 更改锚点名称，需同步更新 findChatAnchor。
插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。