友空间 Hamibot 定时打卡脚本说明
注意！！！：该脚本通过 Android/HarmonyOS 无障碍服务模拟正常的页面点击操作，不修改定位，也不绕过密码、验证码、人脸、指纹或友空间的考勤验证。
1.使用方式
用户通过在Hamibot控制台运行该脚本可实现移动设备的远程自动打卡。如果需要设置自动定时打卡，可通过Hamibot的定时启动脚本功能，设置时间实现某一时刻的自动打卡。
后续会尝试增加定时打卡功能。
3. 使用前提
1.使用脚本前应满足以下条件：
- 友空间已安装并完成登录；
- 手机系统定位已经开启；
- 友空间拥有定位权限；
- 当前地点处于企业允许的考勤范围；
- Hamibot 已安装并登录；
- Hamibot 无障碍服务保持开启；
- “友空间”图标直接位于当前桌面页，不要放入文件夹；
- 定时执行期间网络连接正常；
- 锁屏未设置数字密码、图案密码或其他必须人工完成的安全验证。
-
后台运行权限
- 在系统“应用启动管理”中将 Hamibot 设置为手动管理；
- 允许自启动；
- 允许关联启动；
- 允许后台活动。
-
后台弹出界面权限
- 允许 Hamibot 在定时任务触发时启动或切换应用。
-
电池优化豁免
- 将 Hamibot 设置为“不允许优化”或“无限制”；
- 建议在最近任务列表中锁定 Hamibot，避免被系统清理。
-
悬浮窗权限（建议）
- 便于观察 Hamibot 的运行状态和停止脚本；
- 不影响核心点击流程，但建议开启。
4. 主要功能
脚本被 Hamibot 启动后会自动完成以下操作：
- 判断屏幕是否熄灭；
- 熄屏时点亮屏幕，并尝试上滑无密码锁屏；
- 使用包名
com.yongyou.youpu启动友空间； - 如果包名冷启动被鸿蒙拦截，则返回桌面并点击“友空间”图标；
- 进入“工作台”；
- 优先点击“一键签到”，找不到时点击“网络考勤”；
- 点击“内勤打卡”；
- 打卡后逐层返回，直到检测到“工作台”；
- 返回手机桌面并结束脚本。
5. 安装和首次测试
- 将
youspace_hamibot_scheduled.js导入 Hamibot； - 开启 Hamibot 无障碍和相关后台权限；
- 确认友空间已经登录且定位正常；
- 将友空间图标放在当前桌面页；
- 从最近任务中划掉友空间，模拟应用完全退出；
- 保持手机解锁，直接在 Hamibot 中运行一次脚本；
- 确认脚本能够从桌面冷启动友空间并完成打卡流程；
- 再在无密码熄屏状态下运行一次；
- 两次测试都通过后，再建立正式定时任务。
测试时请观察友空间最终显示的打卡记录，不能只根据 Hamibot 的 Toast 提示判断成功。
6. 启动机制
脚本提供两级启动方案：
- 首先调用包名
com.yongyou.youpu冷启动友空间； - 等待 8 秒仍未启动时，返回桌面并点击“友空间”图标；
- 点击图标后最长等待 25 秒；
- 如果仍未进入友空间，则输出冷启动超时错误。
桌面图标兜底依赖以下条件：
- 图标名称显示为“友空间”；
- 图标位于当前桌面页；
- 图标没有放在文件夹内；
- 桌面没有被弹窗或锁屏界面覆盖。
7.锁屏限制
脚本可以处理：
- 手机熄屏；
- 点亮后只需上滑即可进入桌面的无密码锁屏。
脚本不能处理或绕过：
- 数字密码；
- 图案密码；
- 必须完成的指纹验证；
- 必须完成的人脸验证；
- 企业安全策略要求的二次认证。
如果设备设置了安全锁屏，请在打卡时间前保持手机处于已解锁状态，或者改用允许系统
在锁屏状态运行的企业官方能力。
8. 运行日志说明
正常情况下会依次出现：
步骤1：开始上班/下班打卡正在通过包名启动友空间：com.yongyou.youpu- 必要时显示：
包名启动被系统拦截，尝试点击桌面图标 步骤2：点击工作台步骤3：点击一键签到或网络考勤步骤4：点击内勤打卡步骤5：退出打卡页面
常见错误：
-
找不到页面控件：工作台- 友空间仍在加载、页面结构变化、无障碍未开启或存在弹窗。
-
找不到页面控件：一键签到 / 网络考勤- 工作台尚未加载完成，入口名称发生变化，或企业没有开放对应应用。
-
找不到页面控件：内勤打卡- 尚未进入签到页面、定位页面加载失败或按钮文字发生变化。
-
友空间冷启动超时，请将友空间图标放在当前桌面页- 包名启动被系统拦截，并且脚本在当前桌面页没有找到或无法点击友空间图标。
9. 注意事项
- 脚本应仅用于本人账号和本人有权使用的设备；
- 不要向他人提供友空间账号、密码或 Hamibot 密钥；
- 不要使用脚本伪造定位、绕过人脸、验证码或企业考勤规则；
- 友空间或鸿蒙系统升级后，按钮文字和页面结构可能变化，需要重新调整脚本；
- Hamibot 被清理、无障碍关闭、设备重启或网络断开时，定时任务可能无法执行；
- 建议定期检查友空间中的实际考勤记录。
10. 当前版本未自动处理的情况
- 法定节假日与调休；
- 登录过期；
- 应用更新提示；
- 隐私协议或权限弹窗；
- 数字密码、图案、指纹和人脸锁屏；
- 定位失败或不在考勤范围；
- 友空间按钮名称、页面结构发生变化；
- Hamibot 或无障碍服务被鸿蒙系统终止。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
脚本隐私说明
本脚本在运行过程中不获取、不处理、不上传您的任何个人信息（包括但不限于设备信息、IP地址、账号信息等）。
