前言¶

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