欢迎使用 AAPS 说明文档

Version 3.3
29/12/2024 : 3.3版本发布. 查看发行说明以了解新功能并获取更新说明。
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)和胰岛素泵。 这部分内容概述了您将要经历的过程,并提供了获取 AAPS 全部功能的大致时间表。(安全起见,有些功能是需要您完成一些学习和使用的小任务之后才会开放,比如闭环功能) 本节帮助您在技术上做好准备,以尽可能快速和高效地完成您的AAPS安装调试工作。 CGM配置这一小节解释了如何优化CGM设置,以及数据平滑选项的最优配置方法。
现在,您已经对整个过程有了扎实的理解,可以开始组建您的AAPS闭环系统了。
第3节设置AAPS 包含了每一步操作的说明。 包括选择和配置远程数据服务器(Nightscout或Tidepool),以便您可以查看和分享数据,准备好电脑以构建AAPS应用程序,构建AAPS应用程序并将其传输到手机上。 还涵盖了通过“设置向导”来设置 AAPS,将AAPS与您的CGM以及真实或虚拟的胰岛素泵进行连接,以及将 AAPS 连接到您的远程数据服务器。 接下来,您将通过一个安全审慎方式,一步一步地了解AAPS的全部功能用法,以确保您或者您的孩子能充分掌握所有不同等级的功能和菜单设定,有了足够的使用经验之后你才能使用更高级别的APP功能,教程才会进入下一环节,也就是所谓的“下一个目标”。 这些目标都经过专门的设计,目的是逐渐解锁AAPS从开环到闭环越来越多的功能。
第4节AAPS的日常 介绍了关键的 AAPS 功能,帮助您使用(和自定义)AAPS。 包括理解屏幕显示内容、活性碳水、敏感度、配置文件切换、临时目标、碳水补录(或称eCarbs)、自动化和动态ISF(DynamicISF)。 它还涵盖了一些常见话题,如如何管理不同类型的餐食、如何更换管路和探头、智能手机更新、夏令时变化,以及使用AAPS旅行和运动。 常见问题和答案位于故障排除部分。
第5节远程 AAPS 功能 强调了 AAPS 的真正优势。 不管是远程发送指令,还是仅仅跟踪来自AAPS的数据,AAPS都提供了很多的选择。 不管是想为孩子使用 AAPS 的家长,还是想要比在手机上(手表上,在车上 等等)更方便地监测血糖(及其他指标)的成年糖人,再或者是其他需要检测数据的人来说,AAPS的功能都同样有用。 这一节还提供了Android Auto的使用指南,以便您可以在车上查看血糖水平。
第6节 Wear OS的智能手表 讲的是Wear OS系统的安卓手表的使用,手表可以设定上专用的AAPS表盘或者自定义表盘,这样我们可以通过手机进行远程遥控,或者把手表作为数据显示器。
第7节 AAPS的维护 讲述了如何导出和备份您的设置(如果您的手机丢了或者坏了的时候不至于抓瞎),提供了最新版本说明,并详细介绍了如何更新 AAPS。 一般来说,AAPS每年会有一个新版本,中间会需要更新2-3次。 跟其他所有软件一样,您最好及时更新AAPS,这样才能修复一些发现的小问题,也能用上一些改进的功能。 在故障排除章节专门有一部分内容讲AAPS更新的常见问题。
第8节** 寻求帮助** 会告诉您遇到 AAPS 相关的问题到哪里求助最管用。 特别是在最开始,有这样的指引能让你不会觉着孤立无助,遇到问题也能尽快联系到其他人然后弄清问题、解决问题。 尽管很多人已经顺利用上了AAPS,但谁都会遇到自己无法独立解决的问题。 得益于庞大的用户群,问题提出以后通常几个小时内就能收到回复。 不要因为觉着自己的问题太低级就不好意思开口求助,没有不能问的问题。 不论是新手还是老鸟,只要对系统的顺利搭建和安全运行有帮助,我们期盼大家尽可能多地提出问题。 本节包括 AAPS 和 AAPSClient(跟踪监控数据的程序)常见故障的处理方法,如果您发现AAPS存在需要关注和解决的技术问题,这里也介绍了如何将您的 AAPS 数据(日志文件)发送给开发人员以便查找问题原因。
第9节涵盖了高级AAPS选项的内容,比如如何从使用AAPS进行混合闭环(餐时大剂量_等_)发展到完全闭环(无需手动大剂量),以及开发和工程模式的细节。 对绝大多数用户来说,AAPS的正式版本已经够使了,但总会有些大牛,即便已经用的很好了,还想着继续折腾更深入的功能,这一节的内容主要是给他们看的。
在第10节如何支持AAPS,我们提供了一些有用的信息,以便您能为这个项目提供一些支持。 你可以捐钱、捐设备或捐知识。 你可以对文档的改进提建议,也可以直接下手改,还可以参与到文档翻译中来,或者向开放人类项目(the Open Humans project)提供一些你的数据。
第11节 资料包含了很多文档,有的内容面向对AAPS之类的开源人工胰腺技术感兴趣的临床医生,有的内容面向希望和医生交流相关信息的病人。 这一节还有更多关于糖尿病和闭环的参考资料。 包括术语表,也就是AAPS 中使用的缩写(或简称)清单。 举例来说,想知道ISF或TT代表什么意思就去这里找。
有兴趣开始使用 AAPS? 在 引言 中阅读更多关于AAPS的信息
SAFETY NOTICE
AAPS的安全性依赖于你的硬件装备(手机、泵、动态)的安全功能。 一定要使用经过FDA/CE核准的功能完全正常的胰岛素泵和动态。 不要使用坏的、改装过的或者自制的胰岛素泵或者动态。 泵和动态一定要使用原装或者厂商认证的耗材(助针器、管路和储药器)。 使用未经测试或者改装过的耗材可能造成数据不准确或者胰岛素输注剂量错误,那样可能把使用者置于极其危险的境地。
SGLT-2 抑制剂(格列吡嗪)能降糖,如果服用这种药的话就不要使用 AAPS 。 如果减少胰岛素的剂量会增加糖尿病酮症酸中毒(DKA)的风险,过分追求较低的血糖水平会增加严重低血糖的风险。
Disclaimer
这里提供的所有信息和代码仅用于信息交流和教育目的。 使用 Nightscout 和 AAPS 的后果自负,本文档提供的信息和代码请勿用于医疗决策。 Nightscout 目前尚未尝试达到 HIPAA 隐私规定。
文中来自 github.com 的代码未经正式授权也没有任何官方支持。 更多细节请查阅本代码仓库的许可协议(LICENSE)。
所有产品、公司名称、商标、服务标识、注册商标和注册服务标志归其所有者所有。 使用他们仅是作为参考,并不意味着与他们有任何联系或得到过他们的认可。
请注意 - 本项目与以下机构或个人没有任何关系,也未经其确认背书:SOOIL-秀逸, Dexcom-德康, Accu-Chek, Roche Diabetes Care-罗氏 or Medtronic-美敦力
AAPS文档索引
2) 入门
- AAPS简介
- 什么是“人工胰腺系统”(APS)?
- 什么是混合闭环(hybrid closed loop)?
- 闭环的由来?
- 什么是 Android APS (AAPS)?
- AAPS的基本组成部分有哪些?
- AAPS系统有哪些优势?
- AAPS与MDI(每日多次胰岛素注射)和开环的比较
- AAPS与其他闭环系统的比较
- AAPS是否使用人工智能或任何机器学习算法?
- 哪种系统适合我或我的家人?
- 像AAPS这样的开源系统安全吗?
- 如何与我的临床医生团队讨论AAPS?
- 为什么我不能直接下载 AAPS 并直接使用?
- AAPS 系统的连接性如何?
- AAPS 如何不断发展和完善?
- 哪些人可以从 AAPS 受益?
- 我可以从 AAPS 获得哪些好处?
- 准备使用AAPS
- 设备概览
- - 兼容的胰岛素泵
- - 兼容的动态(CGM)
- - 兼容的手机
- - 兼容的手表
3) AAPS设置
- 配置远程数据服务器
- - Nightscout
- - Tidepool
- 构建(Building)AAPS
- 传输和安装AAPS
- 安装向导
- 完成目标
- 你的AAPS配置文件
- 调整AAPS参数设置
- - 设置向导
- - 首选项
4) AAPS的日常
- AAPS 界面
- AAPS关键特性
- COB计算
- 敏感性检测
- 切换配置文件 & 配置文件百分比
- 临时目标
- 扩展碳水
- 自动操作
- 自动操作示例
- Automating Preference Settings Export
- 自动操作日志
- 动态胰岛素敏感系数(Dynamic ISF)
- 用于儿童的AAPS
- 泵与管路
- 跨时区旅行 & 夏令时
5) 远程 AAPS 功能
6) Wear OS 智能手表
- 构建AAPS Wear OS应用
- 在您的Wear OS手表上安装AAPS
- 远程控制
- 自定义表盘参数
- Custom Watchface Format
- JSON Structure
- How to build/design your first Watchface
- Advanced features
- Key and KeyValue reference
- 自定义表盘交换网站
7) AAPS的维护
- 导出/导入设置
- 回顾你的数据
- AAPS发布公告
- Android version and AAPS version
- WearOS version
- Version 3.3.1.3
- Version 3.3.1.2
- Version 3.3.1.0
- Version 3.3.0.0
- Version 3.2.0.0 dedicated to @Philoul
- Version 3.1.0
- Version 3.0.0
- Version 2.8.2
- Version 2.8.1.1
- Version 2.8.0
- Version 2.7.0
- Version 2.6.1.4
- Version 2.6.1.3
- Version 2.6.1.2
- Version 2.6.1.1
- Version 2.6.1
- Version 2.6.0
- Version 2.5.1
- Version 2.5.0
- Version 2.3
- Version 2.2.2
- Version 2.2
- Version 2.1
- Version 2.0
- 文档更新
- January 2025
- December 2024
- November 2024
- October 2024
- February 2022
- January 2022
- December 2021
- November 2021
- October 2021
- September 2021
- June 2021
- April 2021
- March 2021
- February 2021
- January 2021
- December 2020
- October 2020
- September 2020
- June 2020
- May 2020
- April 2020
- March 2020
- February 2020
- January 2020
- December 2019
- November 2019
- October 2019
- September 2019
- August 2019
- 升级到新版本的AAPS
8) 寻求帮助
- 去哪里寻找帮助
- 常见故障
- Troubleshooting Android Studio
- Lost keystore
- Gradle Sync failed
- Generate Signed APK generated successfully with 0 build variants
- App was created with compiler/kotlin warnings
- No CGM data is received by AAPS
- Apk not installed
- Apk installed but old version
- None of the above worked
- Worst case scenario
- 获取日志
9) 高级AAPS选项
10) 如何支持 AAPS
- 如何提供帮助
- 编辑文档
- 一般
- Code syntax
- Tables
- Style Guide
- Contents
- 1. English language writing tips
- Use language that is appropriate for the reader
- Privacy/licensing concerns:
- Keep sentences short, get to the point
- Don’t be afraid to give instructions
- Mostly use active verbs, rather than passive verbs
- Avoid nominalisations
- Use lists where appropriate
- Mythbusting
- Optimizing writing style by purpose
- 2. AAPS-specific writing/updating notes
- 3. Useful References
- 参与应用和文档的翻译
- 翻译声明
- 开放人类项目上传
11) 资料
- 术语表
- FAQ
- 一般
- APS algorithm
- Other settings
- Frequent questions on Discord and their answers…
- My problem is not listed here.
- My problem is not listed here but I found the solution
- AAPS stops everyday around the same time.
- How to organize my backups ?
- I have problems, errors building the app.
- I’m stuck on an objective and need help.
- How to reset the password in AAPS v2.8.x ?
- How to reset the password in AAPS v3.x
- My link/pump/pod is unresponsive (RL/OL/EmaLink…)
- Build error: file name too long
- Alert: Running dev version. Closed loop is disabled
- Where can I find settings files?
- How to configure battery savings?
- Pump unreachable alerts several times a day or at night.
- Where can I delete treatments in AAPS v3 ?
- Configuring and Using the AAPSClient remote app
- I have a red triangle / AAPS won’t enable closed loop / Loops stays in LGS / I have a yellow triangle
- Can I move an active DASH Pod to other hardware?
- Procedure I follow in this:
- How do I import settings from earlier versions of AAPS into AAPS v3 ?
- 常用糖尿病和闭环资料
- 为AAPS建立专用Google账户 (可选)
- 临床医生参考 (已过期)
- The steps for building a DIY Closed Loop:
- How A DIY Closed Loop Works
- How data is gathered:
- How does it know what to do?
- Examples of AAPS algorithm decision making:
- Here are examples of the purple prediction lines, and how they might differ:
- Here are examples of different time frames that influence the needed adjustments to insulin delivery:
- Scenario 1 - Zero Temp for safety
- Scenario 2 - Zero temp for safety
- Scenario 3 - More insulin needed
- Scenario 4 - Low temping for safety
- Optimizing settings and making changes
- OpenAPS
- Summary