Screen Activity Tracker Lite

SKILL.md

---
name: screen-activity-tracker-lite
description: "Minimal screen activity tracking. Trigger: track screen, start/stop tracking, daily summary, search history, 开始追踪屏幕, 屏幕活动总结, 整理今天的操作. Uses cron tool for tracking and bash for summary/search."
version: "1.0.0"
license: "MIT"
author: "zeject"
homepage: "https://github.com/zeject/screen-activity-tracker-lite"
metadata:
  openclaw:
    emoji: "📸"
    os: ["darwin"]
    requires:
      bins: ["peekaboo", "python3"]
    install:
      - kind: "npm-global"
        pkg: "@steipete/peekaboo"
        bins: ["peekaboo"]
        label: "Install Peekaboo (npm)"
      - id: "python3"
        kind: "system"
        label: "Python 3.x required"
---

# 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:
```json
{
  "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

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

## Summary & Search (bash)

```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