前言¶

在 DSH 的長對話裏，用戶消息越多，定位某一條舊消息越不方便。手動滾動容易越過目標，尤其在消息和回覆交錯時。dsh-plugin-msg-nav 爲這類場景提供一個輕量入口：在對話區右緣渲染一列短橫線節點串，把每條真實用戶消息映射爲一個節點，並支持懸停預覽、點擊跳轉和滾動瀏覽。

這是什麼¶

dsh-plugin-msg-nav 是一個 DeepSeek Harness（DSH）插件，維護者爲 SherUnlocked-4869，許可證爲 MIT。它安裝在 DSH 的 web profile 中，面向對話視圖提供導航能力。插件核心目標是讓長會話中的用戶消息可以快速定位、預覽和跳轉。

核心能力¶

• 在對話區右緣渲染縱向短橫線節點串，每條真實用戶消息一個節點。
• 節點激活狀態隨閱讀位置即時更新。
• 鼠標進入節點串區域時，節點條變形爲單行消息預覽面板；移出後恢復。
• 預覽面板每條消息一行，最多顯示 10 條；超過時可在懸停區域內用滾輪上下滑動列表。
• 點擊預覽可平滑跳轉到對應消息，並顯示高亮橫線。
• host 側會話投影使進入會話時無需逐頁拉取即可覆蓋全部用戶消息。
• 點擊尚未入窗的舊消息節點時，按需拉取更早歷史後再跳轉。
• 用戶消息少於 2 條、空白會話或非對話視圖時自動隱藏。

安裝與啓用¶

下面以 web profile 爲例。先執行安裝命令：

dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-nav

隨後啓動或重啓部署，使 bundle 變更生效：

dsh web

如果頁面已經打開，刷新頁面通常即可拿到新 bundle。

更新到最新版本：

cd ~/.dsh/profiles/web && pnpm update dsh-plugin-msg-nav

卸載：

dsh plugin --profile web remove dsh-plugin-msg-nav

使用方式¶

先打開一個處於對話視圖的會話。當前會話至少要有 2 條真實用戶消息，右緣纔會出現節點串。

1、滾動對話區，觀察右側節點串的激活狀態是否跟隨閱讀位置變化。

2、鼠標進入節點串區域，查看彈出的單行消息預覽面板。

3、如果預覽超過 10 條，在懸停區域內使用滾輪上下滑動列表。

4、點擊目標消息，頁面平滑跳轉到對應消息，並顯示高亮橫線。

5、如果目標消息是尚未入窗的舊消息，插件會按需拉取更早歷史後再跳轉。

運行細節與注意¶

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• package.json 聲明 peerDependencies 中 react ^18.2.0 且爲 optional。
• bundle 變更需重啓部署；刷新頁面通常即可拿到新 bundle。
• 未掛載投影註冊表的部署會自動回退到後臺逐頁加載，每頁 50 條、至多 120 頁。
• 節點串不會在以下情況顯示：用戶消息少於 2 條、空白會話、非對話視圖。

鏈接¶

目錄頁：

• https://www.skillhub.cn/plugins/SherUnlocked-4869/dsh-plugin-msg-nav

GitHub：

• https://github.com/SherUnlocked-4869/dsh-plugin-msg-nav