前言¶
在 DSH Web UI 中使用智能體時，經常需要查看工作區裏的源碼、配置或生成物。如果必須切換到終端、文件管理器或編輯器，就會離開當前會話上下文。dsh-file-explorer 是面向 DSH Web UI 的文件瀏覽器插件，可以在聊天界面旁瀏覽工作區文件、預覽內容，並對文本文件做內聯編輯。下面介紹它的定位、功能、安裝方式和注意事項。
這是什麼¶
dsh-file-explorer 是一個 DSH Web UI 插件，採用 MIT 許可證。倉庫地址爲：
https://github.com/Zalpha263/dsh-file-explorer
插件目錄頁爲：
https://www.skillhub.cn/plugins/Zalpha263/dsh-file-explorer
它主要解決 DSH Web UI 中的輕量文件操作需求：查看當前工作區文件結構、打開文本文件、預覽內容、保存修改，並進行新建、重命名、複製、粘貼、移動、刪除等基礎文件管理。
核心功能¶
- 懶加載目錄樹：按需展開工作區目錄。
- 預覽與內聯編輯：點擊文件可預覽；文本文件可編輯，
Ctrl+S保存，Esc退出；保存帶版本檢測。 - IDE 式右鍵菜單：支持新建文件、新建文件夾、重命名、複製、粘貼、複製絕對路徑或相對路徑、刪除到回收站。
- 拖放移動：將文件或文件夾拖到目標目錄行或目錄樹空白區域後鬆開即可移動；拖到自身或子目錄會被拒絕。
- 即時刷新：新建、重命名、粘貼、保存、刪除、移動後目錄樹更新。
- 跨平臺回收站：刪除時優先使用系統回收站；不可用時寫入內置回收站
~/.dsh-file-explorer-trash/，保留 30 天、最多 200 條。 - 工作區自動跟隨：切換會話或工作區後，文件瀏覽目標跟隨當前工作區。
- 停靠與浮動：面板可停靠或浮動；安裝 ui-beautify 後，由插件面板統一管理。
- 偏好記憶：面板位置、尺寸、停靠模式和預覽高度可本地記憶。
安裝與啓用¶
先確認 DSH 版本。已覈實資料中同時出現兩種版本表述：前置要求爲 DSH 0.1.1-rc.2（或兼容的 0.1.x 系列），兼容性目標版本爲 DSH 0.1.0-rc.7。由於資料中的最低兼容版本表述不完全一致，安裝前建議覈對當前 DSH 版本與官方說明。
官方安裝方式需要 pnpm。執行下面的命令安裝插件：
dsh plugin --profile web add github:Zalpha263/dsh-file-explorer
安裝完成後重啓 DSH。重啓後，會話標題欄右側會出現文件入口；如果已安裝 ui-beautify，入口會歸入插件面板統一管理。
升級插件時執行：
dsh plugin --profile web update dsh-file-explorer
卸載插件時執行：
dsh plugin --profile web remove dsh-file-explorer
典型用法¶
預覽和編輯¶
打開文件入口後，點擊目錄展開，點擊文件進入預覽。文本文件可進入編輯模式；輸入改動後使用 Ctrl+S 保存，按 Esc 退出編輯。保存操作帶版本檢測。
文件管理¶
右鍵文件行或文件夾行，可使用以下能力：
- 新建文件
- 新建文件夾
- 重命名
- 複製
- 粘貼
- 複製絕對路徑
- 複製相對路徑
- 刪除到回收站
拖放移動時，按住文件或文件夾行，拖到目標目錄行或目錄樹空白區域後鬆開即可移動。拖到自身或子目錄會被拒絕。
面板形態¶
未安裝 ui-beautify 時，可通過自帶入口打開文件面板，並使用停靠或浮動形態。安裝 ui-beautify 後，由插件面板統一管理。
安全與限制¶
- 寫操作限制在當前工作區根目錄內；工作區外的寫、刪、改名、移動會被拒絕。只讀瀏覽和預覽不受限。
- 該限制是插件自身的操作邊界，不等同於 DSH 的
read-only/workspace-write策略。插件的 Host 半區會在當前 DSH 進程內執行文件操作，因此它使用當前 DSH 進程可獲得的文件系統權限。請勿在不可信環境中安裝或啓用。 - 預覽有 512KB 截斷限制；二進制文件會自動識別；二進制文件和已截斷文件不可編輯。
- 刪除優先使用系統回收站；系統回收站不可用時，會落入內置回收站
~/.dsh-file-explorer-trash/。 - 插件依賴 dsh 自帶的
@deepseek-ai/dsh-typert-protocolpeer 依賴，不要單獨安裝該包的獨立副本。 - 部分 CSS 選擇器針對指定 DSH 客戶端產物編寫；DSH 大版本升級後可能需要複覈。
適用場景¶
dsh-file-explorer 適合在 DSH Web UI 中處理輕量文件任務，例如查看智能體生成的文件、檢查配置、修改短文本、整理工作區目錄。如果需要完整 IDE 能力、複雜代碼導航、批量處理或嚴格權限隔離，仍應使用專用編輯器或文件管理工具。
安裝前建議檢查源碼、許可證和 DSH 版本兼容說明。
參考¶
- 插件目錄頁：
https://www.skillhub.cn/plugins/Zalpha263/dsh-file-explorer - GitHub 倉庫：
https://github.com/Zalpha263/dsh-file-explorer
