前言¶
在使用 DeepSeek Harness 進行長對話時，經常會遇到需要回溯歷史消息的情況。面對堆疊的上下文，手動滾動查找特定指令或回覆非常低效。dsh-msg-index 插件旨在解決這個問題，通過提供一個懸浮的索引面板，幫助用戶快速定位到當前會話中的任意一條用戶消息。
插件簡介¶
這是一個客戶端插件，通過一個懸浮在對話窗口的類磨砂玻璃圓球，提供當前會話用戶消息的索引和快速定位功能。
核心功能¶
- 消息索引：展開後列出當前會話的用戶消息，包含編號和內容預覽。
- 點擊定位：點擊索引條目，頁面會平滑滾動到對應的消息位置。
- 搜索功能：支持按消息編號（數字）或內容（不區分大小寫）實時搜索，並高亮匹配片段。
安裝與啓用¶
使用官方 CLI 安裝最新版本：
dsh plugin --profile web add -w https://github.com/stnt04/dsh-msg-index/releases/latest/download/dsh-msg-index.tgz
安裝後重啓 dsh web。在對話窗口右下角即可看到懸浮圓球。
典型用法¶
- 展開索引：點擊右下角的懸浮圓球展開當前會話的用戶消息索引列表。
- 快速定位：點擊列表中的任意條目，頁面會平滑滾動到對應的消息。
- 加載歷史：點擊列表頂部的“加載更早消息”按鈕，逐頁加載未渲染的歷史數據（插件不會一次性加載全部歷史以避免卡頓）。
- 搜索高亮：使用標題欄的搜索框，輸入編號或內容進行實時預覽和高亮。
適用場景與注意事項¶
該插件適合需要在長對話中頻繁查找特定指令或回覆的用戶。
在使用時需要注意以下幾點：
* 依賴項：頁面行定位依賴 DSH 運行時提供的 data-chat-anchor-key 屬性與主滾動容器的 _scrollBody 類後綴。若 DSH 版本更新導致這些選擇器失效，需同步調整。
* 項目性質：這是一個純自用/留檔項目，代碼以滿足“能跑”爲標準。
* 性能影響：加載較多消息可能導致網頁渲染變慢，但輸入輸出速度未受影響。
結語¶
該插件通過可視化的索引和定位功能，簡化了長對話的導航過程。更多技術細節和使用反饋，請參考 GitHub 倉庫。
