NTECloud-AutoCheckin

Warning

本项目仍处于 WIP（Work in Progress）阶段，接口行为、配置字段与判断逻辑都可能继续调整。

云·异环（Neverness to Everness）官方云游戏平台自动签到脚本。

当前第一版使用已抓包得到的 user_id、token 和设备参数请求云游戏平台接口，查询每日首次登录 15 分钟奖励是否到账。脚本不会启动云游戏，不会调用 /cloud/game/start。

免责声明

使用本项目即表示你理解并同意：

• 本项目仅供学习、研究与个人自动化使用，请勿用于商业用途或公开宣传。
• 请自行确认使用脚本是否符合云·异环、Hotta Studio、完美世界及相关服务条款。
• 因使用本项目导致的账号异常、登录态失效、时长异常、封禁或其他后果，均由使用者自行承担。
• 本项目不会绕过官方时长规则；每日奖励、刷新时间与 720 分钟上限均以官方实际返回为准。
• 请妥善保管 token、user_id、device_id 等敏感信息，不要提交到公开仓库。

功能

• 支持多账号
• 支持 config.yml 本地配置
• 支持 NTECLOUD_CONFIG 环境变量配置
• 支持随机延迟
• 支持 ServerChan、DingTalk、Telegram、PushPlus 通知
• 支持 GitHub Actions 定时运行
• 使用已确认的 Laohu 云游戏 sign 算法

本地运行

复制示例配置：

cp config.example.yml config.yml

安装依赖：

pip install -r requirements.txt

运行：

python main.py

调试运行可关闭随机延迟并输出详细日志：

NTECLOUD_DEBUG=1 NTECLOUD_LOGLEVEL=DEBUG python main.py

PowerShell：

$env:NTECLOUD_DEBUG = "1"
$env:NTECLOUD_LOGLEVEL = "DEBUG"
python main.py

配置

最小账号配置需要填写：

accounts:
  - name: "account-1"
    user_id: ""
    token: ""
    device_id: ""

推荐按抓包完整填写：

accounts:
  - name: "account-1"
    user_id: ""
    token: ""
    device_id: ""
    device_name: "Pixel 10 Pro"
    device_model: "GEHN3"
    device_type: "GEHN3"
    device_sys: "16"
    version: "1.1.0"
    sdk_version: "1.34.0"
    bid: "com.pwrd.cloud.yh.laohu"
    channel_id: "1"
    app_id: "10597"
    network: "wifi"
    provider: "0"
    idfa: ""

laohu_app_key 默认使用当前版本已确认值：

f1b7f11fc3774f898e387368cce4da04

如果 App 后续更新导致签名失效，可在配置中覆盖。

GitHub Actions

Important

请不要通过 Fork 本仓库来运行 GitHub Actions。请使用 GitHub 的 Use this template 功能在自己的账号下创建新仓库后再配置运行，避免 Fork 的 Actions 用量、调度和风险累积到本仓库关联网络。

Fork 仓库将无法运行本项目的 GitHub Actions，请使用模板创建自己的仓库。

公开仓库运行时不建议开启 DEBUG 日志；调试日志可能包含更详细的请求与运行信息。

1. 使用 Use this template 创建自己的仓库。
2. 在新仓库 Secrets 中添加 NTECLOUD_CONFIG。
3. 内容填写完整 YAML 配置。
4. 将：

.github/workflows/AutoCheckin.yml.disabled

改名为：

.github/workflows/AutoCheckin.yml

如果你担心 GitHub 因仓库长期无活动而停用定时任务，可以将：

.github/workflows/KeepAlive.yml.disabled

改名为：

.github/workflows/KeepAlive.yml

该 workflow 会每月更新一次 .github/keepalive.txt 并提交，用于保持仓库活动。它不是必须启用；如果你不希望仓库产生自动 keepalive commit，请保持禁用。

奖励判断逻辑

脚本通过：

GET /cloud/game/query/duration/earnBilling?durationType=0&pageNo=1

检查当前奖励周期内的收益流水中是否存在：

每日首次登陆奖励

云·异环每日免费时长刷新时间为 05:00 UTC+8，因此脚本只会认可当天 05:00 之后产生的每日奖励记录。

首次登录云游戏平台的账号可能同时出现：

• 每日首次登陆奖励：15 分钟
• 首次登陆游戏奖励：600 分钟

免费时长累计上限为 720 分钟。如果领取每日奖励后会超过上限，实际到账可能少于 15 分钟，甚至在已达上限时不会继续增加。脚本以当前奖励周期内的流水记录作为领取依据，不依赖 remainedDuration 必须增加 15 分钟。

当前不支持

• 自动短信登录
• 自动刷新 token
• 启动云游戏
• 自动提取 appKey
• iOS 参数适配

致谢

感谢 GamerNoTitle/MHYY 项目提供的云游戏自动签到脚本结构、配置方式与 GitHub Actions 使用方式参考。

License

本项目基于 GNU Affero General Public License v3.0 开源。