前言¶

用 DSH 做智能體開發，聊天窗口裏每天都會滾過大量文件路徑和鏈接：助手回覆裏列出一串改動過的文件，工具卡片裏引用產物，代碼塊裏出現日誌位置，用戶氣泡裏直接貼着 URL。Web GUI 把這些渲染成普通文本——想看其中某個文件，你得手動打開文件管理器，沿着路徑逐級點進去；遇到裸 URL，還得先複製、再切到瀏覽器粘貼。單個動作不大，次數多了很打斷節奏。

dsh-pathlink 把這一步壓縮成一個按鍵：Ctrl+click 路徑，文件管理器打開所在文件夾並選中該文件；Ctrl+click 鏈接，新瀏覽器標籤頁直接打開。下面介紹它的定位、實現和用法。

這是什麼¶

dsh-pathlink 是 penguin-oo 維護的 DeepSeek Harness 插件，當前版本 0.1.3，MIT 許可證。DSH 的理念是一切皆插件，這類界面增強自然也以插件形式提供。

插件分兩半：

• 客戶端半部跑在 web GUI 裏（dsh.client，platform web），負責識別消息中的路徑與鏈接、接管點擊；
• 宿主半部是一個 pathlink Remote 服務，負責解析路徑並啓動操作系統的文件管理器。

核心功能¶

• 識別已渲染聊天消息中的文件路徑與 URL，覆蓋助手回覆、用戶氣泡、代碼塊、工具卡片，識別結果以虛線下劃線標記；
• Ctrl+click（macOS 爲 ⌘）路徑：在 OS 文件管理器中打開所在文件夾並選中該文件；路徑指向目錄時，打開該目錄本身；
• Ctrl+click（macOS 爲 ⌘）鏈接：在新瀏覽器標籤頁打開，覆蓋渲染器未自動鏈接化的裸 URL，比如用戶氣泡中直接貼的 URL；
• 普通點擊保持惰性，不干擾文本選擇與複製；路徑不存在時彈出 toast 說明，不靜默失敗；
• 提供配置項 maxPathChars（默認 1024），限制接受的最長路徑文本字符數。

實現方式¶

客戶端半部是一個由 MutationObserver 驅動的掃描器，監視渲染會話容器（data-chat-flow / data-conversation-scroll），在文本節點中識別路徑與 URL，把匹配結果包裹爲惰性內聯 span；點擊處理只用一個捕獲階段委託監聽。它刻意不使用官方 chatFileMentions seam，目的是避免與內置 deliverables provider 衝突，同時統一覆蓋所有渲染面。

宿主半部只暴露一個只讀的 open 方法：按目標會話的工作目錄解析相對路徑，校驗存在性，然後啓動平臺文件管理器。沒有持久狀態，也不會創建或恢復 Agent / Session。

安裝與啓用¶

官方安裝命令：

dsh plugin --profile web add dsh-pathlink

這一條把插件安裝到 web profile。也可以用 GitHub 形式：

dsh plugin --profile web add github:penguin-oo/dsh-pathlink

安裝後重啓 web GUI。插件要求 web profile——瀏覽器是唯一能接收點擊的界面。

典型用法¶

完成安裝並重啓 web GUI 後，按下面的順序使用：

1、等待一條包含路徑或鏈接的已穩定消息。被識別的 token 會帶虛線下劃線，這是判斷插件是否生效的直接方式。

2、按住 Ctrl（macOS 爲 ⌘）並點擊：

• 路徑 → 在 OS 文件管理器中打開所在文件夾並選中文件；
• 鏈接 → 在新瀏覽器標籤頁打開。

3、相對路徑先按會話工作區目錄解析，再按 harness 工作目錄解析；兩處都找不到時顯示 toast 提示。

路徑的打開動作由宿主按平臺分派：

Windows  explorer /select
macOS    open -R
Linux    xdg-open（對父目錄）

配置方面，插件目前只有一個配置項：

maxPathChars = 1024   # 默認值

含義是接受的最長路徑文本字符數。

適用場景與注意¶

適合的情況：如果你整天在 web GUI 裏讀助手回覆、覈對產物文件，這個插件省掉的是「看路徑 → 打開管理器 → 逐級導航 → 找到文件」這個循環。

注意幾點：

1、僅支持 Web GUI，能接收點擊的界面是瀏覽器；宿主打開器覆蓋 Windows / macOS / Linux。

2、路徑識別是啓發式的：CJK 目錄名可以保留，但末段爲無擴展名純英文單詞、且緊跟正文的路徑可能偶爾被過度匹配。這種時候存在性檢查會顯示未找到 toast，不會打開錯誤的內容。

3、權限與安全：插件以當前 dsh 進程的權限運行，宿主半部會調用操作系統的文件管理器。安裝前建議先檢查源碼與許可證，本項目爲 MIT。

結尾¶

dsh-pathlink 解決的是一個很小的痛點，但路徑和鏈接是智能體開發中出現頻率最高的內容之一，一次 Ctrl+click 的收益會隨使用時間累積。插件體量不大，源碼可以直接讀完再決定是否安裝。

入口：

• 社區目錄頁：https://www.skillhub.cn/plugins/penguin-oo/dsh-pathlink
• 源碼倉庫：https://github.com/penguin-oo/dsh-pathlink

其中目錄頁是社區維護的獨立站點，與 DeepSeek / 幻方無官方從屬關係。