准备开始使用 AAPS

欢迎。本文档旨在指导正在准备设置并开始使用 Android 人工胰腺系统（AAPS）的用户。

如何查阅文档

文档结构的索引及其说明可以在这里找到；您也可以点击文档左上角的 AAPS 符号访问该索引。您将在那里看到各个文档部分用途的概览。您还可以使用本页面左侧的标题在文档中导航。最后，在 AAPS 符号的正下方还有一个方便的搜索功能。

我们的目标是帮助您轻松了解 AAPS 的功能和局限性。花费时间阅读文档后，才发现自己可能没有兼容的胰岛素泵或 CGM，或者 AAPS 提供的功能与预期不同，这可能会令人失望。

AAPS 文档中许多与实际体验相关的细节，在您实时使用 AAPS 时会更容易理解。正如仅靠阅读规则很难学会一项运动一样，您需要先学习安全运行 AAPS 的基本规则，然后在开始使用 AAPS 时逐步了解如何最好地应用这些规则。

安全第一

“能力越大，责任越大……”

技术安全

AAPS 具有一整套完善的安全功能。这些功能会施加限制，而这些限制将通过分阶段完成一系列目标逐步解除；这些目标包括测试特定参数和回答选择题。随着目标逐一完成，AAPS 的功能会逐步解锁。这个过程让用户在学习 AAPS 各项功能的同时，能够安全地分阶段从开环迁移到闭环。

目标的设计旨在尽可能为您提供良好的 AAPS 入门体验，同时考虑了 AAPS 开发人员观察到的新用户常见错误和总体趋势。初学者可能因为缺乏经验、急于开始使用 AAPS，或忽略了关键要点而犯错。目标旨在尽量减少这些问题。

医疗安全

避免对眼睛和神经造成永久性且痛苦的损伤

请注意血糖控制快速改善和 HbA1c 降低的风险

一个重要的安全事项是：对于血糖水平长期偏高的人来说，快速降低 HbA1c 并改善血糖控制可能造成永久性损伤。许多糖尿病患者并不了解这一点，而且并非所有临床医生都会向患者说明这一问题。

这种损伤可能包括视力丧失和永久性神经病变（疼痛）。通过更缓慢地降低平均血糖水平，可以避免发生这种损伤。如果您目前的 HbA1c 偏高，并准备开始使用 AAPS（或任何其他闭环系统），请在开始之前与您的医疗团队讨论这一潜在风险，并与他们共同制定逐步降低血糖目标的安全时间表。您可以先在 AAPS 中设置较高的血糖目标（目前可选择的最高目标是 10.6 mmol/L；如有需要，您也可以暂时使用刻意偏弱的基础率配置），然后在接下来的数月中逐步降低目标。

在不增加永久性损伤风险的情况下，我可以多快降低 HbA1c？

一项针对 76 名患者的回顾性研究报告称，如果 HbA1c 在 6 个月内分别下降 1%、2% 或 3%，视网膜病变进展的风险会分别增加 1.6 倍、2.4 倍和 3.8 倍。研究人员建议：“任何 6 个月期间 HbA1c 值的下降都应限制在 2% 以下，以防止视网膜病变进展……在开始控制血糖时下降过快，可能导致视网膜病变进展严重或短暂加重。”

注意：如果您使用不同的 HbA1c 单位（mmol/mol，而不是 %），请点击这里使用 HbA1c 计算器工具。

在另一项针对 954 名患者的回顾性评估中，研究人员指出：

“如果 HbA1c 在 3 个月内下降 2–3 个百分点，发生糖尿病治疗诱发性神经病变的绝对风险为 20%；如果 HbA1c 在 3 个月内下降超过 4 个百分点，发生糖尿病治疗诱发性神经病变的绝对风险将超过 80%。”

关于这项工作的评论也认为，为了避免并发症，**目标应是在 3 个月内将 A1c 降低不到 2%。**您可以在这里和这里阅读有关该主题的其他综述。

通常认为，_新诊断_的 1 型糖尿病患者（他们在诊断时、开始胰岛素治疗前，往往具有非常高的 HbA1c）似乎可以在确诊后立即快速降低 HbA1c，而不会在同等程度上遇到这些风险，因为他们并没有经历如此长时间的高血糖。不过，这仍然是需要与临床医生讨论的事项。

