前言¶
在 DeepSeek Harness（DSH）裏和智能體協作時，聊天裏經常出現指向本機的文件鏈接：Blender 工程、FBX、PSD、壓縮包等。默認行爲往往是喚起系統資源管理器，或只能做簡單預覽，和「在 IDE 裏繼續對話」的節奏不太合拍。社區插件 nuet9/dsh-internal-folder-browser（包名 @local/internal-folder-browser）把「點鏈接 → 看所在文件夾並定位文件」做進 Harness 客戶端面板，圖片和文本仍走 Harness 原有預覽。下面介紹它的定位、能力與安裝方式；事實以 GitHub README 爲準。
這是什麼¶
Harness 內置文件夾瀏覽 / Internal Folder Browser 由維護者 nuet9 發佈，分類爲 客戶端 插件。一句話：在 Harness 內瀏覽工程文件所在目錄，不啓動外部資源管理器；點擊聊天中的本地文件鏈接時，顯示文件夾並高亮目標文件。
DSH 生態強調「一切皆插件」；插件目錄頁託管在社區站點 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係，不是官方應用商店。
核心功能¶
以下能力均來自項目 README 與 package.json（當前版本 1.2.0，許可證 MIT）。
目錄瀏覽與排序¶
- 展示文件名稱、大小、修改時間，文件夾優先排序。
- 雙擊進入子文件夾；支持上一級與刷新。
- 圖片、文本鏈接可繼續使用 Harness 預覽（與純預覽行爲兼容）。
圖標與縮略圖¶
- Windows：使用系統實際文件關聯圖標；對 PNG/JPEG/BMP/GIF/TIFF 生成縮略圖（僅處理小於 16 MiB 的常見格式，192px）。
- 其他平臺：回退到擴展名標識；Windows 原生圖標依賴系統自帶的 Windows PowerShell 與
System.Drawing。
八種查看模式¶
查看模式包括：超大圖標、大圖標、中等圖標、小圖標、列表、詳細信息、平鋪、內容。頂部查看按鈕與面板右鍵菜單均可切換；當前客戶端會記住查看模式。
行爲邊界¶
- 不移動或修改被瀏覽的文件，不產生聊天命令執行記錄。
- 內置界面是本插件提供的目錄 UI，不是嵌入 Windows Explorer；不包含 Explorer 的文件操作、拖放或完整右鍵菜單。
安裝與啓用¶
適用於 Harness Desktop 0.2.1-rc.5。README 寫明：此版本只在上述 Windows Harness 版本上驗證過。
步驟¶
- 從 GitHub Release 下載附件
local-internal-folder-browser-1.2.0.tgz。 - 在 Harness 插件管理 中安裝該本地 bundle。
- 安裝後重新打開文件夾標籤；若客戶端仍加載舊模塊，刷新 Harness。
- 不要與舊的
@local/file-folder-open外部資源管理器方案同時啓用。
也可讓 Harness 助手執行安裝（路徑按你本機下載位置修改）：
{"action":"install_bundle","target":"C:/Downloads/local-internal-folder-browser-1.2.0.tgz"}
插件 Host 側提供只讀目錄列表服務；客戶端模塊通過 dsh.client 注入右側邊欄相關 UI（@deepseek-ai/dsh-client-ui-sidebar-right），並設置 immediately: true 以便儘早掛載。
典型用法¶
用法與 README 描述一致，無需額外配置字段：
- 在 Harness 聊天中點擊 Blender、FBX、PSD、壓縮包等本地文件鏈接。
- 客戶端打開內置文件夾視圖，高亮該鏈接對應的文件，並展示同級目錄內容。
- 需要深入時雙擊子文件夾；需要返回時走上一級；需要換佈局時用八種查看模式之一（偏好會保存在當前客戶端）。
- 若鏈接是圖片或文本，仍可按 Harness 原有方式預覽，文件夾瀏覽與預覽並行不衝突。
權限、限制與適用場景¶
誰適合用¶
- 經常在 DSH 裏點本地資產路徑、希望在同一窗口內定位文件、又不想反覆切到系統資源管理器的開發者。
- 已在 Windows + Harness Desktop 0.2.1-rc.5 環境驗證過的用戶（其他平臺/版本需自行評估圖標與佈局表現）。
務必知曉的限制¶
- 插件 Host 的只讀服務允許已連接客戶端列出本機絕對路徑目錄，包括工作區外目錄。只應安裝在你信任客戶端的本地 Harness 上；不要暴露給不受信任的遠程用戶。
- 列表上限 2000 項；每次最多生成 120 個新圖標，緩存上限 512 項。
- 安裝前建議查看 源碼倉庫 與 MIT 許可證；插件以當前 DSH 進程權限運行，權限範圍與 Harness 本身一致。
回退¶
禁用或卸載 @local/internal-folder-browser 即可恢復 Harness 原文件鏈接行爲；不會更改工程文件。
驗證與維護信息¶
倉庫提供本地校驗命令（面向開發者）：
node --check index.js
node --check client.js
node verify.mjs
README 說明迴歸覆蓋目錄跳轉、中文路徑、高亮、父目錄、原預覽保留、圖標元素、八種模式切換、偏好保存和卸載恢復；Windows 本地版本已通過 Host RPC 列目錄並獲取圖標。發佈包的完整跨機器安裝與八種佈局視覺效果，文檔註明尚未逐一實測。
- 目錄頁：https://www.skillhub.cn/plugins/nuet9/dsh-internal-folder-browser
- GitHub：https://github.com/nuet9/dsh-internal-folder-browser
經過上面的步驟，你可以在 Harness 內完成「點鏈接 → 看文件夾 → 定位文件」的閉環，而不必默認依賴外部資源管理器。
