热量与蛋白质追踪

技能简介

基于SQLite数据库的个人饮食追踪工具，支持手动录入食物、监控蛋白质摄入、设定每日热量目标及记录体重变化。

业务背景

帮助健身爱好者及营养师建立私人的饮食与体重管理台账。脱离商业App的订阅费用和数据隐私顾虑，通过本地数据库自主掌控每日热量盈余、蛋白质达标率及体重变化曲线，形成可长期追溯的健康档案。

落地案例：一位力量训练者希望精准监控增肌期的营养摄入。每日训练后手动录入鸡胸肉、米饭等食物的整数热量与蛋白质克数，系统实时计算当日剩余额度；每周固定日期以磅为单位记录体重，通过history命令回顾7日趋势，调整下周碳水分配策略。

能做什么

• 手动添加食物及其热量和蛋白质含量
• 实时查看当日摄入总量与剩余额度
• 设定并保存个人每日热量目标
• 以磅为单位记录体重（支持小数）
• 查询7天或30天的历史趋势
• 按ID删除错误录入的条目

使用说明

安装要求：Python 3.7及以上版本，无需额外依赖包，数据库在首次运行时自动创建。

基础操作：

1. 设置每日目标：python scripts/calorie_tracker.py goal 2000
2. 添加食物：python scripts/calorie_tracker.py add "chicken breast" 165 31（格式：食物名 热量 蛋白质克数）
3. 查看当日汇总：python scripts/calorie_tracker.py summary
4. 记录体重：python scripts/calorie_tracker.py weight 175.5
5. 查看历史：python scripts/calorie_tracker.py history 7

路径注意：实际使用时需在命令前添加工作目录前缀，如 python3 workspace/calorie-counter/scripts/calorie_tracker.py

输入与输出

见下方输入与输出表格。

风险提示

• 热量和蛋白质值仅接受整数，小数会被截断
• 体重单位固定为磅，公斤需手动换算（1kg≈2.205lbs）
• 未提供蛋白质时需根据食物类型估算，误差可能影响营养判断
• 数据存储于本地SQLite文件，无云同步功能

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/cnqso/calorie-counter/SKILL.md
来源类型：GitHub仓库