bettergi-scripts-list/repo/js/KeepAwakeCountdown/README.md
Zongye Lyu efac5c510b
feat(js): 新增 防休眠倒计时 脚本 (#3315)
* feat(js): 新增 防休眠倒计时 脚本

* update

* fix: 修复等到指定时间的关键问题并完善校验 (v1.3)

- 修复目标时刻当天已过时误等约24小时(新增 allow_next_day 开关,默认否)
- 严格校验 HH:mm 格式,非法输入直接报错退出
- 等到明天改用 setDate(+1) 避免夏令时偏差
- 补充时间逻辑单元测试
2026-06-19 17:33:34 +08:00

4.3 KiB
Raw Permalink Blame History

防休眠倒计时

在游戏主界面等待 / 倒计时,并在等待期间防止电脑自动休眠、熄屏。到点后脚本自动结束,由调度器接着执行下一个任务。

适合的场景:晚上挂着,等到版本更新 / 整点 / 凌晨重置之后再自动开始日常,又不希望电脑在漫长等待中睡过去。

与仓库已有的「等待到指定时间」脚本的区别:本脚本在等待期间会周期性轻晃镜头保持系统唤醒,并且支持「相对倒计时」模式与可被「停止」及时打断。


一、功能说明

  • 两种等待模式(二选一):
    1. 等到指定时钟时间(优先):填 HH:mm(如 04:00),等到当天该时刻。若该时刻今天已过/已到:默认立即结束并继续后续任务(避免脚本启动稍晚就误等约 24 小时);如需等到次日,请把「目标已过时是否等到明天」设为「是」。
    2. 相对倒计时:填分钟 + 秒(上面留空时生效)。
  • 零漂移:始终以「目标时间戳 − 当前时间」判断,跨小时、跨天都精准,不累积误差。
  • 防休眠:每隔设定秒数(默认 60)在主界面轻晃一次镜头——只动视角、不动角色、不开菜单,用于刷新系统空闲计时器,防止自动休眠 / 熄屏。
  • 可随时停止:每秒一跳,按下「停止」可及时中断。
  • 结束时打印日志,并可选发送一条通知。
  • 可选领取月卡:结束后可自动领取「空月祝福(月卡)」奖励——每日重置后购买月卡的账号会弹出领取窗口,若不处理会卡住下一个任务。调用 BGI 官方 genshin.blessingOfTheWelkinMoon(),未购买月卡时安全跳过。

二、使用方法

  1. 把脚本加入调度器配置组,并排在你要执行的下一个任务之前。
  2. 右键脚本 → 修改自定义配置:
    • 想"等到某个时间":在**「等到指定时钟时间」**填 04:00 这类值即可。
    • 想"等一段时长":上面留空,填下面的分钟 / 秒。
  3. 运行配置组。脚本会原地等待并防止休眠,到点后自动结束,调度器随即执行下一个任务。

前置条件

  • 运行前请停在游戏主界面(大世界),角色原地不动。
  • 游戏窗口需处于激活状态,防休眠的晃镜头才有效。

三、注意事项

  • 时间基准为本机系统时间。国服每日 4:00 重置,请确保电脑为北京时间;其它服按电脑时间换算。
  • 防的是「系统睡眠 / 熄屏」,不是 Windows 锁屏。若电源策略很激进(笔记本合盖、低电量强制睡眠、设置了自动锁定),模拟输入可能拦不住——这种情况请到 电源选项 把「睡眠」设为「从不」以彻底保险。
  • 防休眠间隔应小于系统休眠时间(例如系统 10 分钟休眠,间隔就要 < 600 秒)。默认 60 秒可兜底绝大多数设置。
  • 本脚本负责「卡到点」「保持唤醒」与「可选领取月卡」,不处理登录 / 进游戏 / 过公告。请确保等待期间游戏始终在主界面。
  • 领取月卡为可选项(默认关闭):仅在已购买月卡、且等待终点为每日重置之后时才需开启。它在倒计时结束后执行,完成并返回主界面后才结束脚本。

更新日志

1.3

  • 严格校验「等到指定时间」格式(正则 HH:mm),非法输入如 04:00:30 直接报错退出,不再被静默误解。
  • 「等到明天」改用 setDate(+1) 按日历加一天,避免夏令时(DST)切换日的偏差。
  • 补充对应单元测试(非法格式、单数字时分)。

1.2

  • 修复:「等到指定时间」时,若脚本在目标时刻当天已过/已到才启动,会被错误地推迟到次日(约 24 小时)。现默认立即结束并继续后续任务,新增「目标已过时是否等到明天」开关(默认否)。
  • 新增时间逻辑单元测试,覆盖「启动时刻 = / 晚于目标」等边界。

1.1

  • 新增可选项「结束后领取空月祝福(月卡)」,解决每日重置后月卡领取弹窗卡住下一个任务的问题。

1.0

  • 首次发布:支持"等到指定时间 / 相对倒计时"两种模式、零漂移计时、周期性防休眠、可随时停止、结束通知。