前言¶

在 DeepSeek Harness（DSH）裏做智能體或日常對話時，經常要在本地找文件、看體積、打開預覽，或覈對某次會話產出的文檔。切到資源管理器再切回 DSH，路徑和上下文容易斷。社區插件 dsh-disk-manager（維護者 Ananpng123，分類：客戶端）把卷概覽、目錄瀏覽、按需統計文件夾大小、桌面快捷方式佈局以及懸停預覽放進 DSH 右側邊欄，交互思路對齊 Windows「磁盤管理 / 文件資源管理器」：能瀏覽，寫操作僅保留「刪除（一律進回收站）」和「新建文件夾」，不提供分區擴展、收縮、格式化等操作。

這是什麼¶

一句話：面向 Windows 10 / 11 的 DSH 側邊欄磁盤與文件管理插件；卷列表、文件夾樹、地址欄跳轉、工作區按會話分組的文檔列表，以及部分類型的內置預覽。

插件由 GitHub 倉庫 Ananpng123/dsh-disk-manager 維護，當前 package 版本 0.4.2，許可證 MIT。DSH 要求 >=0.2.1-rc.5（README 標註的 tested version）；主機端依賴 Windows API 與 Windows PowerShell 5.1，無額外 npm 運行時依賴。

架構上分爲兩半：index.js 在 DSH 宿主進程註冊 HTTP 路由（如 /api/dsh-disk）；client.js 在瀏覽器裏渲染側邊欄。改 index.js 需 重啓 DSH；僅刷新頁面只會重載 client.js。

核心功能¶

下面介紹 README 中已列出的能力（均爲 Windows 本地實現）。

卷與桌面

• 卷概覽：各驅動器以「此電腦」式卡片展示（盤符圖標、Label (X:)、已用空間條、X free of Y）。
• 桌面停靠：桌面內容 inline 列在卷列表下方；快捷方式顯示真實應用圖標。

瀏覽與導航

• 文件夾瀏覽：進入任意目錄；可按名稱 / 大小 / 修改時間 / 類型排序，分組，緊湊或詳細密度。
• 地址欄：點擊變爲輸入框，輸入路徑後按 Enter 跳轉。
• 多窗格：「在新標籤頁中打開」可爲每個面板記住各自的盤符與路徑。
• 懸停預覽（Hover peek）：指針停在文件夾上時，浮層展示其內容（最多三層，可繼續下鑽）。

打開與預覽

• 按類型打開：文本、代碼、圖片、PDF、Office 等走 DSH 內置側邊欄預覽；視頻、音頻、壓縮包用系統默認程序。
• 右鍵菜單：內置預覽、系統打開、在資源管理器中顯示、複製路徑、刪除（僅回收站）。

空間與寫入

• 按需統計文件夾大小：右鍵文件夾觸發測量，帶 deadline 保護，避免 UI 長時間卡住。
• 新建文件夾：在目錄空白處右鍵，輸入名稱就地創建；重名會提示，不會覆蓋。
• 刪除：右鍵文件或文件夾，確認一次後進入回收站（無永久刪除）。

工作區文檔

• 會話標題欄新增 堆疊文件夾 按鈕：按 會話 分組展示當前工作區各對話產生的文檔（新在上），可摺疊分組；搜索框按文件名過濾；點擊可在內置預覽中打開。

主機端暴露的 endpoint 名稱包括：volumes、ls、size、open、reveal、terminal、mkdir、info、cleanup、clipboard、icons、trash、settings（詳見倉庫 Layout 說明）。

安裝與啓用¶

先做索引或本地包安裝，再重啓 DSH 一次。未重啓時主機路由未就緒，操作會報 backend not ready。

從插件市場（自建索引）¶

在 DSH Settings → Plugin Market 增加索引源：

https://ananpng123.github.io/dsh-disk-manager/index.json

然後在 Discover 頁搜索 disk 並安裝。

README 說明該插件已提交 awesome-dsh-plugin 與 Open Plugin Market 等社區索引，審覈通過前也可通過上述自建 index 立即看到 listing；若需按 tag 安裝，資料中的 install spec 爲：

git+https://github.com/Ananpng123/dsh-disk-manager.git#v0.4.2

（具體在 DSH 插件管理器中的添加方式以你當前 DSH 版本的市場 UI 爲準。）

從本地目錄¶

在 DSH 內通過插件管理器：

plugin_manager install_bundle <path-to>dsh-disk-manager

經過上面的步驟並 重啓 DSH 後，會話標題欄（輸入框上方那一排小圖標）會出現兩個新按鈕（見下一節）。

典型用法¶

新按鈕在哪裏¶

二者均以右側邊欄 標籤頁 打開，可同時保留多個。

磁盤面板¶

1. 點擊顯示器圖標，或在已打開的磁盤標籤裏點卷，進入卷列表。
2. 點擊某捲進入，或在地址欄輸入路徑後 Enter。
3. 單擊文件夾就地展開；雙擊作爲獨立頁面打開。
4. 右鍵文件/文件夾：預覽、系統打開、在 Explorer 中顯示、複製路徑、刪除（回收站）。
5. 右鍵卷卡片：打開、新標籤打開、磁盤檢查、屬性。

工作區文件面板¶

1. 點擊堆疊文件夾圖標。
2. 列表按會話分組，最新在上；點組標題摺疊/展開。
3. 點擊文檔用 DSH 內置預覽打開；右鍵可系統打開 / 顯示 / 複製路徑 / 刪除。
4. 搜索框按文件名跨組過濾。

適用場景與注意¶

適合誰：主要在 Windows 上使用 DSH、希望在同一界面裏看盤符佔用、瀏覽目錄、偶爾刪文件或建文件夾、並快速打開本會話/workspaces 產出文檔的開發者或日常用戶。

權限與安全：插件主機半運行在 當前 DSH 進程權限 下，能訪問該用戶可見的本地路徑並執行上述寫操作。安裝前應閱讀 源碼與 LICENSE，確認可接受 MIT 條款與行爲範圍。

已知限制（README）

• 僅 Windows；無分區操作；刪除必進回收站；無重命名與撤銷；磁盤變更需 手動刷新。
• PowerShell 被禁用時圖標可能退化爲文件類型圖標，其餘功能仍可用。
• 圖標經 SHGetFileInfo 解析，極少數 AppX 註冊異常可能顯示通用圖標。

社區目錄頁（SkillHub 等）與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，索引源由社區或個人託管。

結尾¶

dsh-disk-manager 把 Windows 卷概覽、Explorer 式瀏覽、文件夾體積統計、桌面與工作區文檔入口收進 DSH 右側邊欄，寫操作刻意收窄爲回收站刪除與新建文件夾，適合在對話旁做輕量本地文件操作。

• 目錄頁：https://www.skillhub.cn/plugins/Ananpng123/dsh-disk-manager
• GitHub：https://github.com/Ananpng123/dsh-disk-manager