一个自托管的定时通知 + 项目计划跟踪工具。一棵 Node 树同时管理生日提醒（农历/公历）和项目里程碑，到点把消息并发推送到多个可插拔渠道。Go 单 binary，常驻 VPS 调度。
- 主链路：
mqtt（发布到外置 Mosquitto，自有 MAUI 安卓端订阅弹通知） - 兜底：
email（SMTP） - 本地开发验收：
system（beeep 弹 Windows toast）
设计总览、核心抽象与开发阶段见 DEVELOPMENT.md。 人与 Claude 的协作约定见 CLAUDE.md。
Butler 用两个 JSONC 文件（github.com/tailscale/hujson 解析，支持注释和尾逗号），职责分开，都放在用户配置目录下，与代码仓库物理隔离：
| 文件 | 内容 | 权限 |
|---|---|---|
plan.jsonc |
计划树：生日、里程碑、调度、通知偏移 —— 唯一真相源，由人或 AI 直接编辑 | 0644 |
config.jsonc |
渠道密钥与连接信息（SMTP、MQTT broker） | 0600（仅所有者可读，含密钥） |
位置（os.UserConfigDir()）：
- Windows →
%AppData%\plan.jsonc、%AppData%\config.jsonc - Linux（VPS）→
~/.config/plan.jsonc、~/.config/config.jsonc
首次运行时若文件不存在会自动创建空文件。两者都在用户配置目录、不在仓库内，因此不会进 git，密钥也绝不硬编码进源码。
计划树里的节点只引用渠道名（如 "channels": ["mqtt", "email"]），密钥只存在于 config.jsonc，永不出现在真相源里——这样 AI 编辑计划时不会碰到任何密钥。
早期开发中，当前已跑通：本地
system通知 + 一次性（Once）调度闭环。
# 构建
go build -o butler .
# 前台运行调度器
./butler serve
# 查看命令
./butler --help| 用途 | 选型 |
|---|---|
| CLI | github.com/spf13/cobra |
| JSONC 解析 | github.com/tailscale/hujson |
| cron 解析 | github.com/robfig/cron/v3 |
| 系统通知 | github.com/gen2brain/beeep |
| 后台服务 | github.com/kardianos/service |
| 农历 | github.com/6tail/lunar-go |
| TUI（可选） | github.com/charmbracelet/bubbletea |