技術概覽

Gymios,
深入底層。

對架構、資料取捨和 Apple 整合的精確解讀。狀態標籤區分哪些已整合到程式碼中、哪些仍需在實體硬體上驗證。

iPhone 和 Apple Watch 版 Gymios 已在 App Store 推出。Mac 版將於稍後推出。

Gymios 資料政策
  1. 01
    「健康」App相容欄位的主要來源
  2. 02
    已驗證的來源裝置或已確認的匯入
  3. 03
    Gymios 補充僅在資訊缺少時
保留來源 · 不捏造任何數值
優先順序規則

「健康」App 中的資料不會被覆寫。

對於「健康」App 提供的資訊,Gymios 將此來源視為參考。Gymios 的資料可以補充缺少的欄位,但不會悄悄取代「健康」App 中既有的數值。

  1. 01
    優先讀取「健康」App

    體重、身高、睡眠、心率、心理狀態或體能訓練僅在獲得授權後讀取,並附上日期和來源。

  2. 02
    核對其他來源

    藍牙資料、辨識出的文件或匯入的輸入都會保留其來源。未經驗證的敏感數值需等待確認。

  3. 03
    補充缺少的資訊

    Gymios 的個人資料和問卷只詢問缺少的資訊。拒絕或略過某項資料不會妨礙對其他資訊的分析。

  4. 04
    僅在同意後寫入

    戶外運動、相容的測量資料或感受只有在獲得相應授權後才會加入「健康」App。匯入 Gymios 備份不會修改或刪除「健康」App 中的資料。

主要來源的行為
來源角色控制會覆寫「健康」App 嗎?
「健康」App相容欄位的參考依類別授予 Apple 權限不適用
裝置或匯入可追溯的補充測量技術和人工驗證否
Gymios 輸入補充缺少的資訊使用者的明確操作否
Gymios 分析衍生且可解釋的觀察時間範圍、來源和涵蓋範圍可見否
原生 Apple 架構

每個框架都有清楚的範圍。

Gymios 以原生 SwiftUI App 的形式開發。系統整合彼此隔離,因此拒絕某項授權不會停用不依賴它的模組。

UI

SwiftUI

為每種螢幕調整的 iPhone、Apple Watch 和 Mac 介面,無障礙元件和原生導覽。

已整合
DB

SwiftData

訓練課、營養、已確認的測量資料、目標和偏好設定在本機隨時可用。

已整合
HK

HealthKit

依類別讀寫,集中管理權限,保留來源,且不在 CloudKit 中進行整體備份。

裝置驗證
WC

WatchConnectivity

訓練課的接續、已規劃的路線,以及能等待連線恢復的傳輸佇列。

實體配對驗證
MK

MapKit + Core Location

GPS 軌跡、配速、分段、沿道路規劃的路線、GPX 匯入/匯出以及戶外運動資料庫。

長時間驗證
CK

私有 CloudKit

在 Apple 帳號的私有資料庫中,對明確授權的類別進行選用同步。

預設關閉
BT

Core Bluetooth + FTMS

偵測符合標準的跑步機、單車和划船機,在測試型號之前不承諾相容性。

硬體驗證
VI

Vision + OCR

在本機辨識標籤、食物和候選數值,確認前一律先呈現給你。

已整合
詳細目錄

進階功能,依領域逐一介紹。

「已整合」狀態描述的是現有程式碼。它無法取代所註明的裝置測試、製造商授權或專業驗證。

⌁

訓練

已整合
  • 現成訓練課資料庫、收藏和自訂訓練課
  • 依目標、程度、時長、器材和偏好推薦
  • 運動/休息計時器、訓練課恢復和 Watch 傳輸
  • 動作說明、肌肉部位和動作示範
  • 包含肌力訓練和戶外活動的目標
↗

戶外運動和路線

實地驗證
  • 由你開始 GPS 記錄的步行、跑步和騎車
  • 距離、時間、速度、配速、暫停、爬升和分段
  • 可重新命名的紀錄、收藏、1 到 5 分評分和排序
  • 在 Mac 上建立沿道路規劃的路線,並傳送到 iPhone/Watch
  • GPX/TCX 匯入和匯出、偏離提醒和受保護的恢復
♥

健康與感受

需要實際的 HealthKit
  • 「健康」App 權限統一管理中心
  • 體重、身高、睡眠、心臟、恢復和可見的來源
  • 選用問卷,補充缺少的資訊
  • 如有「健康」App 中的心理狀態資料,則優先使用
  • 自適應觀察,不捏造資料,不做診斷
◒

營養

需要確認
  • 餐點日誌、份量、飲水和趨勢
  • 以有來源的營養資料建立的資料庫
  • Open Food Facts 條碼查詢,不傳送健康資料
  • 標籤 OCR 和本機照片辨識
  • 缺少的數值顯示為無法取得,絕不捏造
◉

連網裝置

