# 国内安装助手：Agent 安装入口

用户要给本地 Codex 或 Claude Code 安装一个辅助排查工具下载与安装失败的 Skill。按用户已有授权操作，不要求用户理解 Git、目录结构或校验命令。不要安装别的 Agent，也不要改全局镜像或代理。

## 先确认你能装到用户想用的位置

- 必须能访问目标电脑的持久文件系统，并运行本地命令。只能网页聊天时，解释需要在已安装的 Codex / Claude Code 本地会话中发送安装请求，不索要 GitHub 账号。
- 远程容器、云端会话、SSH、WSL 与宿主电脑不是同一个安装位置。先报告目标环境；用户只说“装到我的电脑”而当前是远程环境时停止，不把远程安装当成本机成功。
- Codex：当前官方用户级目录是用户主目录下 `.agents/skills/cn-install-skill`。Claude Code：用户主目录下 `.claude/skills/cn-install-skill`；若 `CLAUDE_CONFIG_DIR` 已设置，核对有效配置目录后使用其 `skills` 子目录。组织策略或自定义配置优先，不猜未知 Agent 的目录。
- 项目级试用：仅用户明确选择时，分别使用项目根目录 `.agents/skills/cn-install-skill` 或 `.claude/skills/cn-install-skill`。不自动提交到项目 Git。
- 目标父目录缺失时，在确认的用户级位置创建。只需要普通用户权限；拒绝把目标指向系统目录或别人主目录。

## 本次固定版本和实际文件地址

版本：0.3.2
最低目标卷空闲：64 MiB。ZIP：53122 字节；解压内容：153972 字节。

下载清单（公开 HTTPS，不需要 GitHub、Git、Python 或 Token）：

- https://get.fenming-ai.com/releases/0.3.2/cn-install-skill-0.3.2.zip
  SHA-256: `91665bb7ab30d5bae2f39327716bdce12db3249c5c4619aa39d604506f4c57a7`

- https://get.fenming-ai.com/releases/0.3.2/install.sh
  SHA-256: `0e298cc12dba9050a9da54a6fd299df055a5f022e5a1b0c3b49a2233b47e8884`

- https://get.fenming-ai.com/releases/0.3.2/install.ps1
  SHA-256: `0a852f6ac03ac46459dc51c2816585a65eef2cc0d19cfab0ee3b446adbdfb6ca`

清单内 SHA-256 是这个版本的固定值。先确认 HTTPS 证书有效；哈希用于校验文件一致性，不能替代对交付方的信任。不要关闭 TLS 校验。

## 下载与执行

1. 在本机创建临时下载目录。只下载当前系统的安装器和 ZIP；不必把这些文件交给用户手动管理。
2. macOS / Linux 用系统 curl：`--fail --location --proto '=https' --proto-redir '=https' --connect-timeout 10 --max-time 120 --retry 2`，分别下载到明确文件路径；不使用 `curl | bash`。Windows 用 PowerShell `Invoke-WebRequest -UseBasicParsing -TimeoutSec 120 -OutFile ...`，失败最多再试两次。不要在命令或日志里放凭证。下载失败不继续解压。
3. 检查大小、SHA-256 和安装器内容。Windows 哈希可用 .NET `System.Security.Cryptography.SHA256`，macOS/Linux 用 `shasum -a 256`。发现 HTML 错误页、哈希不符、包截断或缺依赖时停止，报告具体原因。
4. 把下面的参数替换成你刚确定的真实本地路径。使用发布清单的 ZIP 哈希，不自行计算一个哈希再当作期望值。

macOS / Linux：

```bash
/bin/bash "$download_dir/install.sh" --archive "$download_dir/cn-install-skill-0.3.2.zip" --sha256 "91665bb7ab30d5bae2f39327716bdce12db3249c5c4619aa39d604506f4c57a7" --target "$skill_target"
```

Windows PowerShell 5.1 / 7：

```powershell
& "$downloadDir\install.ps1" -Archive "$downloadDir\cn-install-skill-0.3.2.zip" -Sha256 '91665bb7ab30d5bae2f39327716bdce12db3249c5c4619aa39d604506f4c57a7' -Target $skillTarget
```

脚本会检查空间、拒绝危险压缩包路径、默认拒绝覆盖。已有同名 Skill 时，先检查版本和用户改动；用户确认更新后，Shell 加 `--update`，PowerShell 加 `-Update`。保留输出的 `BACKUP` 地址。执行策略或组织权限阻止时，不使用 Bypass、不提权、不关闭防护。

## 完成标准：不是看到 INSTALLED 就结束

1. 核对目标 `VERSION` 为 0.3.2、`SKILL.md` 的 name 为 `cn-install-skill`，并确认目录是在用户要用的环境。
2. 让当前宿主重新发现 Skill。Codex 可从 `/skills` 或可用的 `skills/list` 接口检查；Claude Code 从 `/skills` 或 `/cn-install-skill` 检查。未出现时仅建议新开会话或按产品机制重载，不自动关闭用户正在工作的会话。
3. 从宿主发现的 Skill 入口加载它，做一次无修改调用：“先说清楚你会检查哪些安装条件，不下载、不改配置。”只读取文件不算宿主发现成功。
4. 没有调用证据时只报告“文件已安装，待加载确认”。证据齐全才说“已安装并可调用”。用户已给出要安装的项目就继续原任务；否则请他发目标工具或 Skill 链接。

## 失败和回退

报告卡在读取、下载、校验、写入或加载中的哪一步。空间不足不清理用户文件，权限不足不自动 sudo/UAC，锁冲突不盲目删锁。更新失败保留原版或输出备份；手动回退要先把新版本移到 skills 目录外，再把备份移回，不叠加覆盖。卸载只移走本 Skill 目录；它之后协助安装的其他工具单独处理。

本入口不保证目标 GitHub 项目一定适配用户电脑，也不保证所有国内网络始终可达。不要把所有失败都说成缺代理，更不能要求用户先买付费服务。

路径和加载机制依据：
- https://learn.chatgpt.com/docs/build-skills
- https://code.claude.com/docs/en/skills