前言¶
在 DeepSeek Harness（DSH）裏做健康類工作流時，常見做法是手寫腳本解析 Apple 健康導出的 export.xml，再單獨跑分析、排版。步驟分散，也不方便讓 agent 在會話裏一鍵完成。下面介紹社區插件 dsh-healthkit-report（維護者 little-fire9552，分類：工作流）：安裝後在 DSH 中註冊 healthkit_report 工具，把導出文件解析、去重設備記錄，並輸出 DOCX、XLSX、HTML 等格式的報告。倉庫已內置 python/ 源碼，使用者不必再單獨安裝 healthkit-report 本體。
這是什麼¶
dsh-healthkit-report 是面向 DSH 的插件，一句話定位：把 Apple 健康導出（export.xml 或解壓目錄）變成去重後的體檢報告。實現方式是在 Cordis 側通過 patch 增加 agent 工具 healthkit_report，由插件 bundled 的 Python 邏輯完成 parse / analyze / report。當前 package 版本爲 1.1.0，許可證 MIT。GitHub 倉庫：https://github.com/little-fire9552/dsh-healthkit-report；社區目錄頁：https://www.skillhub.cn/plugins/little-fire9552/dsh-healthkit-report。
核心功能¶
依據 README 與 package.json 描述，已覈實能力包括：
- 解析
export.xml（或指向含該文件的目錄）。 - 對設備記錄做去重（README 與 description 均提到 de-duplicate device records）。
- 按
action分步或一次性執行：parse、analyze、report、all。 - 輸出格式可在
docx、xlsx、html中選取子集；支持since/until日期過濾與報告上的patient_name。 - 跨平臺：macOS、Windows、Linux；插件會優先使用 DSH 自帶的 Python（macOS 下
dependencies/python/bin/python3，Windows 下dependencies/python/python.exe或Scripts/python.exe），找不到再退回 PATH 中的python3/python。
安裝與啓用¶
使用前需爲插件 Python 依賴安裝兩個第三方庫（與 healthkit-report 本體無關）：
python3 -m pip install python-docx XlsxWriter
在 DSH 中安裝插件（步驟來自 README，勿自行拼接 CLI 安裝命令）：
- 打開左側 插件 → 右上角 添加插件；
- 粘貼本倉庫地址
https://github.com/little-fire9552/dsh-healthkit-report，或本地克隆後的目錄絕對路徑； - 安裝完成後，插件列表應出現 Apple 健康報告。
若調用時報 No module named 'docx'，說明當前默認 python3 未裝上述依賴，可重新執行 pip 安裝，或在工具參數中指定 python=/path/to/python3。
注意： 插件以當前 DSH 進程權限運行；安裝前請自行查看倉庫源碼與 MIT 許可證，確認可接受後再啓用。
典型用法¶
在任意會話中可以用自然語言驅動，例如：
幫我分析 Apple 健康數據，生成體檢報告
也可以直接讓 agent 調用工具（路徑請改爲你本機的絕對路徑）：
healthkit_report action=all export=/path/to/export.xml out=out
常用參數如下（與 README 一致）：
| 參數 | 說明 |
|---|---|
action |
parse / analyze / report / all |
export |
export.xml 或解壓目錄的絕對路徑 |
dataset |
parse 產出的 dataset.json（供 analyze / report 使用） |
out |
輸出路徑 |
patient_name |
報告上的姓名 |
formats |
docx,xlsx,html 的子集 |
since / until |
日期過濾 |
python |
指定解釋器（默認 HEALTHKIT_PYTHON 或 python3） |
分步使用時：先用 action=parse 得到 dataset.json，再對 analyze / report 傳入 dataset 與 out。
適用場景與注意¶
適合已在 iPhone 上導出 Apple 健康數據、希望在 DSH 會話或 agent 工作流裏統一完成解析與報告生成的開發者。不適合沒有 export.xml、或無法在運行 DSH 的機器上安裝 python-docx / XlsxWriter 的環境。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件在 GitHub 上當前星標爲 1，功能邊界以倉庫 README 爲準。修改插件 index.js 後需重啓 DSH 纔會生效。
結尾¶
dsh-healthkit-report 把 Apple 健康導出與報告生成收攏到 DSH 的一個工具裏，減少腳本 glue 代碼。需要細節時可直接查閱目錄頁 https://www.skillhub.cn/plugins/little-fire9552/dsh-healthkit-report 與源碼倉庫 https://github.com/little-fire9552/dsh-healthkit-report。
