# MangoDisk **Repository Path**: yanxbandy/mango-disk ## Basic Information - **Project Name**: MangoDisk - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-08 - **Last Updated**: 2026-11-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # MangoDisk // Deep Clean Protocol 黑金科技赛博风的 Web 磁盘清理产品演示。原生 HTML / CSS / JavaScript 前端,搭配零依赖 Node.js 生产服务器;包含 10 个主导航模块、18 项 HiBit 风格工具、模拟清理流程、本地数据持久化与本地生产部署。 品牌徽标使用项目提供的 YXB 圆形金色机械徽标,界面使用 Orbitron / Rajdhani 科技字体、HUD 扫描线、金色能量条与深色磨砂面板。 ![MangoDisk 深度清理界面](preview.png) ## 功能模块 - **深度清理**:11 个缓存分类、单项/半选/全选、智能选择策略、文件详情、清理确认、进度、结果与持久化。 - **大文件清理**:按体积/时间排序,类型筛选、搜索、批量选择与清理。 - **重复文件清理**:内容哈希分组、主版本保留、自动选择重复副本、批量清理。 - **磁盘空间分析**:交互式环形图、分类明细、目录占用、跳转到对应清理模块。 - **隐私清理**:8 类浏览与系统痕迹开关,清理结果持久化。 - **应用卸载**:应用搜索、90 天未使用筛选、批量卸载与残留清理。 - **启动项管理**:登录项/后台代理/守护进程开关、影响评估、推荐配置,状态持久化。 - **系统优化**:健康评分、8 项优化任务、单项/推荐批量执行。 - **系统维护**:磁盘、SMART、内存与更新检测,系统报告导出。 - **全能工具箱(HiBit 风格)**:Windows 应用、浏览器扩展、安装监视、程序组件、残留与强制卸载、服务、计划任务、进程、上下文菜单、Windows 更新、注册表、垃圾文件、空文件夹、快捷方式、文件粉碎、系统还原、备份管理。 - **操作历史**:按类型筛选、释放空间统计、JSON 导出、清空记录。 - **设置**:确认流程、通知、减少动态效果、历史导出、重置演示数据。 所有清理、卸载、优化和维护操作均为**界面模拟**,不会读取或删除真实文件。 ### 全能工具箱 参考 HiBit Uninstaller v2.1.26 中文绿色便携版的一体化工具矩阵,在单个「全能工具箱」页面内分为四组: - **卸载增强**:Windows 商店应用、浏览器扩展、安装监视、程序组件修复、残留扫描与强制卸载。 - **系统管理**:服务启停、计划任务、进程管理、右键菜单与 Windows 更新。 - **深度清理**:注册表扫描修复、垃圾文件、空文件夹、失效快捷方式。 - **安全与备份**:多遍覆写文件粉碎、系统还原点、注册表/驱动/应用数据备份。 工具会保存自己的状态与结果,刷新后继续保留;所有操作仍为演示模拟。 参考:[HiBit Uninstaller 功能列表(小众软件)](https://www.appinn.com/hibit-uninstaller/)、[HiBit Uninstaller 官网](https://hibit-uninstaller.com/zh/index.html) ![HiBit 风格全能工具箱](preview-toolbox.png) ## 运行 ### 直接预览 直接双击 `index.html` 即可。所有字体与图标均存放在本地,`file://` 协议下也能完整显示。 ### 本地生产环境(推荐) 需要 Node.js 18.18+。 ```powershell # 方式一:一键启动(Windows,推荐) .\start-production.cmd # 如果当前 PowerShell 允许本地脚本,也可以: powershell -ExecutionPolicy Bypass -File .\start-production.ps1 # 方式二:npm npm run build npm start ``` 启动后访问 。如果 8787 被占用,快捷启动会自动选择 8788–8790 / 4173 / 8090 中的空闲端口,并把实际地址写入 `.runtime/mangodisk.json`。 ### 快捷启动 / 关闭 **Windows 桌面快捷方式**(推荐): - `MangoDisk 启动`:后台构建/启动服务,并自动打开浏览器 - `MangoDisk 关闭`:安全停止 MangoDisk 服务并提示结果 快捷方式可以通过以下命令重新创建: ```powershell powershell -ExecutionPolicy Bypass -File .\scripts\create-shortcuts.ps1 ``` 也可以在项目目录直接双击: - `MangoDisk-Start.cmd` - `MangoDisk-Stop.cmd` 启动器会自动查找 Node.js、检测已有实例、自动选择空闲端口,并把 PID 写入 `.runtime/mangodisk.json`。关闭器只停止记录在案且命令行为 `server.mjs` 的进程,不会误杀其他 Node 服务。 如果希望从其他设备访问: ```powershell powershell -ExecutionPolicy Bypass -File .\scripts\quick-start.ps1 -BindHost "0.0.0.0" -Port 8787 -NoOpen ``` `start-production.cmd` 可直接双击启动,它会自动定位 Node.js、执行生产构建并启动服务。 生产服务默认只绑定 `127.0.0.1`。如需局域网访问: ```powershell $env:HOST = "0.0.0.0" $env:PORT = "8787" npm start ``` 也可以在启动脚本中指定: ```powershell powershell -ExecutionPolicy Bypass -File .\start-production.ps1 -BindHost "0.0.0.0" -Port 8787 ``` ### 生产特性 - 零运行时依赖的静态服务器 `server.mjs` - `npm run build` 生成自包含的 `dist/` - gzip 压缩、ETag、条件请求与静态资源缓存策略 - CSP、`X-Content-Type-Options`、`X-Frame-Options`、Permissions Policy 等安全头 - `/healthz` 健康检查接口 - SPA 路由回退、HEAD 支持、路径穿越防护 - 优雅关闭与请求日志 ### 测试 ```powershell npm test ``` 测试覆盖页面、健康检查、缓存头、404、405 与 HEAD 请求。 ## 数据与持久化 所有数据均在浏览器本地生成。以下内容写入 `localStorage`: - 清理、卸载、隐私处理与系统优化结果 - 启动项启用状态 - 操作历史 - 设置与侧边栏状态 页面刷新后结果仍然保留。可在「设置」中导出历史或重置演示数据。清理操作不会访问真实文件系统。 ## 目录 ``` index.html 页面结构 styles.css 黑金赛博视觉、HUD 动效与响应式布局 app.js 模块数据、渲染、交互与持久化 server.mjs 零依赖本地生产服务器 scripts/build.mjs 生产构建脚本 scripts/quick-start.ps1 快捷启动(后台、自动选端口) scripts/quick-stop.ps1 快捷关闭 scripts/create-shortcuts.ps1 创建桌面快捷方式 MangoDisk-Start.cmd 双击快捷启动 MangoDisk-Stop.cmd 双击快捷关闭 start-production.ps1 Windows 一键构建与前台启动 start-production.cmd 双击前台启动入口 tests/server.test.mjs 服务器测试 assets/brand/ YXB 徽标原图与优化版本 assets/fonts/ Orbitron / Rajdhani 本地字体 assets/icons/sprite.js 运行时注入的 SVG 图标集 assets/icons/ 图标源文件 preview.png 深度清理界面预览 preview-toolbox.png 全能工具箱界面预览 dist/ 构建产物(不提交) ``` ## 资源许可 - [Lucide](https://lucide.dev/) — ISC License - [Simple Icons](https://simpleicons.org/) — CC0 1.0 - [Font Awesome Free](https://fontawesome.com/) — CC BY 4.0(品牌图标) - [Orbitron](https://fonts.google.com/specimen/Orbitron) / [Rajdhani](https://fonts.google.com/specimen/Rajdhani) — SIL Open Font License 1.1 品牌名称与标识归各自所有者所有。本项目是非商业的界面练习,MangoDisk 的名称与原始设计归原作者所有。