前言¶
DSH 的插件機制允許在 Web GUI 上擴展界面能力。長對話裏，用戶提示詞容易被上下文、工具輸出和後續消息淹沒，想回看“某一次我問了什麼”時，手動滾動和搜索都不夠直接。
dsh-conversation-minimap 是一個 DSH Web GUI 客戶端插件，把每個用戶提示詞映射爲左側導航軌上的錨點，用來快速定位長對話中的關鍵輸入。
DSH 社區目錄是獨立插件站點，不代表 DeepSeek / 幻方官方應用商店；安裝插件前，仍需要按項目要求確認來源、權限和許可證。
這是什麼¶
dsh-conversation-minimap 是 Braidy-Wu 維護的 DSH Web GUI 插件，定位爲“提示詞級對話迷你地圖”。
它解決的問題是：長對話中，用戶提示詞對應的消息位置不容易找。插件把每個用戶提示詞映射成一個錨點膠囊，沿左側導航軌均勻分佈並居中顯示，提供類似桌面聊天軟件裏的會話導航軌體驗。
核心功能¶
導航與定位¶
- 每個用戶提示詞對應一個錨點膠囊，沿導航軌均勻分佈並居中。
- 懸停錨點時顯示完整提示詞預覽。
- 點擊錨點後平滑滾動到對應消息，並高亮 2 秒。
- 藍色發光高亮跟隨當前提示詞；窗口尺寸變化後視圖回到底部。
視覺表現¶
- 魚眼放大：錨點條在光標下方按高斯鐘形曲線放大，峯值爲 44px，並在放大區域內保持放大。
- 頂部和底部邊緣漸隱。
- 超出可見區域的錨點淡出，且不超出導航軌邊界。
數據與穩定性¶
- 通過官方
ctx.sessions與conversation.loadOlder()API 拉取完整歷史，使長對話中的提示詞都能被導航。 - 純 vanilla JS 客戶端插件，無構建步驟、無依賴。
- 異常被 try/catch 保護；如果插件內部失敗，只禁用 minimap，不影響 GUI。
安裝與啓用¶
插件面向 DSH Web 客戶端使用。使用插件名安裝：
dsh plugin --profile web add dsh-conversation-minimap
也可以從 GitHub 倉庫安裝：
dsh plugin --profile web add github:Braidy-Wu/dsh-conversation-minimap
安裝後重啓 dsh web：
dsh web
典型用法¶
默認安裝後即可使用。若需要調整顯示條件或錨點尺寸，可在 cordis.patch.yml 中配置以下可選字段：
enabled: true
minPrompts: 4
anchorSize: 3
字段說明如下：
enabled：總開關，設爲false時不加載 minimap。minPrompts：會話中至少有多少個用戶提示詞時顯示導航軌，默認4，範圍0-100。anchorSize：錨點條高度，單位 px，默認3，範圍2-8。
修改 cordis.patch.yml 後需要重啓 dsh web：
dsh web
開發或源碼檢查時，可以運行語法檢查：
node --check client.js index.js
適用場景與注意¶
適合在 DSH Web 裏處理較長會話，並且經常需要按“我上一句問了什麼”快速跳轉回對應位置的開發者。它適合希望增加輕量導航、又不想引入複雜前端構建鏈的場景。
需要注意：
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼、依賴關係和許可證。 - 許可證爲 MIT。
- 運行環境要求
node >=22.19.0。 - 配置項均爲可選，修改後需重啓
dsh web。
結尾¶
dsh-conversation-minimap 的價值在於把長對話裏的用戶提示詞變成一條可視、可點、可定位的導航軌。它的安裝成本低，配置可選，失敗時也儘量不破壞原有 GUI。
GitHub 倉庫：
https://github.com/Braidy-Wu/dsh-conversation-minimap
插件線索中給出的目錄頁地址（未在本次已抓取資料中確認）：
https://www.skillhub.cn/plugins/Braidy-Wu/dsh-conversation-minimap
