DSH 插件 path-click：懸停即開文件或網址

前言¶

DeepSeek Harness (DSH) 的 Web 界面主要用於查看智能體的運行日誌與工具調用結果。在對話記錄中，文件路徑和網址通常以普通文本形式存在。直接點擊這些文本無法達到“打開文件”或“訪問鏈接”的效果，用戶往往需要手動複製粘貼。

path-click 插件通過監聽鼠標懸停事件，解決了這一交互痛點。它能在用戶將鼠標移至文件路徑或網址時，直接彈出氣泡菜單，提供“在資源管理器顯示”或“用瀏覽器打開”的操作選項。

插件定位¶

這是一款 DSH Web 界面插件，由開發者 whw19761006 維護。其核心價值在於將靜態文本路徑轉化爲可交互的操作入口，簡化了本地文件管理與網頁跳轉的流程。

核心功能¶

插件主要提供以下能力：

• 懸停檢測與氣泡菜單：當鼠標懸停在文件路徑或網址上時，會顯示一個縱向佈局的氣泡菜單。
• 資源管理器操作：支持一鍵在 Windows 資源管理器中顯示文件或文件夾。
• 瀏覽器打開：利用默認瀏覽器打開任何文件類型（如 HTML、JS、圖片、日誌等），效果等同於在瀏覽器地址欄輸入 file:// 路徑。
• 網址自動打開：懸停 http/https/file/mailto 鏈接會自動觸發瀏覽器打開動作。
• 工具調用卡片支持：工具調用卡片中包含的文件路徑同樣支持懸停操作。
• 安全限制：爲防止環境變量展開問題，當路徑包含 % 字符時，拒絕通過瀏覽器打開。

安裝¶

在安裝前，請確保已安裝 DSH 以及 pnpm。

通過命令行安裝插件：

dsh plugin --profile web add github:harmony520/path-click

安裝完成後，需要關閉並重新啓動 DSH，然後在瀏覽器頁面按 F5 刷新以加載插件。

使用¶

1. 打開 DSH Web 界面。
2. 將鼠標懸停在任意文件路徑或網址上。
3. 點擊氣泡菜單中的按鈕執行操作（如“在資源管理器顯示”或“用瀏覽器打開”）。

注意事項¶

• 平臺限制：該插件主要針對 Windows 平臺開發。macOS/Linux 的分支代碼存在但未經驗證。
• 依賴關聯：打開文件依賴瀏覽器的默認文件關聯。如果系統無法讀取註冊表，插件會回退到系統默認的打開方式。
• 路徑解析：相對路徑（如工具卡片中的路徑）按宿主進程的 cwd 解析。默認部署下 cwd 爲工作區根目錄；若宿主啓動目錄非工作區根，相對路徑可能解析錯誤。
• 格式處理：路徑尾部的反斜槓會被自動剝離，以避免破壞命令行參數。
• 安全設計：
  • 路由不在 /api 前綴下，僅接受 POST 請求和 JSON 數據。
  • Origin 必須匹配 http://<Host>，且 Host 必須是迴環地址（127.0.0.1, localhost, ::1）。
  • 僅允許 http、https、file、mailto 協議。
• 文本匹配：在“思考過程”等大段純文本中嵌入的路徑不支持懸停，插件僅識別“內容恰好是路徑”的文本。