# RegScout 自动接入

供本机 Codex 执行：完成配置、登录授权和真实查询。用户只需确认必要权限并登录，不需要处理 Token 或环境变量。

## 1. 连接 MCP

检查当前 Codex 的配置和工具。同地址且可用的 `regscout` 直接复用（包括有效的旧 Bearer 配置）；失效时修复。只有同名服务指向其他地址时，才询问是否替换。不要改动其他服务，也不要输出配置中的密钥。

缺少配置时执行：

```sh
codex mcp add regscout --url https://regscout.olaf.net.cn/api/mcp --oauth-client-id regscout-codex
```

若尚未完成授权，由当前 Codex 执行原生登录，无需用户自行输入命令：

```sh
codex mcp login regscout
```

保持登录进程运行，让 Codex 自动打开浏览器授权页；未自动打开时才提供登录命令返回的链接。请用户在浏览器登录 RegScout 并允许连接，收到成功回调后自动继续安装与验证。用户取消则停止，失败则说明原因。凭据由 Codex 保存，不读取浏览器 Cookie，也不将验证码或令牌写入对话、代码或项目文件。

若没有可用的 CLI，或 `codex mcp add --help` 不支持 `--oauth-client-id`，取得安装许可后按 [Codex 官方说明](https://learn.chatgpt.com/docs/codex/cli)安装或更新。使用实际发现的 CLI 路径和配置目录，不猜路径、不降低安全设置。

## 2. 安装 Skill

下载 [官方 Skill](https://regscout.olaf.net.cn/agent/skill.zip)，校验 ZIP 的 SHA-256：

```text
7fbd1e09eacceb5a353fe1bcab359e2ce3d90c2d25828a58561d0a471d5dc915
```

校验不符时重新获取[本说明](https://regscout.olaf.net.cn/agent/setup.md)和安装包；仍不符则停止。先在临时目录检查并解压：只接受 `regscout-compliance-research/` 内的普通文件和目录，拒绝绝对路径、`..`、反斜杠及符号链接，总大小不超过 8 MiB。

已有相同 Skill 则复用实际加载位置；更新前保留本地修改并确认。首次安装到 `~/.agents/skills/regscout-compliance-research`，保留完整目录，确保其中直接包含 `SKILL.md`。不要重复安装或覆盖其他 Skill。

## 3. 验证并完成

读取已安装的 `SKILL.md`，通过当前 Codex 的 MCP 工具依次执行：

1. `regscout_get_coverage`：确认覆盖范围、数据日期与法律状态日期。
2. `regscout_search_updates`：按实际工具参数检索一条事件。
3. `regscout_get_record`：用结果中的 ID 获取详情和官方依据。

安装、授权及三项查询均成功后，回复 **“已连接，可以开始提问。”**，附一条真实结果和官方来源。不要把事件更新当作现行法律核验，也不要把空结果当作验证成功。

若工具或 Skill 尚未加载，先尝试客户端刷新；必须重新加载时，只提示用户重新加载或新开会话，发送“继续验证 RegScout 接入”。完成真实查询前不要宣称已可用，也无需重复安装。