GuJumpgate v0.1.9

发布日期：2026-06-04

重要！必看

• 目前长链接链路基本不可用，当前请优先使用短链接。
• 云端转换请暂时不要开启。
• 短链接当前风控非常严格；如果环境本身没问题，但短链接提交后直接报错，大概率是 IP 被风控。
• 当前更建议全局使用日本住宅代理，或通过 Zero Omega 这类浏览器代理插件单独为相关站点配置日本住宅线路。
• 需要特别注意：网站上的 IP 纯净度检测结果，不代表该 IP 一定可以通过短链接支付链路。

本次 v0.1.9 主要是把 PayPal Plus Checkout 近期分散推进的改动正式收口，并同步吸收 GitHub 上两个待合入 PR 的修复内容。

已吸收的 PR 修复

• 版本号升级到 0.1.9，发布版本为 GuJumpgate V0.1.9。
• 已吸收 PR #141 fix(payment): 修复日区pp条件下的支付跳转及变量未定义报错：
• 修复日区 PP 条件下，步骤 6 因 hosted checkout 页面过早加载导致的支付跳转异常。
• 修复 normalizePlusPaymentMethodForRun 未定义引发的报错与流程卡死问题。
• 一并补上 checkout 提交按钮 / 地址下拉的多语言识别、原生 chatgpt.com/checkout/* 页面支持，以及账单姓名自动填充与地址字段等待逻辑。
• 补齐“短链报错自动重开”能力：步骤 6 短链 Checkout 出现红色错误框、genericError 或异常回跳时，可直接放弃当前链路并自动重建 Checkout。
• 已吸收 PR #128 修复步骤2/步骤7流程问题，并增强 PayPal JSON 验证码兼容：
• 修复步骤 2 偶发点击 sign up for free 后无动作、导致流程中断的问题。
• 修复步骤 7 检测到已登录账号后，直接点击登录但动作未生效的问题。
• 增强 PayPal 接码流程对 JSON 类型返回值的兼容，同时保留原有字符串结果解析能力。
• 同步吸收 Issue #61 与 Issue #127 的邮箱 provider 扩展需求：
• 新增 MoeMail provider 支持。
• 新增 YYDS Mail provider 支持。

主要更新

• 邮箱 provider 扩展：
• 新增 MoeMail 支持，对应 Issue #61。
• 新增 YYDS Mail 支持，对应 Issue #127。
• 两个 provider 都已接入注册邮箱生成、验证码轮询和主流程读取链路。
• Hotmail Helper 打包体验补齐：
• Windows 发布包现在内置轻量 Python 运行时。
• start-hotmail-helper.bat 会优先使用包内 python\python.exe 启动 scripts\hotmail_helper.py。
• 大多数情况下不再需要用户额外手动安装 Python，即可直接启动本地 Hotmail Helper。
• Hosted Checkout 日区链路补齐：
• 支持按日区模式请求日本地址资料。
• 自动规范日本都道府县、邮编、生日、信用卡有效期和注册密码格式。
• OpenAI Hosted Checkout 表单补齐日区地址字段、国家下拉和都道府县映射。
• PayPal Guest Checkout 自动化增强：
• 日区页面会优先切换 English，再继续填写资料。
• 在需要时自动把 nationality 切换为 United States，降低日文姓名 / 国籍校验带来的拦截概率。
• 对 Guest Checkout 的手机号不可用、卡片不可用、验证码失败等场景补充了自动恢复与重试逻辑。
• 新增“拒卡重试”能力：检测到 We weren't able to add this card / 无法添加此卡 一类拒卡提示后，会自动更换资料并重填，连续多次失败后再停止当前流程。
• Hosted Checkout 资料与验证码处理增强：
• 支持从更多嵌套响应结构中提取验证码，包括 SmsCode 字段。
• 会过滤占位示例码、接口说明和“暂无验证码”类文本，避免把假码当成真实验证码。
• 外部返回密码和随机密码会先归一化，避免超长或不合规密码直接提交失败。
• 手机验证码链路增强：
• requestAdditionalSms 支持返回新的 activation，并在后台立即刷新运行态，减少补码后沿用旧 activation 的错位问题。
• SMSPool 在请求补发短信前会先记录历史验证码，把旧码加入忽略列表，避免重复消费历史短信。
• WhatsApp 识别逻辑收敛：
• 区分“纯 WhatsApp 页面”和“短信 / WhatsApp 选择器文案”。
• 对 Send code via WhatsApp SMS、通过以下方式发送验证码 短信 WhatsApp 这类混合文案不再误判为必须重开 OAuth 的 WhatsApp 页面。
• Hotmail 管理器增强：
• 新增从后台主动回读最新状态的同步逻辑。
• 导入、保存、切换、校验、测试、删除后会立即刷新侧边栏数据，减少前后端状态不同步。

修复内容

• 修复 Hosted Checkout 切到日区后仍继续读取旧的美区验证码接口、手机号或短信池的问题。
• 修复 Hosted Checkout 手动取码时把示例验证码 012345、说明文本或无效响应误识别为真实验证码的问题。
• 修复短链 Checkout 命中红色错误框、异常回跳或 PayPal genericError 后，无法及时放弃当前链路并自动重开的问题。
• 修复 hosted checkout / PayPal Guest Checkout 遇到拒卡提示时，不能自动换资料重试的问题。
• 修复 Windows 发布包未携带可用 Python 运行时时，start-hotmail-helper.bat 仍依赖系统 Python 才能启动的问题。
• 修复 SMSPool 补码时历史短信未被忽略、重复拿到旧验证码的问题。
• 修复手机号页仅展示短信 / WhatsApp 选项时，被误判为 WhatsApp 验证链路并触发重启的问题。
• 修复 Hotmail 设置保存时，空 payload 可能覆盖已有账号列表的问题。
• 修复 Hotmail 账号导入、验证、测试、切换、删除后，侧边栏展示与后台状态不同步的问题。

测试覆盖

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