nex_squid/docs/ROADMAP.md

60 KiB
Raw Blame History

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 侧栏

维护 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 托盘菜单

打开 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 与模块

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 层

新增:

src-tauri/src/security.rs   安全状态、扫描、发现、隔离
src-tauri/src/startup.rs    启动项清单、启停、备份恢复

命令建议:

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 前端

src/pages/SecurityPage.tsx
src/pages/StartupPage.tsx
src/hooks/useSecurityWorkspace.ts
src/hooks/useStartupWorkspace.ts

修改:

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 首版增加:

squid guard status
squid guard scan [paths…] --json
squid guard quarantine --scan <id>

CLI 只读取规则包和隔离清单,不依赖桌面端状态。 TUI 的 Guard 面板放到后续版本,不阻塞桌面端 MVP。

7.5 本地状态

<state>/security/intel/             当前与上一版规则包
<state>/security/cache/             哈希缓存
<state>/security/quarantine/        隔离对象和清单
<state>/security/startup-backups/   启动项备份

config.toml 新增安全设置:扫描计划、通知、自动隔离、规则更新、 安全排除项。现有清理白名单不变。

8. 阶段计划

P0:发布与授权基线(2–3 天)

  • 确认 macOS ad-hoc / Windows 未签名发布流程与 Shift 一致。
  • 扩展现有首次授权卡,加入安全准备检查。
  • 定义扫描覆盖范围和“权限受限”状态。
  • 验证 YARA-X 在 macOS universal / Windows x64 的体积、内存和 MSRV。
  • 验证 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 周)

  • 新增 PageId、侧栏 Protection 组、快捷键、托盘菜单项。
  • 安全页只读骨架:系统防护、覆盖范围、空状态。
  • 启动项页只读列表和详情抽屉。
  • 实时监控页增加“进程”页签,全量进程只读。
  • CLI squid guard status。

出口:两平台能读到真实启动项/进程;系统项不会被误操作;权限缺失有明确说明。

P2:扫描、告警与隔离(2–3 周)

  • 哈希/YARA/启发式扫描引擎。
  • 快速/全盘/自定义扫描和取消。
  • 发现列表、筛选、证据展示。
  • 托盘状态、应用内告警、通知。
  • 隔离/恢复/永久删除。
  • 签名规则包与离线回退。

出口:EICAR、哈希样本、YARA 样本命中;隔离字节一致;正常应用不误报; 扫描取消和权限不足路径稳定。

P3:管理与修复(1–2 周)

  • 用户级启动项停用/恢复。
  • 进程结束、停止并隔离、跳转启动项。
  • 登录后/每日/每周扫描。
  • 自动隔离已确认项(默认关闭)。
  • 安全排除项。
  • 安全页最近活动。

出口:用户级启动项可逆;关键进程保护不回归;定时扫描只在托盘进程存在时运行。

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 一次都没有生效——

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 干净。