云之家自动打卡脚本 · 简要操作说明
（2026-11-05 版｜HONOR 20 / HarmonyOS 4.0 实测）

【一】它做什么
只占 1 个免费定时任务。每天拉起后驻留到 23:30 自动退出，期间
每 5 分钟自检一轮：

1. 上班：窗口未到就启动 → 立即打一次，之后每 30 分钟一轮直到
   打上；窗口内 → 随机等几分钟再打；过窗没打上 → 每 30 分钟
   补打（上班按最早记录计，反复打无副作用）。
2. 下班：窗口内随机时间打，成功后 1 小时+随机几分钟自动再打
   一次；窗口未到则等窗口开始，不提前打。
3. 没打上 → 立即补打，失败才告警。周末节假日自动跳过。

【二】通知原则
【成功一律不出声，失败才提醒】

• 成功：不发通知，只在常驻通知正文记"✅上班 09:18"。
• 失败/漏打/异常：才弹"⚠️ 打卡助手"告警（提示音+振动+锁屏），
  每班次每天最多 1 条，之后静默重试。日常全程无弹窗。

【三】首次部署（5 步）

1. 定时任务只建 1 个，每天 07:50 触发（早于上班窗口即可）。
2. 手机设置→应用→Hamibot：电池不限制、自启动允许、无障碍开启、
   通知权限允许（"打卡调度""打卡失败告警"两渠道都打开）。
3. 手动运行一次，确认出现常驻通知、qmsg 能收到即成。

【四】通知栏怎么看
下一动作：下班打卡 17:45 ← 标题：下一步做什么、几点
剩余1小时37分 · ✅上班 09:18 ← 正文：剩余时间每分钟刷新
[立即打卡] [关闭所有脚本] ← 两个按钮
剩余时间在变小 = 脚本活着；两班打完显示"今日完成"。

【五】「立即打卡」自测（云之家升级后必用）
怀疑打不上卡（App 改版、换机、权限被收）时：下拉通知栏点
「立即打卡」，脚本立刻解锁屏幕、打开云之家走完整流程（最多
重试 3 次），结果回通知栏：
✅ 测试打卡成功（上班 15:36）· 打卡功能正常
❌ 测试打卡失败：<原因> · 检查云之家版本/无障碍/定位
注意：测试不写当天标记、不影响自动流程；但记录与正常打卡一样，
避开下班窗口临近结束时测。

【六】保活（决定成败）
电池优化不限制 + 自启动允许（应用启动管理→手动管理，三项全开）；
无障碍常开，勿清理 Hamibot 后台；系统若提示"后台弹出界面/
锁屏显示"，选允许。

【七】常见问题
Q 没有倒计时数字？荣耀/HarmonyOS 不支持系统通知倒计时，
剩余时间已写在正文（每分钟刷新），正常。
Q 收不到告警？检查 Hamibot 通知权限和"打卡失败告警"渠道。
Q 屏幕有日志浮窗？确认 debug=关闭；仍有则是 Hamibot App 的
"显示运行日志"开关，去 App 设置关掉。
Q 手动停止报错吗？不会，属正常退出；真故障才推异常告警。
Q 清空当天标记重测？执行 storages.create("YzjClock").clear()。
Q 换手机？重调源码屏幕坐标（1080×2340）和按钮位置，上滑
时长自动重新探测。

【八】日常只需做一件事
每天瞄一眼常驻通知：正文有"✅上班""✅下班"两笔、剩余时间在
变小即正常；出现"⚠️"告警再处理。
（完）