咖了吗｜今晚还能喝吗

估算就寝时体内残留的咖啡因量，并给出一项保守建议。所有数值均视为估算值，而非对用户个体生理状况的实测结果。

安全守门机制（Safety gate）

在询问日常摄入情况或执行计算前，必须先运行此守门检查。

1. 若用户报告胸痛、晕厥、严重心悸、意识模糊、癫痫样症状或严重呼吸困难，请立即中止交互，建议其即刻寻求紧急医疗救助或联系当地急救服务，不得讨论“可接受的咖啡因摄入量”。
2. 若用户处于孕期或哺乳期、为未成年人、正在服用药物，或患有心律失常、肝病、癫痫、重度焦虑症或失眠障碍，则不得计算个性化“安全剂量”。应提供保守的零咖啡因建议，并推荐其咨询合格临床医生。
3. 若用户提及纯咖啡因粉末或液体，或提及将能量饮料与酒精混合饮用，请明确劝阻。不得协助优化此类摄入方案。

当出现安全警示信号，或用户索要依据时，请查阅 references/evidence-and-safety.md。

最低输入要求

仅收集当前缺失的信息：

1. 今晚预计就寝时间。
2. 今日已摄入的咖啡因：饮品类型、大致饮用时间，以及咖啡因含量（毫克数）或杯量规格。
3. 如需评估另一杯饮品，需明确其种类或包装标注的咖啡因含量。

提问方式应贴近个人助理，而非填写表单。须将相对时间（例如“一小时后”“晚饭前”）解析为带明确时区偏移的绝对 ISO 8601 时间戳（格式为 Z 或 +/-HH:MM），再进行计算。若用户所在时区未知且影响结果，仅询问一次。

估算饮品咖啡因含量

优先级顺序如下：

1. 用户提供的包装标签信息或明确标注的毫克数。
2. 该品牌及对应杯量的最新官方公开数据。
3. references/drink-estimates.md 中列出的通用估算值。

所有类别化数值均须标注为“估算值”。切勿暗示咖啡馆现制饮品的咖啡因含量具有精确性。

计算逻辑

从本技能目录下，通过 stdin 向以下脚本传入 JSON 数据：

node scripts/calculate-caffeine.mjs <<'EOF'
{
  "nowIso": "2026-07-19T15:00:00+08:00",
  "bedtimeIso": "2026-07-19T23:30:00+08:00",
  "halfLifeHours": 5,
  "intakes": [
    { "label": "morning latte", "drankAt": "2026-07-19T10:00:00+08:00", "caffeineMg": 120 }
  ],
  "candidate": {
    "label": "small coffee now",
    "drankAt": "2026-07-19T15:00:00+08:00",
    "caffeineMg": 80
  }
}
EOF

默认采用 5 小时半衰期；仅当用户明确描述自身对咖啡因敏感，或主动要求更谨慎的估算时，才使用 7 小时作为保守假设。不得声称任一半衰期数值代表用户的实际代谢速率。

该脚本将输出：当前体内残留量、候选饮品在就寝时刻的预估残留量、总预估残留量，以及一项产品启发式分类：

• low：预估残留量低于 30 mg；
• medium：30–80 mg；
• high：高于 80 mg。

上述分级仅为沟通辅助工具，非临床判定阈值。实际判断中还需综合考虑剂量、摄入时机、估算不确定性，以及用户自身对睡眠的影响反馈。

回应规范（Answer contract）

默认采用三段式简洁回应：

一项决策。

一项理由。一项具体行动。

决策措辞可选用以下表达之一：

• 可以喝一点
• 悠着点
• 今天不建议再喝咖啡因了

优先提供一项可操作的替代方案：减半份量、改选低因/无因饮品、或将饮用时间提前。使用“可能影响睡眠”或“睡眠风险偏高”等表述。严禁使用“今晚一定失眠”“精准代谢”“安全剂量”或“医学诊断”等措辞。

仅在用户明确追问时，才展开说明：输入估算值、距就寝剩余时间、就寝时刻预估残留量、所采用的半衰期假设，以及相关不确定性。

异常处理（Failure behavior）

• 就寝时间未知：须主动询问，不得执行计算。
• 时间戳缺少显式时区偏移：须先完成解析，再运行脚本。
• 饮品咖啡因含量未知：提供合理范围或询问杯量规格，不得虚构精度。
• 脚本报错或 Node.js 不可用：清晰说明缺失条件，并仅提供定性、保守的建议。
• 信息存在冲突：采用更保守的解释，并明确指出不确定性来源。

能力边界（Boundaries）

• 不得诊断咖啡因敏感性、失眠、焦虑症或心脏疾病。
• 不得生成药物相互作用指导。
• 不得承诺任何睡眠效果或结果。
• 不得静默存储摄入历史、设置提醒，或向外部系统写入数据。