前言

在 Shiro 主题中有一个 「个人状态展示」 功能，可以展示一些自定义的状态。

为了充分利用这个功能，想将手机的健身圆环的数据同步展示在个人状态里，效果如下：

最初计划通过编写 JavaScript 脚本并借助 Scriptable 应用来实现这个想法。然而经过尝试后发现，Scriptable 并不支持 HealthKit，从而无法获取到健康数据。在苹果设备上，应用需要通过 HealthKit 的 API 才能访问健康数据，而 Scriptable 曾尝试集成 HealthKit但是被苹果商店拒绝。所以只能退而求其次，使用苹果自带的快捷指令来实现这一功能。

2026.3.1 更新，由于快捷指令的限制太多，目前已经更换为自己编写的 App + SideStore自签来实现自动推送

状态展示的设置

通过手动设置个人状态展示，可以在控制台中看到页面通过 POST 的方式向 https://{后端服务器}/api/v2/serverless/shiro/status 发送了一个请求：

请求的请求体包含下面这样格式的 JSON：

为了完成更新个人状态的操作，需要先获取访问令牌并且构建请求头 Authorization: bearer {token} 用于验证用户权限。

访问令牌有两种获得方法，第一种是每次设置状态前先发起一次登录请求，在登录请求返回的 JSON 里就能获得一个 xxxxx.xxxxxxxx 格式的访问令牌。

另一种是通过在后台 设定 -> 安全 -> API Token 里新建一个 xxxxxxxxxxxxxx 格式的访问令牌，这里推荐这种方式。

拿到访问令牌后，控制台里验证一下：

成功设置状态。

设计快捷指令

要实现自动同步健康数据到个人状态展示，需要设计一个能获取健康数据、构建请求并调用 API 的快捷指令。在将流程图转换为快捷指令的过程中有几个需要注意的坑：

1. 如果某类数据当天没有记录（如未锻炼），快捷指令会返回空值而不是 0。需要提前设置一个初始值 0 以避免后续拼接描述文本出现问题。
2. 如果想要数据与苹果健康的健身记录面板数据一致，需特别注意「站立 x 小时」（Stand Hours）的统计方式。它反映的是达标次数，而非实际站立时长。其计算逻辑为：每个小时内，只要累计站立时间达到或超过 1 分钟，即算作 1 小时达标。例如，08:00 - 08:01 站立，09:30 - 09:31 站立，会被记录为 2 小时达标。相比之下，快捷指令获取的「站立分钟数」（Stand Time）是每次站立的实际分钟数。因此，若要统计「站立 x 小时」，需通过计数的方式统计每小时是否达标，而非直接累加站立分钟数。使用指令表达如下：

3. 当接口成功设置状态时，仅返回 204 状态码且不返回任何内容，加上快捷指令本身不支持直接对 HTTP 状态码进行详细判断，因此只能通过判断返回文件的大小是否为 0 来确认设置是否成功。

由于快捷指令太长了，所以放快捷指令。

快捷指令完整流程如下（超级长图警告）：