前言¶
日常饮食记录很容易滑向两个极端：要么只在备忘录里堆菜名，没有结构和情绪反馈；要么打开带红字警告的 App，被「超标」「失败」一类文案推着走。如果你希望在 Agent 对话里自然说出「今天吃了什么」，同时得到可分享的手账卡片、又不必自己写绘图脚本，SkillHub 上的社区 Skill「卡路里手账工厂」把记录、营养估算、情绪标签和视觉输出串成一条流水线。下面介绍它是什么、能做什么，以及如何安装与触发。
这是什么¶
卡路里手账工厂（坐标 @user_9cef5c88/calorie-journal，当前版本 3.0.1，分类 life-service，来源 community）是由发布者 user_9cef5c88 维护的 Agent Skill。Skill 元数据中的作者署名为「饮食疗愈工作室」。官方页面将其定位为「一人公司级治愈系饮食记录平台」：基于《中国居民膳食指南2022》做营养相关校准，强调「零批评」话术（避免「超标」「警告」等制造焦虑的表述），并声明 requires_api_key=false，不强制配置 API Key。
在 SkillHub 统计中，该 Skill 评分为 100000，下载 873 次（以 SkillHub 页面与抓取资料为准，会随时间变化）。
核心功能¶
以下能力均来自官方简介与安装包内 SKILL.md / README.md 的说明，按模块归纳。
完整主题包系统¶
用户可通过编辑 JSON 自定义手账风格，无需改 Python 业务代码。每个主题包包含 6 个配置模块：naming.json（命名）、character.json（角色）、emotion.json（情绪）、quotes.json（话术）、style.json（视觉）、stickers.json（贴纸）。内置主题示例包括 default、space_explorer 等；制作新主题时可复制 scripts/theme_packs/default 目录并修改上述 JSON，详细步骤见包内 scripts/theme_packs/HOW_TO_MAKE_THEME.md。
双输出系统¶
- 图片版：由
scripts/gen_card.py生成 PNG 卡片（文档描述为公交卡式布局，纯代码手绘、不依赖 Emoji 字体，便于 Linux 等环境一致显示）。 - 字符版：由
scripts/text_handbook_generator.py输出纯文本 / Markdown 友好内容，适合聊天转发或纯文本笔记环境。
7 级食物搜索与数据自检¶
scripts/search_engine_v2.py 实现多级降级搜索（内置库、用户扩展数据、可选外部数据源与系数修正、智能估算兜底）。生成流程中包含 7 维度数据自检，出错时可对照 SELF_CHECK_REPORT.txt 或运行 python gen_card.py --check 排查（见 Skill 文档「错误诊断速查」）。
情绪、贴纸与小动物¶
food_mood_analyzer.py：为食物匹配情绪标签（文档称 6 种情绪分类）。emoji_stickers.py：纯代码手绘贴纸。animal_blind_box.py：根据营养结构匹配「小动物盲盒」类陪伴元素。
触发方式¶
Skill 声明在用户提到饮食记录、卡路里、手账、主题包、字符版手账等关键词或明确记录意图时加载；单纯讨论减肥方法而无记录意图、或仅需医学专业咨询时不宜触发。完整触发词列表见安装后的 SKILL.md 头部 triggers 字段。
安装与启用¶
环境依赖¶
Skill 声明需要：
python3Pillow（缺失时常见报错ModuleNotFoundError: PIL，可用pip install Pillow安装）
通过 SkillHub CLI 安装¶
先确认本机已安装 skillhub（安装方式见 SkillHub 安装说明）。安装技能时 必须 使用 --dir 指向当前 Agent 的 skills 目录，否则可能装到默认 ./skills/ 而未被识别。
在 Cursor 中，skills 目录一般为 ~/.cursor/skills/。安装命令示例：
skillhub install @user_9cef5c88/calorie-journal --dir ~/.cursor/skills/
说明：坐标需带 @ 前缀；若仅用 user_9cef5c88/calorie-journal 可能无法解析到社区包。
其他常见客户端路径（摘自 SkillHub 安装文档，以你本机为准）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
通过对话让 AI 安装¶
SkillHub 技能页提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_9cef5c88/calorie-journal`。
将上述内容发给已接入 Skill 机制的 Agent，由其按文档完成 CLI 安装与目录配置。
安装后¶
重启或刷新 Agent 的 Skill 加载后，在对话中使用下文示例触发即可。脚本默认在 Skill 包内的 scripts/ 目录执行；进阶配置可参考包内 ADVANCED_SETUP.md、THEME_PACKS_README.md。
典型用法¶
对话触发（推荐）¶
最快的方式是直接描述餐食，让 Agent 按 Skill 工作流调用脚本。官方 SKILL.md「快速开始」中的示例可直接复制：
我今天早餐吃了包子和鸡蛋，帮我生成手账
记录一下今天的饮食：午餐宫保鸡丁米饭，加餐苹果和奶茶
帮我生成今天的饮食手账，主题用治愈森林
触发后，Agent 应按 Skill 说明依次完成食物识别、情绪分析、卡片生成、小动物匹配与数据自检，并交付图片和/或字符版结果。输入过短时会走文档中的「三轮追问」而非直接失败。
本地一键生成图片卡片¶
进入 Skill 包内 scripts 目录后执行：
cd scripts
python gen_card.py 我的手账
该命令会串联识别、计算、生成与自检；输出目录名由最后一个参数指定。
自定义主题包¶
复制默认主题并编辑 6 个 JSON 文件：
cp -r scripts/theme_packs/default scripts/theme_packs/my_amazing_theme
修改 my_amazing_theme 下各 JSON 后，通过主题加载器使用（文档示例：loader.load_theme("my_amazing_theme")，具体在 Agent 会话或脚本上下文中由 Skill 指引调用）。
字符版手账¶
在对话中说明需要「字符版手账」或「文字手账」，由 Agent 调用 text_handbook_generator.py；也可在熟悉参数后于 scripts/ 下按 SKILL.md 中的分步说明自行运行。
适用场景与注意¶
适合谁
- 希望在 Cursor、Claude Code 等环境中用自然语言记三餐，并拿到可分享手账的人。
- 愿意通过改 JSON 调整配色、话术、贴纸规则，而不想维护独立前端或字体资源的人。
- 需要在 Linux 上稳定出图、避免 Emoji 字体方框问题的用户（Skill 强调纯代码手绘与零 Emoji 字体依赖）。
限制与注意
- Skill 文档明确：不适合替代医疗级营养诊断；特殊疾病饮食需遵医嘱，工具侧仅作个人记录参考。
- 单日餐次过多（文档建议超过 10 餐需分批）或一次塞入多天记录时，应拆分请求，避免一次性生成过多卡片。
- 部分外部数据源（如文档提到的 TianAPI）为可选集成，需自行配置；未配置时会走内置库与估算降级，精度取决于描述详细程度。
- 图片版依赖 Pillow；若系统字体路径特殊，可能需按
SKILL.md排错表处理字体相关报错。
结尾¶
卡路里手账工厂把「说了什么」转成结构化饮食数据，再经主题包与双输出系统变成字符或 PNG 手账，并用多级搜索与自检降低空结果和静默错误的风险。若你要在 Agent 里做低焦虑、可自定义风格的饮食记录，可从 SkillHub 安装 v3.0.1 并按对话示例触发。
- SkillHub 页面：https://www.skillhub.cn/skills/user_9cef5c88/calorie-journal
- 官方坐标链接：https://api.skillhub.cn/user_9cef5c88/calorie-journal
