# 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 ``` CLI 只读取规则包和隔离清单,不依赖桌面端状态。 TUI 的 Guard 面板放到后续版本,不阻塞桌面端 MVP。 ### 7.5 本地状态 ```text /security/intel/ 当前与上一版规则包 /security/cache/ 哈希缓存 /security/quarantine/ 隔离对象和清单 /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` 曾经同时挂在一个 `` 改用 `.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` 的触发框沿用原来 的 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 除概览之外不再有页头小标题 每个页面顶部原来都有一行橙色小字(`应用程序`、`安全`、`设置`……), 下面紧跟同样意思的 `

`。它把页面名说了两遍,还把标题从视觉上压小了。 现在 `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` 一致), 两者都在缺省时不渲染那一段;设置页分组标题下的 `

`、设置行里的 `` 是各组独有的,直接删掉元素。随删掉的文案一起清除的 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` 干净。