前言¶
在 DeepSeek Harness 裏與 AI 對話時，經常需要在本機找資料、確認文件內容，或把文件交給當前會話。若只依賴系統資源管理器和對話窗口來回切換，路徑粘貼、附件添加和預覽都會打斷節奏。下面介紹由維護者 tm5452 發佈的客戶端插件 dsh-workspace-explorer（GitHub：tm5452/dsh-workspace-explorer），它在 Windows 桌面端 Harness 右側欄提供帶標籤頁的文件瀏覽、預覽、工作區搜索和批量文件操作，按當前 Windows 賬戶權限訪問磁盤。
DSH 生態強調「一切皆插件」；插件目錄站 skillhub.cn 爲社區彙總，與 DeepSeek / 幻方無官方從屬關係。本文事實均來自該插件 GitHub README 與 package.json（當前發佈版本 1.1.1）。
這是什麼¶
dsh-workspace-explorer 定位爲 Windows 上的 Harness 文件資源管理器：安裝後從右側欄的「文件瀏覽」進入，在同一界面完成瀏覽、預覽、與會話聯動及就地整理文件。插件 dsh.client.platform 爲 web，向右側欄、會話等客戶端模塊注入能力；擴展預覽部分沿用 dsh-preview-extra，許可證見倉庫內 LICENSE-preview-extra。
核心功能¶
瀏覽與導航¶
- 首頁回到「此電腦」，列出 C、D、E 等本機盤符、可移動盤和光驅；雙擊進入目錄，工具欄支持前進、後退、上一級和刷新。
- 地址欄可點任一級目錄跳轉；路徑過長時可在地址欄上滾動查看；點編輯或按 Ctrl+L 粘貼絕對路徑——文件夾路徑進入目錄，文件路徑則定位並預覽。
- 頂部 + 可再開「文件瀏覽」標籤；各標籤獨立保留目錄、導航歷史和預覽，可拖動排序；同一窗口內會話共享這組標籤，切換會話或工作區時保留瀏覽狀態。
- 列表 / 大圖標視圖可按目錄記憶；大圖標支持圖片與可解碼視頻縮略圖。
- 地址欄旁星標可收藏目錄，支持拖動排序並自動保存。
預覽¶
單擊多數媒體與文本即預覽，雙擊用 Windows 默認應用打開。底部預覽窗可收起；分隔線可拖動調整高度；切換文件夾時可繼續查看上次選中的文件。
| 類別 | 支持格式（節選） | 說明 |
|---|---|---|
| 圖片 | PNG、JPG/JPEG、GIF、WebP 等 | 直接顯示 |
| 視頻 / 音頻 | MP4、WebM、MP3、WAV 等 | 解碼取決於 DSH 內置瀏覽器 |
| 純文本與代碼 | UTF-8 的 TXT、MD、JSON、腳本等 | 最多讀取前 2 MB |
| PDF 與 Office | PDF、DOC/DOCX、XLS/XLSX、PPT/PPTX | 連續滾動；Office 經 Harness 本機轉換；Ctrl+滾輪 縮放 |
| 壓縮包 | ZIP、JAR、TAR、GZ 等 | 「解壓預覽」後瀏覽包內條目 |
| 3D / KiCad / 固件等 | STL、OBJ、.kicad_sch、.hex 等 | 見 README 格式表 |
側欄需完整讀取的格式單文件上限 32 MB。7Z、RAR 等可雙擊用系統默認程序打開。
與會話、工作區聯動¶
- 點擊 AI 交付的文件卡片或回覆中的本地文件鏈接，文件瀏覽頁會跳到所在文件夾並選中預覽；拖到右側指定區域可在新標籤預覽。
- 從列表或大圖標把文件拖到左側輸入框，加入當前會話草稿；文件夾或地址欄各級目錄拖到輸入框會插入絕對路徑，拖到標籤欄可新開瀏覽頁。
- 跳轉至工作區 爲一次性跳轉；在工作區內工作 將啓用時的工作區設爲標籤根目錄並顯示搜索欄，按文件名搜索子目錄（結果標出路徑，最多 300 條，不遍歷目錄聯接）。
就地文件操作¶
右鍵支持複製、剪切、粘貼、重命名、複製路徑、在資源管理器中顯示、刪除；Shift 連選、Ctrl 多選，批量操作每次最多 128 項。粘貼同名文件會保留兩份；刪除經確認後進入回收站。
安裝與啓用¶
推薦從 npm 註冊表安裝。在終端執行：
dsh plugin --profile web add dsh-workspace-explorer
也可在 Harness「插件 → 添加插件」中輸入包名 dsh-workspace-explorer，由註冊表解析。
安裝後需從系統托盤完全退出 Harness，再重新打開右側欄「文件瀏覽」。
從 GitHub Release 安裝時，可在「插件 → 添加插件」粘貼發佈包鏈接或本地 .tgz 路徑：
https://github.com/tm5452/dsh-workspace-explorer/releases/download/v1.1.1/dsh-workspace-explorer-1.1.1.tgz
曾裝早期預覽包的用戶，宜先在插件列表移除舊條目再重裝。源碼調試可用 link:<絕對路徑> 添加插件目錄；發佈包已含構建產物，自行構建需先 npm install，再執行 node scripts/build-client.mjs 生成 lib/client.js。
典型用法¶
- 安裝並重啓 Harness 後，打開右側「文件瀏覽」，從「此電腦」進入項目目錄。
- 用 Ctrl+L 粘貼已知絕對路徑，或開第二個標籤對照兩個文件夾。
- 單擊文本或圖片確認內容；PDF/Office 點「查看文檔」後在側欄滾動查閱。
- 將需要的文件拖到對話輸入框作爲附件，或將文件夾路徑拖入對話說明工作區位置。
- 對當前 Harness 工作區啓用「在工作區內工作」，用搜索欄按文件名定位資料，點擊結果直達預覽。
- 多選文件後右鍵批量複製或剪切到目標目錄（注意權限與 128 項上限）。
適用場景與注意¶
適合在 Windows 桌面 Host 上使用 Harness、且需要在本機磁盤與 AI 會話之間頻繁切換的開發者或使用者。插件僅以啓動 Harness 的 Windows 賬戶權限訪問磁盤；粘貼、重命名等會修改本機文件，拒絕訪問時界面會提示。
安裝前宜瀏覽倉庫源碼與許可證（含 LICENSE-preview-extra）。本插件分類爲客戶端，不替代系統級安全策略；內嵌預覽與搜索均有上述大小、條數與編碼限制。
結尾¶
dsh-workspace-explorer 把 Windows 磁盤瀏覽、多格式預覽、工作區搜索和剪貼板級文件操作收攏到 Harness 右側欄，減少在對話與資源管理器之間的上下文切換。
