前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者根據需求擴展功能。在智能體開發中，直接在對話流中管理當前會話的文件是一個常見痛點。dsh-file-share 專注於解決這一問題，它通過在對話界面增加“文件”標籤頁，提供可視化的目錄樹和文件操作入口，讓文件瀏覽、預覽和管理無縫集成到對話上下文中。
這是什麼¶
這是由 weibaohui 維護的 DSH 插件。它將文件瀏覽、預覽和管理集成到當前的會話工作區上下文中，無需配置固定的外部目錄。
核心功能¶
- 按會話工作區綁定文件樹：文件樹自動綁定到當前對話的工作區目錄。
- 樹形瀏覽：支持懶加載的目錄樹展示。
- 文件預覽：支持文本、代碼和圖片預覽，超大文件或二進制類型引導下載。
- 上傳/下載：支持一鍵上傳本機文件到當前目錄，以及任意文件的下載。
- 批量打包下載：支持文件夾或多選文件批量打包爲 zip，並保留目錄結構。
- 目錄管理：支持新建文件夾、重命名、刪除、刷新和名稱搜索過濾。
- @ 進對話框：點擊“@”按鈕將文件絕對路徑注入輸入框，供 agent 處理。
- 路徑邊界安全：所有操作鎖定在會話工作區內，拒絕
../、絕對路徑和軟鏈逃逸。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add @weibaohui/dsh-file-share -w
安裝完成後，重啓 dsh web 即可生效。
典型用法¶
- 打開 Web UI，進入任意一個在當前實例中打開過的活躍會話。
- 在對話區頂部找到 「文件」 標籤頁（通常位於「工藝」旁），點擊即可查看該會話工作區的目錄樹。
- 點擊文件名可預覽內容；懸停文件行可進行下載、@ 或重命名/刪除操作；工具欄可進行上傳、新建文件夾或搜索過濾。
- 上傳、新建等操作作用於當前目錄——點擊目錄名展開並切換目標目錄。
- 想讓 agent 處理某個文件：點擊「@」將絕對路徑注入輸入框，回車後 agent 直接讀取該文件。
適用場景與注意¶
- 適用場景：需要在對話中頻繁讀寫當前會話工作區文件的 agent 開發場景。
- 注意：文件管理基於當前會話工作區，必須是在本實例中打開過的活躍會話；跨實例或未打開的舊會話無法訪問。所有操作嚴格限制在會話工作區內，拒絕
../、絕對路徑和軟鏈逃逸。
短結尾¶
該插件爲 DSH 用戶提供了在對話上下文中直接操作文件的便捷方式，適合需要文件交互的 agent 場景。項目地址：GitHub。
