配置指南
AndroidAPS 简单模式全解析：103 项被接管的设置与它们的作用
我会先从源码中提取每个设置项对应的标题和说明文案，再据此整理出中文说明。
以下是每个参数的用途说明。所有条目在简单模式下都会被隐藏，并且生效值会按表中所示固定；存储值不会改变。
1. 通用、维护与安全模式
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
胰岛素浓度支持 GeneralInsulinConcentration | insulin_concentration_enabled | 关 | 开启 U50/U200 等非 U100 胰岛素的浓度换算；关闭后所有剂量按 U100 计算 |
语言 GeneralLanguage | language | default（跟随系统） | App 界面语言；简单模式下还会忽略已保存语言，直接跟随手机系统 |
配色 GeneralDarkMode | use_dark_mode | dark | App 深色/浅色/跟随系统主题 |
允许客户端控制 HardenedMode | ns_allow_client_control | 开 | 主控机是否接受已配对客户端的控制指令；开启后同时进入“硬化模式”：NS 远程控制关闭、上传强制开启 |
日志数量 MaintenanceLogsAmount | maintenance_logs_amount | 2 | 维护导出时打包发送的日志文件个数 |
日志收件人 MaintenanceEmail | maintenance_logs_email |
| 日志/设置导出邮件的目标邮箱 |
Fabric 崩溃上报 MaintenanceEnableFabric | enable_fabric2 | 开 | 是否向 Fabric 上报崩溃与诊断数据 |
覆盖勿扰模式 AlertOverrideDoNotDisturb | alert_override_dnd | 开 | 报警时是否突破系统“勿扰”模式发声 |
2. 概览按钮与输入
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
显示治疗按钮 OverviewShowTreatmentButton | show_treatment_button | 关 | 概览底部是否显示“治疗”按钮，用于打开治疗/事件面板 |
显示向导按钮 OverviewShowWizardButton | show_wizard_button | 开 | 是否显示大剂量向导（计算器）按钮 |
显示胰岛素按钮 OverviewShowInsulinButton | show_insulin_button | 开 | 是否显示快速大剂量按钮 |
显示碳水按钮 OverviewShowCarbsButton | show_carbs_button | 开 | 是否显示快速记录碳水按钮 |
显示 CGM 按钮 OverviewShowCgmButton | show_cgm_button | 关 | 是否显示跳转到 xDrip+/Dexcom App 的按钮 |
显示校准按钮 OverviewShowCalibrationButton | show_calibration_button | 关 | 是否显示向 xDrip+ 发送校准的按钮 |
对话框显示备注 OverviewShowNotesInDialogs | show_notes_entry_dialogs | 关 | 碳水/胰岛素等治疗对话框里是否显示备注输入框 |
大剂量顾问 OverviewUseBolusAdvisor | use_bolus_advisor | 开 | 向导中是否显示建议剂量与分配建议 |
大剂量提醒 OverviewUseBolusReminder | use_bolus_reminder | 开 | 血糖升高/进餐后是否提醒补打大剂量 |
Super Bolus OverviewUseSuperBolus | key_usersuperbolus | 关 | 是否启用“大剂量 + 临时零基础率”的 Super Bolus 功能 |
胰岛素按钮步进 1/2/3 OverviewInsulinButtonIncrement1/2/3 | insulin_button_increment_1/2/3 | 0.5 / 1.0 / 2.0 U | 快速大剂量按钮每点一次的增量 |
碳水按钮步进 1/2/3 OverviewCarbsButtonIncrement1/2/3 | carbs_button_increment_1/2/3 | 5 / 10 / 20 g | 快速碳水按钮每点一次的增量 |
补针预设 1/2/3 ActionsFillButton1/2/3 | fill_button1/2/3 | 0.3 / 0.0 / 0.0 U | 补针/填充对话框里的快捷剂量按钮 |
向导百分比重置时间 OverviewResetBolusPercentageTime | key_reset_boluswizard_percentage_time | 16 分钟 | 血糖数据早于该时间时，向导自动恢复按 100% 剂量计算 |
3. 状态灯阈值
这些阈值决定概览状态灯何时变黄（warning）或变红（critical）。
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
管路年龄警告 OverviewCageWarning | statuslights_cage_warning | 48 小时 | 套管使用超过此时间变黄 |
管路年龄严重 OverviewCageCritical | statuslights_cage_critical | 72 小时 | 套管使用超过此时间变红 |
胰岛素年龄警告 OverviewIageWarning | statuslights_iage_warning | 72 小时 | 储药/胰岛素使用超过此时间变黄 |
胰岛素年龄严重 OverviewIageCritical | statuslights_iage_critical | 144 小时 | 储药/胰岛素使用超过此时间变红 |
传感器年龄警告 OverviewSageWarning | statuslights_sage_warning | 216 小时 | 传感器使用超过此时间变黄 |
传感器年龄严重 OverviewSageCritical | statuslights_sage_critical | 240 小时 | 传感器使用超过此时间变红 |
传感器电量警告 OverviewSbatWarning | statuslights_sbat_warning | 25 % | 传感器电量低于此值变黄 |
传感器电量严重 OverviewSbatCritical | statuslights_sbat_critical | 5 % | 传感器电量低于此值变红 |
泵电池年龄警告 OverviewBageWarning | statuslights_bage_warning | 216 小时 | 泵电池使用超过此时间变黄 |
泵电池年龄严重 OverviewBageCritical | statuslights_bage_critical | 240 小时 | 泵电池使用超过此时间变红 |
储药余量警告 OverviewResWarning | statuslights_res_warning | 80 U | 储药低于此值变黄 |
储药余量严重 OverviewResCritical | statuslights_res_critical | 10 U | 储药低于此值变红 |
泵电量警告 OverviewBattWarning | statuslights_bat_warning | 51 % | 泵电池电量低于此值变黄 |
泵电量严重 OverviewBattCritical | statuslights_bat_critical | 26 % | 泵电池电量低于此值变红 |
4. 安全与限制
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
最大基础率 ApsMaxBasal | openapsma_max_basal | 3 × 最大日基础率 | APS 可给出的基础率上限，同时是泵的最大基础率设置 |
SMB 最大 IOB ApsSmbMaxIob | openapsmb_max_iob | 近 7 天最大单次大剂量 + 3 × 最大日基础率 | 当前 IOB 超过该值时 APS 不再追加 SMB |
AMA 最大 IOB ApsAmaMaxIob | openapsma_max_iob | 3 × 最大日基础率 | AMA 算法允许的最大 IOB |
日总量安全倍数 ApsMaxDailyMultiplier | openapsama_max_daily_safety_multiplier | 3.0 | 每日总胰岛素不得超过“最大日基础率 × 该倍数” |
当前基础率安全倍数 ApsMaxCurrentBasalMultiplier | openapsama_current_basal_safety_multiplier | 4.0 | 临时基础率不得超过“当前基础率 × 该倍数” |
Bolus snooze 除数 ApsAmaBolusSnoozeDivisor | bolussnooze_dia_divisor | 2.0 | 餐后大剂量 snooze 的消退速度：DIA ÷ 该值 |
AMA 最小碳水影响 ApsAmaMin5MinCarbsImpact | openapsama_min_5m_carbimpact | 3.0 | AMA 假设每 5 分钟最低的碳水吸收对血糖的影响，用于 COB 衰减和预测 |
SMB 最小碳水影响 ApsSmbMin5MinCarbsImpact | openaps_smb_min_5m_carbimpact | 8.0 | SMB 算法中同上的参数 |
LGS 阈值 ApsLgsThreshold | lgsThreshold | 65 mg/dL（3.6 mmol/L） | 血糖低于此值时暂停胰岛素 |
保护超时 ProtectionTimeout | protection_timeout | 1 秒 | 输入保护密码后，授权会话保持有效的时间；1 秒≈每次都要确认，0=总是询问 |
开环最小变化 LoopOpenModeMinChange | loop_openmode_min_change | 30 % | 开环模式下，只有剂量变化超过该百分比才弹窗请求确认 |
数据陈旧阈值 AlertsStaleDataThreshold | missed_bg_readings_threshold | 30 分钟 | 超过该时间没有新 CGM 数据就触发“数据陈旧”警报 |
泵失联阈值 AlertsPumpUnreachableThreshold | pump_unreachable_threshold | 30 分钟 | 与泵失联超过该时间触发警报 |
5. APS 算法开关
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
自动敏感 ApsUseAutosens | openapsama_useautosens | 开 | 根据历史数据自动调整基础率、ISF 和目标 |
Autosens 下限 AutosensMin | autosens_min | 0.7 | Autosens 比率的最小值，限制敏感度最多能调到多“强” |
Autosens 上限 AutosensMax | autosens_max | 1.2 | Autosens 比率的最大值，限制抵抗最多能调到多“弱” |
SMB 总开关 ApsUseSmb | use_smb | 开 | 是否允许 APS 追加超微大剂量 |
SMB 始终开启 ApsUseSmbAlways | enableSMB_always | 开 | 不依赖 COB/临时目标，任何时候都允许 SMB |
有 COB 时 SMB ApsUseSmbWithCob | enableSMB_with_COB | 开 | 存在活性碳水时允许 SMB |
低目标时 SMB ApsUseSmbWithLowTt | enableSMB_with_temptarget | 开 | 临时目标低于常规时允许 SMB |
高目标时 SMB ApsUseSmbWithHighTt | enableSMB_with_high_temptarget | 关 | 临时目标偏高时仍允许 SMB |
餐后 SMB ApsUseSmbAfterCarbs | enableSMB_after_carbs | 开 | 记录碳水后一段时间内允许 SMB |
UAM ApsUseUam | use_uam | 开 | 未记录餐食时也能检测“无人值守餐”并处理 |
敏感度提高目标 ApsSensitivityRaisesTarget | sensitivity_raises_target | 开 | 检测到敏感度升高时提高目标血糖 |
抵抗降低目标 ApsResistanceLowersTarget | resistance_lowers_target | 开 | 检测到胰岛素抵抗时降低目标血糖 |
短平均变化率 ApsAlwaysUseShortDeltas | always_use_shortavg | 关 | 始终使用较短时间窗口的平均血糖变化率，而非平滑后的长平均 |
DynamicISF 调敏感度 ApsDynIsfAdjustSensitivity | dynisf_adjust_sensitivity | 关 | 动态 ISF 计算时是否同步调整敏感度 |
Autosens 调整目标 ApsAmaAutosensAdjustTargets | autosens_adjust_targets | 开 | Autosens 是否也调整目标血糖，而不只调整基础率/ISF |
6. SMB / UAM 时间参数
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
SMB 间隔 ApsMaxSmbFrequency | smbinterval | 3 分钟 | 两次 SMB 之间的最小时间间隔 |
SMB 基础率限制 ApsMaxMinutesOfBasalToLimitSmb | smbmaxminutes | 30 分钟 | 用多少分钟的基础胰岛素量作为单次 SMB 的上限 |
UAM SMB 基础率限制 ApsUamMaxMinutesOfBasalToLimitSmb | uamsmbmaxminutes | 30 分钟 | 无人值守餐场景下同上 |
碳水建议阈值 ApsCarbsRequestThreshold | carbsReqThreshold | 1 g | 只有建议碳水克数高于此值才弹出“需要碳水”提示 |
7. AutoISF
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
启用 AutoISF ApsUseAutoIsfWeights | openapsama_enable_autoISF | 关 | 启用基于权重的 ISF 动态调整 |
AutoISF 下限 ApsAutoIsfMin | autoISF_min | 1.0 | ISF 调整倍数下限；1.0 等于关闭下调 |
AutoISF 上限 ApsAutoIsfMax | autoISF_max | 1.0 | ISF 调整倍数上限；1.0 等于关闭上调 |
加速权重 ApsAutoIsfBgAccelWeight | bgAccel_ISF_weight | 0.0 | 血糖加速上升时增强 ISF，从而增加胰岛素 |
刹车权重 ApsAutoIsfBgBrakeWeight | bgBrake_ISF_weight | 0.0 | 血糖减速下降时减弱 ISF，从而减少胰岛素 |
低血糖区间权重 ApsAutoIsfLowBgWeight | lower_ISFrange_weight | 0.0 | 血糖低于目标时减弱 ISF，减少胰岛素 |
高血糖区间权重 ApsAutoIsfHighBgWeight | higher_ISFrange_weight | 0.0 | 血糖高于目标时增强 ISF，增加胰岛素 |
SMB 比例血糖区间 ApsAutoIsfSmbDeliveryRatioBgRange | openapsama_smb_delivery_ratio_bg_range | 0.0 | 线性 SMB 比例的映射区间宽度；0 表示关闭线性、使用固定比例 |
餐后权重 ApsAutoIsfPpWeight | pp_ISF_weight | 0.0 | 血糖上升期增强 ISF |
持续时间权重 ApsAutoIsfDuraWeight | dura_ISF_weight | 0.0 | 长时间高血糖平台期增强 ISF |
SMB 比例 ApsAutoIsfSmbDeliveryRatio | openapsama_smb_delivery_ratio | 0.5 | 所需胰岛素中可拆成 SMB 的固定比例 |
SMB 比例下限 ApsAutoIsfSmbDeliveryRatioMin | openapsama_smb_delivery_ratio_min | 0.5 | 线性映射在目标血糖处的比例 |
SMB 比例上限 ApsAutoIsfSmbDeliveryRatioMax | openapsama_smb_delivery_ratio_max | 0.5 | 线性映射在“目标 + 区间”处的比例 |
SMB 范围扩展 ApsAutoIsfSmbMaxRangeExtension | openapsama_smb_max_range_extension | 1.0 | 允许超过常规 120 分钟 maxSMB/maxUAM 上限的倍数 |
半基础率运动目标 ApsAutoIsfHalfBasalExerciseTarget | half_basal_exercise_target | 160 mg/dL | 高 TT 提高敏感度时，在该目标值下跑 50% 基础率（120=75%，140=60%） |
IOB 阈值百分比 ApsAutoIsfIobThPercent | iob_threshold_percent | 100 % | 超过 maxIOB 的该百分比后禁用 SMB；100% 等于不启用 |
高 TT 提高敏感度 ApsAutoIsfHighTtRaisesSens | high_temptarget_raises_sensitivity | 关 | 把高临时目标解释为敏感度升高 |
低 TT 降低敏感度 ApsAutoIsfLowTtLowersSens | low_temptarget_lowers_sensitivity | 关 | 把低临时目标解释为敏感度降低 |
目标值时 SMB ApsAutoIsfSmbOnEvenTarget | Enable alternative activation of SMB always | 关 | 血糖正好等于目标时也允许 SMB |
8. 数据源、同步与泵
设置项 | 存储键 | 生效值 | 作用 |
|---|---|---|---|
上传血糖到 NS BgSourceUploadToNs | dexcomg5_nsupload | 开 | 把 CGM 血糖数据上传到 Nightscout |
记录传感器更换 BgSourceCreateSensorChange | dexcom_lognssensorchange | 开 | 换传感器时自动写入一条 Sensor Change 事件 |
随机血糖随机化 BgSourceRandomBgRandomize | randombg_randomize | 开 | RandomBG 数据源生成的数据是否加随机波动 |
随机血糖间隔 BgSourceRandomInterval | randombg_interval_min | 5 分钟 | RandomBG 生成一条新血糖的间隔 |
使用 WebSocket NsClient3UseWs | ns_use_ws | 开 | NSCv3 使用 WebSocket 而不是轮询；客户端控制与硬化模式依赖它 |
详细 IOB XdripSendDetailedIob | xdripstatus_detailediob | 开 | 向 xDrip+ 状态栏发送详细 IOB 数据 |
显示 BGI XdripSendBgi | xdripstatus_showbgi | 开 | 向 xDrip+ 发送/显示 BGI（血糖影响） |
Garmin 本地 HTTP 服务 Garmin LocalHttpServer | communication_http | 关 | 开启 Garmin 手表同步用的本地 HTTP 服务 |
Garmin 服务端口 Garmin LocalHttpPort | communication_http_port | 28891 | 上述本地服务的监听端口 |
Dana 延长大剂量 Dana UseExtended | danar_useextended | 开 | 剂量超过 200% 时改用延长大剂量方式输注 |
附：非偏好键的界面控制
位置 | 作用 |
|---|---|
主界面齿轮图标 | 简单模式下显示带斜杠的 IcSettingsOff，提示当前处于简单模式；按钮仍可打开设置 |
图表 | 固定为 BG + IOB/BAS + COB；隐藏编辑 overlay、编辑图表、新增图表入口 |
管理面板 | 隐藏临时基础率/取消 TBR、延长大剂量/取消、Careportal 区（BG 检查、备注、运动、问题、公告） |
治疗面板 | 隐藏设置图标 |
碳水/胰岛素/补针对话框 | 隐藏设置图标 |
向导对话框 | 隐藏 Profile 选择行 |
授权客户端界面 | 隐藏“允许客户端控制”开关（已被强制开启） |
语言 | 忽略已保存语言，跟随系统 |
首次安装 | 非客户端且设置向导未完成时默认开启简单模式 |
目标 4（Max Basal） | 自动判定完成，不要求配置最大基础率 |
历史页图表 | 仍按非简单模式渲染，可编辑 |
开关互斥 | 非 U100 胰岛素时禁止开启简单模式，也禁止关闭胰岛素浓度开关 |
补充：HardenedMode 被强制开启后会联动硬化模式规则：NsClientUploadData=开、所有 NsClientAccept*=关；这些键本身没有 defaultedBySM，属于间接影响。