never-miss（不错过）
把散落在口述、截图、邮件里的日程与截止事项，变成 macOS 系统日历里带提醒的事件；提醒由操作系统负责，写入后不再依赖本 Skill 是否在线。
1. 模式判定（先判断当前属于哪种模式）
| 模式 | 判定信号 | 下一步 |
|---|---|---|
| ①交互建提醒 | 用户消息含日程意图（提醒我/记一下/安排/会议/截止…），含口述或截图 | 走 §3 |
| ②自动扫描 | 宿主注入哨兵提示 【never-miss:auto-run】 |
读 references/runbook-auto.md |
| ③查询 | "建了哪些提醒/今天有什么/本周日程/运行状态" | 走 §6 |
| ④配置维护 | "配置日程提醒/再配一个邮箱/删账户/停用账户" | 走 §7 |
2. 铁律（不可妥协）
- 相对时间换算前必须先执行
now取锚点；换算结果必须写进回复明示（NFR-01） - 缺字段如实标"未提供"，禁止编造时间与参与者（FR-13）
- 缺开始时间 / 时间歧义：交互模式追问，自动模式跳过（FR-21/22/24/25）
- 创建成功必须复述完整详情，时间用绝对日期时间（如"9月5日（周六）15:00"）
- 任何失败不静默；按错误码给修复指引或上报（FR-30）
- 密码只经 stdin 入 Keychain，任何输出打码；配置与日志不留明文（FR-03）
3. 交互建提醒流程
now取时间锚点- 提取字段并换算（规则见
references/extraction-rules.md，含 deadline 识别与全天判定） - 缺开始时间 / 时间歧义 → 追问；低置信度 → 追问
- 冲突检查：
check-conflict --start <ISO> --end <ISO>；有冲突则告知用户决定（改期/照建/放弃） - 构建 Event JSON（见 §5）→ 经 stdin 传给
create - 按输出复述详情；
status:"ics_fallback"时提示用户双击导入.ics；duplicate时说明已存在
4. 命令速查
数据目录：NEVER_MISS_DATA 环境变量 > 默认 ~/.workbuddy/never-miss。所有命令用 python3 scripts/never_miss.py <cmd>，输出结构化 JSON。
| 命令 | 用途 |
|---|---|
now |
时间锚点（换算前置） |
init |
生成 config.yaml 与 state.json |
secret set/check/delete <邮箱> |
Keychain 读写删（set 的密码经 stdin） |
doctor [--write-test] |
逐账户自检（配置/时区/Keychain/IMAP/日历） |
create [--journal] |
建日历事件（Event JSON 经 stdin；自动模式加 --journal） |
check-conflict --start --end |
查时间冲突 |
mail list/read |
交互式看/读邮件（FR-09） |
scan fetch/commit |
自动扫描：取信（游标不动）/ 推进游标 |
journal skip/error |
补记跳过/失败（自动模式） |
query events/status |
只读查询（最近 N 天 / 时间范围 / 运行状态） |
错误码：E_ARGS E_CONFIG E_KEYCHAIN E_IMAP E_CALENDAR E_AUTH E_UNSUPPORTED E_STATE E_INTERNAL。对照处置见 references/troubleshooting.md。
5. Event JSON 契约（create 的 stdin）
{
"title": "项目评审",
"start": "2026-09-12T10:00:00+08:00",
"end": "2026-09-12T11:00:00+08:00",
"all_day": false,
"location": "会议室A",
"attendees": ["张三"],
"reminder_lead_minutes": 60,
"source": {"account": "me@example.com", "mail_subject": "评审通知", "mail_uid": 48213}
}
title、start必需；end可省略（普通事件默认 +1h，全天事件默认单日）- 全天事件：
all_day:true且start用YYYY-MM-DD source：邮件来源必填（account/mail_subject/mail_uid）；对话来源可省略
create 返回：status ∈ created|duplicate|ics_fallback，另有 uid、conflicts、ics_path、event（回显）。
6. 查询（只读）
- 最近 N 天建的提醒：
query events --created-days N（默认 7）→ 倒序表格（主题/时间/来源账户/来源邮件主题） - 某时间段日程：
query events --from YYYY-MM-DD --to YYYY-MM-DD - 运行状态：
query status（上次运行、各账户游标、新建/跳过/失败、待汇报标记） - 空结果明确回复"没有"
7. 配置维护
- 对话式收集账户必填项（host/username/label）；各家"专用密码"获取见
references/mail-setup.md - 写 config.yaml（不含密码）+
secret set <邮箱>（stdin 传密码） doctor --write-test逐项汇报；提示宿主注册每天schedule.time定时任务- 追加/停用/删除账户 = 改 YAML；删除时提示是否清理 Keychain
8. 引用（按需加载）
- 提取规则（字段/时间换算/置信度/deadline）：
references/extraction-rules.md - 自动模式完整流程：
references/runbook-auto.md - 邮箱专用密码指引：
references/mail-setup.md - 错误码处置：
references/troubleshooting.md
