食物数据库查询（Food Database Query）

Food Database Query 是 WellAlly Health（原名 Claude-Ally-Health）中的一个 Claude Code 技能。WellAlly Health 由 WellAlly Tech 维护，采用 MIT 协议，是一个本地优先的个人健康档案项目。它为项目的营养命令提供一张本地食物成分表：查询某种食物、对比两种食物、找出某种营养素高或低的食物，以及把你用自然语言描述的一餐算出营养总量。

是参考数据，不是饮食建议。 数值以每 100 克生食或标准烹饪状态计，实际摄入会因烹饪方式、份量和个人吸收而不同。需要治疗性饮食时请咨询注册营养师。

数据库

• 规模：1.0 版（创建于 2026-01-06）收录 50 种常见食物，每种包含 30 多项营养指标：热量、宏量营养素、维生素和矿物质。
• 来源：元数据注明来自《中国食物成分表》（第 6 版）和 USDA FoodData Central。
• 结构：food-categories.json 中有 10 大类、30 多个子类；每种食物带标准份量、英文名和别名（例如“燕麦”“燕麦片”“oats”“rolled oats”指向同一条目）。
• 参考摄入量：单独文件存放 19–50 岁成年男性和女性的每日推荐摄入量，用于对比食物或一餐与每日需要的差距。

这三个文件都在仓库的 data-example/ 目录中，并附有添加食物的维护指南。

功能

• 食物查询：营养成分、营养亮点、健康标签和推荐份量。
• 食物对比：逐项对比两种食物的营养素并给出建议。
• 按营养素推荐：筛选某营养素高于或低于阈值的食物（如高膳食纤维食物）。
• 整餐计算：解析“燕麦粥 1杯 + 鸡蛋 1个 + 牛奶 250ml”这样的输入，匹配数据库条目，换算份量并汇总营养。
• 智能搜索：支持名称和别名匹配、模糊搜索以及按分类浏览。

如何使用

WellAlly Health 是一个 Claude Code 项目，不是独立安装包。克隆仓库后在目录里启动 Claude Code：

git clone https://github.com/huifer/WellAlly-health.git
cd WellAlly-health
claude

技能通过 /nutrition 命令调用。上游文档中的示例：

/nutrition food 三文鱼
/nutrition compare 鸡胸肉 三文鱼
/nutrition record breakfast 燕麦粥 1杯 + 鸡蛋 1个 + 牛奶 250ml

局限

• 只有 50 种食物，很多菜肴和包装食品查不到。上游路线图计划扩充。
• 营养值会因地区、品种和做法不同而有差异。
• 它不会考虑肾病、过敏等个人情况，需要你另行核对。

常见问题

它是在线食物 API 吗？ 不是。它读取本地 JSON 文件，查询不依赖网络，但分析本身通过 Claude Code 完成。

能添加自己的食物吗？ 可以。仓库里有一份说明 JSON 结构的食物数据库维护指南。

替代方案

• Nutrition Analyzer：同项目的饮食分析技能，使用这个数据库。
• Goal Analyzer：追踪基于这些数据设定的饮食目标。
• Health Trend Analyzer：长期关联饮食记录与症状、体重。

更多内容见 skills 分类 和 health 标签。