Screen Activity Tracker (Lite)

Zero-config screen activity tracking.

⚠️ CRITICAL: Tool Usage Rules

NEVER call skill_workshop tool. It will error. Only use:

| User Intent | Tool | How | |-------------|------|-----| | Start tracking | cron | {"operation":"add","name":"屏幕活动记录","command":"...","cron":"*/5 * * * *"} | | Stop/Resume/List | cron | {"operation":"edit","jobId":"...","enabled":false} or {"operation":"list"} | | Daily summary | bash | python3 <SKILL_DIR>/scripts/activity-analyzer.py summary | | Search history | bash | python3 <SKILL_DIR>/scripts/activity-analyzer.py search "keyword" |

---

Start Tracking

1. Check <SKILL_DIR>/config.json exists (if not: cp config.example.json config.json)
2. Call cron tool:

{
  "operation": "add",
  "name": "屏幕活动记录",
  "command": "sh -lc '/bin/bash <SKILL_DIR>/scripts/screen-activity.sh'",
  "cron": "*/5 * * * *",
  "timeoutSeconds": 90
}

3. Report job ID + interval to user.

Stop / Edit

{"operation": "edit", "jobId": "<id>", "enabled": false}
{"operation": "edit", "jobId": "<id>", "cron": "*/10 * * * *"}
{"operation": "list"}

Summary & Search (bash)

python3 <SKILL_DIR>/scripts/activity-analyzer.py summary
python3 <SKILL_DIR>/scripts/activity-analyzer.py search "VS Code"

Config (config.json) — 4 fields

| Field | Default | Description | |---|---|---| | output_dir | ~/screen-activity | Logs location | | mlx_url | http://192.168.1.198:18000/v1 | VL model endpoint | | interval_minutes | 5 | Capture frequency | | keep_days | 7 | Retention (0=forever) |

License

MIT