不要使用 SGLT-2 抑制剂

不要使用 SGLT-2 抑制剂

SGLT-2 抑制剂也称为 gliflozin（格列净），会抑制肾脏对葡萄糖的重吸收。格列净会不可预测地降低血糖，因此在使用 AAPS 这样的闭环系统时，您绝对不能服用这类药物！这会显著增加酮症酸中毒和/或低血糖的风险！将这类药物与会降低基础率以升高 BG 的系统结合使用尤其危险。

简而言之：

  • 示例 1：低血糖风险

午餐时，您根据摄入 45 g 碳水化合物使用 AAPS 计算并输注大剂量。问题在于，AAPS 不知道这些抑制剂会使身体排出部分碳水化合物，结果是相对于实际吸收的碳水化合物，体内胰岛素过多，从而导致低血糖。

  • 示例 2：酮症酸中毒风险

这些抑制剂在后台排出部分碳水化合物，使 BG 降低。AAPS 会自动指示泵减少胰岛素输注，包括基础率。随着时间推移，这可能导致您的 BG 持续低于目标值，以至于体内没有足够的背景胰岛素来处理所吸收的碳水化合物，最终发生酮症酸中毒。通常，T1D 患者发生酮症酸中毒是因为胰岛素泵发生故障，这会触发手机警报，并且高 BG 值也会让人察觉。然而，格列净的危险在于：泵仍然正常运行，BG 可能仍处于目标范围内，因此 AAPS 不会发出警报。

SGLT-2 抑制剂的常见品牌名称包括：Invokana、Farxiga、Jardiance、Glyxambi、Synjardy、Steglatro 和 Xigduo XR 等。

使用 AAPS 进行闭环的关键原则

在使用 AAPS 之前，必须了解闭环的关键原则和概念。为此，您需要投入时间阅读 AAPS 文档并完成目标；这些目标旨在为安全、有效地使用 AAPS 打下坚实基础。AAPS 文档的篇幅一开始可能让人望而生畏，但请保持耐心并相信这个过程——采用正确的方法，您一定能够掌握它！

每个人的进度都不同，但请注意，完成所有目标通常需要 6–9 周。许多人会在真正开始使用 AAPS 之前就开始构建、安装和设置 AAPS。为此，系统提供了一个“虚拟泵”，您可以在完成早期目标期间使用它，从而熟悉 AAPS，而无需真正用它输送胰岛素。下文会详细说明大致时间安排；请注意，完成 AAPS 的目标 8 时，您已经进入闭环。后续目标会加入 SMS 命令和自动化等附加功能，这些功能对部分用户很有用，但并不是 AAPS 核心功能所必需的。

要成功使用 AAPS，需要采取积极主动的态度，愿意分析 BG 数据，并灵活地对 AAPS 做出必要调整，以改善治疗结果。正如仅靠阅读规则几乎不可能学会一项运动一样，AAPS 也不能只靠读文档来掌握。

为设置和运行过程中的延迟及小问题做好准备

在开始使用 AAPS 的早期阶段，您可能会遇到各种困难，例如让闭环的所有组件彼此（以及潜在的关注者）有效通信，或微调设置。有些问题只有在日常使用 AAPS 后才能解决，但 Facebook 群组和 Discord 上提供了大量帮助。请提前做好安排，选择“合适”的时间排查并解决问题，例如周末安静的早晨（不要选深夜、疲倦时，或大型会议或旅行前）。

技术兼容性

AAPS 仅兼容特定型号的胰岛素泵、CGM 和手机，而且某些技术可能无法在部分国家/地区使用。为避免失望或挫折，请阅读 CGM、泵和手机部分。

应用构建时间及逐步进入完整闭环

构建 AAPS 应用所需的时间取决于您的专业知识和技术能力。通常，对于没有经验的用户来说，在社区帮助下，构建 AAPS 可能需要半天到一整天。随着您越来越熟悉流程，构建较新版本 AAPS 所需的时间会明显缩短。

为帮助您完成构建，文档中设有以下专门部分：

达到闭环需要多长时间取决于个人；使用 AAPS 达到完整闭环的大致时间范围可以在这里找到。

密钥库和配置设置导出文件

