前言¶
DeepSeek Harness (DSH) 插件生態強調模塊化與能力擴展。在開發或使用過程中，經常需要在對話中引用本地文件或查看項目目錄結構。fexp-file-explorer 是一個動態 Cordis 插件，它將文件瀏覽能力集成到 DSH 的左側工作區，提供獨立的文件管理面板，方便在對話流中直接操作文件系統。
核心功能¶
該插件通過雙入口設計提供文件訪問能力：
* 雙入口：側欄頂部「文件瀏覽」膠囊按鈕，以及會話標題欄「打開目錄」按鈕。
* 瀏覽面板：點擊任意入口滑出 320px 面板，自動定位到當前工作區目錄（cwd）。面板支持目錄/文件切換、麪包屑導航及工具欄操作（上一級、回到根目錄、刷新）。
* 文件預覽：點擊文件在面板底部預覽文本內容。預覽有大小限制，默認 256KB 上限，最大 1MB，超限會報錯 FS_TOO_LARGE。
* 系統集成：支持在系統資源管理器中打開當前目錄，以及將文件引用添加到聊天輸入框（使用 DSH @ 命令語法）。
* 技術特性：v1.5.0 起爲靜態 bundle 插件，隨 profile 層棧自動加載；支持深淺色主題，使用 CSS 變量適配。
安裝與啓用¶
安裝前請確保已安裝 @deepseek-ai/cordis (^4.0.1)。
dsh plugin --profile web add fexp-file-explorer
安裝完成後，需重啓 dsh web 進程才能使插件生效。靜態 bundle 形式安裝後，每次啓動 DSH 即自動加載。
典型用法¶
- 打開面板：點擊側欄頂部的「文件瀏覽」膠囊，或會話標題欄的「打開目錄」按鈕，320px 面板會從左側滑出並定位到當前工作區目錄。
- 瀏覽目錄：點擊目錄進入下一級，使用工具欄按鈕「上一級」、「回到根目錄」或「刷新」進行導航，或通過麪包屑快速跳轉。
- 預覽文件：點擊文件，面板底部會顯示文本內容預覽。
- 添加到聊天：在預覽模式下，點擊「添加到聊天」按鈕。DSH 會將文件引用（使用
@命令語法）追加到輸入框草稿中，支持連續添加多個文件（空格分隔）。 - 在資源管理器中打開：使用工具欄最右側按鈕，直接在系統資源管理器中打開當前瀏覽的目錄。
注意事項¶
- 文件大小限制：文件預覽默認上限爲 256KB，最大支持 1MB。超過限制會報錯
FS_TOO_LARGE，需在對話中讓助手直接讀取。 - 靜態 bundle 行爲：靜態 bundle 形式隨 profile 加載，無進程存續限制。動態回退形態不跨 DSH 進程存續，重啓後需重新加載。
- 安全審查：該插件的安全審查等級爲 WARN（38/300），依賴
fs和rpc能力，無網絡請求或進程啓動能力。 - 適用場景：適合需要在 DSH 工作區中快速瀏覽文件、引用文件內容或跳轉系統目錄的場景。
生態背景¶
DSH 插件目錄獨立於 DeepSeek 官方應用，由社區維護。使用第三方插件前，建議查閱源碼與許可證。
