前言¶
在 Agent 里做饮食相关问答时,常见做法是让用户口述菜名、份量,再由模型凭经验估热量。这种方式对混合餐、外卖和未标注份量的场景误差大,也不方便留档。下面介绍 SkillHub 上的 食物热量识别(WiseDiag Calories):用户给出本地图片路径或图片 URL,由技能调用 AI 识别食物并返回热量及主要营养成分估算,适合把「看图算餐」接到对话流程里。
这是什么¶
食物热量识别(WiseDiag Calories)(坐标 @user_a457224d/wisediag-calories,英文侧描述为 Food Calorie Estimator)是 SkillHub life-service 分类下的社区 Skill,当前页面标注版本 v1.0.5,来源为 community,发布者为 user_a457224d(SkillHub 展示作者为智诊科技 WiseDiag)。简介说明由 杭州智诊科技有限公司 提供能力:拍食物照片,AI 识别种类并估算每份热量、蛋白质、碳水、脂肪等营养成分。
Skill 带 requires_api_key=true 标签,使用前需在技能说明中完成 API Key 配置(具体字段以安装后的 SKILL.md 为准)。
核心功能¶
依据官方简介与 Skill 线索,已核实能力包括:
- 图像输入:支持本地文件二进制上传,或通过 图片 URL 传入;单次最多 5 张图同时分析。
- 识别与估算:识别食物种类,并给出热量及蛋白质、碳水、脂肪等营养成分的估算。
- 触发方式
- 自然语言:用户上传食物图并询问例如「这顿饭多少卡路里」「这个能吃吗」「帮我算一下热量」「这道菜营养成分是什么」等。
- 显式调用:可说 「Use WiseDiag Calories to analyze this」(与英文简介一致)。 - 响应时间:官方说明分析约 30–120 秒 返回结果。
适用方向在简介中列举:减肥热量管控、糖尿病饮食追踪、健身营养计算、备孕/孕期饮食记录、外卖饮食热量查询等(均为官方表述,非第三方案例)。
安装与启用¶
SkillHub 页面给出的安装方式是:让当前 Agent 按官方安装文档处理坐标包,而不是手写克隆仓库。
方式一:安装提示词(页面一键复制)
将下列意图发给支持 Skill 安装的 Agent(原文来自 SkillHub):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_a457224d/wisediag-calories`。
方式二:SkillHub CLI
若环境已安装 skillhub,按 SkillHub 安装与优先源配置 第三节,安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录(装到默认 ./skills/ 可能不会被识别)。示例:
command -v skillhub && skillhub --version
skillhub install @user_a457224d/wisediag-calories --dir <你的 Agent skills 目录>
文档中列出的常见路径包括:
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
页面还支持 下载 Zip 包安装、安装到本地 Agent 等入口;具体步骤以 SkillHub 当前界面为准。
安装完成后配置 API Key(技能标记为必需),再重启或刷新 Agent 的技能加载方式(依你所用客户端文档而定)。
典型用法¶
在技能已安装且 Key 已配置的前提下,可按下面两类输入复现官方描述的行为。
1. 本地图片 + 热量询问
用户提供本机图片路径,并提问热量或能不能吃,例如:
我拍了午餐,路径是 /home/user/photos/lunch.jpg,这顿饭大概多少卡路里?主要营养成分也帮我列一下。
2. 图片 URL
请根据这张图估算热量和营养:https://example.com/meal.png
3. 显式指定技能(英文触发句)
Use WiseDiag Calories to analyze this.
(同时附上本地路径或 URL,并说明要分析的内容。)
多图时可在同一次请求中提供最多 5 张图的路径或 URL,并预留 30–120 秒等待分析完成。
适用场景与注意¶
适合谁
- 需要在对话里快速做「看图估热量、估宏量营养素」的个人或产品原型,又不想自建视觉识别与营养库接口的团队。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub 技能的 Agent 上工作,并能接受配置第三方 API Key 的开发者。
限制与注意
- 结果为 AI 估算,不能替代临床营养指导或法定营养标签;涉及疾病饮食(如糖尿病)时仍应以医嘱为准。
- 依赖网络与远端识别服务,延迟在官方给出的 30–120 秒区间;图片质量、遮挡和混合餐会影响识别。
- 必须配置 API Key;未在资料中展开的计费与配额以 WiseDiag / SkillHub 侧说明为准。
- SkillHub 页面显示本 Skill 经科恩实验室、云鼎实验室扫描为「安全,无风险」(以页面报告为准)。
结尾¶
食物热量识别(WiseDiag Calories) 把「上传餐食照片 → 识别菜品 → 估算热量与蛋白/碳水/脂肪」封装成标准 Skill,通过自然问句或显式英文触发即可调用,并支持本地文件与 URL、最多 5 图 batch。若你要在 Agent 里接饮食记录或热量问答,可从官方页安装并配置 Key。
- SkillHub 页面:https://www.skillhub.cn/skills/user_a457224d/wisediag-calories
- API 坐标页:https://api.skillhub.cn/user_a457224d/wisediag-calories