workday-music-greeter

将三项现有技能编排为一个工作日例行流程：

1. home-music — 切换全屋音乐场景至当前时段对应的配置。
2. gifgrep — 检索一张契合当前场景情绪的 GIF。
3. imap-smtp-email — 发送一封问候邮件，内嵌该 GIF（通过 ），并同时以附件形式附加该 GIF。

通过 cron 安装脚本，该流程被调度为每周一至周五、在各场景设定的起始时刻自动运行。

文件结构

workday-music-greeter/
├── SKILL.md          # 本文档
├── run.sh            # 主协调脚本（支持 --dry-run 和 auto 模式）
├── scenes.conf       # 场景名 | 起始小时 | GIF 搜索关键词 | 邮件主题
├── install-cron.sh   # 注册周一至周五的 crontab 条目
└── .env.example      # 必需/可选环境变量示例

快速开始

cp .env.example .env && $EDITOR .env      # 配置 WMG_MAIL_TO 及 SMTP_* 凭据
WMG_MAIL_TO=you@example.com ./run.sh morning --dry-run   # 预览执行效果，不触发任何实际操作
WMG_MAIL_TO=you@example.com ./run.sh auto                # 根据当前时间自动选择对应场景
./install-cron.sh                          # 安排周一至周五定时任务

工作原理

• run.sh 执行指定场景；run.sh auto 则根据当前时间，在 scenes.conf 中选取 hour-start 最接近且不大于当前小时的场景（即“当前时段或最近已开始的时段”）。
• 周末防护：若 date +%u >= 6（即周六或周日），脚本直接退出，不执行任何操作。
• GIF 通过 嵌入邮件 HTML 正文（使用 gifgrep 返回的 URL）；若本地已成功下载该 GIF，则额外通过 --attach 参数作为附件添加。
• --dry-run 模式下，所有对外部命令的调用均仅打印而不实际执行——建议首次部署前使用此模式验证流程完整性。

自定义场景

编辑 scenes.conf（管道符分隔）：

morning|8|good morning coffee sunrise|🌅 Good morning — easing into the day
chill|12|relax lofi midday break|🍵 Midday reset — chill vibes on
focus|14|focus work productivity calm|🎯 Afternoon focus block
off|18|goodbye work done relax weekend|🔇 Wrapping up — music off

场景名称必须与 home-music 支持的场景一致（例如 morning、chill、party、off 等）。若修改了起始时间，请重新运行 install-cron.sh；该脚本会以其标记块（tagged block）为单位进行幂等替换。

依赖项与真实限制

若任一依赖项或凭据缺失，run.sh 将发出警告并降级执行（例如跳过某环节），而绝不会伪造成功状态。请务必先使用 --dry-run 进行验证。

环境变量

详见 .env.example。必需变量：WMG_MAIL_TO。SMTP_* 变量由 imap-smtp-email 发送器读取。可选覆盖变量：WMG_GIF_DIR、WMG_SMTP_SCRIPT。