← Back to home@twoweeks1995

dsh-appdata-scanner

DSH 只读 AppData 分析插件:资源管理器式下钻浏览,显示每个目录的体积、来源软件、用途与可删建议,支持按需联网查询

Stars
0
Language
JavaScript
Created
Oct 22, 2026
Updated
Oct 22, 2026

Introduction

AppData Scanner

一个 DeepSeek Harness(DSH)客户端插件:只读分析 Windows 的 AppData 目录,回答三个问题——

这个目录占了多少空间?是哪个软件生成的?能不能删?

它不会删除任何东西。 只帮你定位和解释,删除的决定权始终在你自己手里。

先读这一条:判断只是参考

这个插件给你的是「参考资料」,不是「清理指令」。

三个问题里,「这是什么、谁生成的、装了些什么」才是它的主业;「能不能删」只是一个基于目录名、目录内的文件类型和内置知识库推断出来的参考结论——它并不知道你的实际情况:这里可能是某款软件的授权文件、可能是你还没导出的工程、也可能是公司软件下发的配置。

所以动手之前,请按这个顺序:

  1. 先看「用途」一栏——它比安全级重要,告诉你这块空间在被谁使用;
  2. 拿不准就点行尾的文件夹图标,在资源管理器里亲眼看一下再决定;
  3. 有疑虑就留着。目录留着只是占点空间,删错可能不可恢复。

删除由用户自行操作,请对自己的数据负责。

它是怎么判定的

只扫描目录,不检索文件。

  • 扫描时只统计每个目录的递归体积、文件数、最后修改时间,以及目录里出现了哪些文件类型;不读取任何文件内容。
  • 判定的对象是目录:目录代表这块空间的用途。内置知识库为常见应用目录给出「用途 + 生成它的软件 + 删除后会怎样」,并按可安全删除/需拆分确认/不可删除给出结论。
  • 知识库没有覆盖的目录,按名称与内容特征做启发式推测,并明确标注为推测——不确定就说不确定。
  • 一个目录里混着缓存和用户数据时,例如 Edge\User Data 里书签和缓存是邻居,不给整块结论,拆到子项分别判定。
  • 0.7.0 起,判定完全以目录为单位,此前会单独识别个别文件并给出建议。

判定优先级:知识库匹配 → 混合目录拆分 → 启发式 → 推测。

特性

  • 资源管理器式浏览:点文件夹进入下一层,顶部「← 返回上一级」加面包屑跳级
  • 递归体积统计:显示每个目录含所有后代的真实大小、文件数、最后修改时间
  • 三种排序:名称/大小/修改日期,可切换升降序,选择会记住
  • 三档安全判定:可安全删除/需拆分确认/不可删除,混合目录会拆到子项
  • 一键定位:每行一个按钮,在资源管理器中打开并选中该目录
  • 按需联网:对未知目录可联网检索加模型总结,给出结论与带摘要的来源
  • 按需加载:不点图标不扫描;点开图标后先跑一次扫描,并做一次能力探测

安装

在 DSH 里安装

侧边栏「插件」→「安装第三方插件」,下面三种输入任选其一。

① npm 包链接

dsh-appdata-scanner

② GitHub 链接

https://github.com/twoweeks1995/dsh-appdata-scanner

③ 本地文件

先从 Releases 下载 tgz, 安装框填它的绝对路径,版本号以 Releases 页为准:

D:\temp\dsh-appdata-scanner-0.7.0.tgz

安装后完全退出 DSH 再启动,左侧栏会出现「AppData Scanner」图标。

详见 INSTALL.md。

设计原则

① 只读 不修改、不创建、不删除被扫描目录下的任何文件;插件里没有任何删除按钮,也不会执行任何删除命令。 命令行版 plan 只会打印一条回收站删除命令给你自己核对后手动执行。

② 说明优先于判断 先讲清这块空间是谁的、装了什么,再谈能不能删。只给「可删/不可删」而不说用途,等于让你盲删。

③ 语义优先于体积 先判用途再看大小。按体积排序然后勾大户,第一个就会建议你删掉聊天记录。

④ 混合目录必须拆分 一个目录里同时有缓存和用户数据时,不给整块结论,拆到子项分别判定。

⑤ 不确定就说不确定 知识库未命中的目录标记为「推测」;联网结论恒为【联网·未证实】;模型提示词里明确要求「只依据来源作答,不足就写信息不足」。

已知限制

  • 联网查询需要配置 API key。没有凭据时不会报错,只是把查询串复制到剪贴板,由你自己去问。
  • 配好凭据时,光是打开面板就会产生一次远端检索,用于探测联网能力,结果缓存 5 分钟。
  • 部署里没有 web 服务时,插件不会加载,因为该服务在 inject 里声明为必需。
  • 「在资源管理器中打开」依赖 explorer.exe,仅 Windows 可用;扫描与判定本身跨平台。
  • 首次打开面板需完整扫描一次,约 18 至 25 秒,才能给出精确体积,之后走缓存。
  • 树视图单个目录 5 秒预算、单次请求 20 秒预算;首次全量扫描每个顶层目录 15 秒预算,超大目录会标注「统计中断」。
  • 知识库覆盖的是常见应用目录。没覆盖到的目录只能给「推测」,这份参考的价值取决于知识库的完整度。

许可

MIT