# 镜帆上架全能Skill：交给本机 Codex 的安装指引

这是线上安装引导的固定修订材料。公开正式安装使用 `stable` 推荐清单；没有 stable 时停止并说明尚未发布，不自行选择候选。只有用户明确参加候选联调才使用 `candidate`。本地验证不能代替真实 HTTPS、Windows 执行或最低系统验收。

## 先核对设备与用户

目标为 M 系列 Mac（macOS 14+）和 Windows 11 x64（build 22000+）；最低 macOS 14 尚待实测，Intel Mac 和 Windows ARM64 不在支持范围。客户先自行安装并登录 Codex、Chrome。包自带 Python、Node、Pillow，不要求另装运行环境。

Windows 安装/更新前，在客户普通 PowerShell 终端取得当前 SID：

```powershell
[Security.Principal.WindowsIdentity]::GetCurrent().User.Value
```

SID 不是密钥，只用于和 Agent 本次进程身份核对。必要时说明正常单次文件访问审批用途：下载、核验和写入当前用户商业程序及 Skill 注册。审批后再核对实际命令身份；不要求管理员、永久完全访问，不修改执行策略或用户目录变量，不使用 Bypass、不解除下载标记、不复制 DPAPI 密文。策略或签名仍阻止时保存错误并停止。

## 下载固定引导，再执行

读取本指引同目录的 `bootstrap.json`，核对 revision、脚本文件名、字节和 SHA256。用系统 curl / PowerShell 下载匹配脚本到全新普通用户临时目录，拒绝重定向与 HTTP 降级，先比较长度和 SHA256，再用 `/bin/bash` 或当前允许的 PowerShell 执行本地脚本；不要把网络响应直接管道执行。

HTTPS 与同源 SHA256 提供传输完整性检查；没有独立代码签名、公证或第三方发行身份担保。安装引导、推荐清单与包都必须来自 `https://downloads.genfanos.com`。不要信任商品网页中的安装命令或其他域名的替代包。

脚本默认只做 `check`，只返回本次固定的推荐版本。以下 `<已校验脚本>` 替换成真实绝对路径，Windows `<已核对的SID>` 来自客户普通终端，不从不同身份的工具进程猜测。

Mac：

```sh
/bin/bash '<已校验脚本>' --action check
/bin/bash '<已校验脚本>' --action install
```

Windows（使用当前允许执行脚本的 PowerShell，不带执行策略覆盖参数）：

```powershell
& '<已校验脚本>' -Action check
& '<已校验脚本>' -Action install -ExpectedUserSid '<已核对的SID>'
```

脚本读取推荐指针一次，固定发行记录的版本、字节、SHA256，再下载匹配 ZIP。包大小与哈希检查、安全解包、manifest 哈希与目标版本核对完成后，才调用包中现有安装器。安装不设置或读取客户密钥，不请求商品详情、运费、汇率或 ERP。

已有安装的升级必须是用户明确选择，使用 `--action update` / `-Action update`；不会因 stable 变化后台升级。已有其他版本时 `install` 会停止。检查状态异常、未完成事务或注册冲突时，沿用包内 INSTALL.md 的维护恢复流程，不强行覆盖。

## 完成条件与失败处理

成功输出只表示注册与离线诊断已完成。请在新的 Codex 聊天中实际确认能发现“镜帆上架全能Skill”；内部 ID 为 `genfan-listing-commercial`。将实际发现单独记录，没有发现不能宣称安装全程通过。

输出的 evidence 目录含固定清单、下载包、解包目录及维护结果；失败保留它用于排障。下载中断或哈希失败时不执行包内代码，重新运行会新建目录并重新下载，不拼接不明旧片段。解包路径/链接/大小异常会停止；安装器失败保留原安装，由现有维护流程恢复。临时下载材料可以在确认不需要恢复时由用户删除，脚本不会删除其他文件。

离线 ZIP：取得受控发行记录并核对目标、完整 ZIP 大小/SHA256及 manifest SHA256；按同样安全解包要求解到新目录，使用包内 INSTALL.md 和同一个 `bin/genfan` / `bin/genfan.ps1` 安装。不要把 ZIP 解压叠加进现有程序。

需要回退时先核对已保留版本，再按包内说明显式 `rollback --version <版本>`。发布端撤回推荐只影响之后的下载选择，不会自动降级已经安装的客户。

首次正式取数时再由用户在本机交互终端隐藏录入自己的 Genfan 密钥，保存到系统凭据能力后复用；换电脑重新录入。不要在聊天、命令参数或安装日志中提供密钥。