“密钥库”（.jks 文件）是您自己的 AAPS 副本所独有的密码加密文件。Android 手机使用它来确保没有密钥库的其他人无法升级您的副本。简而言之，作为构建 AAPS 的一部分，您应该：

  1. 将密钥库文件（用于签署应用的 .jks 文件）保存在安全的地方；

  2. 记下密钥库文件的密码。

保存密钥库的方式取决于您的构建方法：

  • Android Studio（计算机）构建：密钥库会在构建过程中创建——请参阅生成签名的 APK，了解应将其保存在哪里。

  • AAPS Builder：请保留创建密钥时设置页面提供的备份文件 aaps-keystore.jks，以及对应的密码和别名。如果您上传了自己的密钥库，请保留该文件。

  • 使用 fork 的浏览器构建：使用专用的导出密钥库工作流，将副本下载到 Google Drive。

这样可以确保每次创建 AAPS 更新版本时，都能使用完全相同的密钥库文件。平均而言，AAPS 每年需要更新 2 次。

此外，AAPS 还支持导出所有配置设置。这样，在更换手机、升级或重新安装应用时，您可以安全地恢复系统，并将中断降至最低。

故障排除

如果有任何不确定的地方，请随时联系 AAPS 社区——没有所谓的愚蠢问题！我们鼓励各种经验水平的用户提问。由于 AAPS 用户众多，问题通常能够很快得到回应。

在 AAPS Facebook 群组提问
在 AAPS Discord 频道提问

去哪里寻求帮助？

本节旨在为新用户提供求助资源链接，包括获取社区支持。这个社区由新用户和经验丰富的用户组成，他们可以解答问题，并帮助您避开使用 AAPS 时常见的陷阱。

临床医生部分

这是一个专门面向临床医生的部分，帮助他们进一步了解 AAPS 和开源人工胰腺技术。简介中还提供了如何与您的医疗团队讨论 AAPS的指导。

我们要构建和安装什么？

该图概述了 AAPS 系统的关键组件（硬件和软件）：

preparing_overview

除了三个基本硬件组件（手机、泵和葡萄糖传感器）之外，我们还需要：

  1. AAPS 应用

  2. 报告服务器，以及

  3. 连续血糖监测（CGM）应用

1) Android 手机应用：AAPS

AAPS 是一款运行在 Android 智能手机和设备上的应用。您将按照分步指南，先从 GitHub 下载 AAPS 源代码，在计算机上安装必要的程序（Android Studio、GitHub Desktop），然后构建自己的 AAPS 应用副本（一个 apk 文件）。之后，您需要将 AAPS 应用传输到智能手机（通过电子邮件、USB 数据线 等）并安装。

2) 报告服务器：NightScout（Tidepool*）

为了充分利用 AAPS，您需要设置 Nightscout 服务器。您可以自行设置，也可以支付少量费用，请托管式 Nightscout 服务代为设置。Nightscout 用于长期收集 AAPS 数据，并生成关联 CGM 与胰岛素模式的详细报告。照护者也可以使用 Nightscout 与 AAPS 应用进行远程通信，以监督孩子的糖尿病管理。此类远程通信功能包括实时监测血糖和胰岛素水平、远程发送胰岛素大剂量（通过短信）以及宣布进餐。

将 CGM 数据与泵数据分开查看来分析糖尿病管理效果，就像司机是盲人、由乘客描述周围景象一样。对于 AAPS 3.2 及更高版本，Tidepool 也可以作为 Nightscout 的替代方案。

3) CGM 传感器应用

根据您使用的葡萄糖传感器/CGM，您需要使用兼容的应用接收葡萄糖读数并将其发送给 AAPS。下面列出了不同选项；有关更多信息，请参阅兼容的 CGM 部分：

dexcom_options libre_options eversense_options

AAPS 系统维护

随着改进版本的发布，Nightscout 和 AAPS 大约需要每年更新一次。在某些情况下，更新可以延迟；在其他情况下，则强烈建议更新，或认为更新对安全至关重要。Facebook 群组和 Discord 服务器会发布更新通知。发行说明会明确说明具体属于哪种情况。更新时可能会有许多人提出与您类似的问题，您也会获得执行更新所需的支持。

设置好所有内容需要多长时间？

如前所述，使用 AAPS 更像是一段需要投入个人时间的“旅程”，而不是一次性设置。目前估计，构建 AAPS、安装和配置 AAPS 与 CGM 软件，以及使用 AAPS 从开环过渡到混合闭环，总共需要约 4–6 个月。因此，建议您尽快优先构建 AAPS 应用并完成早期目标，即使您仍在使用其他胰岛素输送系统（在完成目标 5 之前，您可以使用虚拟泵）。

