自动检测当前 Mac,并在本地页面完成硬件检测与报告下载
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 使用方法时提供上述说明。
执行流程
- 简短告知用户:将运行只读系统检测,不使用管理员权限、不修改系统设置;默认不联网,也不上传序列号或结果。
- 用户同意后,读取 architecture.md、privacy.md 和 agent-runtime.md。
- 必须显式使用 zsh 执行入口;不要依赖压缩包保留可执行权限,也不要要求用户
chmod:
/bin/zsh scripts/run-full-check.sh --output-root ./mac-check-output --locale <LOCALE>
- 入口依次执行环境检查、Session 创建、系统采集、事实规范化、确定性规则判断、单文件 Session App 构建与打开。
- 成功后只需说明:系统自动检测已完成,检查页面已经打开;请用户在页面继续硬件检测并下载报告。
- 若系统不允许自动打开页面,向用户提供脚本输出的
SESSION_HTML绝对路径。不要等待或要求用户把结果复制回聊天。
测试或用户明确不希望打开页面时:
/bin/zsh scripts/run-full-check.sh --output-root <DIR> --locale <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 临时拼接替代页面或报告。 - 麦克风或摄像头权限失败:页面标为“无法确认”并允许重试,不能直接判断硬件损坏。
Related skills
- Downloads
- 2.1kAll time
- Security audit
- Pass
- Last updated
- 3mo ago
- Current version
- v0.1.0
- License
- MIT-0
