前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過社區插件擴展功能。在處理長對話或歷史記錄時，快速定位到特定的用戶提問通常需要手動滾動，效率較低。dsh-bookmark 插件通過在對話側邊欄添加導航標記，解決了這個問題，提供了類似 Codex 的導航體驗。
插件介紹¶
dsh-bookmark 是由用戶 leilei3167 維護的一個客戶端插件。它爲 DSH Web UI 提供對話導航功能，在對話左側的邊緣區域放置緊湊的標記，每個標記對應一個用戶或引導消息。
安裝與啓用¶
安裝該插件需要使用 DSH 的插件管理命令。安裝後需要重啓 Web 客戶端以加載新功能。
安裝命令如下：
dsh plugin --profile web add github:leilei3167/dsh-bookmark
安裝完成後，需要完全停止並重啓 dsh web 進程，以確保瀏覽器端接收到新的客戶端包：
dsh web
若要更新已安裝的插件，可以使用以下命令：
dsh plugin --profile web update dsh-bookmark
更新後同樣需要重啓 dsh web。
核心功能¶
該插件實現了以下核心能力：
- 消息標記：每個用戶或引導消息都會生成一個標記。
- 緊湊展示與交互：標記尺寸爲 12px，懸停時會展開，並呈現 Codex 風格的三級級聯效果。
- 當前位置高亮：視口錨點附近的標記會顯示爲黑色，指示當前閱讀位置。
- 懸停預覽：懸停時，卡片會顯示用戶消息的標題以及下一條助手回覆的預覽。
- 直接導航：點擊標記或使用鍵盤快捷鍵，可以直接平滑滾動到對應的對話回合。
- 會話跟隨：插件會自動跟隨當前選中的會話，包括已保存的對話歷史。
- 歷史加載：當查看舊會話時，插件會通過原生的 DSH 會話 API 加載歷史記錄。
- 響應式佈局：當側邊欄或對話佈局發生變化時，插件會自動重新定位。
典型用法¶
使用該插件主要涉及三種交互方式：
- 懸停預覽：鼠標懸停在標記上，標記及其附近的標記會展開，顯示用戶提問和助手回覆的預覽。
- 點擊跳轉：點擊標記，頁面會平滑滾動到對應的用戶消息處。
- 鍵盤導航：
- 使用
ArrowUp或ArrowDown鍵聚焦標記。 - 使用
Enter或Space鍵觸發標記對應的滾動或按鈕動作。
- 使用
注意事項與適用場景¶
- 運行環境：該插件完全在 DSH Web 客戶端內部運行，不會讀取 API 密鑰，也不會將對話內容發送到外部服務。
- 數據來源：對話數據僅從活動的 DSH 會話快照和已渲染的聊天節點中讀取，並保留在瀏覽器內存中。
- 技術實現：插件使用
[data-chat-anchor-key]和[data-chat-flow-kind]屬性來關聯標記與消息。DOM 選擇器僅作爲兼容性回退；插件不使用哈希主機類名。 - 生態發現：倉庫使用了
deepseek-harness、dsh和dsh-plugin作爲 GitHub 主題，以便 DSH 插件發現工具能夠檢索到它。 - 許可證：插件採用 MIT 許可證。
結語¶
dsh-bookmark 爲 DSH Web UI 提供了基礎的對話導航能力，適合需要在長對話中快速定位上下文的場景。安裝前建議檢查其源碼與許可證。更多詳情可訪問 GitHub 倉庫 或 DSH 社區目錄。
