前言¶
在 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。