Skip to content

v0.1.0 开发预览版

Pre-release
Pre-release

Choose a tag to compare

@xpeng5278-web xpeng5278-web released this 28 Sep 01:14
· 4 commits to main since this release

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。