Hackintosh-skill

---
name: macos-remote-install
description: 从另一台 B 电脑远程协助 A 电脑安装或修复 OpenCore 与 macOS 双系统。覆盖 Windows SSH 接入、硬件兼容性分流、备份和分区、安装 U 盘、重启交接、macOS SSH、驱动排错、硬盘引导和功能验收。适合需要逐步进度反馈及回退记录的安装任务；不承诺所有硬件兼容，也不提供可直接套用的通用 EFI。
metadata:
  version: "0.2.10"
  language: zh-CN
  updated: "2026-11-05"
---

# 远程安装 OpenCore 与 macOS

A 是装 macOS 的电脑，B 是运行你和本指南的电脑。远程操作、读取硬件和安装的目标是 A。用户读回复、回传结果和你保存进度的位置在 B。按当前用户的授权执行，默认保留 A 的 Windows 和用户数据。

## Agent 内部启动

B 能运行 Python 时，先读 [标准流程控制器](references/00-controller.md)。新任务运行 `python scripts/workflow.py --run "私有任务目录" --json init`，续接运行 `status`。`init`／`status` 是内部动作。根据 `next_action` 执行，在当前步骤需要交接时展示该步的 `display`。首次需要在 A 操作时，使用 `prepare` 返回的开场与操作说明，并在同一条消息附完整代码（详见下节）。00 用固定连接器验收，01～08 按合同及证据推进。命令、工具选择和状态记录由 B 处理。

阶段 00 由程序现场验证 SSH、主机密钥、机器身份、管理员权限和文件传输，全部通过才推进。01～08 的统一合同在 [workflow.json](workflow.json)，由 Agent 执行并提交有证据的审核结果。正常分支使用固定脚本，异常分支按错误码 `recover`。未覆盖问题使用 `diagnose → repair-result → 原步骤重验`。

源码升级遇到 LF／CRLF 差异时使用控制器已登记的迁移能力。以 `workflow.py status` 核对版本和阶段，旧 NEXT.md 只作线索。工具探索、临时假设和逐文件检查留在私有日志。核对完整证据后再下结论。

**03 组装 EFI、04 引导故障、06 设备修复都从 [现成方案入口](references/10-existing-solutions.md) 开始。** 新建 EFI 先让用户选 a／b／c；随后在 B 运行 `python scripts/solutions.py lookup <主题> --target "<本机板型／设备ID>"`，按所选路线核对来源，由控制器 `select-source` 登记。保留生成器产物、实际案例原版或官方 Sample，再比较差异并适配。连续无效的同来源试验按控制器错误码回到有依据的来源或交接该项。

下载 GitHub 工具、源码或驱动时，按 [文件下载与局域网中转](references/04-installer.md) 核对实际下载端和具体资产。A 拉取失败就测 B，B 可达时由 B 校验并经 SFTP 中转；两端均失败时使用已有可信缓存或离线包，继续其他可做的检查。

**阶段 03 的固定前置条件：** 默认复用有效本机 ACPI；缺少时由 Agent 在 A 准备 Python 与原作者工具，通过 SSH 在 Windows 中采集，不为了避免安装依赖而默认增加重启。只在用户选择“免 Python 方案”或默认路线经诊断仍不可用并得到用户选择时，用 OpenCore DEBUG 的 SysReport 采集。采集启动必须停在 OC 菜单后回 Windows，不交接“选择 macOS 恢复”。`review` 必须提交并通过实际 ACPI 表／配置／适配证据检查，详情见 [介质前置检查](references/04-installer.md)。阶段 03 未过不得安排安装启动；下载、已授权的介质准备和明确标注的诊断启动可在此前进行。

用户只需一次 A 端配置与结果回传；已有完整可信结果直接导入，已有凭据直接使用。B 的 Python／工具不可用时明确标为“人工指导模式”，按下面参考执行，不伪造控制器输出。用户未要求切换模式时，不因为某个检查失败而绕过程序改用自由操作。

**EFI 路线先让用户选：** 新任务进入 03，原样展示控制器的 a／b／c 选项。a 为 RapidEFI-Tool 生成后适配（推荐），b 为查找相似配置并适配，c 为 AI 按官方 Sample 与本机证据生成。用户选好后执行 `choose-efi --choice a|b|c`，再 `lookup → select-source`；已有明确选择直接登记，不重复提问。不能自动改选另一条路线，也不能让用户手工完成具备桌面自动化能力的 Agent 可以完成的点击。RapidEFI 的固定操作、双机自动化分工和桌面产物定位见 [现成方案入口](references/10-existing-solutions.md)。

**EFI 审计与排错：** 阶段 03 组装前和 04 首次启动失败后，必须读取 [EFI 固定决策与排错流程](references/09-efi-diagnostics.md)。同机成功基线保留为对照；本轮按用户选择的路线生成。使用 `efi_audit.py` 检查配置启用状态、条件、文件差异和版本依据，部署后核对回读。连续两轮无新证据时回到基线／部署／日志核对，再依据新证据或交接继续。任一路线都要通过原有 ACPI、来源、校验及写后回读门槛。

**首次进入 OpenCore：** 生成器原始配置留档，在安装用测试副本设 `Misc → Boot → HideAuxiliary=false`，写盘后回读确认；阶段 03 会检查布尔值 false。人类交接说明文字菜单用上下、图形菜单用左右，回车启动；保留兜底提示“如果开机只看到 Windows，按空格展开隐藏项”。按空格仍无条目才回到介质诊断。菜单外观由实际 PickerMode、OpenCanopy 与资源决定。[安装现场清单](references/05-boot-handoff.md)

## 用户会看到怎样的回复

**第一次开场，要先让人知道自己在做什么。** 阶段名用 **00 准备工作和远程接入**。当控制器给出首次开场，按其顺序呈现，给准备清单和现场操作留出空行。第一次需要在 A 上配置时，在同一条回复交付 `prepare` 的 `display` 和返回文件的完整 PowerShell 代码块。只有开场实际交给用户后，才在 B 执行 `intro-shown` 记下已展示。续接按实际状态继续，避免重复课堂或要求回复“准备好了”。若当前客户端确需按回合发送，下一次处理用户消息时先补记已交付的开场，再处理这次回传。

首次开场应让新手能回答这几个问题，尤其在人工指导模式也要说清楚：

- 我在哪儿？A 是安装机，现在开着 Windows。B 是助手机，你现在正在这里读提示、之后也在这里回传结果。
- 为什么要连？助手在 B，需要开启 A 的远程连接（SSH），才能替你查 A 的硬件、传送安装文件。SSH 前的这一步要你在 A 完成，重启后的安装画面也会给你逐步指引。
- 现在手边要有什么？两台能互访的电脑、A 的 Windows 管理员权限和真实账户密码（平常解锁用的 PIN 不适用），B 有能操作本地文件、终端和网络的助手。稍后检查完再定容量、准备备份位置和可清空的 U 盘。进入安装时要能到 A 前看屏幕、用键鼠。
- 后面会经历什么？先连通并检查硬件 → 验证备份、制作启动 U 盘 → 你在 A 按清单安装至桌面 → 助手连回 macOS，逐项测硬件、验证硬盘启动并交付恢复方法。