部分目标要求经过规定的天数，以确保您理解新功能。这个等待时间无法绕过；这些最短时限是出于您的安全而设定的。

以下是大致时间安排：

任务

大约时间

初步阅读文档

1–2 天

安装/配置 PC 以支持构建

2–8 小时

设置报告服务器

1 小时

安装 CGM 应用（xDrip+、BYODA、…）

1 小时

初步配置 CGM → xDrip+ → APPS

1 小时

初步配置 AAPS → 泵

1 小时

配置 AAPS → Nightscout/Tidepool（仅报告）

1 小时

可选：配置 NightScout ↔ AAPS 和 NSFollowers

1 小时

目标 1：设置可视化和监测

1 小时

目标 2：学习如何控制 AAPS

2 小时

目标 3：证明您掌握相关知识

最多 14 天

目标 4：开始使用开环

至少 7 天

目标 5：了解您的开环

7 天

目标 6：开始闭环（低血糖暂停）

至少 5 天，最多 14 天

目标 7：调试闭环

至少 1 天，最多 7 天

目标 8：调整基础率和比率，启用 Autosens

至少 7 天，最多 14 天

目标 9：启用超微量大剂量（SMB）

至少 28 天

目标 10：自动化

至少 28 天

目标 11：动态 ISF

至少 28 天

当 AAPS 完全投入运行后，您仍需要定期微调设置，以改善整体糖尿病管理。

要求

医疗注意事项

除了安全部分中的医疗警告外，还需要根据您在泵中使用的胰岛素考虑不同的参数。

胰岛素选择

AAPS 的计算基于 100U/ml 的胰岛素浓度（与泵的标准浓度相同）。支持以下类型的胰岛素配置预设：

  • 速效 Oref：Humalog/NovoRapid/NovoLog

  • 超速效 ORef：Fiasp

  • Lyumjev：

仅限实验性/高级用户：

  • Free-Peak Oref：允许您定义胰岛素活性峰值

技术要求

本文档旨在将所需的技术专业知识降至最低。您需要使用计算机在 Android Studio 中构建 AAPS 应用（文档提供分步说明）。您还需要通过互联网在公共云中设置服务器、配置多个 Android 手机应用，并培养糖尿病管理方面的专业知识。只要循序渐进、保持耐心，并获得 AAPS 社区的帮助，就可以做到。如果您已经能够浏览互联网、管理自己的 Gmail 邮件，并让计算机保持最新状态，那么构建 AAPS 是一项可行的任务。请慢慢来。

智能手机

AAPS 与 Android 版本

当前版本的 AAPS（3.4）要求使用搭载 Google Android 12.0 或更高版本的 Android 智能手机。如果您正在考虑购买新手机（截至 2026 年 1 月），建议使用 Android 16。
出于安全原因，强烈建议用户及时更新自己构建的 AAPS。不过，对于无法使用 Android 12.0 或更高版本设备的用户，仍然提供兼容旧版 Android 的早期 AAPS 版本，请参阅：发行说明。

智能手机型号选择

您购买的具体型号取决于所需的功能。您可以在手机页面找到关于可用配置的建议和用户反馈。

我们建议用户及时更新手机的 Android 版本，包括安全参数。不过，如果您是 AAPS 新手或不熟悉技术，可能需要暂缓更新手机，等其他用户在我们的各个论坛中完成更新并确认安全后再进行。

推迟 Samsung 手机更新

Samsung 强制更新手机并由此导致蓝牙连接问题的情况屡有发生。要禁用这些强制更新，您需要按以下步骤将手机切换到“开发者模式”： 前往设置和关于手机，然后打开软件信息；反复点击版本号，直到系统确认您已解锁开发者模式。返回主设置菜单，此时应会看到新的“开发者选项”菜单项。打开“开发者选项”，滚动找到“自动系统更新”，并将其关闭

Google Play Protect 的潜在问题

已有多份报告称，Google Play Protect 会在每天早上随意关闭 AAPS。如果发生这种情况，您需要进入 Google Play 选项并禁用“Google Play Protect”。并非所有手机型号或所有 Android 版本都会受到影响。