MacCheck

Mac 验机助手

为用户启动一次完整、只读、默认离线的 Mac 检测。自动检测完成后，以本地 Session App 作为唯一操作界面；用户可在页面完成硬件检查、查看结论并直接下载报告。

使用边界

• 用户表达“验机”“Mac检测”“全面检查”“设备体检”“收货/维修验收”“购买或出售前检查”等完整检查意图时使用。
• 当前版本固定创建完整 Session；若用户只想了解某个单项，应直接回答或说明该项能力，不要悄悄启动整套流程。
• 支持能够在目标 Mac 上运行本地脚本并打开本地 HTML 的兼容 Agent 桌面宿主，不依赖特定产品、回调协议或对话持续运行。
• 根据当前对话选择 zh-CN 或 en-US；无法判断时使用 zh-CN。

无 Agent 终端运行

本项目也可以在没有 Agent 桌面端的情况下直接运行。下载或解压项目后，用户可打开“终端”，进入项目根目录并执行：

cd /path/to/mac-check-skill
/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN

英文界面将 zh-CN 改为 en-US。系统检测完成后会自动打开本地硬件检测页面；如果页面未能自动打开，可使用终端输出中的 SESSION_HTML 路径手动打开。此方式与 Skill 执行流程复用同一入口，不需要 chmod、sudo、清除隔离属性或安装额外依赖。

当 Agent 正在执行验机任务时，仍按下方“执行流程”直接调用入口，不要额外要求用户改用终端；仅在用户询问无 Agent 使用方法时提供上述说明。

执行流程

1. 简短告知用户：将运行只读系统检测，不使用管理员权限、不修改系统设置；默认不联网，也不上传序列号或结果。
2. 用户同意后，读取 architecture.md、privacy.md 和 agent-runtime.md。
3. 必须显式使用 zsh 执行入口；不要依赖压缩包保留可执行权限，也不要要求用户 chmod：

/bin/zsh scripts/run-full-check.sh --output-root ./mac-check-output --locale 

1. 入口依次执行环境检查、Session 创建、系统采集、事实规范化、确定性规则判断、单文件 Session App 构建与打开。
2. 成功后只需说明：系统自动检测已完成，检查页面已经打开；请用户在页面继续硬件检测并下载报告。
3. 若系统不允许自动打开页面，向用户提供脚本输出的 SESSION_HTML 绝对路径。不要等待或要求用户把结果复制回聊天。

测试或用户明确不希望打开页面时：

/bin/zsh scripts/run-full-check.sh --output-root  --locale  --no-open

正确性与安全

• 只运行 detection-catalog.md 中的只读命令；不使用 sudo、下载脚本、绕过锁定或修改系统的命令。
• Collector 只记录事实；Normalizer 只规范化；只有 rule-spec.md 的确定性规则可以生成结论。读取失败必须标为 UNKNOWN，不能伪装成通过。
• Session App 不执行 Shell、不读取相邻文件、不依赖 CDN、localhost、MCP、AI 回调或外部服务。Apple 保修入口只能由用户主动点击，页面不能后台提交序列号。
• 浏览器无法可靠观察的 Touch ID、物理接口、Force Touch 和感官质量必须采用清晰的引导验证，不得冒充自动检测。
• 不生成缺乏依据的综合评分，不写“放心购买”，不声称 Apple 官方检测或保证不存在任何管理与锁定风险。
• 系统数据必须序列化和转义后注入 HTML。完整序列号只保存在本地 Session 与报告中，页面不得把它发往网络；用户主动前往 Apple 官网查询保修时自行决定是否提交。

页面与报告

• 状态以页面当前内存为准，localStorage 仅作尽力恢复；页面不写回 session.json。
• 报告遵循 report-spec.md。在线风险查询、支付、性能测试、硬盘测速和 AI 评估不属于当前阶段，相关 feature flag 保持关闭。

失败处理

• 单项命令失败：继续其他检测，将对应结果标为“无法读取/需要确认”。
• 设备身份完全无法读取：停止构建页面，保留诊断文件并说明原因。
• 页面构建失败：保留 facts.json 与 system-results.json，不要由 AI 临时拼接替代页面或报告。
• 麦克风或摄像头权限失败：页面标为“无法确认”并允许重试，不能直接判断硬件损坏。