Apple Health アナリスト — ローカルで解析する健康レポート生成ツール
概要
apple-health-analyst は、iPhone の「ヘルス」アプリからエクスポートした Apple Health データをローカルで解析し、睡眠・心拍変動(HRV)・活動・トレーニングなどの指標を横断的に結びつけて解釈するツールです。単なる可視化ではなく「健康顧問」のようにデータの相関や行動パターン(例:週末戦士、夜型化、回復不足)を検出し、睡眠・回復・活動の三軸で 0–100 の総合スコアを算出します。出力は CSS/SVG を埋め込んだ単一のオフライン HTML レポートで、外部 API を使わず完全にローカルで動作するためプライバシー性が高く、手軽に結果を確認できます。(約300字)
リポジトリの統計情報
- スター数: 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字)
リポジトリ情報:
- 名前: apple-health-analyst
- 説明: 説明なし
- スター数: 13
- 言語: TypeScript
- URL: https://github.com/RuochenLyu/apple-health-analyst
- オーナー: RuochenLyu
- アバター: https://avatars.githubusercontent.com/u/1207465?v=4
READMEの抜粋:
apple-health-analyst
本地分析 Apple Health 导出数据,生成带有跨指标关联分析、行为模式识别和综合评分的中文健康报告。
不是数据仪表盘——手机就能看数据。这个工具的价值是像健康顾问一样解读你的数据:睡眠和恢复之间有什么关联?作息规律性如何影响 HRV?训练负荷和恢复能力是否匹配?
特性
- 跨指标关联分析 — 睡眠-HRV 联动、训练-恢复平衡、作息规律性评估
- 行为模式识别 — 周末战士、夜猫子漂移、睡眠补偿、恢复不足
- 综合评分 — 睡眠/恢复/活动三维度 0-100 分,算法透明可解释
- 隐私优先 — 完全本地运行,不调用外部 API,不上传任何数据
- 离线 HTML 报告 — 单文件,内联 CSS + SVG 图表,双击即开
导出 Apple Health 数据
- 打开 iPhone 上的健康 App
- 点击右上角头像…