前言¶
日常飲食記錄很容易滑向兩個極端：要麼只在備忘錄裏堆菜名，沒有結構和情緒反饋；要麼打開帶紅字警告的 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
