Release Squid 0.1.4 with restored navigation
- Restore Deep Clean, Storage, and Real-time monitor menu entries - Group the full sidebar navigation under Maintenance and Insights - Reorganize README around the current desktop, CLI, architecture, and release model - Package macOS and Windows 0.1.4 installers and update manifestmain
parent
09ba6c6b36
commit
20c20128e1
|
|
@ -62,3 +62,5 @@ __pycache__/
|
|||
# ── 显式纳管的发布产物 ───────────────────────────────────────────────
|
||||
!release/0.1.3/Squid-0.1.3-macOS-universal.dmg
|
||||
!release/0.1.3/Squid-Setup-0.1.3-win-x64.exe
|
||||
!release/0.1.4/Squid-0.1.4-macOS-universal.dmg
|
||||
!release/0.1.4/Squid-Setup-0.1.4-win-x64.exe
|
||||
|
|
|
|||
|
|
@ -967,7 +967,7 @@ checksum = "5b3dc8af474f516a851ff4bd12db780f948b9250ad37211e4eec0bccea54e01b"
|
|||
|
||||
[[package]]
|
||||
name = "squid-cli"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"chrono",
|
||||
|
|
@ -986,7 +986,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-core"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"chrono",
|
||||
|
|
@ -1005,7 +1005,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-engine"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"chrono",
|
||||
|
|
@ -1025,7 +1025,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-platform"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"dirs",
|
||||
"libc",
|
||||
|
|
@ -1042,7 +1042,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-rules"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"globset",
|
||||
"serde",
|
||||
|
|
@ -1054,7 +1054,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-stats"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"chrono",
|
||||
"libc",
|
||||
|
|
@ -1066,7 +1066,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-tui"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"chrono",
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ members = ["crates/*"]
|
|||
exclude = ["src-tauri"]
|
||||
|
||||
[workspace.package]
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
edition = "2021"
|
||||
rust-version = "1.80"
|
||||
license = "GPL-3.0-only"
|
||||
|
|
|
|||
522
README.md
522
README.md
|
|
@ -1,385 +1,279 @@
|
|||
# squid
|
||||
# Squid
|
||||
|
||||
macOS / Windows 磁盘清理与系统监控工具:清理缓存与系统垃圾、卸载 App 并连带清掉残留、深度清理构建产物、
|
||||
分析磁盘占用、实时监控资源。命令行与内置 TUI 共用同一套引擎,产物是一个静态二进制,
|
||||
不装后台进程、不写 shell 配置、不需要 root。
|
||||
**给你的电脑洗个澡。**
|
||||
|
||||
Squid 是面向 macOS 与 Windows 的本地系统维护工具:清理可重建的缓存与系统垃圾、卸载应用并处理残留、清理项目构建产物、分析磁盘占用,以及实时查看系统状态。
|
||||
|
||||
桌面端、命令行与 TUI 共用同一套 Rust 扫描和删除引擎。清理规则、安全边界、删除账本与配置只维护一份,不依赖云端服务,也不需要 root。
|
||||
|
||||
## 产品组成
|
||||
|
||||
| 入口 | 技术栈 | 二进制 |
|
||||
| --- | --- | --- |
|
||||
| 桌面应用 | Tauri 2 + React 19 + TypeScript + Vite 6 | `squid-desktop` |
|
||||
| 命令行 | Rust + clap | `squid` |
|
||||
| 终端界面 | Rust + ratatui + crossterm | `squid state` |
|
||||
|
||||
桌面端支持 macOS 12+ 与 Windows 10/11 x64;CLI/TUI 使用同一个 Rust workspace。
|
||||
|
||||
## 功能
|
||||
|
||||
| 功能 | 说明 |
|
||||
| --- | --- |
|
||||
| 电脑概览 | 磁盘健康、常用操作入口与 CPU、内存、存储摘要 |
|
||||
| 日常清理 | macOS 38 条 / Windows 30 条内置规则,覆盖应用与浏览器缓存、日志、崩溃报告、开发缓存与废纸篓等 |
|
||||
| 应用卸载 | 按名称定位应用,把应用本体与偏好、缓存、容器或 AppData 残留组成同一个卸载计划 |
|
||||
| 深度清理 | 查找 `node_modules` 等可重建构建产物、磁盘镜像、安装包和陈旧下载,并保护近期仍在使用的项目 |
|
||||
| 存储空间 | 逐层测量目录、查看最大子项与最大文件 |
|
||||
| 实时监控 | 每两秒采样 CPU、内存、网络、磁盘、电池、卷和高占用进程,可确认后结束进程 |
|
||||
| 历史与撤销 | 每次真实删除写入本地账本;仍在废纸篓或回收站中的内容可以还原 |
|
||||
| 系统更新 | 从发布分支检查、校验、下载并安装新版本 |
|
||||
|
||||
界面支持中文和英文,跟随 Squid 的语言设置与系统语言。
|
||||
|
||||
## 桌面应用
|
||||
|
||||
仓库现在同时提供 macOS / Windows 原生桌面程序 **Squid**。桌面端沿用 `nex_shift` 的技术栈
|
||||
(Tauri 2 + React 19 + TypeScript + Vite)和更新通道,直接复用本仓库现有 Rust 清理引擎:
|
||||
### 左侧菜单
|
||||
|
||||
- 界面:CleanMyMac 风格的概览、清理、应用卸载、深度清理、存储空间、系统状态、历史记录和设置;
|
||||
- 安全:GUI 只能选择后端扫描缓存中的索引,删除前仍由 Rust 引擎重新校验路径、锚点、白名单和锁定状态;
|
||||
- 更新:`releases` 分支中的 `squid-update.json` + 安装包,文件大小与 SHA256 始终校验,可选 Ed25519 清单签名;
|
||||
- 本地化:中英双语,跟随现有 `Settings` 语言偏好。
|
||||
- **维护**:电脑概览、日常清理、应用卸载、深度清理
|
||||
- **洞察**:存储空间、实时监控
|
||||
- **底部**:历史记录、设置
|
||||
|
||||
开发与构建:
|
||||
`⌘1`–`⌘8`(macOS)或 `Ctrl+1`–`Ctrl+8`(Windows)可以直接切换页面。
|
||||
|
||||
### 常驻托盘
|
||||
|
||||
关闭主窗口只会隐藏窗口,Squid 进程继续运行。托盘菜单提供:
|
||||
|
||||
- 打开 Squid
|
||||
- 日常清理
|
||||
- 应用卸载
|
||||
- 深度清理
|
||||
- 退出 Squid
|
||||
|
||||
再次打开应用、双击应用图标或通过单实例唤起时,会恢复并聚焦主窗口。只有选择“退出 Squid”才会结束进程。
|
||||
|
||||
### 软件更新
|
||||
|
||||
- 设置中的系统信息面板始终显示当前系统版本、架构与 Squid 版本。
|
||||
- 只有检测到更高版本时,才显示版本变化和更新说明;已经是最新版本时不显示额外提示。
|
||||
- 自动检查默认开启,每天最多检查一次。
|
||||
- 安装包必须通过 SHA256 与文件大小校验;带发布公钥的构建还会校验清单的 Ed25519 签名。
|
||||
|
||||
### 权限与隐私
|
||||
|
||||
- 首次启动会显示一次可选的全盘访问检查,不会强制弹出 macOS 权限窗口,也不会阻止应用启动。
|
||||
- “设置 → 系统权限”提供权限状态检查和打开“系统设置 → 隐私与安全性 → 全盘访问”的入口。
|
||||
- 没有全盘访问时,受 TCC 保护的位置会被跳过,其余功能仍然可用。
|
||||
- 存储分析与深度清理只在用户选择或配置目录后读取;文件内容不会上传。
|
||||
- 除更新检查和安装包下载外,应用不发起网络请求。
|
||||
|
||||
完整说明见 [`docs/DESKTOP.md`](docs/DESKTOP.md)。
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 桌面端开发
|
||||
|
||||
环境要求:
|
||||
|
||||
- Node.js 20+ 与 pnpm
|
||||
- Rust stable
|
||||
- macOS:Xcode Command Line Tools
|
||||
- Windows:MSVC Build Tools 与 WebView2 Runtime
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
pnpm desktop:dev # 开发窗口
|
||||
pnpm desktop:build # 当前平台安装包
|
||||
bash scripts/build-macos-release.sh
|
||||
bash scripts/build-windows-release.sh
|
||||
pnpm desktop:dev
|
||||
```
|
||||
|
||||
完整的桌面架构、权限和发布说明见 [`docs/DESKTOP.md`](docs/DESKTOP.md) 与
|
||||
[`docs/RELEASE.md`](docs/RELEASE.md)。Nex 系列应用的统一主色与设计常量见
|
||||
[`docs/DESIGN.md`](docs/DESIGN.md)。下面的 CLI / TUI 文档仍然有效,三个入口共用同一套扫描与删除核心。
|
||||
仅运行 Vite 页面时无法调用 Tauri 命令;需要验证扫描、删除、系统数据或更新流程时请使用 `pnpm desktop:dev`。
|
||||
|
||||
## 特性
|
||||
|
||||
| 能力 | 说明 | 桌面 / CLI |
|
||||
| --- | --- | --- |
|
||||
| 清理 | 内置规则 macOS 39 条 / Windows 30 条:应用与浏览器缓存、日志与崩溃报告、Xcode DerivedData、Windows Update 残留、废纸篓 / 回收站等 | 桌面“清理” / `squid clean` |
|
||||
| 卸载 | 按名称定位 App(macOS 扫 `/Applications` 与 bundle id,Windows 读注册表卸载表),本体与散落的偏好、缓存、容器 / AppData 残留一起进入删除计划 | 桌面“应用程序” / `squid uninstall` |
|
||||
| 深度清理 | `node_modules` 等项目构建产物、磁盘镜像、陈旧安装包与下载 | 桌面“深度清理” / `squid purge` |
|
||||
| 存储分析 | 体积树与最大文件,可逐层下钻 | 桌面“存储空间” / `squid analyze` |
|
||||
| 系统监控 | CPU / 内存 / 网络 / 磁盘 / 电池 / 温度 / 进程,并可结束选中的进程 | 桌面“系统状态” / `squid status` |
|
||||
| 历史与撤销 | 每次真实删除写一条 JSON 账本,可将仍在废纸篓 / 回收站里的文件原样放回 | 桌面“历史记录” / `squid history`、`squid undo` |
|
||||
|
||||
- 语言:Rust 1.80+,workspace 由 7 个 crate 组成
|
||||
- 界面:中英双语文案,跟随系统语言;真彩色 / 256 色 / 无色三档自动适配
|
||||
- 结构:命令行与 TUI 共用同一套扫描与删除通道,行为、确认、账本完全一致
|
||||
- 平台:macOS 完整支持;Windows 10 / 11 用同一个构建,已在局域网真机跑通(那台机器自报
|
||||
`Windows 10 Pro (build 18363)`):回收站真实删除与还原、按名称卸载并带走 AppData 残留、系统面板结束进程,
|
||||
中英文 TUI 在 legacy conhost + cp936 下的排版由判据守着而不是靠肉眼——界面启动时自己量一次
|
||||
「一个字形在这里占几格」,被收两格就整屏改用 ASCII 边框,不再叠成花屏;
|
||||
UAC 提权、Windows 11 复验与 Linux 见[路线图](#路线图)
|
||||
|
||||
---
|
||||
|
||||
## 安装
|
||||
|
||||
squid 是一条普通命令:装完之后在任意目录敲 `squid` 即可,不需要进入安装目录执行。
|
||||
|
||||
### 从源码
|
||||
### CLI / TUI
|
||||
|
||||
```bash
|
||||
cargo install --path crates/squid-cli # 装到 ~/.cargo/bin
|
||||
# 或本地构建
|
||||
cargo build --release -p squid-cli && ./target/release/squid --help
|
||||
```
|
||||
cargo install --path crates/squid-cli
|
||||
# 或
|
||||
cargo build --release -p squid-cli
|
||||
|
||||
### 脚本安装
|
||||
|
||||
```bash
|
||||
./scripts/install.sh # 使用 target/release/squid
|
||||
./scripts/install.sh ./dist/squid # 安装已下载的二进制
|
||||
PREFIX=~/.local/bin ./scripts/install.sh # 免 sudo,装进指定目录
|
||||
```
|
||||
|
||||
安装目录按 `PREFIX` → `/opt/homebrew/bin` → `/usr/local/bin` → `~/.local/bin` 取第一个可写者;
|
||||
前两者本身就在 `PATH` 上,落到 `~/.local/bin` 且它不在 `PATH` 时,脚本会打印一行待追加到 `~/.zshrc`
|
||||
的 `export PATH=`。脚本同时清除 `com.apple.quarantine` 并补一次 ad-hoc 签名。
|
||||
|
||||
### 预编译包
|
||||
|
||||
发布产物是通用二进制(arm64 + x86_64)的 tar.gz,附带 sha256;发布脚本目前只出 Apple 产物,
|
||||
Windows 需从源码构建(`cargo build --release --target x86_64-pc-windows-msvc`):
|
||||
|
||||
```bash
|
||||
curl -LO https://github.com/nexdev/squid/releases/download/v0.1.0/squid-0.1.0-universal-apple-darwin.tar.gz
|
||||
curl -LO https://github.com/nexdev/squid/releases/download/v0.1.0/squid-0.1.0-universal-apple-darwin.tar.gz.sha256
|
||||
shasum -a 256 -c squid-0.1.0-universal-apple-darwin.tar.gz.sha256
|
||||
|
||||
tar xzf squid-0.1.0-universal-apple-darwin.tar.gz
|
||||
install -m 0755 squid-0.1.0-universal-apple-darwin/squid /usr/local/bin/squid
|
||||
xattr -d com.apple.quarantine /usr/local/bin/squid 2>/dev/null || true
|
||||
```
|
||||
|
||||
包内是 `squid` 通用二进制、`LICENSE`、`README.md`;单架构构建的包名为
|
||||
`squid-<版本>-aarch64-apple-darwin.tar.gz` / `…-x86_64-apple-darwin.tar.gz`。
|
||||
|
||||
### Homebrew
|
||||
|
||||
[`packaging/homebrew/squid.rb`](packaging/homebrew/squid.rb) 是可直接放进自有 tap 的 formula 模板,
|
||||
填入发布脚本输出的 sha256 后 `brew install <yourname>/tools/squid`。
|
||||
|
||||
### Gatekeeper 与签名
|
||||
|
||||
随仓库脚本产出的是 ad-hoc 签名二进制,本机自用与 `install.sh` 安装不会触发拦截。分发给他人时
|
||||
需要 Apple Developer ID 签名与公证:
|
||||
|
||||
```bash
|
||||
codesign --force --options runtime --sign "Developer ID Application: <Team>" dist/squid
|
||||
xcrun notarytool submit dist/squid-<版本>-universal-apple-darwin.tar.gz --keychain-profile squid --wait
|
||||
xcrun stapler staple dist/squid-<版本>-universal-apple-darwin.tar.gz
|
||||
```
|
||||
|
||||
## 快速上手
|
||||
|
||||
先看,再删——所有会动文件的命令都支持 `--dry-run`:
|
||||
|
||||
```bash
|
||||
squid status # 一次性系统快照(CPU / 内存 / 磁盘 / 进程)
|
||||
squid doctor # 权限、配置、历史自检,并打印生效路径
|
||||
|
||||
squid clean --dry-run # 只看能清多少
|
||||
squid clean # 扫描 → 逐项确认 → 移入废纸篓
|
||||
squid clean --categories caches,browsers --min-age 7
|
||||
|
||||
squid uninstall --list # 已安装的 App 及体积
|
||||
squid uninstall Xmind --dry-run # 预览 App 本体 + 残留清单
|
||||
squid uninstall Xmind # 卸载并删除残留
|
||||
|
||||
squid purge --dry-run # 项目构建产物(node_modules 等)
|
||||
squid purge ~/code ~/work # 指定目录
|
||||
|
||||
squid analyze ~/Library/Caches # 磁盘占用树
|
||||
squid history # squid 删过什么
|
||||
squid state # TUI
|
||||
squid status # 系统快照
|
||||
squid clean --dry-run # 预览可清理内容
|
||||
squid uninstall --list # 已安装应用
|
||||
squid purge ~/code # 深度清理项目构建产物
|
||||
squid analyze ~/Library/Caches # 存储分析
|
||||
squid history # 历史账本
|
||||
squid undo # 还原最近一次废纸篓会话
|
||||
squid state # 进入 TUI
|
||||
```
|
||||
|
||||
## 命令一览
|
||||
常用命令:
|
||||
|
||||
全局参数:`--json`(机器可读,日志走 stderr)、`--quiet`、`--no-color`、`--lang <zh|en>`。
|
||||
|
||||
| 命令 | 作用 | 常用参数 |
|
||||
| --- | --- | --- |
|
||||
| `clean` | 按规则清理缓存、日志、浏览器与开发者垃圾、崩溃报告、废纸篓等 | `--dry-run` `-y` `--categories <a,b>` `--orphans` `--min-age <天>` `--user-only` `--trash` `--permanent` |
|
||||
| `uninstall [NAME]` | 按名称定位 App(Windows 取注册表卸载表),生成并执行「本体 + 残留」计划 | `--list` `--dry-run` `-y` `--trash` `--permanent` `--json` |
|
||||
| `purge [PATHS…]` | 深度清理:项目构建目录、磁盘镜像、安装包、陈旧下载 | `--dry-run` `-y` `--all` `--min-age <天>` `--json` |
|
||||
| `state` | 打开 TUI:清理 / 卸载 / 深度清理 / 存储 / 系统 / 历史 | — |
|
||||
| `status` | 系统快照,适合脚本与 cron | `--processes <n>` |
|
||||
| `analyze [PATH]` | 单路径体积树与最大文件(默认主目录) | `--depth <层>` `--top <n>` `--files` |
|
||||
| `history` | 历史会话(时间、命令、释放空间、条目数) | `--limit <n>` |
|
||||
| `undo [ID]` | 还原某次废纸篓会话(默认最近一次) | — |
|
||||
| `whitelist add\|list\|remove` | 保护路径,任何扫描不再选中它 | — |
|
||||
| `rules` | 列出当前生效的规则 | `--json` |
|
||||
| `doctor` | 权限探测、配置与历史健康检查 | `--json` |
|
||||
|
||||
## TUI(`squid state`)
|
||||
|
||||
六个面板:`1` 清理 · `2` 卸载 · `3` 深度清理 · `4` 存储 · `5` 系统 · `6` 历史。
|
||||
|
||||
启动后焦点位于左侧功能选择区,`↑`/`↓` 选功能,`enter` 或 `esc` 将方向键交还给右侧数据列表,
|
||||
再按一次 `esc` 回到菜单。
|
||||
|
||||
| 按键 | 功能 |
|
||||
| 命令 | 作用 |
|
||||
| --- | --- |
|
||||
| `Tab` / `1`–`6` | 切换面板 |
|
||||
| `esc` | 逐级返回,一次退一级:确认框 → 取消;卸载计划 → 应用列表;最大文件 → 原目录;目录 → 上一级;列表 → 功能菜单。帮助浮层与筛选输入框同样响应 `esc`(确认框还可用 `n`、`backspace` 取消) |
|
||||
| `⌥↑` / `⌥↓`(或 `Ctrl+↑/↓`) | 在任意面板直接切换六个功能 |
|
||||
| `j` `k` `↑` `↓`、`PgUp`/`PgDn`、`Home`/`End` | 移动 |
|
||||
| `space` | 勾选条目或整个分组 |
|
||||
| `enter` | 扫描 / 查看详情 / 进入目录 |
|
||||
| `s` | 扫描当前面板 |
|
||||
| `a` | 全选 / 全不选 |
|
||||
| `d` | 清理已勾选内容 |
|
||||
| `x` | 系统面板:结束光标所在的进程(先弹确认框,复述 pid / CPU / 内存并说明「它不会有机会保存任何内容」);其余面板与 `d` 等价 |
|
||||
| `m` | 废纸篓 ⇄ 永久删除 |
|
||||
| `u` | 还原上一次废纸篓会话 |
|
||||
| `f` | 卸载面板:筛选应用列表(`esc` 清空筛选、`enter` 保留);存储面板:列出当前目录最大的文件 |
|
||||
| `h` `l` `←` `→` | 折叠 / 进入 |
|
||||
| `r` | 刷新当前面板 |
|
||||
| `c` | 取消正在运行的任务 |
|
||||
| `?` / `q` | 帮助 / 退出 |
|
||||
| `clean` | 按规则清理缓存、日志、浏览器与开发者垃圾、崩溃报告和废纸篓 |
|
||||
| `uninstall [NAME]` | 定位应用并生成“本体 + 残留”卸载计划 |
|
||||
| `purge [PATHS…]` | 清理项目构建目录、磁盘镜像、安装包与陈旧下载 |
|
||||
| `state` | 打开包含清理、卸载、深度清理、存储、系统和历史面板的 TUI |
|
||||
| `status` | 输出 CPU、内存、网络、磁盘、电池与进程快照 |
|
||||
| `analyze [PATH]` | 输出目录体积树与最大文件 |
|
||||
| `history` / `undo [ID]` | 查看历史或还原废纸篓会话 |
|
||||
| `whitelist add\|list\|remove` | 维护永不选中的保护路径 |
|
||||
| `rules` | 列出当前生效的规则 |
|
||||
| `doctor` | 检查权限、配置、历史文件和生效路径 |
|
||||
|
||||
删除完成后自动重新扫描当前面板,分组容量随之重算;存储面板的磁盘占用走后台刷新,
|
||||
停在某个下钻目录时只提示按 `r`。进废纸篓不等于已释放空间,标题会区分「移入废纸篓」与「真正释放」,
|
||||
被 `u` 还原的会话在总计中记为 `0`。
|
||||
所有删除命令都支持 `--dry-run`;非交互环境必须使用 `-y/--yes`。完整参数请运行 `squid <command> --help`。
|
||||
|
||||
任务执行期间的按键会给出明确提示(按 `c` 可取消),确认框在忙时保留待确认内容直到任务结束。
|
||||
## 架构
|
||||
|
||||
**显示适配**:启动时探测终端能力并分三档——终端明确声明支持真彩色(`COLORTERM=truecolor|24bit`、
|
||||
iTerm、WezTerm、Ghostty、VS Code、`TERM` 含 `truecolor`)时按设计的 RGB 绘制;否则退到 256 色,
|
||||
每个 RGB 就近映射到 xterm 调色板,选中行使用灰底高亮条、数据列表用相邻两级灰度交替;
|
||||
`NO_COLOR` 或 `TERM=dumb` 时完全不发颜色。三档下选中、勾选、进度都由反白 / 加粗 / `●○` / `█░`
|
||||
表达,不依赖颜色。`SQUID_TRUECOLOR=always|never` 强制指定档位。
|
||||
```text
|
||||
crates/
|
||||
├── squid-core 模型、路径、安全策略、设置、删除账本、进度与取消
|
||||
├── squid-platform macOS / Linux / Windows 平台适配:应用、残留、卷、回收站、进程
|
||||
├── squid-rules TOML 规则引擎:模式展开、锚点、保护、年龄与风险标记
|
||||
├── squid-stats sysinfo 采样、趋势、电池、网络与磁盘活动
|
||||
├── squid-engine clean / uninstall / purge / analyze 与唯一删除通道
|
||||
├── squid-tui ratatui 终端界面
|
||||
└── squid-cli clap 命令行入口
|
||||
|
||||
**Windows 控制台**:legacy conhost 进备用屏时换掉的只是「正在显示的那块缓冲区」,进程手里的窗口比真实
|
||||
存在的格子更宽;cp936 码页又把 `─│·…↑↓✓` 这批 East Asian Ambiguous 字形收两格,而排版按一格算。
|
||||
两种偏差最后长成同一种花屏,所以界面每一拍重新量一次尺寸(只有真的变了才擦屏重画),并在启动时
|
||||
逐字符量一次字形的价格(往屏幕上写一个字符再擦掉),付不起的字符整屏换成 ASCII 边框。
|
||||
命令行不当这个测量的客人——测量要动它正显示的东西——它按码页取悲观值,代价是被误伤的机器上少一个
|
||||
`█`、多一个 `#`。`SQUID_SYMBOL_CELLS=1|2` 强制指定价格,`SQUID_CONSOLE_TRACE=<文件>` 把控制台自报的
|
||||
几组数字写进文件留证。
|
||||
src/ React 桌面界面
|
||||
src-tauri/ Tauri 壳、命令适配、托盘、权限检查与更新器
|
||||
scripts/ 开发、验证与双平台发布脚本
|
||||
docs/ 架构、设计、桌面与发布规范
|
||||
```
|
||||
|
||||
**语言**:中英双语,判定顺序为配置文件 `language` → `SQUID_LANG` → `LC_ALL` → `LC_MESSAGES` →
|
||||
`LANG` → macOS 系统偏好(`AppleLocale`/`AppleLanguages`)→ 英文;`C`/`POSIX`/空值视为无信息继续下探。
|
||||
`squid doctor` 与 TUI 的 `?` 面板都会打印最终生效的语言与配色档位及其来源。
|
||||
核心依赖方向:
|
||||
|
||||
```text
|
||||
squid-core → squid-platform → squid-rules → squid-stats → squid-engine → squid-tui → squid-cli
|
||||
```
|
||||
|
||||
`src-tauri` 独立于根 Cargo workspace,但直接依赖 `squid-core`、`squid-platform`、`squid-stats` 与 `squid-engine`,桌面端不维护第二套清理实现。
|
||||
|
||||
更多设计见 [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md);Nex 系列统一颜色、字体和组件常量见 [`docs/DESIGN.md`](docs/DESIGN.md)。
|
||||
|
||||
## 安全模型
|
||||
|
||||
前提:**可以清理一个 245 GB 的系统盘,但不能毁掉其中的任何用户文件。**
|
||||
1. **索引式删除**:桌面界面只能提交扫描结果中的索引,不能提交任意待删除路径。
|
||||
2. **执行前复验**:Rust 层重新构造扫描条目,并检查路径所有权、安全锚点、保护列表、白名单与锁定状态。
|
||||
3. **默认进废纸篓**:删除模式默认是 `trash`;只有显式选择永久删除才直接移除。
|
||||
4. **硬性禁区**:系统根目录、`/usr`、`/System`、`/Applications` 等位置不能被递归删除;符号链接不会被跟随。
|
||||
5. **规则刹车**:规则支持 `protect`、`min_age_days`、`skip_if_running` 与 `risky` 标记。
|
||||
6. **账本与撤销**:真实删除记录到本地 JSON 账本,仍在废纸篓中的文件可以还原。
|
||||
7. **进程保护**:结束进程前重新采样并核对名称,拒绝 Squid 自身、系统首进程和关键系统进程。
|
||||
|
||||
1. **默认进废纸篓 / 回收站**:`DeleteMode::Trash` 为默认,`--permanent` 才执行 `unlink`;卸载计划包含 App 本体;`squid undo` 原样放回。
|
||||
2. **`--dry-run` everywhere**:任何删除命令都能只看不动。
|
||||
3. **非交互环境需显式确认**:stdin 不是 TTY 时,缺少 `-y/--yes` 直接拒绝执行删除。
|
||||
4. **删除时二次校验**:执行前对每条重新做安全检查、白名单检查与锚点校验;嵌套子项先于父项处理,避免重复计数与 `ENOENT`。
|
||||
5. **硬性禁区**:`squid_core::safety::SafetyPolicy` 内置 `HARD_DENY`(`/`、`/usr`、`/System`、`/Library`、`/Applications`、`/private/var/folders` …)与 `DENY_EXACT`(`~/Library`、`~/Documents`、`~/.ssh`、`~/.aws` … 只允许删子项);递归删除要求位于允许锚点之下至少 `min_depth = 1` 层,且永不跟随符号链接。
|
||||
6. **规则自带刹车**:`protect` 白名单、`min_age_days`、`needs_admin`、`skip_if_running`(进程运行时不提出删除其虚拟磁盘)、`risky`(默认不勾选并提示复核)。
|
||||
7. **删除账本与 `undo`**:每次真实删除写一个 JSON 会话,记录每条的废纸篓目标路径;Windows 的回收站自己保管文件,账本只记「它进了回收站」,还原因此在资源管理器里完成。
|
||||
8. **白名单**:`squid whitelist add '~/Library/Caches/com.apple.Safari'` 之后,任何规则与面板都不会再选中该路径。
|
||||
9. **结束进程也有禁区**:不结束 squid 自己,不结束机器的第一个进程(unix 的 pid 0/1、Windows 的 System Idle 与 pid 4),Windows 上另封 `csrss` / `smss` / `wininit` / `services` / `lsass` / `winlogon`——提权后的进程确实能打开它们,代价是一次回车换来一台重启的机器。确认框交给执行方的是采样而不是 pid,动手前重新读一次;名单里故意没有 `svchost`,因为机器活得过它。
|
||||
GUI 和 CLI 使用同一个 `squid-engine::delete` 通道,因此行为、锁定和审计结果一致。
|
||||
|
||||
## 路径规划
|
||||
## 数据与配置
|
||||
|
||||
### 数据与配置
|
||||
|
||||
| 用途 | 默认位置 | 覆盖方式 |
|
||||
| 用途 | macOS | Windows |
|
||||
| --- | --- | --- |
|
||||
| 配置文件 | `~/Library/Application Support/squid/config.toml` | `SQUID_CONFIG_DIR` |
|
||||
| 自定义规则 | `~/Library/Application Support/squid/rules/*.toml` | `SQUID_CONFIG_DIR` |
|
||||
| 删除账本 | `~/Library/Application Support/squid/history/<会话>.json` | `SQUID_STATE_DIR` |
|
||||
| 删除去向 | `~/.Trash`(`delete_mode = "trash"`);`permanent` 时直接 `unlink` | 配置 `delete_mode`、`--trash` / `--permanent` |
|
||||
| 白名单 | 配置文件 `whitelist` 数组 | `squid whitelist` |
|
||||
| 内置规则 | 编译进二进制的 `crates/squid-rules/rules/*.toml` | `disabled_rules` |
|
||||
| 配置与规则 | `~/Library/Application Support/squid/` | `%APPDATA%\squid\` |
|
||||
| 历史账本 | `~/Library/Application Support/squid/history/` | `%APPDATA%\squid\history\` |
|
||||
| 删除去向 | `~/.Trash` 或永久删除 | 回收站或永久删除 |
|
||||
|
||||
Linux 下配置与状态目录遵循 XDG(`$XDG_CONFIG_HOME/squid`、`$XDG_STATE_HOME/squid`,回落到
|
||||
`~/.config/squid`、`~/.local/state/squid`);Windows 下配置、规则与账本都在 `%APPDATA%\squid\`
|
||||
(`config.toml`、`rules\*.toml`、`history\<会话>.json`),删除去向是回收站——回收站自己保管文件,
|
||||
账本因此不记物理路径,`squid undo` 在 Windows 上把还原交给资源管理器的回收站。
|
||||
`squid doctor` 会打印实际生效的配置与账本路径。
|
||||
Linux 使用 XDG 目录。桌面端与 CLI/TUI 共用配置和历史,因此任一端产生的清理记录都能在另一端查看。
|
||||
|
||||
squid 只在上述位置写入,扫描过程全程只读。
|
||||
|
||||
### 可执行文件
|
||||
|
||||
| 安装方式 | 落点 |
|
||||
| --- | --- |
|
||||
| `cargo install` | `~/.cargo/bin/squid` |
|
||||
| `scripts/install.sh` | `$PREFIX` → `/opt/homebrew/bin` → `/usr/local/bin` → `~/.local/bin` |
|
||||
| `scripts/release.sh` | `dist/squid-<版本>-universal-apple-darwin.tar.gz` 及其 `.sha256` |
|
||||
|
||||
### 配置项
|
||||
常用配置:
|
||||
|
||||
```toml
|
||||
delete_mode = "trash" # trash | permanent
|
||||
history_keep = 60 # 保留多少条历史会话
|
||||
purge_min_age_days = 7 # 7 天内动过的构建产物不算垃圾
|
||||
purge_max_entries = 200000 # 单个项目探测的文件数上限
|
||||
show_allocated = true # 显示实际占盘大小而非逻辑大小
|
||||
language = "zh" # "en" | "zh",留空跟随系统语言
|
||||
delete_mode = "trash"
|
||||
history_keep = 60
|
||||
purge_min_age_days = 7
|
||||
purge_max_entries = 200000
|
||||
show_allocated = true
|
||||
language = "zh" # en | zh
|
||||
whitelist = ["~/Library/Caches/ImportantApp"]
|
||||
disabled_rules = ["user-trash"]
|
||||
purge_roots = ["~/code", "~/Projects", "~/Desktop"]
|
||||
```
|
||||
|
||||
### 环境变量
|
||||
主要环境变量:
|
||||
|
||||
| 变量 | 作用 |
|
||||
| --- | --- |
|
||||
| `SQUID_CONFIG_DIR` | 覆盖配置目录(可移植安装、CI、测试) |
|
||||
| `SQUID_STATE_DIR` | 覆盖状态目录(历史账本所在地) |
|
||||
| `SQUID_TRUECOLOR` | `always` / `never` 强制指定配色能力,跳过自动探测 |
|
||||
| `SQUID_LANG` | `zh` / `en` 强制界面语言,等价于 `squid --lang` |
|
||||
| `SQUID_SYMBOL_CELLS` | `1` / `2` 强制指定「一个歧义字形占几格」,覆盖对控制台的实测(Windows 排版排查) |
|
||||
| `SQUID_CONSOLE_TRACE` | 把控制台自报的尺寸与字形价格写进指定文件,留证据用 |
|
||||
| `NO_COLOR` | 存在即关闭全部颜色输出 |
|
||||
| `SQUID_CONFIG_DIR` | 覆盖配置目录 |
|
||||
| `SQUID_STATE_DIR` | 覆盖状态与历史目录 |
|
||||
| `SQUID_LANG` | 强制 `zh` 或 `en` |
|
||||
| `SQUID_UPDATE_URL` | 覆盖桌面端更新清单地址,适合测试发布通道 |
|
||||
| `SQUID_TRUECOLOR` / `NO_COLOR` | 控制 TUI 颜色 |
|
||||
| `SQUID_SYMBOL_CELLS` / `SQUID_CONSOLE_TRACE` | 排查 Windows 控制台字符宽度与排版 |
|
||||
|
||||
### 自定义规则
|
||||
## 开发与验证
|
||||
|
||||
`<config_dir>/rules/*.toml` 与内置规则合并,同 `id` 覆盖内置:
|
||||
|
||||
```toml
|
||||
[[rule]]
|
||||
id = "my-app-cache"
|
||||
category = "app-caches"
|
||||
title = "MyApp caches"
|
||||
patterns = ["~/Library/Caches/myapp/*"] # `~` 展开;`*` 不跨越路径分隔符
|
||||
mode = "path" # path = 删条目本身, contents = 只清空目录
|
||||
os = ["macos"]
|
||||
protect = ["keep-me"]
|
||||
min_age_days = 3
|
||||
select_by_default = true
|
||||
note = "MyApp 会自动重建这些缓存。"
|
||||
```
|
||||
|
||||
每条 pattern 的最长字面量前缀成为该条目的**锚点(anchor)**,删除只允许发生在锚点之下,
|
||||
因此一条写错的规则不会波及锚点以外的目录。
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
crates/
|
||||
├── squid-core 模型、字节格式化、路径、安全策略、设置、删除账本、进度/取消
|
||||
├── squid-platform Platform trait 与 macOS / Linux / Windows 三套实现:App 清单、残留匹配、卷、
|
||||
│ 回收站(Windows 走 shell 的 `IFileOperation`)、进程终止、控制台尺寸与字形宽度探测
|
||||
├── squid-rules TOML 规则引擎:模式展开、锚点、保护列表、年龄与风险标记
|
||||
├── squid-stats sysinfo 采样器、趋势、电池、uptime
|
||||
├── squid-engine clean / uninstall / purge / analyze 四个引擎 + 唯一的删除通道 delete
|
||||
├── squid-tui ratatui 界面(六个面板、任务线程、主题、中英双语文案)
|
||||
└── squid-cli clap 命令行入口
|
||||
```
|
||||
|
||||
依赖方向单向:`core → platform → rules → stats → engine → tui → cli`。
|
||||
架构细节见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md),威胁模型与漏洞披露见 [docs/SECURITY.md](docs/SECURITY.md)。
|
||||
|
||||
## 开发与测试
|
||||
前端:
|
||||
|
||||
```bash
|
||||
cargo check --workspace --all-targets
|
||||
cargo clippy --workspace --all-targets -- -D warnings
|
||||
cargo test --workspace --no-fail-fast
|
||||
pnpm check
|
||||
pnpm build
|
||||
```
|
||||
|
||||
TUI 的键盘与渲染行为由真实 pty 冒烟测试守护(需要 `pyte`):
|
||||
Rust workspace:
|
||||
|
||||
```bash
|
||||
cargo fmt --all -- --check
|
||||
cargo clippy --workspace --all-targets -- -D warnings
|
||||
cargo test --workspace
|
||||
```
|
||||
|
||||
Tauri:
|
||||
|
||||
```bash
|
||||
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
|
||||
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
|
||||
cargo test --manifest-path src-tauri/Cargo.toml --lib
|
||||
```
|
||||
|
||||
TUI 使用真实 pty 冒烟测试;Windows 控制台另有“抓帧、复放、量框”验证:
|
||||
|
||||
```bash
|
||||
python3 -m pip install --user pyte
|
||||
cargo build --release
|
||||
python3 scripts/tui_smoke.py # menu / menu-mono / uninstall
|
||||
python3 scripts/tui_smoke.py uninstall # 只跑连续卸载
|
||||
python3 scripts/tui_smoke.py
|
||||
python3 scripts/tui-frame-check.py --selftest
|
||||
```
|
||||
|
||||
Windows 上没有 pty 可以 fork,界面排版改由「抓帧 → 复放 → 量框」守护:`win-tui-capture.sh` 让真机的
|
||||
ConPTY 收到什么就原样存什么、抓回本地,`tui-frame-check.py` 用 pyte 把它复放成画面再逐帧量边框——
|
||||
一幅画面要顶住 512 字节的写入不变才算画稳,半帧不许下判词:
|
||||
CI 同时执行 workspace 测试、MSVC 目标交叉检查、桌面前端构建和 Tauri Rust 检查。
|
||||
|
||||
## 打包与发布
|
||||
|
||||
版本必须同时写入以下四处:
|
||||
|
||||
- `Cargo.toml` workspace 版本
|
||||
- `src-tauri/Cargo.toml`
|
||||
- `src-tauri/tauri.conf.json`
|
||||
- `package.json`
|
||||
|
||||
构建安装包:
|
||||
|
||||
```bash
|
||||
python3 scripts/tui-frame-check.py --selftest # 先证明判据本身没坏
|
||||
python3 scripts/tui-frame-check.py /tmp/squid-win-tui.bin # 再判那一帧
|
||||
TUI_REUSE=1 TUI_OUT=/tmp/x.bin ./scripts/win-tui-capture.sh # 只重算旧帧,不连真机
|
||||
scripts/build-macos-release.sh
|
||||
scripts/build-windows-release.sh
|
||||
```
|
||||
|
||||
真机侧的构建与测试由 `scripts/win-sync.sh` 同步源码后跑 `scripts/win-check.ps1`
|
||||
(test / clippy / release build,产物在 `C:\dev\target`)。
|
||||
产物:
|
||||
|
||||
删除相关的测试用例只在 `~/Library/Caches/squid-delete-test-*` 临时目录内操作,
|
||||
并通过 `SQUID_STATE_DIR` 将账本写入临时目录,不会触碰真实用户数据。
|
||||
```text
|
||||
artifacts/Squid-<version>-macOS-universal.dmg
|
||||
artifacts/Squid-Setup-<version>-win-x64.exe
|
||||
artifacts/SHA256SUMS.txt
|
||||
```
|
||||
|
||||
## 发布
|
||||
发布到更新通道:
|
||||
|
||||
```bash
|
||||
./scripts/release.sh # 通用二进制
|
||||
ARCHES="aarch64-apple-darwin" ./scripts/release.sh # 只出当前架构
|
||||
scripts/publish-release.sh --notes /path/to/release-notes.md
|
||||
```
|
||||
|
||||
脚本执行 `cargo build --release`(各 Apple target)→ `lipo -create` 合成通用二进制 →
|
||||
ad-hoc `codesign` → 打包 tar.gz 与 sha256,并打印 `gh release create` 命令与需要填进
|
||||
Homebrew formula 的校验和。
|
||||
发布脚本会重建 `releases` 分支,写入 `squid-update.json`、两个安装包和可选的 `squid-update.sig`。清单包含精确大小与 SHA256,客户端下载后再次校验。
|
||||
|
||||
## 路线图
|
||||
完整发布流程、签名和清单格式见 [`docs/RELEASE.md`](docs/RELEASE.md)。
|
||||
|
||||
| 平台 | 现状 | 待办 |
|
||||
| --- | --- | --- |
|
||||
| macOS | 完整实现(规则、App 残留、卷、卸载钩子)| Developer ID 签名与公证流水线 |
|
||||
| Linux | `squid-platform/src/linux.rs` 已实现 `.desktop` / Flatpak / Snap 应用清单与 XDG 残留目录 | `rules/linux.toml`、真机验证 |
|
||||
| Windows | 平台层已实现:注册表卸载表(HKLM 64/32 位 + HKCU)、AppData 残留目录、卷枚举、回收站(`IFileOperation`)、强制结束进程(附关键进程名单);安全层按 Windows 语义比较路径(大小写不敏感、盘符根/`$Recycle.Bin` 等硬封禁);内置 30 条清理规则(临时文件、WER 崩溃报告、浏览器/Shell/开发缓存、Windows.old 等);CI 每次提交做 MSVC 目标交叉编译检查;已在局域网内的真机验证通过:回收站真实删除(按卷核算字节数、可在资源管理器里还原)、`undo` 的措辞与行为、`--json` 输出只含一份 JSON、系统面板结束进程(确认框复述采样、动手前重读 pid)、列表翻页后高亮不再丢失、动态信息不再压住左侧菜单;TUI 的排版由判据守住而不是靠肉眼:`win-tui-capture.sh` 把真机 ConPTY 吐出的原始 ANSI 抓回本地用 pyte 复放,`tui-frame-check.py` 逐帧问「右边框落在第几列」,并以「顶住 512 字节写入不变」为画稳条件,`--selftest` 先证明判据本身没坏 | UAC 提权、长路径 manifest、Windows 11 真机复验、winget 发布 |
|
||||
## 平台状态
|
||||
|
||||
其他:规则贡献流程与规则覆盖度基准、TUI 主题自定义、Linux 冒烟测试(Windows 已有抓帧复放判据)。
|
||||
| 平台 | 状态 |
|
||||
| --- | --- |
|
||||
| macOS | 桌面端与 CLI/TUI 完整支持,发布通用 DMG |
|
||||
| Windows x64 | 桌面端与 CLI/TUI 支持,发布 NSIS 安装包 |
|
||||
| Linux | 平台层与 CLI/TUI 基础实现;尚未提供内置 Linux 规则和桌面安装包 |
|
||||
|
||||
## 许可证
|
||||
|
||||
squid 采用 **GNU General Public License v3.0 only**(`GPL-3.0-only`),全文见 [LICENSE](LICENSE)。
|
||||
|
||||
```
|
||||
squid — disk cleaning and system monitoring utility
|
||||
Copyright (C) 2026 squid contributors
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, version 3.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.
|
||||
```
|
||||
Squid 使用 **GNU General Public License v3.0 only**(`GPL-3.0-only`)。完整条款见 [`LICENSE`](LICENSE)。
|
||||
|
|
|
|||
|
|
@ -50,7 +50,7 @@ cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
|
|||
| Uninstall apps | Reads installed apps, builds an app-specific removal plan, shows leftover paths and warnings, then uninstalls selected items |
|
||||
| Deep Clean | Searches chosen project roots for regenerable build artefacts with Git and file-age protections |
|
||||
| Storage | Measures a chosen folder, exposes the largest children, drills down, and finds the largest files |
|
||||
| System | Live CPU, memory, network, disk, battery, volume and process data; process termination asks for confirmation |
|
||||
| Real-time monitor | Live CPU, memory, network, disk, battery, volume and process data; process termination asks for confirmation |
|
||||
| History | Lists cleanup sessions, shows the ledger, restores files that are still in Trash/Recycle Bin, and opens the bin |
|
||||
| Settings | Language, deletion mode, history retention, protected paths, local file locations, and software updates |
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"name": "squid-desktop",
|
||||
"private": true,
|
||||
"version": "0.1.3",
|
||||
"version": "0.1.4",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite --port 1420 --strictPort",
|
||||
|
|
|
|||
|
|
@ -0,0 +1,27 @@
|
|||
Squid 0.1.4 - Windows x64
|
||||
|
||||
系统要求
|
||||
--------
|
||||
- Windows 10 或 Windows 11(x64;ARM64 设备通过系统兼容层运行)。
|
||||
- Microsoft Edge WebView2 Runtime。Windows 10/11 通常已内置;如果 Squid
|
||||
启动后窗口空白,请从微软官方页面安装 WebView2 Evergreen Runtime:
|
||||
https://developer.microsoft.com/microsoft-edge/webview2/
|
||||
- 安装与运行都不需要管理员权限。安装位置为
|
||||
%LOCALAPPDATA%\Programs\Squid。
|
||||
|
||||
安装
|
||||
----
|
||||
1. 运行 Squid-Setup-0.1.4-win-x64.exe。
|
||||
2. 这是未签名构建。若 SmartScreen 显示警告,请选择“更多信息” > “仍要运行”。
|
||||
3. 卸载请在 Windows“设置 > 应用”中移除 Squid。
|
||||
|
||||
更新
|
||||
----
|
||||
Squid 使用与 nex_shift 一致的 releases 分支更新通道。更新包会先校验
|
||||
文件大小与 SHA256,再在退出后运行同一个安装程序。若构建时写入发布公钥,
|
||||
还会验证清单的 Ed25519 签名。
|
||||
|
||||
校验
|
||||
----
|
||||
PowerShell:
|
||||
Get-FileHash .\Squid-Setup-0.1.4-win-x64.exe -Algorithm SHA256
|
||||
|
|
@ -0,0 +1,7 @@
|
|||
Squid 0.1.4
|
||||
|
||||
- 恢复左侧完整菜单:维护组包含「电脑概览、日常清理、应用卸载、深度清理」,洞察组包含「存储空间、实时监控」。
|
||||
- 保留 0.1.3 的托盘行为,关闭窗口后继续运行,可从托盘进入日常清理、应用卸载和深度清理。
|
||||
- 保留精简后的软件更新面板:仅发现新版本时显示版本变化与更新说明。
|
||||
- 按当前桌面端、CLI/TUI、共用引擎、安全边界和发布流程重新整理 README。
|
||||
- macOS 与 Windows 同步发布 0.1.4。
|
||||
|
|
@ -0,0 +1,3 @@
|
|||
7b4f91ed0064b8f5e6ed4965167e860fdf6e98b7e576a3fdcd5775521f0fce0b Squid-0.1.4-macOS-universal.dmg
|
||||
970ce8339e3832d045c07f3c13e45793fc9eac9cb22c95cdf1a1ebc5d2c37f24 Squid-Setup-0.1.4-win-x64.exe
|
||||
9937a1bd780b1df60e05df49f2e70434e02eed9e853d30230c89aa7d520867ff README-Windows-x64.txt
|
||||
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,18 @@
|
|||
{
|
||||
"schema": 1,
|
||||
"version": "0.1.4",
|
||||
"date": "2026-11-05",
|
||||
"notes": "Squid 0.1.4\n\n- 恢复左侧完整菜单:维护组包含「电脑概览、日常清理、应用卸载、深度清理」,洞察组包含「存储空间、实时监控」。\n- 保留 0.1.3 的托盘行为,关闭窗口后继续运行,可从托盘进入日常清理、应用卸载和深度清理。\n- 保留精简后的软件更新面板:仅发现新版本时显示版本变化与更新说明。\n- 按当前桌面端、CLI/TUI、共用引擎、安全边界和发布流程重新整理 README。\n- macOS 与 Windows 同步发布 0.1.4。",
|
||||
"artifacts": {
|
||||
"macos": {
|
||||
"file": "Squid-0.1.4-macOS-universal.dmg",
|
||||
"sha256": "7b4f91ed0064b8f5e6ed4965167e860fdf6e98b7e576a3fdcd5775521f0fce0b",
|
||||
"size": 10689388
|
||||
},
|
||||
"windows": {
|
||||
"file": "Squid-Setup-0.1.4-win-x64.exe",
|
||||
"sha256": "970ce8339e3832d045c07f3c13e45793fc9eac9cb22c95cdf1a1ebc5d2c37f24",
|
||||
"size": 3342175
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -3489,7 +3489,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-core"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"chrono",
|
||||
|
|
@ -3508,7 +3508,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-desktop"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"base64 0.22.1",
|
||||
"chrono",
|
||||
|
|
@ -3532,7 +3532,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-engine"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"chrono",
|
||||
|
|
@ -3552,7 +3552,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-platform"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"dirs 6.0.0",
|
||||
"libc",
|
||||
|
|
@ -3569,7 +3569,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-rules"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"globset",
|
||||
"serde",
|
||||
|
|
@ -3581,7 +3581,7 @@ dependencies = [
|
|||
|
||||
[[package]]
|
||||
name = "squid-stats"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
dependencies = [
|
||||
"chrono",
|
||||
"libc",
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
[package]
|
||||
name = "squid-desktop"
|
||||
version = "0.1.3"
|
||||
version = "0.1.4"
|
||||
description = "Squid — a CleanMyMac-inspired cleaner, uninstaller and system monitor."
|
||||
authors = ["squid contributors"]
|
||||
edition = "2021"
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"$schema": "https://schema.tauri.app/config/2",
|
||||
"productName": "Squid",
|
||||
"version": "0.1.3",
|
||||
"version": "0.1.4",
|
||||
"identifier": "app.nex.squid",
|
||||
"mainBinaryName": "squid-desktop",
|
||||
"build": {
|
||||
|
|
|
|||
114
src/App.tsx
114
src/App.tsx
|
|
@ -1,6 +1,8 @@
|
|||
import {
|
||||
AppWindow,
|
||||
Boxes,
|
||||
ChevronDown,
|
||||
CircleGauge,
|
||||
Eraser,
|
||||
History,
|
||||
LayoutDashboard,
|
||||
|
|
@ -8,6 +10,7 @@ import {
|
|||
Settings,
|
||||
ShieldCheck,
|
||||
Sparkles,
|
||||
WandSparkles,
|
||||
} from "lucide-react";
|
||||
import { useCallback, useEffect, useState, type ReactNode } from "react";
|
||||
import { useAppsWorkspace } from "./hooks/useAppsWorkspace";
|
||||
|
|
@ -36,29 +39,63 @@ import { SettingsPage } from "./pages/SettingsPage";
|
|||
import { StoragePage } from "./pages/StoragePage";
|
||||
import { SystemPage } from "./pages/SystemPage";
|
||||
|
||||
const NAV_ITEMS: {
|
||||
id: PageId;
|
||||
const NAV_GROUPS: {
|
||||
labelEn: string;
|
||||
labelZh: string;
|
||||
icon: typeof LayoutDashboard;
|
||||
items: {
|
||||
id: PageId;
|
||||
labelEn: string;
|
||||
labelZh: string;
|
||||
icon: typeof LayoutDashboard;
|
||||
}[];
|
||||
}[] = [
|
||||
{
|
||||
id: "overview",
|
||||
labelEn: "Computer overview",
|
||||
labelZh: "电脑概览",
|
||||
icon: LayoutDashboard,
|
||||
labelEn: "Maintenance",
|
||||
labelZh: "维护",
|
||||
items: [
|
||||
{
|
||||
id: "overview",
|
||||
labelEn: "Computer overview",
|
||||
labelZh: "电脑概览",
|
||||
icon: LayoutDashboard,
|
||||
},
|
||||
{
|
||||
id: "cleanup",
|
||||
labelEn: "Daily cleanup",
|
||||
labelZh: "日常清理",
|
||||
icon: Eraser,
|
||||
},
|
||||
{
|
||||
id: "applications",
|
||||
labelEn: "Uninstall apps",
|
||||
labelZh: "应用卸载",
|
||||
icon: AppWindow,
|
||||
},
|
||||
{
|
||||
id: "purge",
|
||||
labelEn: "Deep Clean",
|
||||
labelZh: "深度清理",
|
||||
icon: WandSparkles,
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
id: "cleanup",
|
||||
labelEn: "Daily cleanup",
|
||||
labelZh: "日常清理",
|
||||
icon: Eraser,
|
||||
},
|
||||
{
|
||||
id: "applications",
|
||||
labelEn: "Uninstall apps",
|
||||
labelZh: "应用卸载",
|
||||
icon: AppWindow,
|
||||
labelEn: "Insights",
|
||||
labelZh: "洞察",
|
||||
items: [
|
||||
{
|
||||
id: "storage",
|
||||
labelEn: "Storage",
|
||||
labelZh: "存储空间",
|
||||
icon: Boxes,
|
||||
},
|
||||
{
|
||||
id: "system",
|
||||
labelEn: "Real-time monitor",
|
||||
labelZh: "实时监控",
|
||||
icon: CircleGauge,
|
||||
},
|
||||
],
|
||||
},
|
||||
];
|
||||
|
||||
|
|
@ -68,7 +105,7 @@ const PAGE_TITLES: Record<PageId, [string, string]> = {
|
|||
applications: ["Uninstall apps", "应用卸载"],
|
||||
purge: ["Deep Clean", "深度清理"],
|
||||
storage: ["Storage", "存储空间"],
|
||||
system: ["System", "系统状态"],
|
||||
system: ["Real-time monitor", "实时监控"],
|
||||
history: ["History", "历史记录"],
|
||||
settings: ["Settings", "设置"],
|
||||
};
|
||||
|
|
@ -331,23 +368,30 @@ function AppChrome({
|
|||
</div>
|
||||
|
||||
<nav className="sidebar-nav" aria-label={t("Main navigation", "主导航")}>
|
||||
{NAV_ITEMS.map((item) => {
|
||||
const Icon = item.icon;
|
||||
return (
|
||||
<button
|
||||
key={item.id}
|
||||
className={`nav-item ${page === item.id ? "is-active" : ""}`}
|
||||
onClick={() => setPage(item.id)}
|
||||
aria-current={page === item.id ? "page" : undefined}
|
||||
>
|
||||
<Icon size={18} />
|
||||
<span>{lang === "zh" ? item.labelZh : item.labelEn}</span>
|
||||
{item.id === "cleanup" && page !== "cleanup" ? (
|
||||
<i className="nav-dot" />
|
||||
) : null}
|
||||
</button>
|
||||
);
|
||||
})}
|
||||
{NAV_GROUPS.map((group) => (
|
||||
<div className="nav-group" key={group.labelEn}>
|
||||
<span className="nav-group-label">
|
||||
{lang === "zh" ? group.labelZh : group.labelEn}
|
||||
</span>
|
||||
{group.items.map((item) => {
|
||||
const Icon = item.icon;
|
||||
return (
|
||||
<button
|
||||
key={item.id}
|
||||
className={`nav-item ${page === item.id ? "is-active" : ""}`}
|
||||
onClick={() => setPage(item.id)}
|
||||
aria-current={page === item.id ? "page" : undefined}
|
||||
>
|
||||
<Icon size={18} />
|
||||
<span>{lang === "zh" ? item.labelZh : item.labelEn}</span>
|
||||
{item.id === "cleanup" && page !== "cleanup" ? (
|
||||
<i className="nav-dot" />
|
||||
) : null}
|
||||
</button>
|
||||
);
|
||||
})}
|
||||
</div>
|
||||
))}
|
||||
</nav>
|
||||
|
||||
<div className="sidebar-bottom">
|
||||
|
|
|
|||
|
|
@ -133,7 +133,7 @@ export function OverviewPage({
|
|||
icon={<CircleGauge size={16} />}
|
||||
onClick={() => onNavigate("system")}
|
||||
>
|
||||
{t("Live system", "系统状态")}
|
||||
{t("Live system", "实时监控")}
|
||||
</Button>
|
||||
</div>
|
||||
<div className="hero-assurances">
|
||||
|
|
|
|||
|
|
@ -73,7 +73,7 @@ export function SystemPage({
|
|||
return (
|
||||
<div className="page system-page">
|
||||
<PageHeader
|
||||
eyebrow={t("System", "系统状态")}
|
||||
eyebrow={t("Real-time monitor", "实时监控")}
|
||||
title={t("The pulse of your machine.", "掌握设备的每一次呼吸。")}
|
||||
description={t(
|
||||
"Live processor, memory, disk and network activity, sampled locally every couple of seconds.",
|
||||
|
|
|
|||
|
|
@ -368,10 +368,24 @@ select:focus-visible,
|
|||
.sidebar-nav {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 3px;
|
||||
gap: 13px;
|
||||
padding: 12px 1px;
|
||||
}
|
||||
|
||||
.nav-group {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 3px;
|
||||
}
|
||||
|
||||
.nav-group-label {
|
||||
padding: 0 11px 5px;
|
||||
color: var(--nex-muted-soft);
|
||||
font-size: var(--nex-text-3xs);
|
||||
font-weight: var(--nex-weight-medium);
|
||||
letter-spacing: 0.02em;
|
||||
}
|
||||
|
||||
.nav-item {
|
||||
position: relative;
|
||||
display: flex;
|
||||
|
|
|
|||
Loading…
Reference in New Issue