dsh-healthkit-report: Generating Health Check Reports from Apple Health export.xml in DSH

前言

在 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 安装命令):

  1. 打开左侧 插件 → 右上角 添加插件;
  2. 粘贴本仓库地址 https://github.com/little-fire9552/dsh-healthkit-report,或本地克隆后的目录绝对路径;
  3. 安装完成后,插件列表应出现 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。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye