使用说明

Android （自动任务）端配置步骤

ADB级别后台保活，常驻后台运行，但需要Shizuku（重启后需要重新打开，如果不想多次启动可以看下面方案）

1. 安装必要软件

• 自动任务 (AutoTask)
• Shizuku
• 任意文件管理器

2. 部署脚本文件

1. 下载 tracker.sh
2. sh文件放置到设备目录：/storage/emulated/0/TimeTracker/
3. 编辑脚本文件，修改以下常量配置：
   • URL - API地址
   • SECRET - 认证密钥

3. 配置自动任务

1. 导入任务配置文件：
   • RunTime Tracker.xtsk
2. 激活自动任务

4. 验证配置

确保所有服务正常运行，数据能正确上报

Android （自动任务）端配置步骤 - 旧

ADB级别后台保活，常驻后台运行，但需要Shizuku（重启后需要重新打开，如果不想多次启动可以看下面方案）

1. 安装必要软件

• 自动任务 (AutoTask)
• Shizuku
• 任意文件管理器

已知问题： 充电状态因引用限制无法及时更新

2. 部署脚本文件

1. 下载 app.sh battery.sh
2. sh文件放置到设备目录：/storage/emulated/0/TimeTracker/
3. 编辑脚本文件，修改以下常量配置：
   • URL - API地址
   • SECRET - 认证密钥

3. 配置自动任务

1. 导入任务配置文件：
   • 应用上报.xtsk
   • 息屏.xtsk
   • 电量反馈.xtsk
   • 设备充电.xtsk
2. 激活自动任务

4. 验证配置

确保所有服务正常运行，数据能正确上报

Android （Macrodroid）端配置步骤

无障碍+自启动保活，一般情况不会被杀后台，使用更方便

1. 导入配置文件：
   • 设备信息上报.category
2. 转到 主页/变量/新建，新建变量SECRET和DEVICE_ID以及API，类型为字符串，分别是密钥，设备名和API地址(示例 https://example.top/api)
3. 激活宏，请给予相关权限（无障碍，读取应用列表，自启动，省电无限制等）

Windows端

1.CSSQY的第三方客户端
2.main.py，不完善没有自启动
3.如果您也在使用这个工具PCTools接入Hass，只需要打开前台软件监听即可

Linux端

使用脚本tracker.sh

X11依赖要求

# Debian/Ubuntu
sudo apt install xdotool x11-utils

# Arch
sudo pacman -S xdotool xorg-xprop

Wayland

由于 Wayland 环境出于安全考虑，权限受限，仅实验性支持，暂时支持以下桌面环境：
Niri
Hyprland
Sway
KDE Plasma Wayland(存在一定局限性，最新版本 KWin 安全策略限制)
GNOME Wayland (受限：仅在允许 unsafe-mode 的 dbus Eval，或安装了暴露 API 的扩展时工作)

装完依赖且配置完可直接启动，可自行配置systemd自启动