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 manifest
main
mula.liu 2026-11-05 14:05:21 +08:00
parent 09ba6c6b36
commit 20c20128e1
19 changed files with 379 additions and 370 deletions

2
.gitignore vendored
View File

@ -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

14
Cargo.lock generated
View File

@ -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",

View File

@ -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
View File

@ -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)。

View File

@ -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 |

View File

@ -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",

View File

@ -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

View File

@ -0,0 +1,7 @@
Squid 0.1.4
- 恢复左侧完整菜单:维护组包含「电脑概览、日常清理、应用卸载、深度清理」,洞察组包含「存储空间、实时监控」。
- 保留 0.1.3 的托盘行为,关闭窗口后继续运行,可从托盘进入日常清理、应用卸载和深度清理。
- 保留精简后的软件更新面板:仅发现新版本时显示版本变化与更新说明。
- 按当前桌面端、CLI/TUI、共用引擎、安全边界和发布流程重新整理 README。
- macOS 与 Windows 同步发布 0.1.4。

View File

@ -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.

View File

@ -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
}
}
}

12
src-tauri/Cargo.lock generated
View File

@ -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",

View File

@ -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"

View File

@ -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": {

View File

@ -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">

View File

@ -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">

View File

@ -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.",

View File

@ -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;