前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許在 Web Profile 中擴展功能。在會話中查看本地文件結構或內容，通常需要切換瀏覽器標籤頁或給 Agent 發送消息。dsh-workspace-files 插件直接在會話界面旁提供文件瀏覽面板，無需中斷當前工作流。
插件介紹¶
該插件由 Momojie-S 維護。它提供右側可調寬的文件樹、遞歸文件搜索、Markdown 與多語言代碼高亮預覽，以及遠程文件下載能力。插件以 MIT 協議開源。
核心功能¶
- 會話標題欄開關：點擊標題欄的按鈕即可打開或關閉面板。
- 可調寬文件樹：右側文件樹寬度可在 240px 至 900px 之間調整。
- 遞歸搜索：支持全工作區遞歸搜索文件名，自動跳過
.git和node_modules目錄。 - 內容預覽：支持 Markdown 渲染（標題、列表、表格、代碼塊、鏈接、圖片）和多種文本文件的語法高亮。
- 浮窗放大：雙擊文件可在浮窗中居中放大預覽，Esc 鍵或點擊遮罩關閉。
- 遠程下載：支持將遠程（域名/局域網）文件直接下載到本地。
安裝與啓用¶
安裝前需確認環境滿足要求：DeepSeek Harness >= 0.1.0-rc.6（Web Profile），構建期需 Node.js >= 20。
dsh plugin --profile web add @momojie-s/dsh-workspace-files
首次構建時，需在 Profile 的 pnpm-workspace.yaml 中添加 allowBuilds 授權。
安裝完成後，在 DSH 界面的會話標題欄點擊「🗂 文件」按鈕即可加載面板。
使用方式¶
- 瀏覽文件：在左側文件樹中，點擊目錄展開或摺疊。單擊文件在右側預覽，雙擊文件在浮窗中居中放大查看。
- 搜索文件：在搜索框輸入關鍵詞並回車，進行全工作區遞歸搜索。按 Esc 鍵返回文件樹。
- 調整面板：拖動面板左緣可調整寬度；點擊左緣中部的「›」按鈕可收起面板。
- 下載文件：在預覽欄標題行或浮窗標題行點擊下載按鈕。對於二進制文件或超過預覽限制的文件，提示語旁也提供下載鏈接。
配置¶
通過 Patch config 字段可以調整行爲，主要配置項如下：
| 字段 | 默認值 | 說明 |
|---|---|---|
maxReadBytes |
1000000 |
單文件預覽讀取上限（字節），超限不預覽。 |
maxDownloadBytes |
200000000 |
單文件下載上限（字節），超限返回 413。 |
maxSearchNodes |
4000 |
遞歸搜索訪問節點預算（文件+目錄）。 |
maxSearchMatches |
300 |
搜索結果條數上限。 |
skipDirs |
['.git', 'node_modules'] |
文件樹與搜索跳過的目錄名。 |
trustedHosts |
[] |
非迴環 host[:port] 授權列表。遠程域名/局域網訪問必須配置此項，否則所有路由返回 403。 |
遠程部署配置示例（覆蓋 bundle 行）：
- id: workspace-files
config:
trustedHosts: ['dsh.example.com']
狀態與建議¶
⚠️ 插件已廢棄（2026-09-11）
DSH 0.1.5 及以上版本官方內置了同等能力的文件面板（ID 與本插件衝突，無法共存），官方側欄文件面板（ui-sidebar-files 文件樹 + ui-sidebar-documentpreview 預覽）已覆蓋主要使用場景。
- DSH 0.1.5+：請直接使用官方內置面板。
- DSH 0.1.2-rc.1 及以下：可繼續使用本插件。
插件不再維護，安裝前請檢查源碼與許可證。
