# 策展 · X (Twitter) 🔥🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Philipp Schmid (@_philschmid) · 平台：X (Twitter) · 日期：2026-07-02

> 原始來源：https://x.com/_philschmid/status/2072371627510423700

## 中文摘要

Philipp Schmid 發布了開源 CLI 工具「ghealth」，讓使用者能透過終端機存取 Fitbit Air 的 40 種健康數據並直接串接至 AI Agent。

**核心功能與應用**
Philipp Schmid 分享的 `ghealth` 專為開發者與 AI Agent 設計，用來簡化與 Google Health API v4 的互動。該工具支援 40 種經過驗證的健康資料類型，包括步數、心率、睡眠階段、血氧濃度（SpO2）及心率變異度（HRV）等。透過 `--detail` 旗標，使用者能獲取更細緻的睡眠階段數據（如清醒、深層睡眠、REM），便於長期分析健康模式。

**安裝與設定指引**
該工具支援透過 `npx` 快速整合至開發環境，並提供完整的 Agent 支援，包含簡化的 JSON 輸出與確定的退出代碼。若要開始使用，請執行以下步驟：

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/7e7ff9a683504f83.jpg)
> 這張圖片展示了 Google Health CLI 的介紹及其相關的指令範例，包含安裝 Agent Skill 與執行資料查詢的指令。

1. 安裝與設定：
   ```bash
   npx skills add Google-Health-API/google-health-cli
   ghealth setup
   ```
2. 執行資料查詢（範例）：
   ```bash
   # 查詢最近 10 筆心率數據
   ghealth data heart-rate list --from today --limit 10
   
   # 查詢一週內的每日步數總和
   ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29
   ```

**專為 Agent 設計的架構**
`ghealth` 具備多項針對自動化流程優化的特性，確保 AI Agent 能穩定運作：
- **自我探索能力**：Agent 可透過 `ghealth schema types` 或 `ghealth data <type> --help` 查詢支援的操作與參數，無需預先讀取完整文件。
- **認證流程**：支援互動式與 Headless 模式（適用於 CI 或無瀏覽器環境），並能處理 OAuth 權杖的匯出與匯入，方便在不同機器間遷移設定。
- **錯誤處理**：當設定缺失時，CLI 會回傳結構化的 JSON 錯誤訊息，並包含 `next_steps` 陣列，讓 Agent 能將引導步驟直接呈現給使用者，無需人工介入解析。
- **資料輸出**：預設輸出簡化後的 JSON 格式，並支援 `--format csv` 或 `--format table`，方便將健康數據直接導入資料分析工具或作為 AI 的上下文（context）。

## 標籤

CLI, Agent, 開源專案, Google, Fitbit