前言¶
在使用 DeepSeek Harness 進行會話開發時，查看當前工作目錄結構往往需要切換窗口。這個插件在側邊欄底部增加了一個停靠的文件瀏覽器，提供懶加載目錄樹、篩選與重讀功能，以及可拖拽調整高度的交互。
核心功能¶
- 停靠式集成：渲染在側邊欄腳部，寬度自動跟隨側邊欄，不使用浮窗或獨立卡片。
- 高度可拖動：通過拖動上邊緣調整面板高度。
- 懶加載目錄樹：只展開已點擊的層級，減少內存佔用。
- 內存態開關：開關在內存中（設置 → 通用 → 文件瀏覽器），關閉後面板收起至標題行。
- 只讀與圍欄：插件只列舉元數據，限制路徑在會話工作目錄內，單次最多列舉 800 項。
- 雙語支持：跟隨 DSH 界面語言。
- 安裝便捷：無需構建，直接安裝。
安裝¶
使用官方 CLI 安裝 profile 插件：
dsh plugin --profile web add github:mabaoguo9527/dsh-file-explorer
安裝後重啓 dsh web 即可生效。
使用方式¶
- 導航：點擊目錄行展開或收起層級，點擊文件行選中並顯示相對路徑。
- 篩選：在篩選框中輸入名稱過濾已加載的文件。
- 刷新：點擊標題旁的 ↻ 圖標重新讀取目錄。
- 摺疊/展開面板：點擊標題行左側的箭頭，或通過設置中的開關。
- 調整高度：按住面板上邊緣並拖動。
安全與限制¶
插件設計爲只讀環境：
* 路徑校驗：所有請求都會校驗路徑是否在會話工作目錄內，拒絕逃逸。
* 無內容讀取：僅使用 fs.stat 和 fs.listDir，不讀取文件內容。
* 無網絡請求：不訪問憑據或發起外部網絡請求。
* 配置限制：插件不接受任何配置文件，開關狀態保存在內存中，重啓後重置。
結尾¶
這個插件通過將文件樹集成到側邊欄，解決了本地開發時頻繁切換窗口查看目錄結構的痛點。其嚴格的只讀限制和安全設計使其適合在開發環境中使用。
