在 DeepSeek Harness (DSH) Web GUI 中進行長對話調試時，快速定位用戶的提問往往需要頻繁滾動。dsh-question-nav 插件在對話列的左側或右側邊緣提供了一條圓點迷你地圖，用於快速定位。
插件定位¶
這是一個針對 DSH Web GUI 的會話內提問導航器。它由 AbelKeithsun 維護，通過在對話邊緣嵌入一個垂直的圓點軌道，將用戶的歷史提問映射爲可視化的節點。
核心功能¶
插件具備以下特性：
- 邊緣對齊的迷你地圖：圓點軌道位於對話列的左側或右側邊緣（可在設置中切換），軌道嵌入在界面中，不預留額外寬度。
- 高度限制與滾動：軌道高度限制爲對話高度的 60%，超出部分可在該區域內滾動查看。
- 提問映射：每個圓點代表一次提問，與 Trajectory 視圖的回合編號嚴格對齊。
- 全歷史持久化：記錄所有歷史提問，數據持久化，不通過擴展渲染窗口來展示內容。
- 懸停聚焦：懸停在圓點上時，圓點及其上下相鄰的兩個鄰居會放大。同時，會在圓點旁展示一個垂直堆疊的卡片列表（共 5 個），顯示完整提問文本和發送時間（同日顯示 HH:MM，跨日顯示 MM-DD HH:MM）。
- 點擊跳轉：點擊圓點或對應的卡片，即可跳轉到該提問在聊天窗口中的位置。
- 溢出控制：當提問數量較多超出 60% 高度限制時，軌道上方會出現 ▲ 按鈕，下方會出現 ▼ 按鈕。點擊可翻頁顯示更多圓點，翻頁大小可配置（默認 5 個）。
- 零依賴：客戶端通過外部化調用 DSH Shell，不佔用額外的運行時資源。
安裝與啓用¶
安裝前需確保環境滿足 Node.js 版本要求（Node.js >= 20）。
- 安裝命令：
dsh plugin --profile web add @luziyang2026/dsh-question-nav
重啓 Web GUI 後，插件將自動加載。
- 版本選擇：
插件發佈了兩條版本線：- latest：穩定版，匹配 DSH SDK 0.1.1-rc.1 線，適用於大多數日常使用。
- alpha：Alpha 版，匹配 Alpha GUI 專用 SDK 線。
典型用法¶
- 查看詳情：將鼠標懸停在邊緣的圓點上，查看完整的問題文本和發送時間。
- 快速跳轉：點擊圓點或懸停時出現的上下文卡片，聊天窗口會自動滾動並定位到對應的提問消息。
注意事項¶
- Alpha GUI 兼容性：如果使用的是 Alpha GUI，必須安裝
alpha版本線，否則功能會降級（僅顯示投影點）。 - 空區域交互：軌道的空區域不會阻擋聊天交互，不影響正常的消息輸入和閱讀。
- 配置調整：可以通過設置菜單調整軌道對齊方式（左/右）以及單頁顯示的圓點數量（3/5/8/10）。
總結¶
dsh-question-nav 通過可視化的邊緣導航，解決了長對話中定位用戶提問繁瑣的問題。它不改變聊天窗口布局，僅以輕量級的方式提供全歷史的快速索引能力。
- GitHub 倉庫：abelkeithsun/dsh-question-nav
- 插件目錄：dsh-question-nav
