核心用法
Diet 是一款基于 Bash 和 Python3 的命令行饮食记录工具，主打轻量、本地化的营养追踪。用户可通过 log 命令记录每餐食物的卡路里及三大营养素（蛋白质、碳水、脂肪），系统自动将数据以 JSON 格式存储于 ~/.diet/ 目录，确保数据主权完全归用户所有。
主要功能模块包括：
- 饮食记录：支持指定餐别（早餐/午餐/晚餐/加餐），默认归档为零食
- 数据查询：
calories与macros命令可快速回溯单日摄入总量与营养结构占比 - 膳食规划：根据历史饮食数据生成指定天数、目标卡路里的简易餐单
- 水分追踪：独立记录每日饮水量（毫升）
- 趋势报告：生成单日或七日营养摘要，便于长期健康管理
显著优点
1. 隐私优先：数据本地存储，无云端上传，规避了主流饮食 App 的数据商业化风险
2. 极简依赖：仅需 Bash 4+ 和 Python3 标准库，零额外包管理负担
3. 可扩展性：JSON 数据格式开放，便于与其他工具链（如数据分析脚本）集成
4. 开源透明：源码托管于 GitHub，社区可审计、可 fork
潜在局限
- 无图形界面：纯 CLI 交互，对非技术用户门槛较高
- 无食物数据库：需手动输入每项食物的营养数据，无法像 MyFitnessPal 那样扫码或搜索即得
- 无社交功能：缺乏社区激励、好友挑战等主流健康 App 的粘性设计
- 宏量计算依赖用户输入：若用户误判食物分量，数据准确性将受影响
适合人群
- 注重数据隐私的技术爱好者与开发者
- 已有固定饮食习惯、对常见食物营养值较熟悉的进阶健身用户
- 希望将饮食数据纳入本地自动化工作流（如配合 cron 定时备份、配合 BI 工具分析）的极客群体
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 数据丢失 | 本地 JSON 文件无自动云备份 | 建议配合 `rsync` 或 `git` 定期同步至私有仓库 |
| 营养计算误差 | 手动输入易产生系统性偏差 | 参考 USDA 或本地食品成分数据库标准化录入 |
| 过度简化 | 未考虑微量营养素、膳食纤维、升糖指数等 | 作为基础记录工具使用，复杂需求建议咨询营养师 |
| 饮食障碍触发 | 精细化热量追踪可能加剧焦虑 | 心理敏感用户建议谨慎使用或配合专业指导 |