核心用法
Diet 是一款基于 Bash 和 Python3 的轻量级饮食管理工具，面向偏好本地数据存储的技术型用户。通过命令行界面，用户可快速记录每餐食物、追踪热量与三大宏量营养素（蛋白质/碳水/脂肪）、监测每日饮水量，并生成日度或周度营养分析报告。
主要功能模块：
| 命令 | 功能 | 示例 |
|:---|:---|:---|
| `log` | 记录餐食及营养数据 | `bash scripts/script.sh log "鸡胸肉沙拉" 350 35 10 12 lunch` |
| `calories` | 查询指定日期热量摄入 | `bash scripts/script.sh calories 2024-01-15` |
| `macros` | 查看宏量营养素占比 | `bash scripts/script.sh macros`（默认今日） |
| `water` | 记录饮水量（毫升） | `bash scripts/script.sh water 500` |
| `plan` | 基于历史数据生成膳食计划 | `bash scripts/script.sh plan 1800 7` |
| `report` | 输出日/周营养报告 | `bash scripts/script.sh report weekly` |
数据以 JSON 格式存储于 ~/.diet/ 目录，确保用户完全掌控个人健康数据。
显著优点
- 完全本地化：所有数据存储于用户主目录，无云端上传，隐私可控
- 低依赖门槛：仅需 Bash 4+ 和 Python3 标准库，无需额外包管理
- 脚本化工作流：适合集成到自动化任务（如定时日报推送）
- 可扩展存储格式：JSON 数据结构便于后期迁移或自建可视化
- 宏量营养素追踪：超越单纯热量计数，支持蛋白质/碳水/脂肪比例分析
潜在缺点与局限性
- 无图形界面：纯命令行操作，对非技术用户门槛较高
- 食物数据库缺失：需手动输入每项食物的营养数据，无内置搜索或条码扫描
- 无营养科学校验：生成的膳食计划仅基于历史记录简单推算，缺乏专业营养算法
- 数据同步困难：多设备使用需自行解决文件同步（如 Syncthing、云盘）
- 无膳食限制支持：未内置过敏原检测、宗教信仰饮食或慢性病饮食管理功能
适合人群
- 开发者、系统管理员等技术背景用户
- 重视数据隐私、拒绝 SaaS 健康追踪服务的用户
- 已具备基础营养知识、无需食物数据库辅助的进阶用户
- 希望将饮食记录集成到个人自动化工作流的用户
常规风险
- 数据丢失风险：本地 JSON 文件无自动备份机制，建议配合定期备份策略
- 营养计算误差：手动输入易出现记录错误，长期可能影响饮食决策准确性
- 膳食建议局限性：
plan命令的算法简单，不可替代注册营养师的专业指导 - 脚本执行安全：从 GitHub 下载的 Bash 脚本需审查来源，避免供应链攻击
- 跨平台兼容性：依赖 Bash 4+，Windows 原生环境需 WSL 支持
评估结论
该工具定位清晰，适合技术用户作为轻量级、隐私优先的饮食追踪解决方案，但不应作为医疗营养管理工具使用。