前言¶
DeepSeek Harness (DSH) 提供了插件化架構，允許擴展工作臺功能。在開發或調試過程中，開發者往往需要在查看 AI 對話上下文的同時，檢查工作區內的源代碼、配置文件或日誌。官方 DSH 界面本身沒有側邊欄文件瀏覽功能，這需要頻繁切換窗口或使用外部工具。relay-dsh-plugin-files 通過插件系統爲官方 DSH Web UI 增加了右側的文件瀏覽面板，使開發者可以在不離開當前對話的情況下查看和預覽文件。
這是什麼¶
relay-dsh-plugin-files 是一個爲 DeepSeek Harness Workbench 提供工作區文件瀏覽視圖的插件。該插件由 yangbobo2021 維護，採用 MIT 許可證。
它的核心作用是：
1. 在 Workbench 側邊欄增加一個 Files 視圖。
2. 通過 DSH Agent 身份加載當前會話工作區的文件樹。
3. 對文件內容進行限制的 UTF-8 文本預覽。
4. 提供過濾框以快速篩選可見文件。
核心功能¶
該插件提供以下具體能力：
- 文件樹展示：在 Workbench 側邊欄加載並展示當前工作區的文件結構。
- 身份鑑權：利用 DSH Agent 身份進行工作區文件加載，確保安全性。
- 路徑校驗：執行工作區包含檢查，確保預覽內容嚴格限制在活躍的工作區路徑內。
- 文本預覽：支持對源代碼、Markdown、JSON、日誌等 UTF-8 文本文件進行預覽。
- 快速過濾：提供過濾框，允許用戶快速縮小可見文件範圍。
- 非二進制處理：不將二進制文件、超大文件或工作區外的路徑作爲純文本預覽。
安裝與啓用¶
安裝該插件需要同時安裝 relay-dsh-plugin-workbench 作爲宿主面板。安裝命令如下：
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.3-rc.1 relay-dsh-plugin-files@0.2.3-rc.1
安裝完成後，啓動或重啓 DSH Web 進程：
npx @deepseek-ai/dsh@0.1.2-rc.1 web
重啓進程是確保插件加載生效的關鍵步驟。
典型用法¶
在 DSH Web 界面中，典型的工作流如下：
- 打開 DSH Web 終端輸出的 URL，進入官方界面。
- 完成首次啓動引導（如有）。
- 創建或選擇一個已關聯了本地工作區目錄的對話。
- 在左側或右側面板打開 Workbench 側邊欄。
- 在 Workbench 面板中選擇
Files視圖。 - 點擊列表中的文件，即可在面板內查看其 UTF-8 文本內容。
適用場景與注意¶
適用場景：
- 需要在瀏覽器中瀏覽當前對話關聯工作區文件的 DSH 用戶。
- 需要預覽 Markdown、JSON、日誌等 UTF-8 文本的開發者。
- 想要在保持使用官方 DSH 的同時，通過插件系統擴展文件瀏覽能力的用戶。
注意：
- 該插件僅擁有 Files 視圖，不依賴 Codex、Claude、Relay Events 或任何私有 Relay 運行時。它通過公共插件契約與共享的 Workbench shell 通信。
- 插件不支持二進制文件、超大文件以及工作區外的路徑作爲純文本預覽。
- 插件遵循 MIT 許可證。
總結¶
relay-dsh-plugin-files 是一個輕量級的 DSH 插件，它在不改變官方 DSH 核心邏輯的前提下，通過插件機制補全了文件瀏覽能力。它適合需要在工作區上下文中頻繁查閱文本文件的開發者，有助於保持開發流程的連貫性。
- 插件倉庫: https://github.com/yangbobo2021/relay-dsh-plugin-files
- 插件目錄: https://www.skillhub.cn/plugins/yangbobo2021/relay-dsh-plugin-files
