欢迎阅读 AAPS 文档

Android APS(AAPS)是一款面向依赖胰岛素生活的糖尿病患者的开源应用。它是一套运行在 Android 智能手机上的人工胰腺系统(APS)。AAPS 使用 OpenAPS 软件算法,旨在通过自动给药使血糖水平保持在健康范围内,实现真实胰腺的功能。要使用 AAPS,您需要三台兼容设备:(1) 一部 Android 手机、(2) 一台连续血糖监测(CGM)设备,以及**(3)** 一台获得 FDA/CE 批准的胰岛素泵。您还可能需要云服务**(4),用于远程控制 AAPS、共享数据并将数据存储在报告服务器中,此外还需要(5)** 一块智能手表。
本文档介绍如何设置和使用 AAPS。您可以通过左侧菜单(以及方便的“搜索文档”功能)浏览 AAPS 文档,也可以使用本页底部的AAPS 文档索引进行导航。
AAPS 文档概览(“文档”)
第 2) 开始使用 部分的AAPS 简介解释了人工胰腺系统(APS)要实现的基本概念。它概述了闭环的一般背景、开发 AAPS 的原因,将 AAPS 与其他系统进行比较,并说明安全性。它提供了如何与您的临床团队讨论 AAPS 的建议,解释了为什么您需要自行构建 AAPS 应用而不是直接下载,并概述了典型 AAPS 系统的连接方式。本部分还介绍了无障碍性,以及哪些人可能从 AAPS 中受益。
使用 AAPS 前的准备更详细地介绍了安全注意事项,以及与 AAPS 兼容的手机、CGM(连续血糖监测设备)和胰岛素泵。它概述了您将经历的流程,并提供了获得 AAPS 全部功能的大致时间表。本部分帮助您做好技术准备,以便尽快高效地组装 AAPS 系统。其中的CGM 配置小节解释了如何优化 CGM 设置,以及哪些平滑选项最合适。
现在,您已经充分了解了整个流程,可以开始组装您的 AAPS 闭环系统。
第 3) 设置 AAPS 部分包含完成这些工作的分步说明。它涵盖如何选择和设置报告服务器(Nightscout 或 Tidepool)以便查看和共享数据,如何为构建 AAPS 应用做好准备,如何构建 AAPS 应用并将其传输到手机(包括Android 开发者验证,这是 Google 从 2026 年 9 月开始推出的一项会影响自建应用安装的变更)。本部分还介绍如何使用设置向导设置 AAPS 应用,将其与 CGM 应用以及真实或虚拟胰岛素泵连接,并将 AAPS 连接到报告服务器。 您随后会通过一个安全且经过仔细校准的分步流程,逐渐熟悉 AAPS 提供的全部功能。该流程旨在确保您或您的孩子在进入下一阶段(通常称为下一个“目标”)之前,能够充分熟悉并自如地浏览各个级别和菜单配置,直到积累足够经验开始使用应用中提供的更高级选项。 这些目标经过专门设计,会逐步解锁 AAPS 的更多可能性,并从开环切换到闭环。
第 4) 使用 AAPS 的日常生活 部分介绍 AAPS 的主要功能,帮助您使用(并自定义)AAPS。内容包括了解各个界面、餐后碳水化合物(COB)、敏感性、配置文件切换、临时目标、延长碳水化合物(或 eCarbs)、自动化和 DynamicISF。本部分还涵盖常见主题,例如如何管理不同类型的餐食、如何处理插管和传感器更换、智能手机更新、夏令时变更,以及携带 AAPS 旅行和运动。常见问题及答案位于故障排查部分。
第 5) AAPS 远程功能 部分重点介绍 AAPS 的一项真正优势。您可以通过多种方式远程向 AAPS 发送命令,或仅查看 AAPS 的数据。这对于希望为未成年人使用 AAPS 的照护者同样有用;对于患有糖尿病的成年人也很有用,他们可能希望比仅在手机上更方便地监测血糖(例如在手表或汽车中 等),或希望家人也能监测数据。本部分还提供了使用 Android Auto 的指导,以便您在车内查看血糖水平。
第 6) Wear OS 智能手表 部分介绍如何使用 Android Wear OS 智能手表,以及配套的 AAPS 表盘或自定义表盘;手表既可以作为手机的遥控器,也可以仅用作显示指示器。
第 7) AAPS 的维护 部分介绍如何导出和备份设置(如果手机丢失或损坏,这一点非常重要),提供最新版本说明,并详细说明如何更新 AAPS。预计每年会有一个新版本和 2-3 次必要更新。与所有软件一样,您需要进行这些更新,以修复小错误并改进 AAPS。本部分设有专门的“更新”故障排查章节,解答常见问题。
第 8) 获取帮助 部分将帮助您找到获取 AAPS 一般帮助的最佳途径。这非常重要,可以让您尽快与其他人联系、澄清问题并解决常见障碍。已经有许多人成功使用 AAPS,但每个人都会遇到无法独自解决的问题。由于用户数量众多,问题通常能很快得到回复,一般只需几小时。不要担心寻求帮助,没有所谓的愚蠢问题!我们鼓励任何经验水平的用户提出尽可能多的问题,以便安全地开始使用。此部分包含 AAPS 和 AAPSClient(配套的跟随应用)的一般故障排查,还说明了如果您认为 AAPS 存在需要调查的技术问题,如何将 AAPS 数据(日志文件)发送给开发者。
第 9) 部分介绍 AAPS 的高级选项,例如如何从使用 AAPS 进行混合闭环(为餐食等进行大剂量)进阶到完全闭环(无需大剂量),以及开发和工程模式的详细信息。大多数用户只使用主要的或“Master” AAPS 版本就能顺利运行,无需研究这些选项;本部分面向已经拥有良好控制效果、希望进一步改进系统设置的用户。
在第 10) 如何支持 AAPS 部分,我们提供了支持本项目的信息。您可以捐赠资金、设备或专业知识;可以自行建议或修改文档,帮助翻译文档,并通过 Open Humans 项目提供您的数据。
第 11) 资源 部分包含归档或补充文档,其中有面向对 AAPS 等开源人工胰腺技术感兴趣的临床医生的小节,也适合希望与临床医生分享此类信息的患者;简介中也介绍了这一主题。本部分还包含更多糖尿病和闭环相关的参考资料与资源。其中包括AAPS 术语表,列出了 AAPS 中通用的首字母缩略词(或简称)。例如,您可以在这里了解 ISF 或 TT 分别代表什么。
想开始使用 AAPS?请阅读AAPS 简介,进一步了解 AAPS。
安全须知
AAPS 的安全性取决于硬件(手机、胰岛素泵、CGM)的安全功能。只能使用功能完好的、获得 FDA/CE 批准的胰岛素泵和 CGM。不要使用损坏、改装或自行制造的胰岛素泵或 CGM 接收器。只能使用制造商批准用于您的胰岛素泵和 CGM 的原装耗材(插入器、插管和胰岛素储液器)。使用未经测试或改装的耗材可能导致测量不准确和胰岛素给药错误,从而给用户带来重大风险。
如果您服用 SGLT-2 抑制剂(格列净类药物),请勿使用 AAPS,因为它们会降低血糖水平。由于胰岛素输送减少和血糖水平降低,您会增加糖尿病酮症酸中毒(DKA)以及低血糖的风险。
免责声明
此处描述的所有信息和代码仅用于信息和教育目的。使用 Nightscout 和 AAPS 的风险由您自行承担,不要使用这些信息或代码来作出医疗决定。Nightscout 目前未尝试遵守 HIPAA 隐私合规要求。
使用来自 github.com 的代码不提供任何形式的保证或正式支持。详情请查看本仓库的 LICENSE。
所有产品和公司名称、商标、服务标志、注册商标和注册服务标志均归其各自持有人所有。使用这些名称仅用于信息目的,并不表示与其存在任何关联或获得其认可。
AAPS 与以下公司均无关联,也未获其认可:SOOIL、Dexcom、Accu-Chek, Roche Diabetes Care、Insulet 或 Medtronic。
AAPS 文档索引
2) 开始使用
- AAPS 简介
- 使用 AAPS 前的准备
- 组件概览
- - 兼容的胰岛素泵
- - 兼容的 CGM
- - 兼容的手机
- - 兼容的手表
3) 设置 AAPS
- 设置报告服务器
- - Nightscout
- - Tidepool
- 构建 AAPS
- - 浏览器构建
- - Android Studio 构建
- - CLI 构建
- 传输和安装 AAPS
- Android 开发者验证
- 设置向导
- 您的 AAPS 配置文件
- 更改 AAPS 配置
- - 配置构建器
- - 偏好设置
- 完成目标
4) 使用 AAPS 的日常生活
5) AAPS 远程功能
6) Wear OS 智能手表
7) AAPS 的维护
- 导出/导入设置
- 查看您的数据
- AAPS 发行说明
- Android 版本与 AAPS 版本
- WearOS 版本
- 版本 3.4.2.6
- 版本 3.4.2.5
- 版本 3.4.2.4
- 版本 3.4.2.3
- 版本 3.4.2.2
- 版本 3.4.2.1
- 版本 3.4.2.0
- 版本 3.4.1.0
- 版本 3.4.0.0
- 版本 3.3.2.1
- 版本 3.3.2.0
- 版本 3.3.1.3
- 版本 3.3.1.2
- 版本 3.3.1.0
- 版本 3.3.0.0
- 版本 3.2.0.4
- 版本 3.2.0.0 致敬 @Philoul
- 版本 3.1.0
- 版本 3.0.0
- 版本 2.8.2
- 版本 2.8.1.1
- 版本 2.8.0
- 版本 2.7.0
- 版本 2.6.1.4
- 版本 2.6.1.3
- 版本 2.6.1.2
- 版本 2.6.1.1
- 版本 2.6.1
- 版本 2.6.0
- 版本 2.5.1
- 版本 2.5.0
- 版本 2.3
- 版本 2.2.2
- 版本 2.2
- 版本 2.1
- 版本 2.0
- 版本 1.0
- 文档更新
- 2026年6月
- 2026年3月
- 2025年1月
- 2025年12月
- 2025年10月
- 2025年8月
- 2025年5月
- 2025年1月
- 2024年12月
- 2024年11月
- 2024年10月
- 2022年2月
- 2022年1月
- 2021年12月
- 2021年11月
- 2021年10月
- 2021年9月
- 2021年6月
- 2021年4月
- 2021年3月
- 2021年2月
- 2021年1月
- 2020年12月
- 2020年10月
- 2020年9月
- 2020年6月
- 2020年5月
- 2020年4月
- 2020年3月
- 2020年2月
- 2020年1月
- 2019年12月
- 2019年11月
- 2019年10月
- 2019年9月
- 2019年8月
- 更新到新的 AAPS 版本
- - 浏览器更新
- - Android Studio 更新
9) AAPS 高级选项
11) 资源
- 术语表
- 常见问题
- 常规
- APS 算法
- 其他设置
- Discord 中的常见问题及答案……
- 这里没有列出我的问题。
- 这里没有列出我的问题,但我找到了答案。
- AAPS 每天大约在同一时间停止运行。
- 如何整理备份?
- 构建应用时遇到问题或错误。
- 我卡在某个目标上,需要帮助。
- 如何重置 AAPS v2.8.x 中的密码?
- 如何重置 AAPS v3.x 中的密码?
- 我的 Link/泵/Pod 没有响应(RL/OL/EmaLink……)。
- 构建错误:文件名过长
- 提示:正在运行开发版本。闭环已禁用
- 在哪里可以找到设置文件?
- 如何配置电池节省?
- 每天数次或夜间出现胰岛素泵不可达提醒。
- 在 AAPS v3 中哪里可以删除治疗记录?
- 如何配置和使用 AAPSClient 远程应用?
- 我有红色三角形 / AAPS 无法启用闭环 / 闭环停留在 LGS / 我有黄色三角形
- 可以把正在使用的 DASH Pod 移到其他硬件吗?
- 我采用的操作步骤
- 如何将早期版本 AAPS 的设置导入 AAPS v3?
- 糖尿病和闭环综合资源
- AAPS 专用 Google 账号(可选)
- 面向临床医生(已过时)