前言¶
DeepSeek Harness（DSH）強調插件化擴展，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對使用 dsh web GUI 的開發者來說，agent 在一輪會話中會創建、修改或下載文件，這些文件通常出現在當前會話的工作目錄中，後續還需要手動查找路徑、打開文件、預覽圖片或查看文本。
dsh-file-panel 是 DeepSeek Harness 的右側文件面板插件。它在會話過程中跟蹤 agent 創建或下載的文件，並把它們集中顯示在右側面板中，支持預覽、打開、在文件夾中顯示和複製路徑。
定位與維護信息¶
dsh-file-panel 由 yu2025-luo 維護，許可證爲 MIT。
它的核心用途是：在 dsh web 界面中提供一個右側文件面板，顯示當前會話中 agent 創建或下載的文件，並提供常見的文件查看與定位操作。
核心功能¶
dsh-file-panel 提供以下已覈實能力：
- 當 agent 創建或下載文件時，自動彈出右側面板。
- 新文件帶
NEW標記。 - 圖片可內聯預覽。
- 文本文件顯示前 256 KB 內容。
- 其他類型文件顯示元數據。
- 在操作系統文件管理器中選擇並顯示文件。
- 使用系統默認應用打開文件。
- 複製文件絕對路徑。
- 提供打開當前會話工作區文件夾的快捷入口。
- 可切換新文件自動彈出。
- 可收起爲浮動啓動按鈕，或隱藏面板。
安裝與啓用¶
從 GitHub 安裝到 web profile：
dsh plugin --profile web add github:yu2025-luo/dsh-file-panel
插件集合在 dsh web 服務器重啓後生效。安裝完成後，重啓 dsh web 服務器，並刷新：
http://127.0.0.1:3080
如果之後需要移除該插件：
dsh plugin --profile web remove dsh-file-panel
典型用法¶
安裝並啓用後，可以按下面的方式使用：
1、Agent 創建或下載文件後，右側面板自動彈出，新文件帶 NEW 標記。
2、點擊某一行，可內聯預覽圖片、文本或元數據。
3、懸停行上的操作，可執行預覽、打開、在文件夾中顯示或複製路徑。
4、點擊鈴鐺圖標，切換新文件自動彈出。
5、點擊 – / ×，將面板收起爲浮動啓動按鈕或隱藏面板。
6、點擊底部 open workspace folder，打開當前會話工作目錄。
安全邊界與運行限制¶
使用這個插件時，需要關注以下事實：
/file-panelRPC 通道限制爲loopback authority，僅127.0.0.1頁面可調用；網絡訪問時面板顯示提示並保持不活動。- 讀取/顯示文件端點只接受 tracker 已觀察到的絕對路徑，不能作爲通用文件讀取接口。
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與 MIT 許可證。 - 遞歸文件系統監視依賴
Node >= 20的fs.watch({ recursive: true })，在不可用平臺上可能漏掉 shell 下載。 - 面板狀態是進程本地，重啓後爲空，不會掃描歷史文件。
- 默認忽略
node_modules、.git和臨時文件噪聲。 - 在 headless Linux 上
reveal可能報告canReveal: false並隱藏按鈕。 - DeepSeek Harness 處於
pre-release，插件依賴的接口可能隨dsh升級變化。
適用場景¶
dsh-file-panel 適合希望在 dsh web 會話中快速查看 agent 產出文件的開發者。它能減少手動查找文件、打開文件和複製路徑的步驟，尤其適合會話中會產生圖片、文本、日誌、下載文件等產物的工作流。
如果依賴遠程訪問完整啓用面板，或需要掃描歷史文件、把文件讀取端點用於通用文件讀取，這個插件的邊界不滿足這些要求。
鏈接¶
GitHub：
https://github.com/yu2025-luo/dsh-file-panel
目錄頁：
https://www.skillhub.cn/plugins/yu2025-luo/dsh-file-panel
