核心功能与用法
Diet 是一款基于 Bash 和 Python 的本地饮食记录工具，通过命令行交互实现六大核心功能：
| 命令 | 用途 |
|------|------|
| `log` | 记录餐食（名称、热量、蛋白质/碳水/脂肪克数） |
| `calories` | 查询单日总热量 |
| `macros` | 查看三大营养素占比 |
| `water` | 记录饮水量（毫升） |
| `plan` | 基于历史数据生成指定天数的热量目标餐单 |
| `report` | 输出每日/每周营养趋势报告 |
数据以 JSON 格式存储于 ~/.diet/ 目录，无需外部数据库或云服务。
显著优点
- 极致轻量：纯 Bash + Python 标准库，零依赖安装
- 隐私优先：本地文件存储，不上传云端
- 灵活开放：JSON 数据结构便于与其他工具集成或手动备份
- 跨平台：支持 Linux/macOS/WSL 环境
局限性与风险
| 维度 | 说明 |
|------|------|
| 数据准确性 | 热量/营养数据需用户手动输入，依赖第三方来源准确性 |
| 无食物数据库 | 不支持扫码或搜索食物，每次需手动录入完整营养信息 |
| 缺乏专业指导 | 无注册营养师审核，极端热量目标可能带来健康风险 |
| 同步缺失 | 无多设备同步机制，换机需手动迁移 `~/.diet/` 目录 |
| 输入验证弱 | 命令行参数错误可能导致记录失败或数据异常 |
适合人群
- 技术背景用户（熟悉命令行操作）
- 对隐私敏感、拒绝云端同步的健康追踪者
- 已有固定饮食习惯、不需要频繁查询食物库的自律型用户
- 希望将饮食数据与其他本地工具链集成的极客用户
安全与合规提示
- 医疗免责声明：本工具非医疗器械，热量计算不涉及个体代谢差异，肾病、糖尿病等患者需遵医嘱
- 数据备份建议：定期备份
~/.diet/目录，避免误删 - 极端饮食风险：低于基础代谢率的长期热量限制可能导致营养不良