逐一型號
  • 適用於相容跑步機、單車和划船機的 FTMS
  • 透過「健康」App 連接體重計
  • 受限的血糖匯入,先隔離再確認
  • 依品牌提供配對協助,不虛假承諾支援
  • 優先採用唯讀方式,避免任何意外指令
◎

社群與同意

基礎已整合
  • 模組預設關閉,可隨時撤銷
  • 選用的使用者名稱、私密個人資料和自選的可見性
  • iCloud 同步僅限非醫療類偏好設定
  • 不會自動匯入通訊錄
  • 私密代碼、邀請、封鎖和檢舉均已整合;內容審核流程需在開放前驗證
★

目標與獎盃

自願分享
  • 個人目標、連續天數和視覺慶祝
  • iPhone 和 Mac 上的直向陳列櫃,每層三個獎盃
  • 透過系統分享使用者選擇的摘要
  • 選用的 Game Center,僅限成就辨識碼和進度
  • 發布到圈子或社群,連接 Gymios HTTPS 服務,需要 Apple 登入
✓

教練角色

設定和測試進行中
  • 角色由本人聲明:Gymios 不核實資格,也不要求任何證明文件
  • 專為你已經認識的教練設計,例如健身房的教練,他會用自己的代碼邀請你
  • Apple 登入在伺服器端驗證;更新權杖加密保存,以便在刪除帳號時撤銷登入
  • 未經你同意不分享任何資料,逐一類別授權,並設有結束日期
✦

本機分析

實驗室
  • 只交叉分析真正可用的類別
  • 觀察結果附上時間範圍、涵蓋範圍和來源
  • 選用的 Apple Intelligence,用於對已計算出的結論重新排序
  • 模型無法直接存取「健康」App
  • 不傳送任何原始醫療文件、自由備註或詳細 GPS 軌跡
☁

Apple 接續互通

簽署待驗證
  • 小工具、複雜功能、智慧型堆疊和即時動態
  • App Intents、Siri 捷徑和深層連結
  • iPhone 和 Mac 空間分別自訂
  • Watch 首頁提供常用捷徑
  • 當系統新功能無法使用時採用傳統備援方案
社群與教練圈子

少分享,
但分享得清清楚楚。

公開社群和教練的私密追蹤是兩個獨立的空間。啟用其中一個絕不會自動取得另一個的存取權。

01 明確啟用

此模組一開始維持私密並處於關閉狀態。之後由使用者選擇自己的使用者名稱、可見性和每一段關係。

已整合的設定
02 自願發布

獎盃僅在授權後發布。教練資料卡只包含已勾選的類別,並區分高度敏感的資料。

已實作,服務待部署
03 自稱的教練

教練角色只是一項聲明。Gymios 不核實資格:你只與自己認識的人分享。

已實作
04 細部同意

接收者、目的、類別、期間和到期日期在存取前確定。伺服器端撤銷立即生效,並會切斷分享的資料卡。

政策和服務已整合
一律不在教練分享範圍內
血糖生殖健康醫療文件iCloud 中的「健康」資料

教練永遠無法直接查看「健康」App。資料卡在本機依據一份封閉的已授權類別清單準備,然後在一個獨立於 iCloud 的服務上加密。

資料邊界

哪些資料會離開 App,哪些不會。

每個管道都有自己的允許清單。啟用某項同步不會自動取得其他類別的存取權。

本機儲存

訓練課、營養、已確認的測量資料、目標和工作資料保留在裝置上。

預設
「健康」App

只有在 Apple 安全介面中所選的類別才會被讀取或寫入。

依類別
私有 iCloud

例行訓練和計畫安排;已規劃的路線和 Gymios 記錄的 GPS 紀錄需分別取得兩項同意。從「健康」App 匯入的戶外運動、心率測量和心率區間、血糖和營養均排除在外。

選用
Game Center

成就辨識碼和完成百分比,不含健康測量資料或詳細路線。

選用
Open Food Facts

僅透過 HTTPS 傳送條碼,用於查詢產品資訊。

第三方服務
社群

非醫療類偏好設定儲存在 iCloud 中;身分、關係、獎盃和教練資料卡儲存在一個獨立的服務上,敏感內容加密儲存。HTTPS API 已部署;開放需等待 Apple 正式環境設定和內容審核驗證。

API 已部署
證據等級

能編譯不等於已驗證。

技術文件將證據分為四個等級。以下步驟說明預期的檢查;硬體驗證和發行驗證仍在進行中。

1已整合的程式碼

編譯功能並測試其可自動化的規則。

2模擬器

在本機檢查介面和無感測器的情境。

3實體硬體

在裝置上檢驗 GPS、Watch、HealthKit、藍牙、電池續航力和中斷情況。

4發行

檢查發行版本的簽署、隱私、輔助使用以及 Apple 的各項要求。

健康範圍

Gymios 提供個人日誌、趨勢和觀察。本 App 不是醫療器材,不提供診斷或治療,也無法取代任何健康、運動或營養專業人員。

追蹤各項功能的實際狀態

發展藍圖將已整合的內容、驗證中的內容和未來方向區分開來。

打開發展藍圖