Repository navigation
Releases: xpeng5278-web/diskpilot
Releases · xpeng5278-web/diskpilot
Release list
v0.1.1 免安装预览版
这是过渡版本。 推荐使用轻量版 DiskPilot Lite v0.2.0:约 23 KB,双击一次就能扫描 C 盘。
第一个免安装版本:下载 zip 解压,双击就能用
用法
- 下载下面的
DiskPilot-0.1.0-win-x64.zip - 解压到任意文件夹(请先解压,不要在压缩包里直接运行)
- 双击
启动 DiskPilot.cmd,浏览器会自动打开
Windows 第一次运行下载来的 .cmd 可能弹出安全提示,点「更多信息」再点「仍要运行」即可。
这一版的变化
- 自带 Node 运行时(v24.21.0),不需要装 Node、git 或任何依赖
- 示例报告换成 GB 级数据(约 178 GB,7 个分类),轻度、中度、重度三档方案都有内容
- 没装 WizTree 时界面会给出提示和安装方法,示例报告照常可用
需要
- Windows 10 或更高版本
- 真实扫描需要自己安装 WizTree(
winget install AntibodySoftware.WizTree),本包不附带
DiskPilot 只在本机分析,不上传任何数据;它只给清理建议,不会删除文件。
v0.1.0 开发预览版
DiskPilot 首个公开开发预览版。它借助你本机已安装的 WizTree 扫描磁盘,帮你看懂 Windows 磁盘空间去了哪里,再决定如何整理。只提供建议,不删除、不迁移任何文件;扫描数据不上传。
⚠️ 这是开发预览版(pre-release):目前没有一键安装包,需要从源码运行;功能和界面可能继续调整。
主要功能
- 全盘扫描与进度:默认扫描 Windows 识别的所有就绪固定磁盘(不含网络盘、可移动盘),不会自动开始;也可指定文件夹或磁盘根目录。扫描时显示当前磁盘与阶段,解析 CSV 时显示实际读取百分比,并可随时取消。
- 按用途分类:系统与程序、开发与应用缓存、可重建的构建产物、下载与安装包、个人文件、应用数据等,并列出最大的文件和文件夹。同时显示文件大小总计和 WizTree 磁盘分配量。
- 轻度 / 中度 / 重度分级方案:从缓存,到可重建的项目产物,再到下载与个人文件的迁移,逐级展示可优先查看的空间。
- 复核清单:在方案中勾选待复核路径,勾选状态在本机浏览器中保留;勾选只表示“待你核对”,不会触发任何操作。
- Markdown 报告导出:导出中文复核报告,包含分类、分级方案、已勾选清单、最大路径。
- 示例报告:没有 Windows 或 WizTree 也可点击“加载示例报告”预览界面(内置模拟数据,会明确标注)。
- 仅本机运行:网页服务只监听 127.0.0.1;WizTree 生成的临时 CSV 解析后立即删除;不调用外部网络 API,不含统计 SDK。
- 不删除文件:DiskPilot 不执行任何删除或迁移,系统目录和应用数据建议通过官方卸载或迁移方式处理。
运行要求
- Windows(真实扫描和桌面助手仅支持 Windows)
- Node.js 20 或更高版本
- 自行安装的 WizTree(本项目不包含其程序文件,使用须遵守其官方许可);安装在非标准位置时设置
WIZTREE_PATH - 桌面助手(文件夹选择器)需要 Windows 自带的 .NET Framework 4
快速开始
git clone https://github.com/xpeng5278-web/diskpilot.git
cd diskpilot
git checkout v0.1.0
npm run desktop保持桌面助手窗口打开,访问终端显示的本机地址。只想预览界面可运行 npm start 并点击“加载示例报告”。
已知限制
- 尚无一键安装包或签名的可执行文件。
- 候选空间不等于可释放空间;嵌套文件夹可能重复显示。
- 默认不请求管理员权限,完整扫描 C 盘可能较慢或跳过部分受保护目录。
- 多盘扫描中任一磁盘失败会结束本次任务,不会输出不完整报告。
反馈问题前请对路径、用户名和报告脱敏,详见 CONTRIBUTING.md。