用途:通过随附的 kitchen-axi CLI(位于本技能 scripts/ 目录,不在 PATH 上)读写厨房模块,包括消费日志与库存。调用方式为相对技能基目录的路径:scripts/kitchen-axi(首页:今日合计、优先食用、待答问题)、scripts/kitchen-axi --help(完整命令列表)、scripts/kitchen-axi <group> --help(命令组用法)。输出为 TOON 紧凑表格,加 --json 可得原始 API JSON。服务器默认 http://localhost:2529,可用环境变量 CLAUDE_ASSIST_SERVER 覆盖。完整行为契约见 specs/modules/kitchen.md。
主要能力:记录餐食与零食(entries log,可带 --recipe 与 --component 精确计算);事后调整份量(entries patch --multiplier,始终基于 base 重算,幂等);修正营养数值(九个宏量字段可就地 patch,属终态手动覆盖);按天聚合(days 一次返回每日预计算行,避免手工汇总导致 UTC 分桶错误);库存事件(opened/finished/tossed,--fraction 语义各不相同);备餐转换(inventory convert --to 带 recipe_ulid 才生成可一键消耗的条目);食谱 upsert(同名推送即替换,不建变体);小票扫描(receipts scan,照片仅内存暂存);价格与浪费查询(products prices、inventory waste,null 表示未知而非零)。
使用方式:常见流程如记录刚吃的东西用 entries log "<描述>";只吃一半用 entries patch <ulid> --multiplier 0.5;已知完整营养面板则记录时直接传 --calories/--protein/… --label,避免先记后改的竞态;补记餐食应传带时区的完整本地时间戳(--at 2026-04-29T14:30:00-04:00),裸日期仅作兜底并强制为当地正午。分桶以 day 字段为准,不要从时间戳推导日期。
适用场景:个人饮食记录、库存与备餐管理、小票与价格追踪、食物浪费统计。
限制:照片不持久化,无法事后重新 OCR;成本为 null 表示未知,不可当作零;总糖与添加糖是两个不同数字,只有添加糖有上限;未匹配的库存备注返回 {matched:false} 属正常,需回退到 inventory list 加显式事件;食谱无硬删除,recipes delete 仅归档。其余细节暂未提供。