前言¶
DeepSeek Harness（dsh）把模型、工具、會話、沙箱和界面都做成插件，官方口號是「一切皆插件」。開發者預覽版的網頁界面默認以對話爲中心：智能體在工作區裏讀文件、寫代碼時，你往往還要另開終端或編輯器，才能看清目錄結構和剛改過的內容。
社區插件 dsh-file-explorer 做的事情比較直接：在網頁會話的標題欄加一個文件夾按鈕，點開後在頁面右側出現可調寬度的文件樹。Markdown 可以渲染，常見源碼按擴展名高亮，面板裏也能改文件並寫回磁盤，需要完整 IDE 時再一鍵喚起 VS Code。
本文按社區插件目錄頁、GitHub 倉庫 README、package.json 和源碼交叉覈對後整理。需要說明：DeepSeek Harness 本身由 DeepSeek AI 維護，倉庫在 deepseek-ai/deepseek-harness；本文用到的插件目錄 deepseek-harness-plugin.com 是獨立的社區站點，與 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。
這是什麼¶
dsh-file-explorer 是一款面向 DeepSeek Harness Web 界面的文件資源管理器插件，由 GitHub 用戶 joejojoking-cloud 維護，社區目錄歸在「工具與能力」分類。倉庫當前版本爲 0.1.3（package.json），主要語言是 JavaScript。目錄頁顯示 14 星，GitHub 倉庫當前爲 15 星，數字會隨時間變化，以打開頁面時爲準。
它解決的是網頁會話裏「看不到、不好找、不好改工作區文件」的問題，而不是再做一個獨立 IDE。按 README 的定位，裝好並重啓 harness 後，所有會話都會加載該插件：host 側提供 /plugins/file-explorer/* 路由，web client 負責右側面板和標題欄按鈕。
package.json 把許可證字段標爲 MIT，但倉庫根目錄目前沒有獨立的 LICENSE 文件，GitHub 也未識別出許可證。安裝前仍應自己打開源碼覈對。
核心功能¶
下面這些能力來自倉庫 README，並與 lib/index.js、lib/client.js 對過，沒有把未聲明的功能寫進去。
右側文件樹面板¶
插件把面板掛在 shell.overlay 上，從頁面右側滑出，可以開關。面板左邊緣可拖拽調寬，README 給出的範圍是 260–900px。面板打開時，左邊緣中間有一個「>」收起按鈕；雙擊聊天區域也可以把面板收回。
標題欄左側寫着「文件」，右側是五個圖標，功能分別是：
- 在 VS Code 中打開整個工作區
- 全部展開 / 全部摺疊
- 刷新
- 進入編輯模式
- 關閉面板
會話標題欄右側會多一個「文件資源管理器」按鈕，用來開關面板。文件樹以當前會話工作區爲根，根目錄默認展開；目錄點擊後懶加載子項，再點一次摺疊。
搜索文件¶
面板上方有搜索框，佔位符是「搜索文件」。搜索會遞歸掃描工作區，跳過 .git 和 node_modules，最多返回 300 條。host 側實現裏還有掃描節點上限（4000），達到上限時結果會帶截斷標記。匹配按文件名（及目錄名）包含關係，大小寫不敏感。
Markdown 預覽與語法高亮¶
單擊或雙擊文件會打開預覽：
.md會渲染 Markdown，覆蓋標題、列表、代碼塊、引用和鏈接；圍欄代碼塊按語言高亮。- 其他文本文件按擴展名自動高亮。README 列出的語言包括 JSON、YAML、JS、TS、Python、C、C++、Java、Go、Rust、Shell、SQL、TOML、INI、CSS、HTML 等。高亮邏輯寫在客戶端裏，沒有額外運行時依賴。
- 超過 1 MB 的文件不支持預覽，界面會提示過大。host 側讀取上限是
1_000_000字節，與 README 一致。 - 再次點擊當前正在預覽的文件，可以關掉預覽框。
面板內編輯¶
點標題欄的「編輯」圖標後，預覽區變成可編輯文本。保存會通過 host 的 write 路由寫回磁盤。這是真實寫文件，不是會話裏的臨時草稿。
一鍵打開 VS Code¶
VS Code 圖標會把當前工作區路徑交給本機的 code 命令。host 側優先用 subprocess 直接啓動可執行文件；在 Windows 上如果解析到的是 .cmd 包裝腳本，會嘗試改走 Code.exe。找不到 code 時，返回「未找到 VS Code（code 命令不在 PATH 中）」。因此本機需要先能在終端裏運行 code。
安裝與啓用¶
社區目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端裏運行即可：
dsh plugin add github:joejojoking-cloud/dsh-file-explorer
這是目錄頁原文，不要自己按倉庫名拼接。package.json 把客戶端平臺標成 web，README 的安裝示例也帶 --profile web。實際使用網頁界面時，更穩妥的寫法是裝進 web profile：
dsh plugin --profile web add github:joejojoking-cloud/dsh-file-explorer
裝完後需要重啓 harness。README 寫明：重啓後所有會話纔會加載該插件（host 路由 /plugins/file-explorer/* + web client 面板）。cordis.patch.yml 會把 id: file-explorer、name: dsh-file-explorer 插入當前 profile 的 host 組合，一般不用手工改補丁。
目錄頁建議可復現安裝時固定 commit 哈希，模板是：
dsh plugin add github:joejojoking-cloud/dsh-file-explorer#commit
把末尾的 commit 換成倉庫裏的真實哈希。本文覈對過的 main 最新提交是 9e1f3ea7baa43d737c51ffc68adb5eb95b024c32（2026-08-15，版本號升到 0.1.3）。固定安裝可以寫成：
dsh plugin --profile web add github:joejojoking-cloud/dsh-file-explorer#9e1f3ea7baa43d737c51ffc68adb5eb95b024c32
哈希會隨倉庫更新變化，安裝前到 GitHub 再確認一次。
典型用法¶
下面步驟都來自 README 和實際界面文案，可以按同樣順序復現。
- 確認已經能打開 DeepSeek Harness 網頁界面（官方倉庫的常見入口是
npx @deepseek-ai/dsh web或源碼裏的pnpm dsh web）。 - 在終端執行上一節的
dsh plugin命令，然後重啓 harness。 - 打開任意會話。標題欄右側應出現文件資源管理器按鈕，點擊後頁面右側打開文件樹。
- 在樹裏展開目錄，單擊某個
.md或源碼文件，右側預覽區會渲染 Markdown 或帶高亮的文本。 - 需要改文件時，點標題欄「編輯」，改完保存，內容寫回工作區磁盤。不需要預覽時，再點一次該文件即可關掉預覽框。
- 文件較多時，用「搜索文件」按名稱過濾；結果裏不會出現
.git、node_modules下的路徑。 - 需要完整編輯器時，點 VS Code 圖標。若本機
code不在 PATH 中，這個按鈕不會成功打開項目。
插件分兩半，理解安裝後的行爲時可以用得上：
lib/index.js：host 側，註冊list/search/read/write/open-vscode五條 HTTP 路由，文件操作走 dsh 的fs服務。lib/client.js：web 客戶端，註冊shell.overlay面板和conversation.session.header.actions切換按鈕。
適用場景與注意事項¶
比較適合這些情況：
- 主要在 DeepSeek Harness 網頁界面裏跟智能體協作，想順手看工作區目錄和剛生成的文件。
- 需要快速掃一眼 README、配置或源碼，不一定每次都切到 VS Code。
- 改幾行配置或 Markdown 後希望立刻寫回磁盤，再讓智能體繼續跑。
使用前注意下面幾條邊界，都來自目錄頁或倉庫實現，不是推測：
- 只面向 web profile。
package.json的dsh.client.platform是web。headless / TUI 會話不會出現這塊面板。 - 預覽有大小限制。超過 1 MB 的文件不會讀入預覽。
- 搜索不是全文檢索。按路徑名匹配，跳過
.git和node_modules，最多 300 條。 - 編輯會寫盤。
write路由把內容交給fs.writeText。插件以當前 dsh 進程的權限運行，能改到進程能改到的文件。 - VS Code 依賴本機
code命令。沒裝 VS Code、或命令不在 PATH 裏，這個按鈕無效。 - 社區插件，版本仍早。當前是
0.1.3，倉庫創建於 2026-08-14，API 和界面都可能繼續改。社區裏還有其他文件瀏覽類插件，名稱相近，安裝時認準joejojoking-cloud/dsh-file-explorer。
目錄頁的安全提示需要原樣對待：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證；如需可復現安裝，請固定 commit 哈希。
小結¶
dsh-file-explorer 把文件樹、Markdown 預覽、語法高亮、面板內編輯和 VS Code 喚起接到 DeepSeek Harness 的網頁會話裏，讓對話界面少切一次窗口。它不是官方內置功能，也不是完整 IDE，但在 web profile 下足夠用來看目錄、讀文檔、改小文件。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-file-explorer/
GitHub：https://github.com/joejojoking-cloud/dsh-file-explorer
DeepSeek Harness 官方倉庫：https://github.com/deepseek-ai/deepseek-harness
