前言¶
在使用 DeepSeek Harness（DSH）進行智能體調試或對話開發時，對話上下文往往較長。在長對話中快速定位到特定的用戶提問，通常需要手動滑動查找，效率較低。dsh-user-question-nav 插件在對話區域右側提供一個膠囊軌道，允許用戶通過懸停或點擊快速跳轉至對應位置，提供類似 ChatGPT 的導航體驗。
安裝與啓用¶
該插件屬於客戶端插件，需要 DeepSeek Harness Desktop 環境支持。
1、確保 DeepSeek Harness Desktop 已安裝並運行過一次。
2、在終端執行安裝命令：
dsh plugin --profile desktop add dsh-user-question-nav
3、安裝完成後，Cmd+Q 退出 DSH Desktop，重新打開即可生效。
核心功能¶
插件在對話區右側懸浮顯示一個膠囊軌道，包含上下箭頭（⏫⏬）和刻度線。刻度線與對話中的用戶問題一一對應。
膠囊軌道與抽屜¶
鼠標懸停在刻度區域並保持 1 秒後，貼邊抽屜會自動滑出，展示所有用戶問題列表。若鼠標快速掃過或提前離開，抽屜不會打開，避免誤觸。
抽屜內包含：
* 搜索框：輸入關鍵詞可實時篩選問題列表，計數文案在「共 N 條」與「篩出 N 條」間切換。
* 問題列表：每行顯示「序號 · 問題原文」。
導航與跳轉¶
- 一鍵平滑跳轉：在抽屜中點擊任意一行，對話區域會平滑滾動至對應問題位置。
- 刻度同步高亮：滾動對話時，膠囊軌道上的刻度會自動更新。當前問題對應的刻度會顯示爲品牌藍色，鼠標懸停的刻度會加深顯示。
邊界處理與校準¶
- 邊界氣泡提示：到達第一條或最後一條問題時，對應的箭頭會變灰但仍可點擊。點擊已變灰的箭頭時，會彈出氣泡提示「已經是第一個問題」或「已經是最後一個問題」，1.5 秒後自動消失。
- 位置漂移自動校準：對話區域因摺疊/展開面板等操作產生整體位移時，低頻定時器（1 秒間隔）會檢測位置變化，若漂移超過閾值，會自動校準軌道與抽屜的位置。
- 會話自動重掛載：切換會話時，插件會自動檢測並重新掛載到新的對話容器。
注意事項¶
- 交互邏輯：邊界箭頭僅變灰，不設爲禁用狀態。這是爲了防止用戶誤以爲功能已損壞，點擊時通過氣泡提示引導。
- 權限：插件以 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
- 位置校準：如果遇到位置漂移，通常會在 1 秒內自動修正。
後記¶
該插件通過膠囊軌道與貼邊抽屜的結合，解決了長對話中查找特定問題的痛點。經過校準與重掛載機制，保證了在複雜佈局下的穩定性。
