使用说明
May 21, 2026 · View on GitHub
Android （自动任务）端配置步骤
ADB级别后台保活，常驻后台运行，但需要Shizuku（重启后需要重新打开，如果不想多次启动可以看下面方案）
1. 安装必要软件
- 自动任务 (AutoTask)
- Shizuku
- 任意文件管理器
2. 部署脚本文件
- 下载 tracker.sh
- sh文件放置到设备目录：
/storage/emulated/0/TimeTracker/ - 编辑脚本文件，修改以下常量配置：
URL- API地址SECRET- 认证密钥
3. 配置自动任务
- 导入任务配置文件：
- 激活自动任务
4. 验证配置
确保所有服务正常运行，数据能正确上报
Android （自动任务）端配置步骤 - 旧
ADB级别后台保活，常驻后台运行，但需要Shizuku（重启后需要重新打开，如果不想多次启动可以看下面方案）
1. 安装必要软件
- 自动任务 (AutoTask)
- Shizuku
- 任意文件管理器
已知问题： 充电状态因引用限制无法及时更新
2. 部署脚本文件
- 下载 app.sh battery.sh
- sh文件放置到设备目录：
/storage/emulated/0/TimeTracker/ - 编辑脚本文件，修改以下常量配置：
URL- API地址SECRET- 认证密钥
3. 配置自动任务
4. 验证配置
确保所有服务正常运行，数据能正确上报
Android （Macrodroid）端配置步骤
无障碍+自启动保活，一般情况不会被杀后台，使用更方便
- 导入配置文件：
- 转到 主页/变量/新建，新建变量SECRET和DEVICE_ID以及API，类型为字符串，分别是密钥，设备名和API地址(示例 https://example.top/api)
- 激活宏，请给予相关权限（无障碍，读取应用列表，自启动，省电无限制等）
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自启动