DeepSeek Harness 插件：dsh-files-pane —— 在線瀏覽與閱讀文件

前言¶

在 DeepSeek Harness（DSH）Web 界面中，點擊會話裏的文件鏈接通常調用 remote.session.openWorkspacePath。在無頭主機或遠程環境下，這會嘗試調用系統的原生打開器（如 xdg-open），而瀏覽器無法執行此操作。dsh-files-pane 插件攔截了這一調用，在聊天界面內提供一個獨立的“文件”視圖標籤，直接在瀏覽器中瀏覽和讀取文件。

插件簡介¶

名稱：dsh-files-pane
維護者：liooil
定位：DSH 網頁“文件”視圖標籤。它提供兩欄目錄導航，並支持就地閱讀文件內容。該插件不改變主窗體佈局，而是複用聊天窗口的 Markdown 與代碼渲染器。

核心功能¶

1. 文件作爲會話視圖標籤
   在“對話”和“軌跡”標籤旁增加第三個標籤頁，全寬顯示。該視圖獨立存在，不使用浮動窗口或側邊欄接管。
2. 點擊穿透
   會話中的工具卡片、@path 提及以及生成的文件引用點擊後，會直接在此標籤頁打開，並自動選中該標籤。
3. 複用渲染器
   文本內容通過聊天窗口自帶的 MarkdownText 渲染，代碼塊使用自帶的 Shiki 高亮，保證視覺一致性。
4. 相對圖片支持
   支持 Markdown 中的相對圖片語法（如 ![](./img/x.png)），圖片會從主機讀取並渲染在 Markdown 文本旁。
5. 兩欄導航
   左側爲父級目錄，右側爲當前目錄，支持快速切換，無需頻繁返回上級。
6. 可編輯路徑
   點擊頂部的加粗文件名，輸入路徑並回車即可導航。支持 ~ 展開，輸入文件路徑顯示內容，輸入目錄路徑顯示列表。

安裝與啓用¶

安裝插件後需要重啓 DSH 服務才能生效。

通過包管理器安裝：

dsh plugin add dsh-files-pane

後續操作：
安裝完成後，重啓 DSH 服務。可以通過以下命令重啓（具體方式取決於主機管理方式）：

systemctl --user restart dsh

注意事項：
* 不要同時從兩個來源掛載同一個包（例如既通過本地路徑掛載，又通過包管理器安裝），這會導致客戶端模塊掃描失敗。
* 插件以當前 DSH 進程的權限運行，請確保安裝前檢查源碼與許可證。

典型用法¶

1. 打開文件：在對話中點擊任意文件引用，插件會攔截調用並在“文件”標籤頁打開文件內容。
2. 導航目錄：在文件標籤頁頂部點擊路徑，輸入新的目錄路徑（如 ~/project/src）並按回車，即可跳轉。

適用場景與限制¶

• 適用場景：在 DSH Web 界面中需要查看日誌、代碼或文檔，且希望在瀏覽器內直接閱讀，不希望彈出原生窗口。
• 限制：
  • 單個文本文件讀取上限爲 400KB，圖片上限爲 4MB。
  • 二進制文件會給出提示，不會在界面中直接 dump 內容。
  • 插件採用純 ESM，無構建步驟，無外部依賴。

生態與鏈接¶

該插件遵循 MIT 許可證。更多技術細節（如開發、佈局結構）可參考其 GitHub 倉庫。

• 目錄頁：https://www.skillhub.cn/plugins/liooil/dsh-files-pane
• GitHub 倉庫：https://github.com/liooil/dsh-files-pane