spacesniffer-to-md
v1.0.2
Published
Convert SpaceSniffer export files to Markdown tree for AI analysis
Maintainers
Readme
SpaceSniffer 结果转 AI 格式阅读器
由于大语言模型 (AI) 读取大量图片的截图会耗费极多的 Token 并且有时容易错位,本项目将 SpaceSniffer 的导出数据快速转化为 Markdown 树状层级文本,完美适配各大主流 AI(如 Gemini, DeepSeek, ChatGPT 等),方便 AI 帮你一键诊断磁盘空间如何清理。
第一步:从 SpaceSniffer 导出数据
我发现您可以直接使用 SpaceSniffer 自带的默认格式!无需做任何复杂的配置:
- 打开 SpaceSniffer 扫描您的磁盘。
- 在顶部菜单栏点击
File > Export...(文件 > 导出)。 - 在弹出的 Export 窗口中,Configuration (配置) 下拉菜单直接选择自带的
Grouped by folder即可(这就是您截图中默认的首选状态)。 - 点击界面上的 Run (或者存盘图标) 将结果保存为一个
txt文本文件,例如C_Drive_Scan.txt。
(注:系统同时也兼容通过 <path>|<disksizebytes> 的底层定制导出模式。)
第二步:使用该工具进行转换
无需安装,只要您的电脑有 Node.js 环境,打开终端直接使用 npx 运行即可:
# 基本用法:
npx spacesniffer-to-md "C_Drive_Scan.txt"
# 高级用法(可自定义输出路径和过滤门槛)
# 默认会过滤掉小于 50MB 的小文件。如果想改成过滤 100MB,可以传入字节大小 (-t 104857600)
npx spacesniffer-to-md "C_Drive_Scan.txt" -o "Report.md" -t 104857600第三步:发给 AI 开始清理之旅
打开生成的 analysis_ready.md,您可以:
- 浏览文件底部的 📝 用户补充说明,在里面告诉 AI 哪些是你的重要工作文件不能动。
- 然后
Ctrl + A复制该文件的全部内容,直接贴到 AI 对话框中即可!
