# Gatekeeper v3.2 部署说明

## 变更

- 一次邮箱验证码开启最长 12 小时、空闲 1 小时自动失效的工作会话。
- 会话绑定人格体、服务器和操作范围。
- `POST /auth/session/end` 对应冰朔“今天结束”，立即吊销会话。
- 删除客户端自填邮箱；验证码只能发往服务器白名单登记邮箱。
- 注册铸澜 `ICE-GL-ZL-001`。
- 将苍耳 `TCS-GL-009`、耳耳蛋与鉴影合并进固定白名单。

## 服务器部署

1. 备份线上 `engine-v3.js`、`tokens.json` 和 `whitelist.json`。
2. 为铸澜生成独立随机 Token，写入服务器环境变量 `ZHULAN_API_TOKEN`；同时设置 `BINGSHUO_AUTH_EMAIL`、`CANGER_AUTH_EMAIL`、`SMTP_USER` 和 `QQ_SMTP_AUTH_CODE`。所有值只留服务器，不得写入仓库或日志。
3. 部署 `engine-v3.js` 与 `session-manager.js` 到同一目录。
4. 运行：

   ```bash
   node --check engine-v3.js
   node --test session-manager.test.js engine-v3.2-security.test.js
   pm2 reload engine-v3 --update-env
   curl -fsS http://127.0.0.1:3911/health
   ```

5. 确认健康接口返回 `version: 3.2.0`。

## 回滚

健康检查或会话测试失败时，恢复备份文件并执行 `pm2 reload engine-v3 --update-env`。不得删除现有 Token/白名单文件。