前言¶
DeepSeek Harness（DSH）遵循“一切皆插件”的理念。在長對話中快速定位上下文或查看歷史細節，是智能體開發中的常見需求。dsh-msgrail 是一款針對這一場景的客戶端插件，它在對話區右側邊緣提供垂直分佈的消息索引圓點，支持懸停預覽與點擊跳轉。
插件定位¶
這是一款提供消息索引功能的軌道插件，由 futongxu9-maker 維護。它通過右緣圓點列展示對話結構，支持懸停預覽、點擊跳轉及自動加載歷史，且採用純插件（shell.overlay）架構，不修改宿主代碼，升級 DSH 無憂。
安裝與啓用¶
使用官方插件命令安裝即可：
dsh plugin --profile web add github:futongxu9-maker/dsh-msgrail
安裝完成後刷新頁面，圓點列將自動出現在對話區右緣。
核心功能¶
該插件實現了以下核心能力：
- 消息索引：對話右緣顯示垂直圓點列，每條真實用戶消息對應一個圓點（自動排除插件注入的上下文節點）。
- 懸停預覽：鼠標懸停時，圓點放大高亮，左側彈出包含時間和文本的預覽卡片，文本超過 3 行會自動省略，伴隨淡入上浮動畫。
- 點擊跳轉：點擊圓點可跳轉至對應消息。若該消息尚未加載，插件會自動觸發“加載更早”操作，逐頁追載直至目標消息。
- 全量歷史：數據直接讀取自會話日誌，不依賴前端當前已加載的窗口內容，因此能索引所有歷史記錄。
- 皮膚適配：顏色完全基於 DSH 的語義 token，隨 DeepSeek 主題或任意皮膚（如 Pinkie、龍裔）變化。
- 最新消息常亮：最新一條圓點會顯示得更亮、更醒目。
- 滾動索引：當消息量巨大時，圓點列支持內部滾動，且上下兩端有漸變淡出效果。
典型用法¶
在長對話中，使用滾輪在圓點列內部滾動即可快速瀏覽歷史消息。懸停在某個圓點上，即可在左側查看該消息的詳細內容。點擊圓點，如果消息在當前視圖外，系統會自動加載歷史並跳轉過去。
適用場景與限制¶
該插件適合需要頻繁在長對話中切換上下文的開發者。需要注意兩點限制：首先，跳轉到非常老的未加載歷史時，受限於 DSH 前端分頁機制（每次 50 條）和無虛擬滾動限制，可能需要逐頁加載並伴隨短暫卡頓；其次，圓點列錨定在對話區右緣，在窄窗口或超寬佈局下位置可能偏右，建議在窗口寬度大於 800px 時使用。
結語¶
dsh-msgrail 爲 DSH 用戶提供了輕量級的導航輔助。插件源碼與文檔位於：GitHub，社區目錄頁面爲：SkillHub。
