欢迎使用 AAPS 说明文档

Latest Release
4 June 2026 : Version 3.4.2.3 is out. Check the Release Notes to see what’s new and follow the instructions in the update manual to update.
Android APS (AAPS) 是一个开放源码的安卓应用程序,适用于糖尿病依赖型(I型)糖尿病患者。 是一款可以在安卓智能手机上运行的人工胰腺控制软件。 其主要功能是通过运用OpenAPS算法来模拟正常的胰腺功能:通过自动胰岛素输注(Automated Insulin Dosing,AID)将血糖水平保持在正常限度内。 使用AAPS要用到3种设备:**(1)一部安卓手机,(2)动态血糖仪(CGM),(3)经过FDA/CE认证的胰岛素泵。 另外,如果你希望远程控制AAPS、远程存储查看相关数据,你还需要(4)相应的云服务器,以及(5)**一块智能手表。
本文档解释了如何设置和使用 AAPS。 您可以通过左侧的菜单浏览 AAPS 文档(以及方便的”搜索文档”功能), 或者使用此页面底部的 索引进行导航。
AAPS 文档概述(“说明书”)
第2节“入门”, 简介 部分对人工胰腺系统(APS)的设计初衷作了详细说明。 概述了闭环的背景, AAPS 的开发初衷,并把 AAPS 与其他类似系统进行了比较,对一些使用安全问题做了声明。 该章节提供了与医疗团队沟通 AAPS使用的建议。解释了为什么您需要自己去构建(build,将软件源代码转换为可以安装和运行的应用程序的过程) AAPS 应用,而非直接下载安装,并说明了AAPS系统的典型设备连接方式。 同时涵盖无障碍使用设计及AAPS适用人群说明。
AAPS准备工作章节详细介绍了更多关于安全考量,以及与AAPS兼容的手机、动态血糖仪(CGM,Continuous Glucose Monitors)和胰岛素泵。 这部分内容概述了您将经历的流程,并提供了实现 AAPS 全部功能的大致时间表。(安全起见,有些功能是需要您完成一些学习和使用的小任务之后才会开放,比如闭环功能) 本节帮助您在技术上做好准备,以便尽可能快速高效地搭建AAPS系统。 动态血糖仪(CGM)配置这一小节解释了如何优化动态血糖仪(CGM)设置,以及数据平滑选项的最优配置方法。
现在,您已充分了解整个流程,可以开始组建您的AAPS闭环系统了。
第3节设置AAPS 包含具体的分步操作说明。 它涵盖了选择并设置你的报告服务器(Nightscout 或 Tidepool)以便你查看和分享数据,以及为构建 AAPS 应用做好准备、构建应用并将其传输到手机的整个流程。 同时指导您通过“设置向导”来完成 AAPS 应用的初始化配置,将其与动态血糖仪(CGM)应用及真实/虚拟胰岛素泵进行联动,并将 AAPS 连接到您的远程数据服务器。 接下来,您将通过一个安全审慎的分阶段训练流程,一步一步地掌握AAPS的全部功能,该流程旨在确保您/您的孩子能完全熟悉并熟练操作所有不同层级的功能和菜单设置,然后才进入下一阶段(AAPS界面上称之为”目标(Objectives)”)。 这些目标(Objectives)都经过专门的设计,将循序渐进地解锁AAPS更多可能性,最终实现从开环模式向闭环模式的过渡。
第4节AAPS的日常 涵盖 AAPS 的关键功能,帮助您使用(和自定义)AAPS。 内容包括理解操作界面、活性碳水(COB,carbs-on-board)、敏感度、配置文件(profile)切换、临时目标(TT,temp targets)、扩展碳水(extended carbs,eCarbs)、自动化规则(automations)和动态ISF(DynamicISF)。 同时涉及常见主题,例如如何管理不同类型的餐食、处理管路(cannula)与探头(sensor)更换、智能手机更新、夏令时调整、使用AAPS旅行及运动场景。 常见问答详见故障排查章节。
第5节远程 AAPS 功能 强调了 AAPS 的真正优势。 用户可通过多种方式远程发送指令或单纯查看AAPS数据, 该功能既适用于想用 AAPS孩子血糖的家长,也便于成年糖尿病患者通过智能手表、车载设备_等_多端便捷监测血糖及其他指标,同时支持重要亲友共同查看数据。 这一节还提供了Android Auto的使用指南,实现车载血糖监测。
第6节 Wear OS的智能手表 讲的是如何搭配Android Wear OS系统的智能手表,来使用AAPS专属表盘或自定义表盘,既可以作为手机远程控制器,也可以作为显示终端。
第7节 AAPS的维护 讲述了如何导出和备份您的设置(手机丢失或损坏时不至于抓瞎),提供了最新版本说明及AAPS更新操作指南 。 预计每年发布1个新版本及2-3次强制更新, 跟其他所有软件一样,您需要及时更新AAPS以修复潜在问题并优化系统性能。 本节设有“更新”问题排查专区,解答常见疑问。
第8节** 获取帮助指南将引导您快速找到AAPS的技术支持资源。 该指南能帮助您快速联系社区成员,解答疑问并规避常见问题。 尽管很多人已经顺利用上了AAPS**,但遇到疑难时仍需寻求帮助。 得益于庞大的用户群,问题提出以后通常几个小时内就能收到回复。 不要因为觉着自己的问题太低级就不好意思开口求助,没有不能问的问题。 无论使用者经验水平如何,我们都鼓励积极提问以确保安全使用。 本节包括 AAPS 和 AAPSClient(其配套数据查看应用)常见故障的排查方案,并说明当AAPS系统出现技术故障时,如何向开发者发送AAPS数据(日志文件)进行分析。
第9节涵盖了高级AAPS选项的内容,比如如何从使用AAPS进行混合闭环(需手动注射餐时大剂量_等_)进阶至全闭环模式(无需手动注射大剂量),以及开发和工程模式的细节。 对绝大多数用户来说,AAPS的主版本(”Master”版)即可满足需求,但总会有些大牛,即便已经用的很好了,还想着继续折腾更深入的功能,这一节的内容主要是给他们看的。
在第10节如何支持AAPS,我们提供了一些有用的信息,以便您能为这个项目提供一些支持。 您可通过捐款、捐赠设备或贡献专业知识助力项目发展。 也可自行提出或修改文档内容、协助文档翻译,并通过Open Humans项目共享个人数据。
第11节 资料包含了很多文档,有的内容面向对AAPS之类的开源人工胰腺技术感兴趣的临床医生,有的内容面向希望和医生交流相关信息的病人。 这一节还有更多关于糖尿病和闭环的参考资料。 包括术语表,也就是AAPS 中使用的缩写(或简称)清单。 举例来说,想知道ISF或TT代表什么意思就去这里找。
想要开始使用 AAPS? 请参阅引言部分进一步了解AAPS。
SAFETY NOTICE
AAPS的安全性依赖于你的硬件装备(手机、泵、动态)的安全性能。 请务必使用经FDA/CE认证且功能完整的胰岛素泵及动态血糖仪(CGM)。 禁止使用损坏、改装或自制的胰岛素泵或动态血糖仪。 泵和动态一定要使用原装或者厂商认证的耗材(助针器、管路和储药器)。 非官方测试或改装配件可能导致数据误差及胰岛素输注错误,从而对使用者构成重大风险。
请勿在使用SGLT-2抑制剂(格列净类药物)期间使用AAPS。 此类药物会降低血糖水平。由于胰岛素输注量减少及血糖水平降低,可能增加糖尿病酮症酸中毒(DKA)及低血糖风险。
Disclaimer
本文所述所有信息及代码仅供教育参考之用。 使用 Nightscout及AAPS需自行承担风险,相关内容不可作为医疗决策依据。 Nightscout目前未针对HIPAA隐私合规性进行特别设计。
文中来自 github.com 的代码未经正式授权也没有任何官方支持。 更多细节请查阅本代码仓库的许可协议(LICENSE)。
所有产品、公司名称、商标、服务标识、注册商标和注册服务标志归其所有者所有。 使用他们仅是作为信息传递目的,不暗示任何关联或官方认可。
请注意 - 本项目与以下机构或个人没有任何关系,亦未获得其认可:SOOIL-秀逸, Dexcom-德康, Accu-Chek, Roche Diabetes Care-罗氏,Insulet以及 Medtronic-美敦力。
AAPS文档索引
2) 入门
- AAPS简介
- 什么是“人工胰腺系统”(APS)?
- 什么是混合闭环(hybrid closed loop)?
- 闭环的由来?
- 什么是 Android APS (AAPS)?
- AAPS的基本组件有哪些?
- AAPS系统有哪些优势?
- AAPS与MDI(每日多次胰岛素注射)和开环(open loop)的比较
- AAPS与其他闭环系统的比较
- AAPS是否使用人工智能或任何机器学习算法?
- 哪种系统适合我或我的家人?
- 像AAPS这样的开源系统安全吗?
- 如何与我的临床团队讨论AAPS?
- 为什么我不能直接下载 AAPS 并直接使用?
- AAPS 系统的连接性如何?
- AAPS 如何不断发展和完善?
- 哪些人可以从 AAPS 受益?
- 我可以从 AAPS 获得哪些好处?
- 准备使用AAPS
- 设备概览
- - 兼容的胰岛素泵
- - 兼容的动态(CGM)
- - 兼容的手机
- - 兼容的手表
3) Setting up AAPS
- Setting up the reporting server
- - Nightscout
- - Tidepool
- Building AAPS
- - Browser Build
- - Android Studio Build
- - CLI Build
- Transferring and Installing AAPS
- Setup Wizard
- Your AAPS Profile
- Change AAPS configuration
- - Config Builder
- - Preferences
- Completing the objectives
4) AAPS的日常
- AAPS 界面
- AAPS关键功能
- Loop mode
- Autosens
- Super Micro Bolus (SMB)
- Advanced Meal Assist (AMA)
- Overview of hard-coded limits
- COB的计算
- 敏感性检测
- 配置文件切换 & 配置文件百分比
- 临时目标(Temp-Targets)
- 扩展碳水(Extended carbs)
- 自动化规则(Automations)
- 动态胰岛素敏感系数(Dynamic ISF)
- 将AAPS用于儿童
- 泵与管路(cannulas)
- 跨时区旅行 & 夏令时
5) 远程 AAPS 功能
6) Wear OS 智能手表
7) Maintenance of AAPS
- Export/Import Settings
- Reviewing your data
- AAPS Release Notes
- Android版本与AAPS版本
- WearOS版本
- Version for 3.4.2.3
- Version 3.4.2.2
- Version 3.4.2.1
- Version 3.4.2.0
- Version 3.4.1.0
- Version 3.4.0.0
- Version 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
- Version 1.0
- Documentation updates
- March 2026
- 2025年1月
- December 2025
- October 2025
- August 2025
- 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月
- Updating to a new version of AAPS
- - Browser Update
- - Android Studio Update
8) 获取帮助
- 在哪里可以获得 AAPS 的帮助
- 通用故障排除
- - 蓝牙故障排除
- 配置文件调优指南
- Android Studio 故障排除
- 访问日志文件
9) 高级AAPS选项
- 全闭环(Full Closed Loop)
- What to expect?
- General considerations why (not to) move from HCL to FCL
- Well-tuned hybrid closed loop
- Fast insulin (Lyumjev, Fiasp)
- Prerequisites
- Meal-related limitations
- Preparing for activity/sports
- Hurdles for kids
- Enabling boosted SMBs: safety
- Meal detection/your Automations for boosting
- Hypo prevention
- 故障排除
- 开发分支(Dev branch)
- 自动调校(Autotune)
10) 如何支持 AAPS
11) 资料
- 术语表
- FAQ
- 常规
- APS算法
- 其他设置
- Discord上的常见问题及其解答…
- 我的问题不在此列。
- 我的问题不在列表中,但我已找到解决方法
- AAPS每天大约在同一时间停止运行。
- 如何整理我的备份?
- 我在构建应用程序时遇到问题和错误。
- 我被卡在一个目标上,需要帮助。
- 如何在AAPS v2.8.x中重置密码?
- 如何在AAPS v3.x中重置密码?
- 我的连接/胰岛素泵/Pod无响应(RL/OL/EmaLink等设备)
- 构建错误:文件名太长
- 警告:正在运行开发版本。 闭环已禁用。
- 在哪里可以找到设置文件?
- 如何配置电池节能设置?
- 胰岛素泵无法连接警报每天或夜间多次出现。
- 我可以在AAPS v3中删除治疗记录吗?
- 配置和使用AAPSClient远程应用程序
- 我出现红色三角形警告 / AAPS无法启用闭环模式 / 循环始终处于LGS状态 / 我出现黄色三角形警告
- 能否将运行中的DASH Pod迁移到其他硬件?
- 我在此过程中遵循的操作流程如下:
- 如何将早期版本的AAPS设置导入到AAPS v3中?
- 常用糖尿病和闭环资料
- 为AAPS建立专用Google账户 (可选)
- 临床医生参考 (已过期)