Skip to content

Release.md

Latest commit

 

History

History
91 lines (77 loc) · 7.02 KB

Release.md

File metadata and controls

91 lines (77 loc) · 7.02 KB

GuJumpgate v0.1.9

发布日期：2026-06-04

重要！必看

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

本次 v0.1.9 主要是把 PayPal Plus Checkout 近期分散推进的改动正式收口，并同步吸收 GitHub 上两个待合入 PR 的修复内容。也就是说，虽然这两个 PR 截至 2026-06-04 在仓库页面仍显示为 Open，但对应修复已经在当前版本说明里补齐并体现在本地代码中。

已吸收的 PR、issu 修复

  • 版本号升级到 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 都已接入注册邮箱生成、验证码轮询和主流程读取链路。
  • 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 管理器增强：
    • 新增从后台主动回读最新状态的同步逻辑。
    • 导入、保存、切换、校验、测试、删除后会立即刷新侧边栏数据，减少前后端状态不同步。

修复内容

  • 修复 Plus Checkout 配置只能按单一模式保存的问题，自动运行恢复时现在会保留 plusCheckoutMode 和对应 profile。
  • 修复 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 元数据
    • 补发短信前自动记录并忽略历史验证码

升级提醒

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