在 DeepSeek Harness (DSH) 對話中，AI 輸出的文件或目錄路徑通常是純文本。要打開這些路徑，用戶通常需要選中、複製，再粘貼到系統文件管理器中。dsh-file-opener 插件將這類文本轉換爲可交互的元素，點擊即可在右側側邊欄預覽，或調用系統默認程序打開。
插件介紹¶
該插件由用戶 sailoumili 開發，版本 1.4.0，採用 MIT 許可證。它支持 DSH 0.1.7-alpha.1 及以上版本，且零第三方運行時依賴。
安裝¶
Web 版：
在終端執行以下命令：
dsh plugin --profile web add dsh-file-opener
桌面版：
1. 打開 DSH 桌面版，點擊左側欄「插件」。
2. 點擊「添加插件」。
3. 輸入包名 dsh-file-opener，點擊「安裝」。
4. 安裝完成後點擊「立即啓用」，並確認其開關爲打開狀態。
核心功能¶
插件會自動識別對話中的路徑文本，並將其轉換爲可點擊的按鈕。
- 點擊文件路徑：如果文件支持預覽（例如 Markdown、圖片、代碼文件等），則在右側側邊欄顯示；否則調用系統默認程序打開。
- 點擊目錄路徑：在 Windows 上使用資源管理器打開；其他平臺則通過側邊欄處理。
- Shift + 點擊文件路徑：強制調用系統默認程序，忽略預覽邏輯。
- 點擊路徑後的文件夾圖標：點擊文件路徑後的文件夾圖標，可打開其所在目錄；如果是目錄，則打開該目錄本身。
- 點擊不存在的路徑：不報錯，而是打開其所在的那一級真實目錄。
- 路徑識別範圍：支持絕對路徑、
~/...（展開爲當前用戶主目錄）、./與../（按會話工作目錄解析）。 - 行內代碼識別：即使未附帶官方按鈕，只要內容是路徑的行內代碼，同樣可點擊並帶有文件夾圖標。
- 錯誤處理：打開失敗時會給出可見提示，不會靜默失敗。
使用建議¶
爲了讓 AI 回覆中的文件路徑可點擊，建議在 agent 指令文件（如 AGENTS.md）中明確要求 AI 使用反引號包裹完整絕對路徑。例如：
回覆中提到的每個文件或目錄，都必須用反引號包裹完整絕對路徑，例如
C:\work\報告.md。
注意事項¶
由於插件以當前 DSH 進程的權限運行，使用時需注意以下限制：
- 平臺差異：目錄打開僅支持 Windows；其他平臺會退回到側邊欄打開。
- 安全過濾：UNC 網絡路徑（如
\\server\share）與 Windows 保留設備名（CON、PRN、AUX、NUL、COM1-COM9、LPT1-LPT9）不予打開。 - 相對路徑限制：相對路徑無絕對路徑可用時，僅能通過側邊欄打開；Shift 強制系統程序對其無效。
- 工作區外訪問：工作區外的路徑交給側邊欄預覽時，可能因宿主訪問策略返回 403，或文件過大返回 413。此時按住 Shift 點擊用系統程序打開。
- 權限問題：權限不足的路徑會被視爲不存在，表現爲打開其上級目錄。
- 特殊字符：文件名以單引號或反引號結尾時，該字符會被當作標點去掉。
結語¶
該插件通過將路徑交互化，降低了 DSH 對話中文件管理的操作成本。如需查看源碼或反饋問題，可訪問其 GitHub 倉庫。
