Screen Reviewer — 电脑行为复盘助手

自动截图 → 结构化日志 → AI 每日复盘报告。

文件位置

• 脚本: scripts/（相对于本 skill 目录）
• 数据: ~/.screen-reviewer/（含截图、日志、报告、配置）
• 配置: ~/.screen-reviewer/config.yaml
• 报告: ~/.screen-reviewer/reports/YYYY-MM-DD-review.md
• Venv Python: ~/.screen-reviewer/venv/bin/python

快速参考

所有命令均通过 service_manager.py 执行。请使用 venv 中的 Python 运行：

VENV=~/.screen-reviewer/venv/bin/python
SCRIPTS=/scripts

$VENV $SCRIPTS/service_manager.py start        # 启动截图守护进程
$VENV $SCRIPTS/service_manager.py stop         # 停止守护进程
$VENV $SCRIPTS/service_manager.py status       # 查看状态 + 今日统计信息
$VENV $SCRIPTS/service_manager.py pause        # 暂停（守护进程保持运行）
$VENV $SCRIPTS/service_manager.py resume       # 恢复截图
$VENV $SCRIPTS/service_manager.py report               # 生成昨日报告
$VENV $SCRIPTS/service_manager.py report 2026-03-22     # 指定日期的报告
$VENV $SCRIPTS/service_manager.py cleanup      # 删除超过 3 天的截图
$VENV $SCRIPTS/service_manager.py install      # 安装 macOS 自启动服务
$VENV $SCRIPTS/service_manager.py uninstall    # 卸载自启动服务

初始化设置（首次运行）

在仓库根目录下执行：

bash install.sh

安装完成后，请授予 屏幕录制 和 辅助功能 权限： 系统设置 → 隐私与安全性 → 屏幕录制 → 启用 Terminal / Python。

配置

编辑 ~/.screen-reviewer/config.yaml：

工作原理

1. 截图循环（每 5 秒一次）：截图 → 变化检测 → 获取窗口信息 → OCR 文本提取 → 写入 JSONL 日志
2. 每日报告（每日上午 8 点或按需触发）：聚合日志 → 应用分类 → AI 生成 Markdown 报告
3. 清理任务（随报告生成一同执行）：删除早于 3 天的截图目录

日志格式

~/.screen-reviewer/logs/YYYY-MM-DD.jsonl 中每一行为一条 JSONL 记录：

{"timestamp":"2026-03-22T14:30:05","app":"Cursor","window_title":"capture_daemon.py","screenshot":"screenshots/2026-03-22/14-30-05.jpg","ocr_text":"def main():..."}

故障排查

当用户提出以下请求时…

• 开始监控: 运行 service_manager.py start
• 查看今日活动: 运行 service_manager.py status，然后查阅当日日志
• 生成复盘报告: 运行 service_manager.py report [date]
• 修改设置: 编辑 ~/.screen-reviewer/config.yaml
• 将应用加入黑名单: 在配置中向 privacy.blacklist_apps 追加应用名
• 检查磁盘占用: du -sh ~/.screen-reviewer/screenshots/