NexusPHP PT 自动晋级助手
NexusPHP PT 自动晋级助手
版本：1.5.13
面向 NexusPHP 架构 PT 站点的用户脚本。它会读取当前账号数据与站点等级规则，计算下一等级的缺口、分享率风险、预计兑换次数与魔力值消耗，并提供手动、晋级计划和可选自动兑换功能。
已针对 GameGamePT（gamegamept.com，下称 GGPT）完成主要适配与验证。其他 NexusPHP 站点的页面结构、等级规则和兑换档位可能不同，使用前应先核对面板解析结果。
重要提示
- 兑换会真实消耗魔力值，并改变账号上传量或下载量；开启自动兑换前请先阅读并理解站点规则。
- 脚本只辅助计算和提交站点已有的兑换操作，不能绕过站点的冷却、权限、魔力值或等级限制，也不保证兑换后立即升级。
- 自动兑换默认关闭。建议先使用“刷新”和预计消耗信息核对数据，再进行手动或晋级兑换。
- 不同站点的规则与页面可能随时调整。发现等级、档位或余额显示异常时，请停止兑换并先刷新/核对站点页面。
功能一览
| 功能 | 说明 |
|---|---|
| 账号状态识别 | 读取等级、上传、下载、分享率、魔力值和注册时间；数据缺失时会尝试从自己的详情页补齐。 |
| 中英文等级显示 | 对可识别等级显示为“中文(English)”形式，例如 修仙(Ultimate User)。 |
| 等级规则与晋级计算 | 解析 FAQ 规则；对 GGPT 使用内置的权威等级数据。计算注册时间、下载量、上传量、分享率与做种积分等条件。 |
| 注册时间倒计时 | 显示注册时长尚差多久及预计达标日期；无法可靠读取注册日期时明确显示“注册时间未知”。 |
| 分享率保护 | 计算下载量兑换后的分享率影响；晋级计划始终先补上传量、后补下载量，避免先兑换下载量拉低分享率。 |
| 魔力值预算 | 用站点实际的 100 GB 档位计算所需轮数、实际兑换量和预计魔力值总消耗，并显示当前魔力值缺口。 |
| 手动按量兑换 | 输入总目标量和兑换类型，脚本按 100 GB 一轮循环；非 100 的倍数会向上取整。 |
| 自动兑换 | 可选择“晋级驱动”“定时定额”“按量完成”三种模式；默认关闭，按量模式只允许选择 100 GB 档位。 |
| 冷却与结果核验 | 循环兑换会等待站点冷却。GGPT 每次提交后会重新读取余额确认实际扣除，不能仅凭页面提示或 HTTP 成功状态判断成功。 |
| 浮动面板与菜单 | 提供刷新、晋级兑换、FAQ、设置和手动兑换入口；也提供用户脚本菜单命令。 |
安装
- 安装并启用用户脚本管理器，例如 ScriptCat 或 Tampermonkey。
- 导入 nexusphp-auto-promote.user.js，保存并确保脚本已启用。
- 登录目标 PT 站点，打开任意站内页面并刷新。
- 页面右侧会出现“NP 晋级助手”面板；若未出现，可从脚本管理器菜单选择“显示/隐藏面板”。
脚本的匹配范围较宽，但启动时还会检测 NexusPHP 页面特征；GitHub 已被明确排除，不应在 GitHub 页面弹出面板。
基本使用
1. 先刷新并核对账号数据
打开面板后点击“刷新”。重点核对以下内容是否与站点页面一致：
- 当前等级（应以
中文(English)显示）； - 上传、下载和分享率；
- 当前魔力值；
- 注册时间；
- 下一等级、未满足条件和兑换计划。
若等级、注册时间或流量数据缺失，先访问自己的用户详情页或首页后再刷新。若仍无法识别，不要直接兑换。
2. 查看晋级计划与预计魔力值
当下一等级存在流量缺口时，面板会给出预计信息，包括：
- 应补的上传量和下载量；
- 按 100 GB 档位取整后的实际兑换量与轮数；
- 每类兑换成本及预计总魔力值；
- 当前魔力值不足的差额。
例如目标为 250 GB，脚本会安排 3 次 100 GB 兑换，实际兑换 300 GB。预计成本以当次读取到的站点档位为准，不应把旧截图或旧余额当作当前报价。
3. 使用“晋级兑换”
点击“晋级兑换”后，脚本会重新读取账号状态和兑换档位，再按当前下一等级的流量缺口执行：
- 先循环兑换上传量；
- 每轮等待站点要求的冷却并核验余额扣除；
- 上传完成后，再循环兑换下载量。
做种积分未达标时，脚本不会以兑换流量的方式绕过该条件。注册时间尚未达标但仅存在流量缺口时，脚本会列出剩余注册时间、计划、预估成本和余额差额，并要求你在浏览器确认后才继续；这只是提前准备流量，不代表会立即晋级。取消确认不会提交兑换。
4. 使用“手动兑换”
在面板底部的“手动兑换”区域：
- 在“总量（GB）”填写总目标量，例如
100或250； - 选择“上传量”或“下载量”；
- 点击“立即兑换”，在确认提示中核对轮数、实际兑换量和预计成本；
- 确认后，脚本会使用 100 GB 档位循环到完成或安全停止。
手动兑换不依赖晋级评估，但仍会遵守站点冷却、余额核验和最低魔力值保留设置。
魔力值兑换规则
100 GB 档位
本版本的手动兑换、晋级兑换和按量自动兑换均固定使用站点的精确 100 GB 档位。这是为避免小档位价格不划算，也使估算和实际提交采用同一取整规则。
若站点无法读取 100 GB 上传量或下载量档位，脚本会停止并提示原因，不会退回使用小档位代替。
GGPT 冷却与核验
GGPT 的站点提示为 10 秒内只能点击一次交换。脚本会记录并等待该冷却；若站点仍返回冷却拒绝，会有限次数重试。
GGPT 的兑换 POST 页面可能显示提交前的旧余额。因此脚本在每次提交后会对 mybonus.php 发起新的只读读取，确认魔力值确实下降后才计为成功。余额未变化、无法核验或重复失败时，脚本会停止，未成功轮次不会计入进度。
自动兑换设置
在面板中点击“设置”，开启“自动兑换总开关”后选择模式。自动兑换默认关闭。
| 模式 | 用途 | 注意事项 |
|---|---|---|
| 晋级驱动 | 根据下一等级的流量缺口执行计划。 | 注册时间未达标且需要人工确认的计划会被自动模式跳过，不会自动弹窗或绕过确认。 |
| 定时定额 | 按设定间隔和类型执行固定量兑换。 | 独立于晋级计划，开启前请自行确认对分享率和账号的影响。 |
| 按量完成 | 以选择的 100 GB 档位循环，直到完成目标总量。 | 会记录已完成量与剩余量；目标非 100 的倍数会按实际轮次向上取整。 |
建议同时设置：
- 兑换间隔；
- 手动/自动冷却时间（若站点无法自动识别时使用）；
- 单次兑换上限；
- 兑换后最低保留魔力值。
自动模式不应被理解为无人值守的账户托管：页面是否持续打开、站点规则是否变更、余额是否足够、登录状态是否失效，都可能使任务暂停或停止。
GGPT 等级数据来源
GGPT 的已知等级顺序和晋级条件参考 PT-depiler 的站点数据。该来源用于提高规则一致性，不表示本脚本与该项目存在隶属或官方关系。
以 Ultimate User 为例，等级条件中的下载量与分享率不是彼此独立：在下载量达到 5 TiB 且分享率需不低于 5 时，上传量还必须同时满足 上传量 ÷ 下载量 ≥ 5。脚本会按目标下载量重新计算所需上传量，而不是只补固定上传缺口。
常见问题
面板没有出现或错误地出现在非 PT 页面
脚本仅会在通过 NexusPHP 特征检测的页面启动；GitHub 已在脚本元数据中排除。请确认脚本已更新保存、管理器中的旧版本已停用，并刷新目标页面。
一直显示“无法识别当前等级”或“注册时间未知”
先打开自己的用户详情页和首页，再点“刷新”。站点可能把这些字段放在不同页面，或采用脚本尚未覆盖的标记方式。未能可靠识别时不要据此执行晋级兑换。
显示预计成本，但点击后没有完成全部兑换
预计值基于开始前读取的档位与余额。运行过程中如遇到站点冷却、余额不足、最低保留魔力值限制、登录失效、档位变化或余额未能核验，脚本会停止或只完成已确认的部分。请以面板刷新后的实际数据为准。
为什么输入 250 GB 后实际会兑换 300 GB？
脚本只使用 100 GB 档位，计算公式为 ceil(目标 GB / 100) × 100 GB。确认弹窗会在提交前提示轮数和实际兑换量。
脚本能保证不会被封号吗？
不能。脚本只能采用保守的兑换顺序、冷却等待和余额核验；账号行为是否符合站规仍由使用者负责。请遵守站点规则，避免在不了解影响的情况下开启自动模式。
数据与权限说明
脚本会在登录状态下读取站内页面数据，并向站点自身的兑换页面提交已确认的兑换请求。设置、缓存的规则和最近兑换时间通过用户脚本管理器的存储能力保存在本地。安装任何用户脚本前，仍建议自行审阅完整源代码和管理器所显示的权限。
开发与反馈
脚本为单文件用户脚本，无构建步骤。可使用以下命令检查语法：
node --check .\nexusphp-auto-promote.user.js
许可证：MIT（以脚本文件头声明为准）。