哪些 Hevy 資料會傳送至 Gemini
Hevy 的直接連線能保留結構化的肌力訓練細節，不會把訓練簡化成一般活動，因此對 AI 助理很有用。運動項目、完成組數、次數、重量，以及可取得的 RPE，都能成為可查詢的歷史紀錄。
這些歷史資料可以和 Wellness Project 其他來源的睡眠、恢復、步數及身體資料並列。Hevy 本身不提供這些穿戴裝置指標，因此若要讓助理一併分析訓練和恢復，請另外連接恢復或健康資料來源。
Gemini 不會收到整批穿戴裝置匯出資料。它會透過 Gemini 中已授權的自訂 MCP 應用程式，向 Wellness Project 索取回答問題所需的受支援資料列。
如何將 Hevy 連結至 Gemini
你的設定畫面可能略有不同。
AI 助理經常調整設定與導覽。選單名稱與步驟可能會因網頁版、桌面版或行動版用戶端、裝置與作業系統、方案、帳戶類型、版本及分階段推出而不同。請將本頁說明視為目前的指引；如果你的版本不同，請尋找對應的 Apps、Connectors、Plugins 或 MCP 控制項。
建立 Hevy API 金鑰
Hevy 僅開放 Hevy Pro 使用 API。請在 Hevy 的開發者/API 設定中建立個人 API 金鑰。
在 Wellness Project 連接 Hevy
開啟 Settings → Devices → Hevy，貼上個人 API 金鑰並開始首次同步。此整合會直接從 Hevy 讀取訓練歷史資料。
檢查每組訓練的詳細資料
在 Wellness Project 中開啟近期訓練，確認預期的運動名稱、組數、次數、重量和可取得的 RPE 都已匯入。
在 Gemini 中將 Wellness Project 新增為自訂應用程式
在 gemini.google.com 開啟「Settings」→「Connected apps」（或「Personal intelligence」→「Connected apps」）。在「Custom apps」下選擇「Add a custom app」，貼上 https://wellnessproject.ai/api/mcp，點選「Next」，然後登入並授權。不需要用戶端憑證。
向 Gemini 詢問真實歷史資料
先指定明確的日期範圍和問題。例如：「過去八週，哪些舉重動作的訓練重量增加了？」接著，助理就能擷取 Wellness Project 中的相關資料列，不必根據截圖或單次匯出檔推論。
連結 Hevy 後，可以問 Gemini 什麼
實用的提示詞會比較你自己的長期歷史資料。以下範例根據此來源實際傳送至 Wellness Project 的資料設計。
- 過去八週，哪些舉重動作的訓練重量增加了？
- 比較主要肌群每週的高強度訓練組數，並指出訓練量停滯之處。
- 從上個月以來，哪些運動的次數或負荷進步最明顯？
Hevy → Wellness Project → Gemini 資料傳輸路徑的限制
必須使用 Hevy Pro，因為 Hevy 將 API 存取權限限定在此方案。
此整合用於匯入訓練歷史資料，不會讓 Hevy 變成睡眠、HRV 或恢復指標的來源。這些指標請使用其他已連線的資料來源。
Gemini 是透過已授權的 Wellness Project MCP 連線讀取資料，並非使用 Gemini 開發者提供的原生 Hevy 整合功能。
連結 Hevy，再向 Gemini 提問。
將支援的歷史資料同步至 Wellness Project、授權 Gemini，直接根據真實趨勢提問，不必匯出檔案或貼上截圖。
