檔案:隨時可得的 CSV、JSON 和 GPX
Marrow 擁有的一切,想要時就能變成一個檔案。本頁列出每種匯出的確切內容,讓試算表、腳本或醫師知道自己在看什麼。
所有 Marrow 指南: MCP · 自架鏡像 · 自動化操作 · 檔案 · 支援
按鈕在哪裡
匯出、手動。在最上方選擇範圍和格式。下面每個區段會產生一個檔案並交給分享選單,所以它可以送到「檔案」、AirDrop、郵件,或任何接受檔案的 App。沒有任何東西會被上傳到任何地方。
每日指標
Marrow 追蹤的每一個 Apple Health 資料序列,每天一個值,涵蓋 30 天、90 天、一年或全部。可以挑選特定指標,也可以全選。
- CSV(
marrow-daily-DATE.csv):每天一列,每個指標一欄,欄位依字母排序,每個標題都附上儲存單位:date,active_energy (kcal),body_mass (kg),step_count (count),… - CSV(長表)(
marrow-daily-long-DATE.csv):date,metric,value,unit,每個指標每天一列。這是 pandas、R 和樞紐分析表想要的格式。 - JSON(
marrow-daily-DATE.json):與自動化操作資料內容相同的每日總計.
同樣資料的兩次匯出,位元組完全相同,所以檔案可以乾淨地做差異比對和版本控管。
營養日記
每一筆記錄的餐點及其完整營養素細節。CSV 欄位:day,meal,name,grams,kcal,protein_g,carbs_g,fat_g,logged_at,extra,其中 extra 是該筆記錄所帶的所有其他營養素的 JSON(纖維、糖、鈉、維生素…)。JSON 把記錄巢狀放在各天底下。
重訓記錄
每一組正式組(不含熱身組),以次數和重量表示,附上估算的 1RM、每次訓練各動作的進步情況,以及各肌群的訓練量。重量採用你在設定、單位中選的單位,欄位名稱會標明:date,session,exercise,set,weight_lb,reps,est_1rm_lb,set_type(或 _kg),其中 set_type 是 work、failure 或 drop.
症狀與心情
你在 Apple Health 記錄的每個症狀,附上 Apple 以文字表示的嚴重程度,以及每筆 State of Mind 記錄,包含其愉悅程度、你選的感受,以及感受的對象。CSV 或 JSON,可用於追蹤或與醫師分享。同樣的資料序列也可以在每日指標匯出和自動化操作中選取。
體能訓練路線
所選範圍內每次記錄了 GPS 的訓練各一個 GPX 檔。可用 Strava、Google Earth、Komoot 或任何地圖工具開啟。
單位
指標檔案沿用 Apple Health 儲存的單位(kg、m、mL、°C、kcal),而且一定會標示,所以試算表或腳本永遠不必猜。App 本身則依你在設定、單位中的選擇顯示。重訓檔案也依這個選擇。
疑難排解
- 所選範圍內沒有餐點、組數或記錄。每個區段都匯出「匯出、手動」最上方所選的範圍(30 天、90 天、1 年或全部)。請選較長的範圍,或先確認資料已在 Marrow 中。
- 某個指標不見了,或它的欄位是空的。Marrow 只能匯出 Apple Health 讓它讀取的內容。在「健康」App 中,點右上角的照片,然後依序點 App、Marrow,並開啟該項目。接著在 Marrow 的設定、Apple Health 存取權限中,於「正在從 Apple Health 讀取」底下點再次讀取。
- 這個範圍內沒有帶 GPS 路線的體能訓練。只有記錄了路線的訓練(例如戶外步行、跑步和騎車)才有路線。室內訓練永遠沒有。如果你確定有路線,請確認 Marrow 在「健康」App 中被允許讀取體能訓練路線(App、Marrow)。
- 無法讀取路線。Apple Health 回傳了錯誤,訊息就是這句話。請再試一次,如果重複發生,請如上所述檢查體能訓練路線的存取權限。
- 分享選單裡沒有地方可放。選擇儲存到檔案,把檔案留在手機或 iCloud Drive,或用 AirDrop 傳到 Mac。任何能開啟 CSV、JSON 或 GPX 檔的 App,安裝後都會出現在分享選單中。
- 試算表只顯示一長欄。檔案是以逗號分隔的。請以逗號分隔符號匯入為 CSV,不要當作純文字開啟。CSV(長表)更適合樞紐分析表。
- 數字看起來不對。指標檔案沿用 Apple Health 儲存的單位(kg、m、mL、°C、kcal),並在每個標題中標明。重訓檔案依設定、單位。
- 你每週都匯出同樣的東西。自動化操作可以依排程送出,App 不用開著。
各個 App 的步驟,包括 Google Sheets 和 Strava,都在連線底下.
什麼時候選檔案
檔案最適合一次性的需求:試算表、醫師、資料科學 notebook、備份。如果你發現自己在定期匯出,自動化操作可以不用你動手就做到同樣的事,而想要查詢而不是讀檔案的智慧代理,應該使用 MCP.