1115 lines
60 KiB
Markdown
1115 lines
60 KiB
Markdown
# Squid 安全与管理功能路线图
|
||
|
||
状态:P0–P3 已实现(0.1.7),并按第 13、14 节重做了列表、下拉组件、启动项页与界面文案;P4 未开始
|
||
更新时间:2026-11-07
|
||
适用平台:macOS 12+、Windows 10/11(x64;ARM64 通过兼容层运行)
|
||
|
||
本文是新版菜单、页面职责、授权流程和交付阶段的唯一规划来源。代码实现与本文冲突时,
|
||
先改本文并说明原因,再改代码。
|
||
|
||
## 1. 已确定的决策
|
||
|
||
1. 发布方式与 Shift 保持一致:macOS 使用 ad-hoc 签名 DMG,不公证;Windows 使用未签名、
|
||
按用户安装的 NSIS。首次安装由用户通过 Gatekeeper / SmartScreen 自行授权。
|
||
2. 不使用本地自签证书。自签证书会让 macOS 直接显示“应用已损坏”,且没有可用的放行入口。
|
||
3. 不新增 daemon、系统服务、内核扩展或常驻特权 helper。需要管理员权限的动作,
|
||
每次由系统弹窗授权。
|
||
4. 保留现有 8 个页面,新增「安全」和「启动项」两个页面。侧栏总入口变为 10 个。
|
||
5. 「安全」页负责扫描、发现、告警和隔离;隔离不单独开页面。
|
||
6. 「启动项」页负责持久化入口;进程管理不单独开页面,放入「实时监控」页签。
|
||
7. 首版不做 Cleanup + Security 的合并“智能扫描”。两个扫描入口使用不同措辞,
|
||
避免用户以为一次扫描已经检查了所有内容。
|
||
8. 首版不做安全评分,只展示可验证的系统状态、扫描覆盖范围和发现数量。
|
||
9. 历史页首版仍只承载清理/卸载账本;安全扫描与隔离记录先放在安全页的“最近活动”。
|
||
10. 清理白名单与安全排除项是两份独立配置。清理白名单不能静默抑制恶意软件发现。
|
||
|
||
## 2. 发布与授权基线
|
||
|
||
### 2.1 安装与更新
|
||
|
||
| 场景 | macOS | Windows |
|
||
| --- | --- | --- |
|
||
| 首次安装 | 下载 DMG,拖入“应用程序”;首次启动由用户在 Gatekeeper 中放行一次 | 运行未签名 NSIS;SmartScreen 中选择“更多信息 → 仍要运行” |
|
||
| 应用内更新 | 校验文件大小、SHA256 和可选 Ed25519 清单签名;挂载 DMG、替换 App、清理 quarantine,不再弹 Gatekeeper | 校验后静默运行同一个 NSIS;失败时回退为手动打开安装包 |
|
||
| 安装权限 | 普通用户权限 | 普通用户权限,安装到 `%LOCALAPPDATA%\Programs\Squid` |
|
||
| 代码签名 | `signingIdentity: "-"`,保持 ad-hoc;发布检查必须显示 `Signature=adhoc` | 无 Authenticode;发布说明必须写明 SmartScreen 步骤 |
|
||
| 信任说明 | macOS 首次放行是系统信任提示,不是病毒扫描结果 | Windows SmartScreen 是系统信任提示,不是 Squid 的检测结果 |
|
||
|
||
应用内更新和规则包更新都不以“操作系统信任发布者”为前提,但必须继续做内容完整性校验。
|
||
清单签名解决“更新内容是否来自 Squid 发布者”,不能替代 Gatekeeper / SmartScreen。
|
||
|
||
### 2.2 首次授权卡
|
||
|
||
扩展现有 `SetupPanel`,从单一 Full Disk Access 检查变为非阻塞的“安全准备”卡片。
|
||
每项都显示状态、影响和修复入口,关闭卡片不改变任何设置。
|
||
|
||
| 检查项 | macOS | Windows |
|
||
| --- | --- | --- |
|
||
| 系统防护 | XProtect 版本、定义日期、后台/启动扫描是否开启、Gatekeeper 状态 | Defender / 第三方杀毒软件状态、实时保护、定义版本 |
|
||
| 扫描访问 | Full Disk Access 可选;未授权时跳过受保护目录并标注覆盖受限 | 通常无需额外隐私权限;安全中心不可读时标注状态未知 |
|
||
| 通知 | 请求通知权限;拒绝时保留应用内告警 | 请求通知权限;拒绝时保留应用内告警 |
|
||
| 登录启动 | 可选;用于托盘定时扫描和告警 | 可选;用于托盘定时扫描和告警 |
|
||
| 规则更新 | 可选;只下载签名规则包,不上传扫描结果 | 同 macOS |
|
||
|
||
首次扫描前再显示一次扫描范围确认:
|
||
|
||
- 快速扫描会覆盖哪些目录。
|
||
- 哪些目录可能触发 macOS 文件夹授权。
|
||
- 被拒绝或不可读的目录会在结果中明确标注“未检查”。
|
||
|
||
更新后重新检查权限。ad-hoc 身份会随构建变化,Full Disk Access、通知等授权可能被系统重置。
|
||
安全页顶部用一条“权限需要处理”提示承载,不再次强制弹窗。
|
||
|
||
### 2.3 用户授权边界
|
||
|
||
- 扫描本身不需要管理员权限。
|
||
- 当前用户拥有的启动项可以直接停用/恢复。
|
||
- 系统级启动项需要一次系统授权;不安装常驻 helper。
|
||
- 结束进程只处理当前用户拥有的进程;系统进程和他人进程只显示原因。
|
||
- 隔离、恢复、停用启动项默认每次确认。
|
||
- 自动隔离默认关闭;开启后也只处理“已确认”级别,不处理“可疑”级别。
|
||
- Windows 服务首版只读。
|
||
- macOS 登录项首版只读,修改入口跳转系统设置。
|
||
|
||
### 2.4 无 Developer ID / Authenticode 时的能力边界
|
||
|
||
无代码签名不会阻止 Squid 做本地扫描和用户授权范围内的处置,但会限制系统对发布者的信任,
|
||
以及后台接管能力。实现时不能把“用户放行”描述成“系统已认证安全”。
|
||
|
||
| 能力 | 无签名 / ad-hoc 时 | 边界 |
|
||
| --- | --- | --- |
|
||
| 首次安装与启动 | 可做 | 仍需要用户手动通过 Gatekeeper / SmartScreen;不承诺免提示 |
|
||
| 应用内更新 | 可做内容完整性校验 | SHA256 + 可选 Ed25519 清单签名;不能替代系统发布者信任 |
|
||
| 扫描用户文件 | 可做 | 受当前用户权限和 macOS Full Disk Access 限制 |
|
||
| 隔离与恢复 | 可做 | 只处理 Squid 自己记录、且重新校验通过的发现项 |
|
||
| XProtect / Defender 状态 | 只读查看 | 不调用系统扫描、不复制规则、不接管系统实时防护 |
|
||
| 用户级启动项 | 可做启停 | 仅限当前用户的 LaunchAgents / HKCU Run 等 |
|
||
| 系统级启动项 | 有限支持 | 每次依赖系统授权;不安装常驻特权 helper |
|
||
| 进程管理 | 可做当前用户进程 | 系统进程、他人进程只显示原因,不强制结束 |
|
||
| 常驻实时拦截 | 不做 | 没有内核扩展或系统服务;只在应用/托盘运行时做定时或手动扫描 |
|
||
| 通知 | 可做 | 依赖系统通知权限;拒绝后保留应用内告警和托盘状态 |
|
||
|
||
因此首版的安全定位是“本地按需扫描 + 可逆隔离 + 启动项/进程可见性”,而不是
|
||
CleanMyMac 式的常驻实时防病毒产品,也不是 XProtect / Defender 的替代品。
|
||
|
||
## 3. 菜单结构
|
||
|
||
### 3.1 侧栏
|
||
|
||
```text
|
||
维护 Maintenance
|
||
概览 Overview
|
||
日常清理 Daily cleanup
|
||
应用卸载 Uninstall apps
|
||
深度清理 Deep Clean
|
||
|
||
保护 Protection
|
||
安全 Security
|
||
启动项 Startup items
|
||
|
||
洞察 Insights
|
||
存储空间 Storage
|
||
实时监控 Real-time monitor
|
||
|
||
(侧栏底部)
|
||
历史记录 History
|
||
设置 Settings
|
||
```
|
||
|
||
说明:
|
||
|
||
- 「安全」和「启动项」是新入口,放在「保护」组,不塞进「洞察」。
|
||
- 「实时监控」保持原名称,但页面内部增加「性能」和「进程」两个页签。
|
||
- 「历史记录」和「设置」继续固定在侧栏底部。
|
||
- 不新增「隔离区」「进程」「病毒扫描」等第三个入口,避免菜单膨胀。
|
||
|
||
### 3.2 页面 ID 与快捷键
|
||
|
||
| 序号 | Page ID | 中文 | English | 快捷键 |
|
||
| --- | --- | --- | --- | --- |
|
||
| 1 | `overview` | 概览 | Overview | `Cmd/Ctrl+1` |
|
||
| 2 | `cleanup` | 日常清理 | Daily cleanup | `Cmd/Ctrl+2` |
|
||
| 3 | `applications` | 应用卸载 | Uninstall apps | `Cmd/Ctrl+3` |
|
||
| 4 | `purge` | 深度清理 | Deep Clean | `Cmd/Ctrl+4` |
|
||
| 5 | `storage` | 存储空间 | Storage | `Cmd/Ctrl+5` |
|
||
| 6 | `system` | 实时监控 | Real-time monitor | `Cmd/Ctrl+6` |
|
||
| 7 | `security` | 安全 | Security | `Cmd/Ctrl+7` |
|
||
| 8 | `startup` | 启动项 | Startup items | `Cmd/Ctrl+8` |
|
||
| 9 | `history` | 历史记录 | History | `Cmd/Ctrl+9` |
|
||
| 10 | `settings` | 设置 | Settings | `Cmd/Ctrl+0` |
|
||
|
||
`Cmd/Ctrl+7/8` 从原来的历史/设置改为安全/启动项;历史/设置顺延到 `9/0`。
|
||
升级说明中要写清楚这一变化。
|
||
|
||
### 3.3 托盘菜单
|
||
|
||
```text
|
||
打开 Squid
|
||
保护状态:正常 / 发现 2 个问题 (只读状态行)
|
||
扫描恶意软件
|
||
管理启动项
|
||
---
|
||
日常清理
|
||
应用卸载
|
||
深度清理
|
||
---
|
||
退出 Squid
|
||
```
|
||
|
||
行为:
|
||
|
||
- 托盘菜单跟随界面语言。
|
||
- “保护状态”是禁用状态行;有已确认发现时显示数量,点击系统通知直接打开安全页。
|
||
- 正在扫描时,“扫描恶意软件”变为“正在扫描…”并禁用。
|
||
- 托盘图标/提示文字显示保护状态;有高危发现时优先于“有更新”提示。
|
||
- 点击托盘通知默认打开安全页的发现列表。
|
||
|
||
### 3.4 导航徽标
|
||
|
||
- 「安全」:存在未处理的已确认发现时显示数量徽标;只有可疑项时显示普通圆点。
|
||
- 「启动项」:首版不加数字徽标,避免把正常的系统启动项也变成噪声。
|
||
- 「日常清理」:保留现有圆点。
|
||
- 「设置」:保留现有更新圆点。
|
||
|
||
## 4. 页面职责
|
||
|
||
### 4.1 页面总表
|
||
|
||
| 页面 | 主要职责 | 主要动作 | 不承载 |
|
||
| --- | --- | --- | --- |
|
||
| 概览 | 汇总电脑状态、清理结果和安全状态 | 开始清理扫描、开始安全扫描、跳转 | 复杂发现处置、启动项编辑 |
|
||
| 日常清理 | 按规则扫描并删除可重建缓存和垃圾 | 选择、删除、撤销入口 | 安全发现和隔离 |
|
||
| 应用卸载 | 读取应用、生成卸载计划 | 卸载 App 与残留 | 安全扫描、启动项管理 |
|
||
| 深度清理 | 查找项目构建产物和旧安装包 | 选择、删除 | 安全扫描 |
|
||
| 存储空间 | 磁盘占用树和大文件 | 浏览、定位、打开 | 安全处置 |
|
||
| 实时监控 | 性能监控 + 全量进程管理 | 结束进程、查看进程详情 | 启动项启停 |
|
||
| 安全 | 系统防护、恶意软件扫描、发现、隔离 | 扫描、隔离、恢复、排除 | 编辑启动项、结束进程 |
|
||
| 启动项 | 管理登录/启动时运行的持久化入口 | 停用、恢复、查看关联进程 | 全量进程列表 |
|
||
| 历史记录 | 清理/卸载账本与恢复 | 查看会话、撤销 | 安全事件审计 |
|
||
| 设置 | 全局偏好、权限、排除项、更新 | 修改设置、打开系统设置 | 扫描结果和处置 |
|
||
|
||
### 4.2 概览
|
||
|
||
职责:给用户一个“现在该做什么”的入口,不在这里完成复杂处置。
|
||
|
||
页面区块:
|
||
|
||
1. 顶部问候与设备信息(保留)。
|
||
2. 安全状态条:
|
||
- 系统防护:XProtect / Defender 是否正常。
|
||
- Squid 扫描:从未扫描 / 上次扫描 / 发现数量。
|
||
- 覆盖范围:完整 / 受限。
|
||
- 有未处理发现时替换为红色提示卡,按钮“查看发现”。
|
||
3. 清理扫描卡(保留现有磁盘仪表和清理结果)。
|
||
4. 两个明确分开的扫描按钮:
|
||
- “清理扫描” / “Cleanup scan”
|
||
- “安全快速扫描” / “Quick security scan”
|
||
5. 快捷入口:安全、日常清理、应用卸载、存储空间。
|
||
6. 性能概览(保留 CPU、内存、存储)。
|
||
|
||
首版不把两个扫描合并。用户必须能分清“释放空间”和“检查威胁”。
|
||
|
||
### 4.3 安全
|
||
|
||
职责:承载系统防护状态、恶意软件扫描、发现列表、告警和隔离区。
|
||
|
||
页面区块:
|
||
|
||
1. 页头:
|
||
- “安全”标题。
|
||
- 扫描按钮和扫描类型菜单:快速扫描 / 全盘扫描 / 自定义路径。
|
||
- 扫描中显示进度、当前文件、取消按钮。
|
||
2. 系统防护卡:
|
||
- macOS:XProtect 版本、定义日期、启动/后台扫描、Gatekeeper。
|
||
- Windows:当前杀毒产品、实时保护、定义版本、最近扫描。
|
||
- 状态不可读时显示“无法确认”,不使用绿色。
|
||
3. 覆盖范围卡:
|
||
- 已授权目录、未授权目录、被跳过数量。
|
||
- Full Disk Access 缺失时提供“打开系统设置”。
|
||
- 规则包版本、上次更新、离线使用提示。
|
||
4. 发现列表:
|
||
- 过滤:全部 / 已确认 / 可疑 / 已隔离。
|
||
- 行内容:级别、名称、路径、证据、发现时间、建议动作。
|
||
- 操作:隔离、在 Finder/资源管理器中显示、忽略一次、加入排除项。
|
||
- 只有“已确认”项可批量隔离;可疑项只能逐条处理。
|
||
5. 隔离区:
|
||
- 列表:原始路径、大小、发现原因、隔离时间。
|
||
- 操作:恢复、永久删除、查看详情。
|
||
- 空状态说明隔离区只保存 Squid 隔离的对象。
|
||
6. 最近活动:
|
||
- 最近 20 次扫描、隔离、恢复;首版不写入历史页。
|
||
7. 空状态与错误:
|
||
- 未扫描:“尚未扫描这台电脑”。
|
||
- 扫描干净:“在已检查范围内未发现威胁”。
|
||
- 覆盖受限:必须同时显示未检查范围,不能只显示“安全”。
|
||
- 扫描失败:保留上次结果,不清空发现。
|
||
|
||
页面动作:
|
||
|
||
- 开始扫描、取消扫描。
|
||
- 更新规则包。
|
||
- 隔离/恢复/永久删除。
|
||
- 忽略一次/加入排除项。
|
||
- 打开系统设置、打开规则日志、打开隔离目录。
|
||
|
||
页面不负责:
|
||
|
||
- 启停启动项:跳转启动项页。
|
||
- 结束进程:跳转实时监控 → 进程,并带上 PID/路径过滤。
|
||
- 卸载 App:跳转应用卸载;安全页只提供入口,不自动生成卸载计划。
|
||
|
||
### 4.4 启动项
|
||
|
||
职责:展示并管理登录/启动时自动运行的持久化入口,解释每个条目的来源和风险。
|
||
|
||
页面按操作系统自己的分法组织,而不是按实现文件的分法。macOS 把它拆成「登录时打开」
|
||
和「允许在后台」两张列表,并把每个条目归到安装它的应用下面;0.1.6 的第一版把两者拍平成
|
||
一条 873 行的 plist 标签列表,结果既看不到系统设置里那两三项「登录时打开」,也读不懂剩下
|
||
八百项。现在:
|
||
|
||
1. 页头:一句话说明按应用分组、以及「风险标记只代表值得检查」,不显示“优化分数”。
|
||
2. 两个页签,数字与点进去看到的条数一致:
|
||
- **登录项**:登录时会打开界面/应用的条目。macOS 的登录项,Windows 的启动文件夹与
|
||
Run/RunOnce。平铺不分组,组头位置放一个「打开系统设置」入口——这一列表在两个平台
|
||
都不归 squid 写。
|
||
- **后台程序**:不打开界面的 helper。macOS 的 LaunchAgents/LaunchDaemons、
|
||
Windows 的计划任务与服务。按所属应用折叠,组头显示应用名、条目数、已停用数、
|
||
值得检查数与签名状态。
|
||
3. 过滤:范围下拉(全部 / 当前用户 / 系统)、仅看值得检查、显示系统自带条目
|
||
(默认关闭,chip 上带着被藏起来的条数)。搜索匹配名称、命令、路径与应用名,
|
||
搜索时所有分组自动展开。
|
||
4. 列表行:名称、目标路径、风险标签、来源(分组视图里才显示,因为组头已经说明来源相同)、
|
||
系统级标记;右侧是开关或只读原因。
|
||
- 风险标签:目标不存在、路径在临时目录、无可用签名、**签名无法读取**、经由脚本解释器启动、
|
||
近期创建、隐藏条目、位于隐藏目录。
|
||
5. 详情抽屉:完整命令、所属应用、工作目录、可执行文件、声明位置、修改时间、签名;
|
||
关联进程跳转实时监控,文件可以单独送去扫描。
|
||
不可修改时,只读原因是本地化后的 `StartupLock` 枚举,不是后端拼好的英文句子。
|
||
6. 修改确认:展示将被改名/移动的 plist、注册表值或启动文件夹条目,说明影响与恢复方式;
|
||
操作后重新读取真实状态,不只更新前端缓存。
|
||
|
||
`StartupItem` 因此新增三个字段,全部由路径推导,不需要管理员权限:
|
||
|
||
- `category`:条目属于上面两张列表中的哪一张,由 `source` 决定。
|
||
- `owner`:安装它的应用。macOS 先取目标路径里的 `.app` 祖先并读它的 `CFBundleDisplayName`;
|
||
`/Library/PrivilegedHelperTools` 里的 helper 路径不携带答案,改用 launchd 标签去匹配
|
||
**已安装应用**的 bundle id 前缀,且只有该前缀只被一个应用拥有时才认领
|
||
(`org.wireshark.ChmodBPF` 曾经因为只比较首段而被归给 GeoGebra)。都失败时退回签名里的组织名。
|
||
Windows 用 Authenticode 发布者,其次 Program Files 下的产品目录。
|
||
- `lock`:不可修改的原因,枚举值,交给界面翻译。
|
||
|
||
首版操作范围:
|
||
|
||
| 平台 | 可直接操作 | 首版只读 |
|
||
| --- | --- | --- |
|
||
| macOS | 用户 `~/Library/LaunchAgents` | 全局 LaunchAgents/Daemons、登录项、Apple 系统项 |
|
||
| Windows | HKCU Run/RunOnce、用户启动文件夹 | HKLM、系统计划任务、Windows 服务 |
|
||
|
||
后续阶段:
|
||
|
||
- macOS 全局 LaunchAgents/Daemons:一次性管理员授权,备份后停用/恢复。
|
||
- Windows HKLM Run、系统计划任务:一次性 UAC 授权。
|
||
- Windows 服务:保持只读,不提供启停。
|
||
- macOS 登录项:保持只读,页面直接打开系统设置对应 pane(13.4)。
|
||
|
||
### 4.5 实时监控
|
||
|
||
职责:性能监控与进程管理。不新增第三个进程页面。
|
||
|
||
页面页签:
|
||
|
||
1. **性能 / Performance**
|
||
- 保留现有 CPU、内存、网络、磁盘、电池、卷、高占用进程。
|
||
- 高占用进程标题右侧增加“查看全部进程”。
|
||
2. **进程 / Processes**
|
||
- 全量进程表格,按需加载,不跟随 1Hz 刷新。
|
||
- 列:进程(路径并到名称下面一行)、PID、用户、CPU、内存、启动时间、签名,
|
||
行尾是「由启动项启动」标记与结束进程按钮。父进程只在详情抽屉里给,不占一列。
|
||
- 搜索、排序、按应用聚合、只看当前用户、只看未签名、只看有启动项。
|
||
- 行详情抽屉:命令行、可执行文件、哈希、签名、工作目录、启动项、父进程。
|
||
- 操作:结束进程、停止并隔离(仅已确认恶意)、打开文件位置、复制路径、跳转启动项。
|
||
|
||
「只看有启动项」和那个标记读的是同一个字段。0.1.6 里那个字段从来没被赋过值,
|
||
所以这一列和这个筛选都是 13.9 之后才真正可用的——上面这行是照实现改的,不是照愿望写的。
|
||
|
||
安全约束:
|
||
|
||
- 保留现有 PID/名称复核和关键进程保护。
|
||
- 结束进程仍然只处理当前用户拥有的进程。
|
||
- “停止并隔离”必须来自安全发现项或用户显式选中的已确认项,不能对任意进程直接开放。
|
||
- 不自动结束“可疑”进程。
|
||
|
||
### 4.6 设置
|
||
|
||
保留现有设置,并增加安全相关区段:
|
||
|
||
1. 语言与外观(不变)。
|
||
2. 系统权限:
|
||
- Full Disk Access。
|
||
- 通知权限。
|
||
- 登录启动(用于托盘定时扫描)。
|
||
- Windows 安全中心状态。
|
||
3. 安全:
|
||
- 扫描计划:关闭 / 登录后 / 每天 / 每周。
|
||
- 发现高危时通知。
|
||
- 自动隔离已确认项(默认关闭)。
|
||
- 规则包自动更新(默认开启,可关闭)。
|
||
- 扫描范围和默认排除项。
|
||
- 安全排除项列表,独立于清理白名单;新增排除项需要二次确认并显示风险提示。
|
||
4. 启动:
|
||
- 现有“开机自启”重命名为“登录时启动 Squid”,与“启动项”页面区分。
|
||
5. 删除安全(不变)。
|
||
6. 受保护位置(清理白名单,不变;说明它不影响安全扫描)。
|
||
7. 文件与信息:
|
||
- 配置、历史、规则包、隔离区路径。
|
||
- 构建信任状态:ad-hoc / 未签名,附发布说明链接。
|
||
8. 软件更新:
|
||
- 应用更新和规则包更新分开显示版本与信任状态。
|
||
|
||
### 4.7 历史记录
|
||
|
||
首版保持不变:只显示清理/卸载会话和撤销。
|
||
|
||
安全扫描、隔离、恢复和启动项修改先放在安全页的“最近活动”。
|
||
后续如果增加“保护事件”页签,再迁移,不在首版混入清理账本。
|
||
|
||
### 4.8 日常清理、应用卸载、深度清理、存储空间
|
||
|
||
这四个页面保持现有职责,首版不做安全功能混入:
|
||
|
||
- 日常清理:不显示恶意软件发现。
|
||
- 应用卸载:不自动把可疑 App 加入卸载计划。
|
||
- 深度清理:不自动扫描或删除安全发现。
|
||
- 存储空间:只负责体积分析和定位。
|
||
|
||
跨页面跳转只提供入口,不把不同引擎的状态混在同一张表里。
|
||
|
||
## 5. 关键流程
|
||
|
||
### 5.1 首次启动
|
||
|
||
1. 用户完成 Gatekeeper / SmartScreen 首次授权。
|
||
2. 打开 Squid,显示“安全准备”卡片。
|
||
3. 卡片列出系统防护、访问权限、通知、登录启动和规则更新。
|
||
4. 用户可逐项处理,也可直接关闭。
|
||
5. 进入概览页;没有安全扫描时显示“尚未扫描”,而不是“安全”。
|
||
|
||
### 5.2 发现 → 隔离
|
||
|
||
1. 安全页展示发现项和证据。
|
||
2. 用户点击“隔离”。
|
||
3. 后端重新校验发现 ID、路径、哈希、文件身份和权限。
|
||
4. 移入 Squid 隔离区,写隔离清单。
|
||
5. 刷新发现列表和托盘状态。
|
||
6. 失败时明确说明原因:文件已变化、权限不足、正在运行、需要管理员授权。
|
||
|
||
### 5.3 进程 → 启动项
|
||
|
||
1. 用户在进程页打开某个进程详情。
|
||
2. 若进程关联启动项,显示“由启动项启动”。
|
||
3. 点击后跳转启动项页并定位该条目。
|
||
4. 启动项页不自动停用,用户再次确认。
|
||
|
||
### 5.4 通知
|
||
|
||
1. 高置信度发现产生系统通知。
|
||
2. 点击通知打开安全页并定位发现。
|
||
3. 通知权限被拒绝时,应用内红色提示和托盘状态仍然有效。
|
||
4. Squid 未运行时没有实时通知;用户可通过“登录时启动”让托盘常驻。
|
||
|
||
### 5.5 更新后权限检查
|
||
|
||
1. 应用内更新完成并重启。
|
||
2. 重新读取 Full Disk Access、通知和登录启动状态。
|
||
3. 权限丢失时在安全页顶部显示“扫描覆盖受限”,提供修复入口。
|
||
4. 不阻塞启动,不自动重新弹系统权限对话框。
|
||
|
||
## 6. 功能契约
|
||
|
||
### 6.1 扫描模式
|
||
|
||
| 模式 | 范围 | 默认 |
|
||
| --- | --- | --- |
|
||
| 快速扫描 | 应用目录、用户/全局启动项、浏览器扩展、Downloads/Desktop 中的可执行候选 | 是 |
|
||
| 全盘扫描 | 用户主目录、Applications、启动项目录;显式发起 | 否 |
|
||
| 自定义扫描 | 用户选择的文件或目录 | 否 |
|
||
|
||
默认不挂载 DMG、不递归解压归档、不扫描网络卷和未授权目录。
|
||
|
||
### 6.2 检测层
|
||
|
||
1. 系统防护状态:XProtect / Defender,只读。
|
||
2. 精确 SHA-256 哈希黑名单。
|
||
3. YARA-X 规则,覆盖 Mach-O、PE、脚本、App Bundle、浏览器扩展和启动项 plist。
|
||
4. 启发式风险:签名、路径、启动方式、伪装名称、异常参数。
|
||
|
||
级别:
|
||
|
||
- 已确认:哈希或高置信规则命中。
|
||
- 可疑:只有启发式证据,不自动隔离。
|
||
- 提示:签名/路径/启动项风险,仅展示。
|
||
|
||
### 6.3 隔离不变量
|
||
|
||
- 扫描不删除文件。
|
||
- 隔离只接受后端缓存的发现项 ID,前端不能提交任意路径。
|
||
- 移动前重新读取并核对哈希、大小、文件身份和权限。
|
||
- 不跟随符号链接。
|
||
- 不隔离系统目录、XProtect、Squid 自身和隔离区自身。
|
||
- 隔离区文件不可执行、权限受限。
|
||
- 恢复需要确认;永久删除只从隔离区发起。
|
||
- 隔离清单与清理账本分开。
|
||
|
||
### 6.4 启动项不变量
|
||
|
||
- 修改前备份原 plist、注册表值或启动文件夹条目。
|
||
- 每次只改一个条目,不做“一键全部禁用”。
|
||
- 系统级修改必须经过一次系统授权。
|
||
- 操作后重新读取真实状态,不信任前端缓存。
|
||
- 目标消失、权限变化、条目被 App 重建时,报告实际状态而不是假装成功。
|
||
- 「无法读取签名」和「没有签名」是两件事:root 安装成 0711 的 helper 能执行、不能打开,
|
||
`codesign` 回答 Permission denied。把它报成未签名是在指控一个其实签过名的程序。
|
||
- 归属只写有依据的名字:路径里的 `.app`、唯一匹配的 bundle id 前缀、签名里的组织名。
|
||
两个应用共享同一前缀时是平局,平局不写答案,条目留在未分组里。
|
||
- 只读原因、读不到的目录、读不到的登录项都以枚举/结构体上传,由界面翻译;
|
||
平台层不拼接句子,否则中文界面会漏出英文。
|
||
|
||
### 6.5 规则包
|
||
|
||
- 内置基础规则,离线可用。
|
||
- 外部规则包使用独立 Ed25519 公钥验签,并校验 SHA256/大小。
|
||
- 只下载规则,不上传文件名、哈希或扫描结果。
|
||
- 验签失败、损坏或回滚时继续使用最后可用版本。
|
||
- 更新 `docs/SECURITY.md` 的网络说明。
|
||
|
||
### 6.6 性能预算
|
||
|
||
- 不新增常驻扫描线程。
|
||
- 空闲 0% CPU;安全页未打开时额外内存目标低于 20 MB。
|
||
- 扫描最多 4 个 worker,低优先级,可取消。
|
||
- 快速扫描目标 60 秒级;全盘扫描必须显式发起。
|
||
- 安装包增加目标不超过 10 MB;规则包压缩后目标不超过 5 MB。
|
||
- 哈希缓存按路径、大小、mtime、文件 ID 失效。
|
||
|
||
## 7. 实现落点
|
||
|
||
### 7.1 新 crate 与模块
|
||
|
||
```text
|
||
crates/squid-guard/
|
||
scan.rs 扫描编排、范围、进度、取消
|
||
signatures.rs 哈希索引、规则包加载
|
||
heuristics.rs 应用/启动项/进程风险判断
|
||
quarantine.rs 隔离、恢复、清单
|
||
intel.rs 规则包格式、验签、版本回退
|
||
|
||
crates/squid-platform/src/startup.rs
|
||
crates/squid-platform/src/process_table.rs
|
||
crates/squid-platform/src/trust.rs
|
||
```
|
||
|
||
`squid-guard` 依赖 `squid-core` 和 `squid-platform`,不依赖 `squid-engine`。
|
||
隔离执行不复用清理删除引擎,但复用进度、取消、路径规范化和权限判断。
|
||
|
||
### 7.2 Tauri 层
|
||
|
||
新增:
|
||
|
||
```text
|
||
src-tauri/src/security.rs 安全状态、扫描、发现、隔离
|
||
src-tauri/src/startup.rs 启动项清单、启停、备份恢复
|
||
```
|
||
|
||
命令建议:
|
||
|
||
```text
|
||
security_status
|
||
security_scan
|
||
security_cancel
|
||
security_quarantine
|
||
security_restore
|
||
security_delete_quarantine
|
||
security_exclusions
|
||
security_update_rules
|
||
startup_items
|
||
startup_set_enabled
|
||
open_startup_settings
|
||
process_inventory
|
||
process_detail
|
||
```
|
||
|
||
`open_startup_settings` 只打开系统设置对应的 pane:登录项、计划任务和服务在两个平台
|
||
都不归 squid 写,能给的诚实动作是送到那一页,而不是给一个未必生效的开关。
|
||
|
||
扫描结果、启动项清单和隔离项都由后端保存并分配 ID;前端只提交 ID。
|
||
运行中的扫描复用 `Progress`、`CancelToken` 和现有 `ProgressReporter` 模式。
|
||
|
||
### 7.3 前端
|
||
|
||
```text
|
||
src/pages/SecurityPage.tsx
|
||
src/pages/StartupPage.tsx
|
||
src/hooks/useSecurityWorkspace.ts
|
||
src/hooks/useStartupWorkspace.ts
|
||
```
|
||
|
||
修改:
|
||
|
||
```text
|
||
src/App.tsx 新增 PageId、Protection 导航组、快捷键
|
||
src/pages/SystemPage.tsx 增加“性能 / 进程”页签
|
||
src/pages/OverviewPage.tsx 增加安全状态条和两个独立扫描入口
|
||
src/pages/SettingsPage.tsx 增加安全设置与权限项
|
||
src/components/SetupPanel.tsx 扩展为安全准备卡片
|
||
src/types.ts / src/lib/api.ts / src/i18n.tsx
|
||
src/styles.css
|
||
```
|
||
|
||
### 7.4 CLI / TUI
|
||
|
||
CLI 首版增加:
|
||
|
||
```text
|
||
squid guard status
|
||
squid guard scan [paths…] --json
|
||
squid guard quarantine --scan <id>
|
||
```
|
||
|
||
CLI 只读取规则包和隔离清单,不依赖桌面端状态。
|
||
TUI 的 Guard 面板放到后续版本,不阻塞桌面端 MVP。
|
||
|
||
### 7.5 本地状态
|
||
|
||
```text
|
||
<state>/security/intel/ 当前与上一版规则包
|
||
<state>/security/cache/ 哈希缓存
|
||
<state>/security/quarantine/ 隔离对象和清单
|
||
<state>/security/startup-backups/ 启动项备份
|
||
```
|
||
|
||
`config.toml` 新增安全设置:扫描计划、通知、自动隔离、规则更新、
|
||
安全排除项。现有清理白名单不变。
|
||
|
||
## 8. 阶段计划
|
||
|
||
### P0:发布与授权基线(2–3 天)
|
||
|
||
- [x] 确认 macOS ad-hoc / Windows 未签名发布流程与 Shift 一致。
|
||
- [x] 扩展现有首次授权卡,加入安全准备检查。
|
||
- [x] 定义扫描覆盖范围和“权限受限”状态。
|
||
- [x] 验证 YARA-X 在 macOS universal / Windows x64 的体积、内存和 MSRV。
|
||
- [x] 验证 XProtect `status/version`、Defender 状态读取。
|
||
|
||
出口:首次安装、应用内更新、权限降级三条路径都有可演示 UI,不开始写扫描器。
|
||
|
||
实现说明:YARA-X 1.23 关掉默认 feature,只开 string / math / hash / time / macho / pe
|
||
等必要项。它把 workspace 的 MSRV 抬到 1.95,`ratatui` 也因此从 0.29 升到 0.30(0.29 用
|
||
`=0.2.0` 钉死 `unicode-width`,与 yara-x 的依赖链冲突)。`pe` 与 `macho` 两个模块大约贵
|
||
11 MB,但去掉 `pe` 就无法交叉编译到 Windows,所以留着。
|
||
|
||
### P1:可见性(1–1.5 周)
|
||
|
||
- [x] 新增 PageId、侧栏 Protection 组、快捷键、托盘菜单项。
|
||
- [x] 安全页只读骨架:系统防护、覆盖范围、空状态。
|
||
- [x] 启动项页只读列表和详情抽屉。
|
||
- [x] 实时监控页增加“进程”页签,全量进程只读。
|
||
- [x] CLI `squid guard status`。
|
||
|
||
出口:两平台能读到真实启动项/进程;系统项不会被误操作;权限缺失有明确说明。
|
||
|
||
### P2:扫描、告警与隔离(2–3 周)
|
||
|
||
- [x] 哈希/YARA/启发式扫描引擎。
|
||
- [x] 快速/全盘/自定义扫描和取消。
|
||
- [x] 发现列表、筛选、证据展示。
|
||
- [x] 托盘状态、应用内告警、通知。
|
||
- [x] 隔离/恢复/永久删除。
|
||
- [x] 签名规则包与离线回退。
|
||
|
||
出口:EICAR、哈希样本、YARA 样本命中;隔离字节一致;正常应用不误报;
|
||
扫描取消和权限不足路径稳定。
|
||
|
||
### P3:管理与修复(1–2 周)
|
||
|
||
- [x] 用户级启动项停用/恢复。
|
||
- [x] 进程结束、停止并隔离、跳转启动项。
|
||
- [x] 登录后/每日/每周扫描。
|
||
- [x] 自动隔离已确认项(默认关闭)。
|
||
- [x] 安全排除项。
|
||
- [x] 安全页最近活动。
|
||
|
||
出口:用户级启动项可逆;关键进程保护不回归;定时扫描只在托盘进程存在时运行。
|
||
|
||
### P4:系统级与增强(2–3 周,可选)
|
||
|
||
- [ ] macOS 全局 LaunchAgents/Daemons 一次性管理员授权。
|
||
- [ ] Windows HKLM Run / 系统计划任务一次性 UAC 授权。
|
||
- [ ] Downloads/Desktop/启动项目录的可选监听。
|
||
- [ ] 历史页增加“保护事件”页签。
|
||
- [ ] TUI Guard 面板。
|
||
- [ ] 误报反馈与本地诊断包。
|
||
|
||
出口:系统级修改有备份和恢复路径;不引入常驻特权 helper。
|
||
|
||
## 9. 验收标准
|
||
|
||
### 9.1 菜单与页面
|
||
|
||
- 侧栏 10 个入口顺序、分组、快捷键与本文一致。
|
||
- 新页面可被托盘、通知、概览、进程详情正确跳转并定位。
|
||
- 语言切换后菜单、托盘、页面文案同步。
|
||
- 安全页发现数量与托盘状态一致。
|
||
|
||
### 9.2 扫描与隔离
|
||
|
||
- 扫描绝不删除文件。
|
||
- 隔离只接受后端发现项 ID。
|
||
- 隔离 → 恢复后字节、权限一致。
|
||
- 已确认/可疑/提示三级不会互相冒充。
|
||
- 覆盖受限时不显示“完全安全”。
|
||
- 规则包篡改、断网、回滚都能安全降级。
|
||
|
||
### 9.3 启动项与进程
|
||
|
||
- 用户级启动项停用/恢复可往返。
|
||
- 系统级项目在未授权时不会变化。
|
||
- Apple/Microsoft 系统项默认隐藏且只读。
|
||
- 关键进程结束被拒绝并说明原因。
|
||
- 进程详情能正确关联启动项。
|
||
- 「登录项」页签显示的条目与系统设置「登录项与扩展 → 登录时打开」一致;
|
||
读不到时页面说明原因,而不是显示一张空表假装「没有」。
|
||
- 后台程序按应用分组,组名是可辨认的应用名,不是 plist 标签;归不了类的条目集中在一组,
|
||
不被随便塞进某个应用。
|
||
- 打开启动项页的等待时间与进程表同级,不出现「转圈几秒」。
|
||
|
||
### 9.4 发布
|
||
|
||
- macOS `codesign -dv` 显示 `Signature=adhoc`,不能出现本地证书名。
|
||
- 新 Mac 首次安装需要一次手动放行;应用内更新不再提示。
|
||
- Windows 安装器为 per-user,无管理员权限;SmartScreen 步骤写入发布说明。
|
||
- 两个平台的更新都完成大小、SHA256 和可选 Ed25519 校验。
|
||
|
||
### 9.5 性能
|
||
|
||
- 空闲无新增常驻线程和可测 CPU 占用。
|
||
- 安全页未打开时额外内存低于预算。
|
||
- 扫描可取消,取消后不继续消耗 I/O。
|
||
- 快速扫描达到目标时间,全盘扫描必须显式确认。
|
||
|
||
## 10. 明确不做
|
||
|
||
- 不复制或再分发 Apple XProtect 规则。
|
||
- 不伪装成 XProtect / Defender 的替代品。
|
||
- 不做内核扩展、EndpointSecurity、驱动或实时执行前拦截。
|
||
- 不安装常驻管理员 helper 或系统服务。
|
||
- 不自动删除低置信度发现。
|
||
- 不自动停用全部启动项。
|
||
- 不把清理白名单当作安全排除项。
|
||
- 不上传文件名、哈希、扫描结果或隔离文件。
|
||
- 首版不做安全评分。
|
||
- 首版不合并清理扫描和安全扫描。
|
||
|
||
## 11. 代码开工顺序
|
||
|
||
1. 先做 P0 的授权卡、发布检查和规则包/扫描引擎 spike。
|
||
2. 再做 P1 的导航、安全只读页、启动项只读页和进程页签。
|
||
3. P1 验收通过后接 P2 扫描与隔离。
|
||
4. P3 只加用户级操作和定时扫描。
|
||
5. P4 的系统级操作必须在 P3 稳定后再开始。
|
||
|
||
## 12. 实现后修订(0.1.6)
|
||
|
||
下面几条是写完、并在真机上量过之后必须回写给本文的差异。按本文开头的规矩:先改本文,
|
||
再改代码。
|
||
|
||
### 12.1 6.6 性能预算的实测结果
|
||
|
||
在 macOS 15.7.1 / 16 GB / NVMe 的开发机上,对真实主目录测量:
|
||
|
||
| 指标 | 目标 | 实测 |
|
||
| --- | --- | --- |
|
||
| 快速扫描耗时 | 60 秒级 | 冷启动 26 秒;命中判定缓存 9 秒 |
|
||
| 快速扫描读取量 | — | 约 1,900 个文件 / 6.2 GB |
|
||
| 全盘扫描耗时 | 显式发起即可 | 162 秒 / 50,070 个文件 |
|
||
| 遍历遇到的条目 | — | 约 105 万条,其中 34 万是无扩展名文件 |
|
||
| 空闲额外线程 | 0 个常驻扫描线程 | 1 个阻塞在 channel 上的定时线程,可被设置变更唤醒 |
|
||
|
||
「不新增常驻扫描线程」按原意保留:只有那个定时线程,它不轮询、不占 CPU,且只在应用运行
|
||
时存在(2.4 已写明没有 daemon)。
|
||
|
||
判定缓存与候选去重最初写成 `Vec` + `same_path` 线性查找,快速扫描因此跑到十分钟且 CPU
|
||
满核——看着像磁盘慢,实际是每文件上万次路径比较的纯 CPU 开销。改成按
|
||
`paths::canonical_key` 建索引后达到上表数字,并有测试断言 `canonical_key` 与 `same_path`
|
||
判定一致:键和判定不一致,就等于把一份缓存结论用到了另一个文件身上。
|
||
|
||
### 12.2 判定门槛(6.2 的必要补充)
|
||
|
||
6.2 说了有哪几层检测,没说**什么文件值得打开**。这是本项目里对可用性影响最大的一个决策,
|
||
写清楚:
|
||
|
||
1. 名字(遍历时免费);
|
||
2. `stat`:大小上下限 + 执行位;
|
||
3. 目录形状:`.app` 内部只取主可执行文件与 `Info.plist`,否则光是 `/Applications` 就要
|
||
多读十 GB;
|
||
4. 只有浏览器下载目录才去读文件头。
|
||
|
||
一条实测逼出来的修正:**扩展名要压过执行位**。解压压缩包会把里面所有文件都标成可执行,
|
||
于是「有执行位就算程序」在一台干净的 Mac 上报出 951 条假发现(`.class`、`.svg`、`.zip`、
|
||
`.DS_Store`)。现在的规则是:有名可查的按名字判断,无名可查的才看执行位。用户自己指名的
|
||
目录不受这条限制——那里按内容判定,因为 `eicar.com` 的后缀和它的身份本来就互相矛盾。
|
||
|
||
`.js` / `.json` / `.html` / `.lnk` 故意**不在**可执行扩展名里:它们在快速范围里有 35,288
|
||
个、1.31 GB;而恶意脚本真正的载体 `.ps1` / `.bat` / `.cmd` / `.hta` 只有 69 个文件、体积
|
||
几乎为零。全盘扫描与自定义扫描仍然看得到前者。
|
||
|
||
### 12.3 6.2 级别定义的收紧
|
||
|
||
「可疑」原先等于「有任何一条启发式证据」。在一台干净的 Mac 上这是 975 条。现在要求**两条
|
||
信号互相印证**——单个「无签名」只是「提示」,「无签名 + 开机启动」才是「可疑」。实测同一台
|
||
机器降到 8 条可疑 / 296 条提示,而这 8 条确实都值得看。伪装成系统组件仍然单独就能定为可疑,
|
||
因为没有正经程序会那么命名自己。
|
||
|
||
已发布探测器(哈希 / YARA)不受这条影响:它按自己的等级说话,也不替启发式充当第二条证据。
|
||
|
||
### 12.4 6.5 规则包的验签策略
|
||
|
||
6.5 要求「独立 Ed25519 公钥验签」,但没说构建里没有公钥时怎么办。按字面实现会让规则包在
|
||
除正式发布以外的每一个构建里永远更新失败。现在的做法与应用更新一致:
|
||
|
||
- 构建内有公钥 → 必须验签通过,否则拒绝(这是密钥的全部意义);
|
||
- 构建内没有公钥 → 接受,但把 `provenance` 记成 `unverified` 并落盘,安全页与设置都写明
|
||
「仅校验哈希,未验签」。
|
||
|
||
清单与包体仍然照 6.5 校验大小与 SHA-256;YARA 编译不过的包照样不允许成为 `current`。
|
||
|
||
### 12.5 与本文的两处措辞差异
|
||
|
||
- 4.3 的「扫描按钮和扫描类型菜单」实现为三个并列按钮(快速 / 全盘 / 自定义),不是下拉
|
||
菜单:全盘与自定义的代价不同,摊开比收进菜单更不容易误点。
|
||
- 4.4 的风险标签在列表中只显示图标与短语,完整解释在详情抽屉里。一行六个橙色标签读起来
|
||
和没有标签一样。
|
||
|
||
### 12.6 7.1 的模块划分与落点清单
|
||
|
||
7.1 写的是 `signatures.rs` 一个文件,实际需要三份互不相干的状态,硬挤在一起会分不清哪份
|
||
磁盘缓存对应哪个结论,所以拆成:
|
||
|
||
- `rules.rs`:哈希黑名单与 YARA 规则的编译与加载;
|
||
- `intel.rs`:规则包格式、验签、版本回退(与本文一致);
|
||
- `store.rs`:扫描结果、发现、忽略项与最近活动的落盘。7.1 没提这个文件,但 6.3
|
||
「前端只提交 ID」和 4.3「最近活动」都要求后端保存一份带 ID 的历史,它必须有归宿。
|
||
|
||
另外两处与清单的差集:
|
||
|
||
- 7.2 的命令表列了 12 条,实现为 18 条,多出 `security_open`(4.3 的「在 Finder 中显示」)、
|
||
`security_ignore`(4.3 的「忽略一次」)、`security_settings_save`、
|
||
`security_rollback_rules`(6.5 的回滚)、`open_quarantine_folder` 和 `process_stop`
|
||
(4.5 的结束进程,清单把它漏在 `process_detail` 之后)。清单里的 `security_cancel` 实现了。
|
||
- 7.1 说 `squid-guard` 不依赖 `squid-engine`:成立;它只依赖 `squid-core` 与
|
||
`squid-platform`。
|
||
|
||
### 12.7 界面不新增规范,并删掉重复解释
|
||
|
||
两个新页面第一版写完,界面自己变成了第二套设计系统:108 个新 class、两套 chip、两套
|
||
标签页、两个搜索框、两种图标按钮,外加 25 条超过 88 字符的解释文案。这一节把结论写死,
|
||
以后再加页面照此执行:
|
||
|
||
**复用,不新造。** 新页面一律用既有原语:卡片壳 `.panel`(和 `.apps-list-panel` 同一组
|
||
声明)、`.status-chip`(补 `is-success/warning/danger/info` 四个色调,而不是再造一个
|
||
`.state-pill`)、`.search-field`、`.icon-button`、`.text-button`、`.metric-icon` + `tone-*`、
|
||
`.quick-copy`、`.settings-row`、`.settings-select`、`.empty-inline`、`.host-card`、
|
||
`.confirm-extra`。`.startup-source` 曾经同时挂在一个 `<select>` 和一个 `<span>` 上,
|
||
`<select>` 改用 `.settings-select`。
|
||
|
||
**同一件事只有一种写法。** 发现行、启动项行、隔离行共用 `.item-row/.item-main/.item-copy/
|
||
.item-actions`;抽屉正文共用 `.item-detail`;统计块共用 `.stat`。`security-toggle` 组件本身
|
||
就是 `.settings-row` 的复制品,已删除。
|
||
|
||
**文案一条一句话。** 页面副标题 60–120 字符,和旧页面一致。同一个事实只在离它最近的
|
||
控件上出现一次:发现数以前在 `SectionTitle` 副标题和筛选 chip 各写一遍,现在只有 chip
|
||
带数字,而且 chip 上的数字就是点下去会看到的条数。
|
||
|
||
**不新增的规范也要说清楚。** 隔离行、启动项行原来各自定义了边框/圆角/背景,现在都来自
|
||
`.item-row` 一处;改一处两个页面同时生效,这正是不开第二套规范的目的。
|
||
|
||
> 13.1 把这一节里的三件事改掉了:`.item-row` 的定义换成扁平分隔线、`.settings-select`
|
||
> 变成组件 `Select`、`.stat` 删除。这一节保留原文,因为它记录的判断(复用而不是新造)
|
||
> 依然成立,被改掉的只是它当时选中的具体 class。
|
||
|
||
### 12.8 6.6 的体积预算超了,并且部分是我自己造成的
|
||
|
||
6.6 写「安装包增加目标不超过 10 MB」。0.1.6 实测:
|
||
|
||
| 安装包 | 0.1.5 | 0.1.6 | 增加 |
|
||
| --- | --- | --- | --- |
|
||
| macOS universal DMG | 10,702,261 | 21,831,698 | **+10.6 MiB** |
|
||
| Windows x64 NSIS | 3,354,754 | 7,816,721 | +4.3 MiB |
|
||
|
||
两点都要写清楚,不要含糊过去:
|
||
|
||
1. **Windows 在预算内**(+4.3 MiB),macOS 略微超出。超出部分主要是 yara-x 把 wasmtime
|
||
与 cranelift 拖了进来——`wasmtime` 在 yara-x 1.23 里是**必需依赖**,不是可选 feature,
|
||
即便只开 `macho`/`pe` 这些模块也一样链接。想靠关 feature 省下来省不掉。
|
||
2. **第一次构建时报 `stripping debug info with rust-objcopy failed`**:`src-tauri` 被根
|
||
workspace `exclude`,自己又没写 `[profile.release]`,所以桌面端从来没被 strip 过。
|
||
补上 `strip = "symbols"` 后 universal 二进制从 85,043,456 降到 63,457,920 字节
|
||
(−20.6 MiB),DMG 从 23.6 MiB 降到 20.8 MiB。也就是说:如果没有这次发现,超预算会
|
||
严重得多;而 `panic` 仍然保持 unwind,因为「命令线程 panic 只失败一次请求」变成
|
||
「整个应用退出」不属于这个版本该有的行为变化。
|
||
|
||
预算本身不改成 11 MB:超了就是超了,写在这里比改数字更有用。下一版如果要还这笔账,
|
||
方向是二进制本身(例如等 yara-x 提供关掉 wasm 后端的选项),不是砍功能。
|
||
|
||
## 13. 第二轮修订:列表样式、下拉组件与启动项重做
|
||
|
||
0.1.6 发出去以后收到的三条反馈都成立,而且第三条最严重:启动项页把 873 个 launchd
|
||
标签拍平成一列,用户在这页既找不到系统设置里那两三项「登录时打开」,也读不懂剩下的八百项。
|
||
|
||
### 13.1 列表统一成扁平分隔线,不要指示器
|
||
|
||
0.1.6 的两个新页面给每一行套了一张 1px 描边的圆角卡片,再用 3px 左边框当严重级别指示器。
|
||
这一条不只是审美问题:它和旧模块根本不通约,而且同一版里自己就不统一——
|
||
安全页/启动项页是描边圆角盒,新进程表是斑马纹,`.evidence-list li` 是实心色块,
|
||
旧模块则从来不是这个样子。现在:
|
||
|
||
- `.item-row` 重新定义:`min-height: 44px`、`padding: 7px 10px`、
|
||
`border-bottom: 1px solid var(--nex-line)`、无圆角、hover 用 `--nex-cream`,最后一行不画线。
|
||
旧页面本来只有两种行:一种带分隔线(`.process-row` + `.process-head`),一种是圆角但
|
||
不画边的悬浮高亮(`.cleanup-row`、`.app-row`、`.large-file-row`、`.whitelist-row`)。
|
||
0.1.6 造的是第三种——每行一个 1px 描边圆角盒子,再加 3px 左边框,哪一种是都不像。
|
||
新页面并入第一种:安全页和启动项页的条目是「几百行里扫一眼」的列表,
|
||
和进程表同类;`.history-card` 那种整卡是「一次会话」的容器,不是同一件事。
|
||
- 级别不再用边框表示。`.level-dot` 和 `.risk-chip` 删除;色调改为给
|
||
`.item-copy strong` 着色(`is-danger` / `is-warning`),级别文字仍由 `.status-chip` 承担。
|
||
- 同一版里剩下的两处也并入分隔线:`.evidence-list li`(原来是实心色块圆角)、
|
||
`.ptable.pt-rows li` 与 `.process-group-head`(原来是斑马纹圆角)。
|
||
改完之后**安全页和启动项页**与旧模块里带分隔线的那种行完全一致。旧模块本身仍有两种行
|
||
(带分隔线的 `.process-row`,和不画边、圆角高亮的 `.cleanup-row`/`.app-row`/`.large-file-row`/
|
||
`.whitelist-row`),这一轮没有去统一它们:用户要的是新模块别再自己发明第三种,
|
||
而不是把八个旧页面重排一遍。
|
||
- 我这次新增的类只有 12 个(`group-*` 5 个、`select*` 3 个、`is-{start,end,current,nested}`),
|
||
同时删掉 9 个(`level-dot`、`risk-chip`、`settings-select`、`startup-batch*` 3 个、
|
||
`startup-meta`、`stat`、`stat-grid`)。启动项页原来的五块 `.stat` 摘要删除,
|
||
数字回到页签和筛选 chip 上,和 12.7 的结论一致。
|
||
|
||
### 13.2 下拉组件不用原生控件
|
||
|
||
`<select>` 的弹出层由操作系统绘制,字号、配色、圆角都不受应用控制,放进这套界面里
|
||
像另一个程序。`ui.tsx` 增加组件 `Select`(触发按钮 + `.panel` 同款浮层 + `Check` 标记当前项,
|
||
支持指针外点、Esc、↑↓、Enter),`.settings-select` 删除。三处原生 `<select>` 全部换掉:
|
||
安全设置的扫描计划、设置页的历史保留条数、启动项页的范围筛选。`Select` 的触发框沿用原来
|
||
的 86×31 与 8px 圆角,所以替换不会挪动任何布局。全应用现在没有原生下拉。
|
||
|
||
启动项页的「来源」下拉本来有七个选项,重做之后被两件事取代:页签表示 `category`,
|
||
分组标题表示所属应用。少一个控件比把控件做漂亮更有用。
|
||
|
||
### 13.3 启动项按操作系统的分法重排
|
||
|
||
`StartupItem` 增加三个字段,都由路径推导,不需要管理员权限:
|
||
|
||
- `category`:`open-at-login`(macOS 登录项、Windows 启动文件夹与 Run/RunOnce)
|
||
或 `background`(LaunchAgent/Daemon、计划任务、服务)。这就是页签的两栏,
|
||
名字直接沿用系统设置「登录项与扩展」的分区。
|
||
- `owner`:安装该条目的应用。macOS 先看目标路径的 `.app` 祖先并读 `CFBundleDisplayName`;
|
||
`/Library/PrivilegedHelperTools` 里的 helper 路径不带答案,改用 launchd 标签去匹配
|
||
**已安装应用**的 bundle id 前缀,且只有该前缀只被一个应用拥有时才认领;都失败时退回
|
||
签名里的组织名。Windows 用 Authenticode 发布者,其次 Program Files 下的产品目录。
|
||
- `lock`:不可修改的原因,是枚举而不是句子,由界面翻译。12.6 已经为
|
||
`schedule_note` 犯过同样的错——后端拼好的英文会漏进中文界面。
|
||
|
||
页面结构:页签(登录项 / 后台程序,数字与点进去看到的条数一致)→ 搜索 + 范围 +
|
||
「值得检查」+「系统自带条目」四个筛选 → 登录项平铺、后台按应用折叠。
|
||
系统自带条目仍然默认隐藏,chip 上直接写明被藏起来的是多少条(本机 845 条)——
|
||
「默认帮你藏了 845 条」必须让人看见,否则「全部」这个词在这页是假的。
|
||
|
||
**本机实测**(M1 Pro,macOS 15.7.1):874 条,其中 Apple 845 条;非系统条目
|
||
归成 19 组,例如 Google Chrome 4 条、Docker 2 条、Microsoft Corporation 2 条、Zoom 1 条;
|
||
另有 3 条确实归不出来,集中在一组,不硬塞。
|
||
`login-item://豆包` 一条,与系统设置「登录时打开」一致。
|
||
|
||
### 13.4 登录项此前一条都没有,原因是两个真 bug
|
||
|
||
用户说「mac 设置里登录打开的内容反而没有」,不是主观感受:那一栏当时恒为空。
|
||
|
||
1. `login_items()` 从 `backgrounditems.btm` 里刮 ASCII 路径,再要求命中 `"/Applications/"`。
|
||
这个归档里的路径全是小写(`/applications/wireguard.app`),大小写敏感的匹配一个都不中。
|
||
2. 修好大小写也不够。BTM 是 NSKeyedArchiver,装的是 security-scoped bookmark;
|
||
用户目录里那份只含 9 个容器,系统设置面板显示 30 多个应用组,`sfltool dumpbtm`
|
||
需要 root 才能读全。刮字符串永远对不上系统设置。
|
||
|
||
现在改问 System Events(`every login item`),也就是系统设置那块面板自己的视图,
|
||
两者不会打架。登录项仍然只读——AppleScript 的 `delete` 在不同 macOS 版本上并不可靠——
|
||
所以旁边给一个「打开系统设置」的动作,命令按 `sw_vers` 的主版本号选 URL:
|
||
13 及以上用 `com.apple.LoginItems-Settings.extension`,12 用
|
||
`com.apple.preference.users?LoginItems`(这两个是不同的 pane,`open` 对不认识的
|
||
pane 也返回 0,所以不能靠试错)。读不到时 `StartupNote.kind = login-items-unavailable`
|
||
在页面上说明原因,而不是显示空表假装「没有」。Info.plist 为此加了
|
||
`NSAppleEventsUsageDescription`,首次读取会请求自动化权限。
|
||
|
||
### 13.5 打开这一页要 8 秒
|
||
|
||
`inventory()` 冷启动 8.65 s。原因不是 plist:868 个条目里 844 个的 `program` 指向
|
||
Apple 自己的文件,而 macOS 的 `trust::assess` 每次 fork 一个 `codesign`,
|
||
等于给一屏永远没人检查的条目问 844 次签名。三处改动之后 0.34 s,
|
||
而且真正需要问签名的从 868 个降到 16 个:
|
||
|
||
- 签名判断从 `judge_program` 里拆出来。`system_vendor` 的条目和「目标已不存在」的条目
|
||
都不再问:前者不是要检查的对象,后者「不在了」本身已经是答案。
|
||
- 剩下那十几次用 `par_iter_mut` 并行;`trust::assess` 原来在整个 `codesign` 期间持有
|
||
缓存互斥锁,那样并行等于白做,现在只在查/写缓存时加锁。
|
||
- 顺序有讲究:先签名后归属,因为路径认不出应用时要用「谁签的名」兜底。
|
||
两个平台的 `inventory()` 末尾收敛到同一个 `finish()`,不再各自写一遍。
|
||
|
||
扫描结果没有因此变化:同一台机器仍是 8 suspicious / 308 advisory / 0 confirmed。
|
||
|
||
### 13.6 顺手修掉的两个签名谎报
|
||
|
||
- `trust::might_be_executable` 用扩展名判断「值不值得问签名」。macOS 特权 helper 叫
|
||
`us.zoom.ZoomDaemon`、`com.microsoft.autoupdate.helper`,最后一个点是名字的一部分,
|
||
于是它们被判成「不是可执行文件」,进而报成**未签名**。本机
|
||
`/Library/PrivilegedHelperTools` 的 7 个 helper 全部踩中这条:改之前一个都没被问过签名,
|
||
其中 5 个其实签名完好,剩下 1 个是根本读不了的 `com.docker.socket`。改成读前 8 个字节判断
|
||
Mach-O/PE;打不开文件时不再一律回答 false,
|
||
因为 root 装成 0711 的 helper 能执行、不能打开。
|
||
- 上面那种「打不开」现在单独成一级:`StartupRisk::SignatureUnreadable`。
|
||
把读不到说成没签名,是在指控一个签过名的程序,而 6.4 的整份信用就建立在这种区分上。
|
||
|
||
### 13.7 「太多太杂」的真正原因:字段名根本没对上
|
||
|
||
重查时发现比样式严重得多的事:`StartupItem` 没有 `rename_all`,而包住它的 `StartupView` 有。
|
||
后端发的是 `system_vendor`,页面读的是 `item.systemVendor`,于是这个表达式**恒为 `undefined`**,
|
||
`if (!showVendor && item.systemVendor) return false` 一次都没有生效——
|
||
|
||
```text
|
||
0.1.6 的启动项页:默认显示 873 行(Apple 的 845 行全都列在外面)
|
||
现在(同一台机器,同一个 inventory):默认显示 29 行
|
||
```
|
||
|
||
这正是用户说的「太多、太杂看不懂」的直接原因,也解释了为什么这一版光是分组还不够:
|
||
分组之前得先让那 845 行真的被藏起来。TypeScript 看不见这个 bug——interface 描述的是
|
||
意图,不是线上真正发出来的字节。
|
||
|
||
同类问题一共四个,全都在 0.1.6 就发出去了:
|
||
|
||
| 类型 | 页面读到的是 | 实际收到 | 后果 |
|
||
| --- | --- | --- | --- |
|
||
| `StartupItem` | `systemVendor`/`workingDirectory`/`modifiedMs` | snake_case | 「隐藏系统项」失效;详情抽屉的工作目录、修改时间恒为空 |
|
||
| `StartupOwner` | `bundlePath` | `bundle_path` | 组头的 bundle 路径不显示 |
|
||
| `ProcessRow` | `startedMs`/`startupItem`/`workingDirectory` | snake_case | 进程表「启动时间」列恒为 `—`,按它排序恒为平局(`startupItem` 另有原因,见 13.9) |
|
||
| `Trust` | `adHoc` | `ad_hoc` | 进程详情把 ad-hoc 签名说成「未签名」 |
|
||
|
||
修法沿用本文既有约定:**跨 IPC 的结构体自己声明 camelCase**(`Finding`、`SecuritySettingsView`
|
||
等一直这么做),而不是在 `*View` 里再套一层复制。改的是发送端,Rust 内部字段名不变,
|
||
CLI/TUI 直接访问字段因此不受影响;`squid guard startup --json` 的输出键随之变成 camelCase,
|
||
和 `guard scan --json`、`guard status --json` 统一(那两个一直是 camelCase)。
|
||
`SystemSnapshot`、`LargestFile` 两侧本来就是 snake_case,属于另一种一致,没有动。
|
||
|
||
回归测试在 `src-tauri/src/startup.rs` 的 `wire_tests`:它序列化真正的 `StartupView`,
|
||
断言页面读得到的每个名字都在线上,并且断言线上**没有**同一字段的第二种拼法。
|
||
把 `StartupItem` 的 `rename_all` 删掉,测试立刻红。
|
||
|
||
### 13.8 屏幕锁着也能验:把真组件跑进无头 Chrome
|
||
|
||
Computer Use 需要显示器点亮,而验收期间这台 Mac 一直锁着。替代办法是
|
||
`probe/`:用真的 `StartupPage` + 真数据(`squid guard startup --json` 落地成
|
||
`fixtures/startup.json`)+ 真 `src/styles.css`,在 headless Chrome 里量**计算后**的样式并截图。
|
||
它当场抓到一个肉眼看不出的 bug:`.status-chip` 没有 `white-space: nowrap`,
|
||
中文标签在行内被挤成**一字一行**(截图里「无法读取签名」竖着排)。旧 `.risk-chip` 本来有 nowrap,
|
||
13.1 合并 chip 时把这个性质丢了。修在 `.status-chip` 本身(`flex: 0 0 auto` + `white-space: nowrap`),
|
||
因为它是 6 处共用的原语,不是一个页面的补丁。
|
||
|
||
量出来的行形状,新列表和旧模块对齐:
|
||
|
||
| | 圆角 | 左边框 | 下边框 | 背景 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `.item-row`(安全页/启动项页) | 0 | 0 | 1px solid | 透明 |
|
||
| `.group-head` | 0 | 0 | 1px solid | 透明 |
|
||
| `.process-row`(旧模块) | 0 | 0 | 1px solid | 透明 |
|
||
| `.select-menu`(下拉浮层) | 11px | — | 1px solid | 卡片底色 + 阴影 |
|
||
|
||
全页 `document.querySelectorAll('select').length === 0`,`option` 同样是 0。生产包里
|
||
`option` 元素计数也是 0(`select` 那个命中来自 react-dom 自带的 DOM intrinsic 表,不是应用代码),
|
||
所以「所有下拉都不是原生控件」在整个应用范围内成立,不只是这三处改过的地方。
|
||
|
||
nowrap 的代价是标签不能折行,所以同一份探针量了溢出:1180 / 1280 / 820 / 900 宽度下
|
||
`scrollWidth - clientWidth` 全为 0,页面没有横向滚动;820px 截图里行仍是一行,
|
||
过长的是**名字**(`.item-copy` 本来就会打点省略),标签完整可读。
|
||
|
||
`probe/` 是临时脚手架,量完已删除,不进版本库;它不是产品的一部分。
|
||
### 13.9 进程表里那个从来不会亮的标记
|
||
|
||
`ProcessRow::startup_item` 的注释写着「由桌面层填」,进程表从 0.1.6 起就照着它画
|
||
「由启动项启动」的盾牌图标,筛选条也照它做「只看有启动项」——但**全仓库没有任何地方给它赋过值**,
|
||
三处构造点全是 `None`。所以那个图标从来没出现过,那个筛选永远返回 0 行。
|
||
13.7 修好的只是字段名;名字对了,值仍然是空的。
|
||
|
||
现在 `process_inventory` 读一次启动项清单,按可执行文件路径把两者对上:
|
||
|
||
- 一次 inventory 给整张表用。`entry_for` 每次调用都重新扫一遍全部根目录,按行调用等于 757 次。
|
||
- 实测(M1 Pro,757 进程 / 874 条目;`join_tests::what_the_join_costs`,`--ignored` 才跑):
|
||
签名检查开着(默认)时表本身 5 s,加 join 之后 6 s,757 行里 452 行被标注;
|
||
签名检查关掉时表本身只要 26 ms,加 join 变成 390 ms。默认路径几乎没动,签名才是瓶颈;
|
||
那条快路径多出的 0.36 s 是这次改动真实的代价,写在这里而不是糊过去。
|
||
|
||
没有加缓存是有意的。这张表只在打开页签、切换签名、点「刷新」时读,没有定时器;
|
||
而把 inventory 缓存下来正是 `useStartupWorkspace` 的注释里点名不要的做法——
|
||
App 会自己把启动项装回来,记住旧值的列表会在条目已经重新启用之后还显示它是关着的。
|
||
- 同一个程序被两个条目声明时(`com.google.keystone.agent` 在 `~/Library` 和 `/Library` 各一份),
|
||
取清单里先出现的那个,也就是当前用户拥有的那份。
|
||
- **已停用的条目照样标注**:停用不一定能让进程退出,而这恰好是人最需要看清
|
||
「它还开着是因为那条启动项」的时刻。详情抽屉的 `entry_for` 也从来没按 `disabled` 过滤,两边一致。
|
||
|
||
这条不在 5.3 的验收里(那节只要求进程**详情**能关联启动项),但 5.3 的措辞是「若进程关联启动项」,
|
||
列表既然已经为这个标记画了图标、做了筛选,就不该是个永远不会亮的摆设。
|
||
测试:`join_tests` 两条,覆盖匹配、用户拥有的条目优先、无路径不匹配、停用仍标注。
|
||
|
||
## 14. 第三轮修订:菜单命名、页头小标题与重复说明
|
||
|
||
这一轮全是界面,没有改判定逻辑:扫描结果、启动项清单、进程表在本机与 13.9 结束时一致。
|
||
|
||
### 14.1 第一项改名「概览」
|
||
|
||
原来叫「电脑概览」,侧栏、顶栏、快捷键提示、README 与本文一起改成「概览」。
|
||
菜单宽度有限,而这一项旁边已经有磁盘健康卡片说明它讲的是这台电脑,「电脑」是废字。
|
||
|
||
### 14.2 除概览之外不再有页头小标题
|
||
|
||
每个页面顶部原来都有一行橙色小字(`应用程序`、`安全`、`设置`……),
|
||
下面紧跟同样意思的 `<h1>`。它把页面名说了两遍,还把标题从视觉上压小了。
|
||
现在 `eyebrow` 只留在概览:那里写的是「下午好 · macOS」,是问候加系统名,不是第二遍页面名。
|
||
其余 9 个页面一律不传 `eyebrow`;`.page-eyebrow` 规则保留,因为组件仍支持它。
|
||
|
||
### 14.3 界面上一半的说明是在重复离它最近的那个控件
|
||
|
||
12.7 定的规矩是「同一个事实只在离它最近的控件上出现一次」,当时只清理了两个新页面。
|
||
这一轮把同一条规矩用到全部 10 个页面和 5 个卡片:整段删掉 22 处说明(中文约 530 字),
|
||
另外把 14 处两句话的说明压成一句。删之前先确认「删掉之后这句话还有没有人说」,所以保留的都各有理由:
|
||
|
||
**删掉的是复述。** 设置页每个分组标题下面那句解释,说的都是标题或下面的控件已经说过的话:
|
||
「选择登录电脑后是否自动启动 Squid」在下一行的「登录时启动 Squid」开关上,
|
||
「超过此数量后较早的记录会被移除」在选择框里那五个数字上,
|
||
「默认选择当前系统语言」在任何平台的语言选择器上都是显然的。
|
||
安全页更夸张:「尚未扫描」在同一屏里出现了四次——页头标题、发现区副标题、
|
||
空状态标题、覆盖卡片——现在只剩页头和覆盖卡片两处,各自承担不同的事。
|
||
空状态「还没有清理记录」「查看已安装的应用」下面那段「扫描之后你会看到什么」整段删除:
|
||
用户扫一次就知道了,而这句话挤掉了真正的入口按钮。
|
||
|
||
**保留的是删掉就没人说的话。** 隐私承诺留在它自己那两行里(「规则只下载到本机,不上传任何内容」
|
||
「只读取,不改动」),页脚那句「一切都在本机完成」是它们的复述,删页脚不删这两行。
|
||
确认对话框里的「永久删除无法撤销」「此进程中未保存的内容可能会丢失」全留,
|
||
那是不可逆操作唯一的提示位。覆盖受限时「未检查的范围见上方覆盖说明」也留:
|
||
6.4 要求不能把没读过说成安全,这句是它在界面上的落点。
|
||
「停用会保留原始文件或注册表值,可随时恢复」留一次就够,同一个承诺在停用确认框里再说一遍是多余。
|
||
|
||
**改动方式。** 删掉说明会留下空容器,所以 `PageHeader.description` 与
|
||
`EmptyState.description` 从必填改成可选(和本来就是可选的 `SectionTitle.subtitle` 一致),
|
||
两者都在缺省时不渲染那一段;设置页分组标题下的 `<p>`、设置行里的 `<span>`
|
||
是各组独有的,直接删掉元素。随删掉的文案一起清除的
|
||
CSS 规则有 4 条:`.page-footnote`、`.setup-note`、`.field-help`、`.settings-footer`,
|
||
都是这次改完之后全仓库再无引用的。没有新增任何 class,没有改任何尺寸,
|
||
所以删完之后每一页剩下的控件位置没动。
|
||
|
||
**验证:** `npx tsc --noEmit` 通过(顺带清掉因此失效的 `formatBytes` 导入;
|
||
`SecuritySettingsCard` 的 `api` 与 `ui.tsx` 的 `lang` 两处未使用变量在 HEAD 上就存在,没有动);
|
||
`pnpm build` 通过;`cargo test --workspace` 272 项通过;`cargo fmt --check` 干净。
|