GOG 过期游戏清理工具

查找您已安装但超过 30 天未游玩的 GOG 游戏，向您发送邮件报告，并创建 Apple 提醒事项，以便您决定是否卸载。

适用场景

• 用户希望整理自己的 GOG 游戏库
• 用户询问有关“过期 / 未使用 / 被遗忘”的已安装游戏
• 用户需要周期性清理提醒的工作流
• 使用了诸如“stale games”、“game cleanup”、“haven't played in a while”等表述

不适用场景

• 浏览或搜索 GOG 目录 → 请使用 gog 技能
• 直接管理游戏的安装/卸载 → 仅支持通过 GOG Galaxy 客户端操作
• 调度扫描任务本身 → 首次运行该技能后，可通过 cron 实现定时调度

前提条件

1. GOG 游戏库数据 —— 工作区中需存在一个 JSON 文件：config/gog_library.json（可从 GOG Galaxy 导出，或手动维护）。文件中必须包含 games[] 数组，且每个条目需有 installed（布尔值）和 last_played（ISO-8601 格式时间字符串，或为 null）字段。
2. Himalaya —— 已配置好 personal 账户的命令行邮件客户端（运行 himalaya --version 可验证）。
3. remindctl —— Apple 提醒事项命令行工具（运行 remindctl status 可验证）。仅限 macOS 系统。
4. “Gaming” 提醒列表 —— 名为 Gaming 的 Apple 提醒事项列表（如不存在将自动创建）。

配置项

所有路径均相对于 OpenClaw 工作区根目录，除非指定为绝对路径。

脚本

主脚本为 scripts/gog-stale-scan.sh。可直接运行，也可由 agent 调用执行。

# 试运行（仅打印结果，不发送邮件/不创建提醒）
bash scripts/gog-stale-scan.sh --dry-run

# 完整运行
bash scripts/gog-stale-scan.sh

# 自定义过期天数阈值
STALE_DAYS=60 bash scripts/gog-stale-scan.sh

功能说明

1. 读取 config/gog_library.json 文件
2. 筛选出 installed: true 且 last_played 时间早于当前时间 30 天以上（或为 null）的游戏
3. 在标准输出中打印格式化的表格
4. 通过 himalaya 向您的 personal 账户发送 HTML 格式邮件
5. 为每个过期游戏在 Gaming 提醒列表中添加一条提醒，附注内容为：“Consider uninstalling — last played YYYY-MM-DD”

cron 定时调度（可选）

首次成功运行后，可按月调度：

0 10 1 * *  # 每月 1 日上午 10 点

使用 cron 工具配合携带 agentTurn 负载的请求来调用本技能。

输出示例

🧹 过期 GOG 游戏（30+ 天未游玩）
─────────────────────────────────────────────
  Stardew Valley          last played 2026-03-28
  Baldur's Gate 3         last played 2026-04-01
─────────────────────────────────────────────
共发现 2 款过期游戏。邮件已发送。已在 Gaming 列表中添加 2 条提醒。