# GuJumpgate v0.1.7

发布日期：2026-05-29

本次版本聚焦三件事：把 PayPal Plus Checkout 从单一美区链路扩展成美区 / 日区双模式；补齐 Hosted Checkout 在资料生成、验证码读取和 PayPal 客页填充上的稳定性；同时修正 SMSPool 补码、WhatsApp 识别和 Hotmail 账号管理里的几个高频误判与状态同步问题。

## 本次更新

- 版本号升级到 `0.1.7`，发布版本为 `GuJumpgate V0.1.7`。
- Plus Checkout 新增双模式：
  - `美区PP Plus Checkout`
  - `日区PP Plus Checkout`
- 侧边栏新增 Plus Checkout 模式切换入口；美区 / 日区各自维护独立的 Hosted Checkout 配置与短信池状态，避免切模式后把验证码接口、号码池和使用记录串用。
- Hosted Checkout 日区链路补齐：
  - 支持按日区模式请求日本地址资料。
  - 自动规范日本都道府县、邮编、生日、信用卡有效期和注册密码格式。
  - OpenAI Hosted Checkout 表单同步适配日区地址字段与州/都道府县映射。
- Hosted Checkout 资料生成与验证码解析增强：
  - Hosted Checkout 随机密码生成与外部返回密码会先做合法性归一，避免超长或不合规密码直接提交失败。
- 手机验证码链路增强：
  - `requestAdditionalSms` 支持返回新的 activation，并在后台立即刷新当前运行态，减少补码后仍沿用旧 activation 导致的错位。
  - SMSPool 在请求补发短信前会先记录历史验证码，把旧码加入忽略列表，避免补码后重复消费历史短信。
- WhatsApp 识别逻辑收敛：
  - 添加手机号页和验证码页会区分“纯 WhatsApp 流程”和“短信 / WhatsApp 选择器文案”。
  - 对 `Send code via WhatsApp SMS`、`通过以下方式发送验证码 短信 WhatsApp` 这类混合文案不再误判成必须重开 OAuth 的 WhatsApp 页面。
- Hotmail 管理器增强：
  - 新增从后台主动回读最新状态的同步逻辑。
  - 导入、保存、切换、校验、测试、删除后会立即刷新侧边栏数据，减少前端列表和后台真实状态不一致的问题。

## 修复内容

- 修复 Plus Checkout 配置只能按单一模式保存的问题，自动运行恢复时现在会保留 `plusCheckoutMode` 和对应 profile。
- 修复 Hosted Checkout 切换到日区后仍可能继续读取旧的美区验证码接口、手机号或短信池的问题。
- 修复 Hosted Checkout 手动取码时把示例验证码 `012345`、说明文本或无效响应误识别为真实验证码的问题。
- 修复 SMSPool 补码时历史短信未被忽略、重复拿到旧验证码的问题。
- 修复手机号页正文只是在展示短信 / WhatsApp 选项时，就被误判为 WhatsApp 验证链路并触发重启的问题。
- 修复 Hotmail 设置保存时，空 payload 可能覆盖已有账号列表的问题。
- 修复 Hotmail 账号执行导入、验证、测试、切换、删除后，侧边栏展示与后台状态不同步的问题。

## 测试覆盖

- 新增 / 更新 Hosted Checkout 测试，覆盖：
  - 示例验证码过滤
  - `SmsCode` 字段提取
  - Plus Checkout 双模式 profile 解析
  - 日区地址拉取与资料归一
- 新增 / 更新手机号验证测试，覆盖：
  - 中文 / 英文短信 + WhatsApp 混合选择器文案识别
  - WhatsApp 自动重启只在真正命中 WhatsApp 页面时触发
- 新增 SMSPool 测试，覆盖：
  - activation 归一化时保留 resend 元数据
  - 补发短信前自动记录并忽略历史验证码

## 升级注意

- 如果你此前已经配置过 Hosted Checkout 验证码接口或号码池，升级后建议分别检查美区 / 日区模式下的配置是否符合预期。
- 日区 PP Plus Checkout 会使用独立的地址资料与表单映射；如外部地址源返回字段异常，系统会自动回退到内置默认值，但仍建议优先检查你的资料接口。
- 如果步骤 9 开启了 WhatsApp 页面自动重启，现在只有真正命中 WhatsApp 验证页才会触发；短信 / WhatsApp 选择器页会继续走正常短信链路。