Apple Health アナリスト — ローカルで解析する健康レポート生成ツール

Data

概要

apple-health-analyst は、iPhone の「ヘルス」アプリからエクスポートした Apple Health データをローカルで解析し、睡眠・心拍変動(HRV)・活動・トレーニングなどの指標を横断的に結びつけて解釈するツールです。単なる可視化ではなく「健康顧問」のようにデータの相関や行動パターン(例:週末戦士、夜型化、回復不足)を検出し、睡眠・回復・活動の三軸で 0–100 の総合スコアを算出します。出力は CSS/SVG を埋め込んだ単一のオフライン HTML レポートで、外部 API を使わず完全にローカルで動作するためプライバシー性が高く、手軽に結果を確認できます。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 13
  • フォーク数: 2
  • ウォッチャー数: 13
  • コミット数: 15
  • ファイル数: 11
  • メインの言語: TypeScript

主な特徴

  • Apple Health エクスポートをローカルで解析し、オフラインで単一HTMLレポートを生成
  • 睡眠–HRV、トレーニング–回復といったクロス指標の相関分析と可視化
  • 行動パターン検出(週末戦士・夜型・睡眠補償・回復不足など)
  • 説明可能なアルゴリズムによる睡眠/回復/活動の総合スコア(0–100)

技術的なポイント

本プロジェクトは TypeScript を用い、Apple Health のエクスポートを取り込み(README にある手順に従う)、時系列データの前処理、指標抽出、相関解析、行動パターン検出、スコアリング、そして単一ファイルの HTML レポート出力という一連のパイプラインをローカルで完結させる構成です。注目点は「オフラインで自己完結」する設計で、データは端末外部へ送信されないためプライバシーが保たれます。また、出力レポートは inline CSS と SVG を使って視覚化を埋め込み、依存を減らして双クリックで閲覧できる利便性を確保しています。解析面では複数指標の時間的相関(例:睡眠品質と翌日の HRV、直近のトレーニング負荷と回復指標のバランス)を扱い、単純な統計量にとどまらない「行動パターン認識」ロジックを実装している点が特長です。TypeScript による型安全性やコードの可読性も確保されており、アルゴリズムは説明可能性を重視して設計されているため、結果の根拠を追いやすい構造になっています。現状は単一ユーザー向けのオフライン解析に最適化されており、将来的な改善点としてはデータフォーマットの拡張、モジュール化による再利用性向上、テストカバレッジの拡充、より高度な時系列解析(例:機械学習モデルによる予測)への対応が考えられます。(約700字)

プロジェクトの構成

主要なファイルとディレクトリ:

  • .agents: dir
  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • docs: dir

…他 6 ファイル

まとめ

ローカル完結で説明可能な健康解析とシンプルなオフラインレポート生成に特化した実用的ツールです。(約50字)

リポジトリ情報:

READMEの抜粋:

apple-health-analyst

本地分析 Apple Health 导出数据,生成带有跨指标关联分析、行为模式识别和综合评分的中文健康报告。

不是数据仪表盘——手机就能看数据。这个工具的价值是像健康顾问一样解读你的数据:睡眠和恢复之间有什么关联?作息规律性如何影响 HRV?训练负荷和恢复能力是否匹配?

查看示例报告

特性

  • 跨指标关联分析 — 睡眠-HRV 联动、训练-恢复平衡、作息规律性评估
  • 行为模式识别 — 周末战士、夜猫子漂移、睡眠补偿、恢复不足
  • 综合评分 — 睡眠/恢复/活动三维度 0-100 分,算法透明可解释
  • 隐私优先 — 完全本地运行,不调用外部 API,不上传任何数据
  • 离线 HTML 报告 — 单文件,内联 CSS + SVG 图表,双击即开

导出 Apple Health 数据

  1. 打开 iPhone 上的健康 App
  2. 点击右上角头像…