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 進程權限運行，安裝前建議檢查源碼與許可證。