前言¶
在 DeepSeek Harness (DSH) 的開發或使用場景中，工作區通常包含大量文件。爲了查看目錄結構或文件內容，開發者往往需要在 DSH Web 界面與本地文件管理器（Finder / File Explorer）之間切換，這會打斷工作流。dsh-file-explorer-kit 旨在解決這一痛點，它允許用戶直接在 DSH 的聊天 GUI 中瀏覽工作區目錄並預覽文件。
這是什麼¶
dsh-file-explorer-kit 是一個 DeepSeek Harness (DSH) 的客戶端插件，以 Cordis bundle 形式發佈。它通過註冊只讀的 /dsh-files 路由和一個專用的“Files”會話選項卡，將文件瀏覽與預覽功能集成到對話界面中。插件本身僅提供瀏覽能力，不涉及任何文件修改操作。
核心功能¶
-
集成瀏覽選項卡
插件會在會話界面註冊第三個選項卡“Files”（顯示爲“文件”或“Files”），與“對話”和“軌跡”並列。該選項卡通過conversation.view環註冊，自動顯示在選項卡欄中。 -
目錄與文件預覽
用戶可以單擊目錄行進入下一級目錄，單擊文件行查看預覽。支持通過頂部欄的麪包屑導航、隱藏文件切換、刷新按鈕以及絕對路徑跳轉框快速定位文件。 -
自動刷新
“Files”選項卡在保持打開狀態時會自動刷新，以便實時捕獲智能體在後臺寫入的文件內容。 -
雙語與多格式預覽
界面支持中/英雙語自動切換（也可手動切換）。預覽區域位於右側，支持 Markdown、圖片、純文本以及嵌入式 PDF 的渲染。對於二進制文件，系統提供“Copy path（複製路徑）”和“Open in file manager（在文件管理器中打開）”的操作。
安裝與啓用¶
安裝前請確保環境滿足要求：DSH 版本 ≥ 0.1.1-rc.2，且安裝了 Node.js 20+。
dsh plugin --profile web add dsh-file-explorer-kit
安裝完成後，無需重啓 DSH 進程，直接在 Web 界面打開任意會話即可看到新增的“文件”選項卡。
典型用法¶
- 打開任意一個 DSH 會話，界面頂部應顯示三個選項卡：對話 | 軌跡 | 文件。
- 點擊“文件”選項卡，頁面主體區域將顯示當前會話工作區的目錄結構。
- 使用鼠標單擊目錄以進入子目錄，或單擊文件以在右側查看預覽。
- 若需跳轉到特定路徑，可在頂部欄的輸入框中輸入絕對路徑並確認。
- 預覽 Markdown 或文本文件時，可切換“預覽”與“Raw”模式；查看二進制文件時，可使用右側操作欄複製路徑或打開文件管理器。
適用場景與注意¶
- 適用場景：需要頻繁查看項目結構、檢查智能體生成的代碼或文檔，希望避免在 IDE 和瀏覽器之間來回切換的開發者。
- 安全與權限：該插件完全基於只讀路由，不會修改任何文件。其基於主機信任門控機制運行：迴環地址請求直通，非迴環地址請求需要同源標記。這符合 DSH 官方 Web 服務器的默認綁定行爲。
- 兼容性：該插件與
dsh-workspace-kit兼容，兩者可以同時啓用。
結尾¶
dsh-file-explorer-kit 通過集成文件瀏覽能力，優化了 DSH 的本地開發體驗。對於習慣在 DSH 中處理工作流的人來說，這是一個提升效率的實用工具。更多細節可參考插件倉庫或目錄頁。
