name: life-log slug: life-assistant displayName: Life Log 生活記錄 description: >- 把日常飲食、睡眠、運動記錄到飛書多維表格，並生成周期復盤。當用戶說 "記錄早餐/午餐/晚餐"、"吃了什麼"、"記錄睡眠/昨晚睡了"、"記錄運動/瑜伽/跑步"、 "今天吃了XX"、"周復盤/月復盤/本週總結"、"配置飛書/還沒有表格"、 或想查詢某天已記錄的資料、或想接入飛書模版時使用。 summary: 用一句話記錄每日飲食、睡眠、運動到飛書多維表格，自動生成周/月復盤報告。面向想做自我量化與生活管理的飛書使用者，零配置上手，告別手抄表格。 version: 1.0.3 author: Minor license: MIT level: personal

Life Log 生活記錄

把聊天裡的生活片段（飲食 / 睡眠 / 運動）結構化寫入飛書多維表格，並支援週期復盤。

首次使用需配置：複製一份飛書模版 + 建應用授權。流程見 references/SETUP.md 與 references/base_template.md（模版連結在作者的付費文章裡）。

Before logging

1. 確認 Node.js 18+（node -v）。缺失則按 SETUP.md Step 0 安裝。
2. 確認已配置：優先讀本 skill 目錄下的 life-log.config.json；否則執行 npx tsx scripts/setup_life_log.ts --check。
3. 若未配置，走 SETUP.md（這是聊天清單，不是終端嚮導）：
4. 讓使用者從 base_template.md 頂部的文章拿到模版連結 + 訪問密碼， 複製到自己的飛書空間。
5. 要求回傳新的、可編輯的 /base/... 連結（不要官方原連結）。
6. 收集飛書 appId / appSecret，帶 flag 執行 setup。
7. 禁止在聊天裡無 flag 執行 npx tsx scripts/setup_life_log.ts。
8. 所有標準寫入走 scripts/life_log.ts。
9. 僅當需營養查詢時用 scripts/query_food.ts。

Supported flows

• diet：餐食 / 加餐 / 飲品 / 脹氣反饋
• sleep：入睡 / 起床時間、質量分、原因、感受
• exercise：運動名 / 時間 / 時長 / 型別 / 強度 / 感受
• inspect：寫前或使用者問"記了啥"時回讀某天
• review：周 / 月復盤（只讀），見 references/review.md

  7w4.net提供免費和付費技能下載。

Workflow

1. 分類請求

• 食物 / 餐 / 加餐 → diet
• 睡眠 / 起床 / 質量 → sleep
• 運動 / 瑜伽 / 羽毛球 / 騎行 → exercise
• 糾正 / 已記了啥 → 先 inspect 再更新或追加
• 安裝 / 配置 / 還沒有表格 → references/SETUP.md
• 周復盤 / 月復盤 / 本週總結 → references/review.md

2. 只問缺失的關鍵欄位

資訊足夠就不多問。

• diet：日期、餐別、食物清單
• sleep：起床日期、入睡時間、起床時間、質量
• exercise：日期、時間、名稱、時長、型別、強度、感受

3. 執行統一 CLI

飲食 JSON 用 Write 工具寫到 tmp/diet-items.json 再傳 --items-file（Windows cmd.exe 不要內聯 JSON）。 首次執行 npx tsx 會自動下載 tsx；如需離線，先 npm install。

npx tsx scripts/life_log.ts diet  --date YYYY-MM-DD --meal 午餐 --items-file tmp/diet-items.json
npx tsx scripts/life_log.ts sleep --date YYYY-MM-DD --sleep-at 23:30 --wake-at 07:30 --quality 85 --feeling "還行"
npx tsx scripts/life_log.ts exercise --date YYYY-MM-DD --time 18:00 --name "瑜伽" --type "拉伸/塑形" --duration 60 --intensity 2 --feeling "放鬆"
npx tsx scripts/life_log.ts inspect --date YYYY-MM-DD

重要規則

• sleep 以起床日期為主日期；跨午夜由 CLI 自動處理。
• 00:00 後入睡需先問原因再儲存。
• diet 寫入後每日彙總自動重算。
• 睡眠同步到 macOS 日曆僅在 config 開啟且 macOS 上自動；首次會編譯小助手 app 並彈一次日曆授權，告訴使用者允許。 日曆失敗絕不阻斷飛書寫入。
• 日曆許可權被拒（點過 Deny）後 macOS 不再彈窗，讓使用者去 系統設定 → 隱私與安全 → 日曆 手動為 "SleepSync" 開啟。
• 運動日曆同步可選，用獨立指令碼。
• 絕不直接呼叫飛書記錄 API / addRecord(s)，也不硬編碼任何 token / 表 ID / 憑證。
• 命令失敗不要改走直接寫飛書重試。

糾正

使用者說記錯了：

1. inspect 該天；
2. 確認改哪條；
3. 定向更新而非重複追加。

附加參考

• 配置引導：references/SETUP.md
• 建表模版（含文章連結）：references/base_template.md
• 記錄示例：references/EXAMPLES.md
• 欄位規則：references/FIELD-RULES.md
• 週期復盤（只讀）：references/review.md

這個工具質量不錯，能幫你記錄飲食、睡眠、運動資料到飛書表格，還能生成周報月報。文件寫得很清楚，示例豐富，配置引導也很貼心，會一步步教你檢查環境和連線飛書。美中不足的是模版需要從作者公眾號付費文章裡找連結才能拿到，對新手不太友好；日曆同步功能只在 Mac 上能用，Windows 使用者暫時用不了這些花活兒。總體來說功能紮實，適合已經在用飛書做自我管理的人。