把健保「健康存摺」、Apple 健康與 CPAP 呼吸器的下載檔，變成一份越養越深、 可搜尋、可帶去回診討論的家庭健康紀錄。全程本機，資料不離開你的電腦。
macOS／Windows 桌面 App · 不需要帳號 · 檢視時不需要網路
（macOS 選 .dmg；Windows 選 .msi 或 .exe。安裝與首次開啟說明見下方
安裝）
屬於 notoriouslab 開源工具組的一員
本軟體僅進行個人健康資料的備份、匯整、搜尋與視覺化排版，不提供任何 醫療診斷、治療、用藥或其他醫療判斷建議。 資料可能不完整或有格式誤差， 畫面上數值的意義請諮詢合格醫事人員。軟體全程本機運作，匯出的檔案含有 完整個人醫療資料，請妥善保管，切勿隨意外傳。
健保署的「健康存摺」只查得到最近三年的就醫與用藥紀錄，Apple 健康的 匯出檔又大又難讀，CPAP 呼吸器的資料則鎖在一張 SD 卡裡。HealthWorkbench 把這些來源整理進同一個本機資料庫：每隔一陣子把新下載的檔案拖進來， 三年的滾動視窗就被接成不斷加深的個人縱深，重複的部分自動跳過， 不會越匯越亂。
打開 App 就是完整的健康儀表板：總覽、就醫、用藥、檢驗、測量、睡眠呼吸 六個分頁，還有全文搜尋。要給家人或帶去診間，可以匯出成單一 HTML 檔或 EPUB 電子書，兩種都是獨立檔案，收到的人不必安裝這個 App，摺疊、搜尋與 趨勢圖照樣能互動。
- 資料留在自己家：健康資料全程留在這台電腦，不註冊、不上傳、不追蹤， 檢視過程零網路請求。想清空一切，刪掉一個資料夾就結束。程式唯一會主動連外 的一次是啟動時檢查有沒有新版本，首次啟動會先問過你（見下方「隱私」）。
- 突破三年視窗：健康存摺只保留最近三年，逐次匯入就能無限期累積； 重複內容自動跳過，同一份檔案匯幾次都不會變亂。
- 全家一台電腦：成員新增、改名、刪除、資料改歸屬（匯錯人救得回來）， 右上角一鍵切換看誰的資料。
- 以藥品為核心的視角：不只按看診日排列，還能按藥品聚合，看出長期 用藥的斷續與劑量變化；每張用藥卡都能展開官方登記的適應症原文。
- 睡眠呼吸與體重可同期對照：匯入 CPAP 呼吸器 SD 卡的整個資料夾， 每晚的 AHI、使用時數、漏氣與治療壓力就進了同一個資料庫，每晚 AHI 的圖與體重、血壓共用同一條時間軸。回診要看的正是這組關係。
- 看診前的十秒：就醫分頁上方固定一塊「近日用藥、居家量測、最近一次 抽血、資料裡的變化」，還能印成一頁帶去看診。
- 帶得走的一份檔案：匯出單檔 HTML 或 EPUB，內容與 App 裡看到的一樣， 互動也還在。電腦用瀏覽器開 HTML，手機、平板用電子書 App 開 EPUB。
- 輕到不需要建置：前端是 Preact + htm，原始碼直接入庫，沒有打包步驟，
改完
app/src/的 JS 存檔就生效。
App 內分成六個分頁：總覽、就醫、用藥、檢驗、測量、睡眠呼吸。以下截圖
使用合成的示範資料（人名、院所、診斷皆為虛構，藥品成分、適應症與仿單
連結取自官方開放資料）。這份示範資料可自行重現，也可以拿來試用 App：
node scripts/gen_demo_data.mjs（產出示範資料庫與示範頁面）。截圖本身也是
一個命令：node scripts/gen_screenshots.mjs（讀示範頁面、逐頁拍成
docs/screenshots/）。
體重、血壓、日均步數與最近就診一眼看完，帶年度體重趨勢與最新檢驗快覽。 最新檢驗只列最近幾項，同一天還有其他項目時會標「同日還有 N 項」， 點進去看那一天的全部結果。
這一頁上方固定一塊看診用的區塊，把看診時最常被問到的幾件事集中在一起：
- 近日用藥：就醫日期加給藥日數還沒過的藥，附成分與還剩幾天。自費藥與 保健食品不在健保資料裡，看診時可以自己補充。
- 居家量測：血壓、體重、睡眠時數與呼吸器數據的近 7 天與近 30 天中位數， 並標明那段期間有幾天真的有量到（兩天有量和二十八天有量的中位數，可信度 不一樣）。
- 最近一次抽血：那一天的全部項目與參考值，項目多的時候預設收起來。
- 資料裡的變化：某項檢驗最近連續三次落在參考值之外、以及最久沒驗的 幾項。只陳述資料裡有的事，不做任何判斷。
沒有資料的小節不會出現，四塊都沒有內容時整個區塊不顯示。右上角的 「列印看診摘要卡」可以把這一塊印成一頁帶去看診。
下方是跨院所、跨年度的就醫歷史，依健保檔區分西醫門診、中醫門診、牙醫門診 與藥局調劑，並依年份摺疊。展開單筆可看主診斷、醫令與藥品成分、官方仿單 連結、部分負擔與健保點數，並標注這筆資料來自哪一份匯入檔。有疫苗接種 紀錄時，同一頁另有一區列出日期、疫苗名稱與院所。
以藥品為核心聚合，分成藥品、中醫用藥、診療項目與其他三類，附成分與 官方仿單連結。用藥卡可展開查看官方登記適應症原文（來自藥品許可證開放 資料集，隨版本更新、離線可看），官方登記有用法用量的一併顯示原文。 長條圖每根代表一次處方，高度是給藥日數，長期用藥的斷續與變化看得出來。 這一頁也可以印出用藥清單（分「目前在吃」與「過往」兩區），見下方 「印出來帶去看診」。
檢驗有自己的分頁：全部項目清單（含每項筆數）、選中項目的趨勢圖與該項 逐筆表。灰帶是最近一次報告的參考值區間，方便對照數值落在哪裡；只有 上限或下限的參考值改畫一條虛線並標示上限或下限；格式無法確定的（例如 按年齡分段的長字串）就不畫，原文仍完整列在逐筆表裡。不同院所對同一項 檢驗的不同寫法（如 LDL-Cholesterol 與 LDL-C、大小寫與標點差異）會合成 同一條趨勢線；每個項目附名稱出處與中性說明，不做數值判讀。
Apple 健康與健保成人健檢的量測數據，分成身體、循環、活動、其他四區： 體重（Apple 每日中位數與成人健檢的量測點同圖）、BMI、體脂率、除脂體重、 行走穩定度、血壓、心率、血氧、步數、距離、爬樓層數、能量消耗與運動 記錄。心率、血氧、呼吸速率畫成每日最低到最高的範圍加上每日平均。 有 CPAP 資料時，每晚 AHI 的圖也在這一頁，與體重、血壓共用同一時間 區間，可直接同期對照。時間區間（近三月／近一年／全部）作用於整頁。 沒有對應資料的區塊不會出現，例如沒戴手錶就不會有心率圖。
匯入 CPAP 呼吸器 SD 卡或 Apple 睡眠資料後多出的分頁。CPAP 這邊有每晚 AHI（可展開阻塞／中樞／低通氣分項）、使用時數、漏氣、治療壓力與逐次 呼吸事件，日期以「入睡當晚」為準（一個治療夜自正午起算，與機器的原生 語意一致）；Apple 這邊有睡眠時數（可展開各睡眠階段）、睡眠時數與 CPAP 使用時數的對照、睡眠期呼吸速率與血氧低點。
兩種資料都沒有時，這個分頁不會出現。
到 Releases 下載對應平台的安裝包：
| 平台 | 下載 | 開啟說明 |
|---|---|---|
| macOS | .dmg（Apple Silicon；Intel 版後續提供） |
DMG 內附「使用說明（請先閱讀）.txt」 |
| Windows | .msi 或 .exe（x64） |
一併下載 README-Windows.txt |
- macOS：v0.6.0 起已用 Developer ID 簽章並經 Apple 公證，下載後 直接開啟即可，不需要任何終端機指令。首次開啟時系統會問一次「確定要 打開從網路下載的 App 嗎」，按「打開」就進去了（那是 macOS 對所有下載 程式的標準一次性確認，不是錯誤）。 v0.5.0 以前的版本未簽章，首次開啟需手動放行：按住 Control 點 App 圖示 →「開啟」，或系統設定 → 隱私權與安全性 → 仍要開啟。
- Windows：安裝檔未簽章，SmartScreen 出現時點「其他資訊」→ 「仍要執行」
也可自行建置：cd app && npm ci && npx tauri build（需先安裝 Rust）。
- 下載自己的資料
- 健保：登入健康存摺（myhealthbank.nhi.gov.tw）→ 下載「醫療類」 資料（建議 JSON；XML 也支援）
- Apple：iPhone 健康 App → 個人頭像 → 匯出所有健康資料 → 把 匯出檔（zip 或資料夾）傳到電腦
- CPAP（ResMed）：把呼吸器的 SD 卡插進讀卡機，整張卡（含
STR.edf與DATALOG資料夾）複製到電腦
- 拖進 App：選擇這份資料屬於哪位成員 → 開始匯入。格式自動判別、 重複自動跳過；健保檔會用遮罩身分證核對成員，選錯人會被擋下。 CPAP 直接拖整個資料夾，只有新檔會被處理，插卡幾次都不會重複。
- 看與分享：「資料檢視」分頁直接看；要給家人或帶去診間，就匯出成 HTML 或 EPUB（僅含當前成員的資料，檔案含個資請妥善保管）。兩種格式 怎麼選，見「把匯出檔帶到手機、平板上看」。
目前只有 ResMed S9 AutoSet 經過實機驗證（開發者自用的機器， 從插卡匯入到檢視完整跑過）。
ResMed 記錄卡用的是公開的 EDF 標準，所以 S10、AirSense 這些較新的 機型「理論上」格式相同，但確實沒有測試過，檔案配置或訊號命名 若有差異，可能會判型失敗或數字對不上。其他廠牌（例如 Philips） 目前不支援。
如果你的機型匯不進來、或匯進來以後數字看起來不對，歡迎 開一個 Issue 或直接送 PR。
回報時請特別注意：記錄卡裡是你的健康資料，不要把整份檔案或
STR.edf 上傳到 Issue。描述這些就很夠用了：
- 機型字串：記錄卡根目錄
Identification.tgt裡#PNA那一行 - 卡片最上層有哪些檔案與資料夾（檔名即可，不用內容）
- 畫面上出現的訊息原文
兩種匯出格式的內容完全相同，差別只在用什麼開：
| 格式 | 適合 | 怎麼開 |
|---|---|---|
| 單檔 HTML | 電腦（macOS、Windows） | 瀏覽器直接開 |
| EPUB | 手機、平板 | 用 Apple Books 這類會執行網頁程式的閱讀器開啟，字級可調 |
手機、平板建議用 EPUB。iOS 沒辦法用 Safari 或 Chrome 開啟本機 HTML 檔案，「檔案」App 的預覽又不執行網頁程式，只會一直停在「載入中」； 真要在 iOS 上看 HTML 的話，存進「檔案」App 再用 HTML & Markdown 檢視器 這類 App 開啟也可以。
EPUB 要挑會執行網頁程式的閱讀器。匯出檔保留了摺疊、搜尋與趨勢圖， 這些需要閱讀器支援 EPUB 3 的 scripted content，而多數閱讀器不支援（支援 EPUB 3 不等於支援 scripted content，這是最容易誤會的一點）。
實測可用：Apple Books（macOS 與 iOS 都驗過）、Thorium Reader （跨平台，Windows 上也能用）、Android 的 Reasily。Google Play Books 實測不執行，只會顯示一行提示。其他閱讀器沒有一一測過，開起來若只看到 那行提示就是這個原因，換一個閱讀器，或在電腦上開 HTML 即可。
Books 這邊有一點要留意：只要它的 iCloud 同步是開著的（Mac 預設開著）， 這份檔案就會在 iCloud 有備份。只想留在自己機器上的話，先在「系統設定 → 你的名字 → iCloud → 顯示全部 → 圖書」（iPhone、iPad 是「設定 → 你的名字 → iCloud → 顯示全部 → 圖書」）關掉，再把檔案加進 Books。App 在匯出 EPUB 前也會提醒一次。
兩份可以印，用途不同：
- 看診摘要卡（就醫分頁）：近日用藥、居家量測與資料裡的變化，一頁。 自己帶去看診用。
- 用藥清單（用藥分頁）：藥品與中醫用藥兩節，每節內再分「目前在吃」 與「過往」，目前在吃的標明還剩幾天；沒有給藥日數的品項列在過往並註明。 每列是名稱、成分與最近處方日期，頁首標示成員名、產生日期、就醫資料 截止日與品項檔版本。給藥師或長輩看比較合適。
兩份都在頁尾註明只是就醫溝通的輔助。按下按鈕會叫出系統的列印視窗，由你 自己選擇印出或存成 PDF，全程不連網、程式也不會自己產生檔案。按哪一顆就 只印那一份。
按鈕在匯出的單檔 HTML 裡（用瀏覽器開啟後就看得到）。App 內會顯示操作 指引，帶你先匯出單檔 HTML 再於瀏覽器列印，因為 App 視窗本身不支援系統 列印。EPUB 不提供這兩顆按鈕，各家閱讀器的列印行為無法控制。
- 成員管理：新增、改名、刪除成員（刪除會連同該成員全部資料， 需輸入名稱確認）。
- 一鍵切換：視窗右上角切換成員，儀表板即時跟著換人。
- 匯錯人也救得回來：匯入紀錄裡每份檔案都能「改歸屬」搬給正確 的成員（原始檔刪了也沒關係），或「刪除」後重新匯入；操作前都有 明細預覽與確認。
- 備份與搬家：「匯出資料庫檔…」存一份完整備份，到新電腦用 「匯入既有資料庫檔…」整庫接回。
- 資料只存在你電腦的系統應用程式資料目錄（macOS：
~/Library/Application Support/com.notoriouslab.healthworkbench/； Windows：%APPDATA%\com.notoriouslab.healthworkbench\）， 不上傳、不註冊、不追蹤。 - 檢視過程零網路請求；只有點擊藥品仿單這類外部連結時才會開瀏覽器。
- 啟動時可以檢查有沒有新版本，首次啟動會先問你要不要開。它只查最新的版本號， 不送出你的版本、也不送出任何識別資料（比對在你的電腦上做），而且只通知、 不下載。不想要就關掉：版號那一行的「啟動時檢查新版」按一下即可切換。
- 匯出的儀表板檔名帶
-private字樣、頁首有紅字提醒，內含全部 嵌入資料，請勿外傳。EPUB 若加進 Apple Books，Books 的 iCloud 同步 會讓它在 iCloud 有備份，匯出前 App 會提醒一次。 - 想清空一切：刪掉上面那個資料夾就結束了。
本專案刻意不做醫療判斷、也不擴張功能邊界，協作重點集中在「資料對齊、 整理與搜尋體驗」這三件事：
- 維護解析器：健康存摺的格式會隨政策微調，需要讓解析保持彈性，
遇到沒見過的欄位不要整份匯入失敗。相容性回歸由
tests/fixtures/的合成樣本與 Python 端逐位元組差分對帳把關。 - 補充檢驗項目知識庫：
app/src/knowledge/labs.json目前收錄 49 項 常見檢驗的項目名稱出處與中性說明，歡迎擴充（每筆需附來源與引用日期； 單一分析物的醫令可附 order_codes，讓沒見過的院所寫法靠醫令代碼對到）。 - 看診與手機閱讀體驗：匯出檔已針對窄螢幕調整版面，可印的有兩份 （看診摘要卡與用藥清單，見「印出來帶去看診」）。其他分頁還沒有可以印 的版面，長輩要把整份紀錄印出來帶去看診的話這塊值得補；圖上的數值目前 只有滑鼠停留才看得到，觸控裝置讀不到，也是一塊。
- 擴充 CPAP 機型相容性：目前只實測過 ResMed S9 AutoSet（見
「關於 CPAP 機型的支援範圍」）。手上有其他機型又願意幫忙的話，
最有用的貢獻是回報判型與解析的落差；
app/tests/helpers/make_edf.mjs可以生成合成 EDF 素材，補測試不需要用到真實資料。
開發環境（macOS／Windows 皆可）：
git clone https://github.com/notoriouslab/health-workbench.git
cd health-workbench/app
npm ci # 只裝 Tauri CLI，前端沒有依賴
npx tauri dev # 需先安裝 Rust 工具鏈前端邏輯全在 app/src/，改完存檔即生效，沒有打包步驟。跑測試：
cd app && npm test。
送 PR 前請確認：測試全綠、不夾帶任何真實個人健康資料（data/ 與
App 資料目錄一律不進版本控制，測試只用合成樣本）。
App 的 SQLite 資料庫可供外部工具以唯讀方式（mode=ro）查詢。
給整合方的三個契約：
- schema 穩定性：任何 schema 變更（含只新增欄位）都會遞增
schema_version表的版本號，且只提供前向遷移。破壞性變更（欄位 改名、刪除、語意改變）在 1.0 之後走 major 版號；1.0 之前會在 CHANGELOG 醒目標註。建議整合方鎖定schema_version，版本不符時 拒絕作答，而不是猜欄位繼續跑。 - 分類請用
type欄：encounters.section是健保存摺的原始 區段代碼（r1 西醫門診、r3 牙醫門診等，定義見app/src/adapters/nhi_fieldmap.js），同一區段可能含多種就醫 類型（例如藥局調劑就落在 r1 之下）；type才是正規化後的分類， App 畫面與統計一律以type為準。 - 合成資料不是規格：
scripts/gen_demo_data.mjs產出的示範 資料只用於展示與截圖，可拿來驗流程，但欄位語意請以openspec/specs/的規格為準，不要照合成資料反推。
- App：Tauri 2（Rust 殼只做 SQLite 橋與插件，業務邏輯全在
app/src/的 JS）；前端 Preact + htm（原始碼直接入庫，免建置）。 - 命令列工具：
src/（Python 3.13 標準庫 + PyYAML）自 v0.3 起 凍結新功能，作為 App 匯入引擎的差分驗收基準。常用：bin/hwb import <檔案>、bin/hwb rebuild、bin/hwb status、bin/hwb knowledge update（更新藥品品項快取，唯一主動連網的命令）、bin/hwb knowledge normalize（重算檢驗名稱對照，冪等、不連網）。 - 測試：
cd app && npm test（446 項，含與 Python 的逐位元組 差分對帳、匯入與救援操作的非破壞性紅隊矩陣、檢視器全分頁渲染守衛）；python3 -m pytest tests/；端到端scripts/e2e_idempotency.sh。 - CI：
.github/workflows/app-build.yml（測試＋守衛 → 雙平台建置）；release.yml（推 semver tag → 版本一致性關卡 → 全測試 → 雙平台 建置並發成 release 草稿，零長期密鑰）。 - 規格：
openspec/specs/（Spectra SDD，specs 為單一事實來源）； 健保存摺的官方格式文件在docs/specs/；phase0/為已封存的探索原型。 - 個資紀律：
data/與 App 資料目錄一律不進版本控制；CI 只用 合成測試資料；README 截圖亦為合成資料。開發過程紀錄（proposal／ design／驗證紀錄／交接文件）不進本倉庫：它們的存在目的就是記錄 實測，而實測來源是真人的健康資料，即使只寫筆數與天數，合起來仍構成 可辨識的健康輪廓。