前言¶

DeepSeek Harness（DSH）會在本機留下安裝目錄、.dsh 下的會話與附件、各類緩存和插件依賴。時間一長，很難回答三個實際問題：一共佔多少、空間花在哪、哪些可以刪而不傷數據。手動翻目錄既慢，也容易誤刪 spill、workspace-changes 等仍被舊會話引用的文件。

社區插件 dsh-storage-insight（維護者 superchen061220）在 DSH 設置裏增加 設置 → 存儲空間 頁，用掃描結果和明確的白名單/黑名單回答上述問題。下面介紹它的定位、能力與安裝方式；事實以 GitHub 倉庫 README 爲準。

這是什麼¶

Storage Insight for DeepSeek Harness — 看一眼 dsh 在本機佔了多少空間，然後只清理可以重建的緩存。

插件分類爲 admin-security，當前 npm 包版本 0.1.0，許可證 MIT。它不替代 DSH 自帶的配置或會話管理，而是隻讀掃描本地三個根（DSH_HOME、安裝目錄、系統臨時目錄），在 UI 裏彙總佔用並在受控條件下執行清理或刪除已歸檔會話。

核心功能¶

總覽與分類¶

設置頁用總量行和環形圖展示 Harness 佔用、其他程序與可用空間，並把 DSH 相關佔用拆成三類（README 示例）：

總量        1.95 GB      安裝 1.02 GB · 臨時 0.14 GB
會話與文件   166 MB       會話日誌 + 附件
緩存與臨時   155 MB       投影緩存、縮略圖、臨時目錄
運行時插件   1.78 GB      內置運行時、工具鏈、插件依賴、程序本體
佔用比例     0.45%       相對整塊磁盤

• 會話與文件 → 管理：按工作區分組、附件按類型、已歸檔會話（可刪除）。
• 緩存與臨時 → 清理：先列表預覽，確認後才執行刪除。

可清理與明確不碰¶

刪除會話在 Windows 上走系統回收站（可還原）；回收站不可用時落到 <.dsh>\.trash\sessions。

安全與隱私（host 側）¶

• 只掃描上述三個本地根，不聯網；不跟隨符號鏈接/junction，不越出根目錄。
• 寫操作接口要求請求頭 x-storage-insight: 1，用於 CSRF 防護。
• 刪除只允許已歸檔會話；未歸檔一律拒絕。
• 掃描 15 秒硬上限，超時返回已完成部分並標註「不完整」。
• 寫 workspace.json 前自動備份到 <.dsh>\.storage-insight\backup\。
• /storage-insight/api/* 僅接受迴環地址（127.0.0.1 / ::1）；dsh 若綁定 0.0.0.0 或經反向代理暴露，接口返回 403 loopback-only。
• 頁面只請求同源 storage-insight/api/*，無外部字體、埋點或遙測。

安裝與啓用¶

推薦：在 dsh 的 插件 頁搜索 dsh-storage-insight 安裝並啓用（插件管理器會處理依賴和啓用狀態）。

命令行（profile 名通常是 web；桌面版是 desktop）：

dsh plugin --profile web add dsh-storage-insight          # npm（推薦，快）
dsh plugin --profile web add github:superchen061220/dsh-storage-insight   # GitHub 源（備選）

在已存在的 profile 裏，dsh plugin add 只安裝依賴，不會把插件登記進 dsh.profile.bundles；裝完後還需在 插件 頁啓用（或讓插件管理器執行一次啓用）。全新 profile 首次安裝時會自動登記。這是 dsh 自身行爲，不是本插件獨有。

npm 源需能訪問 registry.npmjs.org；GitHub 源需能訪問 github.com。兩者都不通時，可下載倉庫後本地安裝，例如：

dsh plugin --profile web add "C:\path\to\dsh-storage-insight"

裝完重啓 dsh，打開 設置 → 存儲空間。

典型用法¶

1. 進入 設置 → 存儲空間，查看總量、環形圖與三類明細。
2. 需要騰空間時，在 緩存與臨時 中打開清理列表，預覽後再確認執行（只動上表「會清理」項）。
3. 需要刪舊對話數據時，在 會話與文件 → 管理 中處理已歸檔會話；未歸檔會話不會被批量刪除接口接受。
4. Windows 上刪除的會話可從回收站恢復；其他平臺注意文案會說明 .trash 路徑。

適用場景與注意¶

適合：長期在本機跑 DSH Web、插件和會話較多、想先看清佔盤再動手清理可重建緩存的管理員或日常使用者。

兼容性（README 摘要）：

• 需要 dsh Web（0.1.x / 0.2.x），設置面板存在 settings.section 槽位。
• 掃描和統計跨平臺可用；系統回收站與「打開所在目錄」僅 Windows。
• 會話標題解析依賴 Node ≥ 22 的 zstd；更老運行時僅顯示短 id，不影響掃描與清理。
• 歸檔列表依賴 dsh 的 workspace.json（archivedSessionIds / tables.workspaces[].sessionIds）；結構變化時會退化爲按磁盤目錄列出，不會崩潰。

安裝前：插件以當前 dsh 進程權限讀寫本機目錄與部分 workspace.json；安裝前應閱讀 源碼與 MIT 許可證，確認符合你的安全策略。DSH 生態是「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-storage-insight 把「佔多少、在哪、能安全刪什麼」收進設置頁，並在 host 側用迴環限制、CSRF 頭與歸檔校驗約束寫操作。若你主要在本機維護 DSH，可先安裝啓用，從 設置 → 存儲空間 做一次掃描再決定是否清理緩存或刪除已歸檔會話。

• 目錄頁：https://www.skillhub.cn/plugins/superchen061220/dsh-storage-insight
• GitHub：https://github.com/superchen061220/dsh-storage-insight