Glucose Buddy 糖小助是什么？

Glucose Buddy（糖小助）是一个基于 Nightscout 打造的智能血糖监控与决策辅助系统。它将连续血糖监测（CGM）、指尖血糖、治疗方案、饮食运动记录等多源数据汇总到同一界面，通过交互式图表和 AI 模型，为用户提供血糖趋势洞察、风险预警和个性化管理建议。

该项目为开源工具，面向有血糖管理需求的个人用户、家属以及有技术背景的健康管理从业者，用于

数据理解与自我管理参考

，不构成任何形式的诊疗建议。


核心功能亮点


🩸 血糖数据监控与可视化

  • 实时对接 Nightscout API，展示当前血糖水平和趋势变化
  • 支持 1–90 天历史数据浏览，查看长期波动情况
  • 提供平均血糖、目标范围占比、变异系数、糖化血红蛋白估算等统计指标
  • 同屏对比 CGM 数值与指尖血糖数据，助力校准与误差判断
  • 针对餐前、餐后场景生成详细分析报表，并根据实际进食时间计算餐后 2 小时血糖
  • 支持优化排版的打印报表，方便线下沟通与存档


🧠 AI 驱动的血糖预测与智能分析

  • 基于最近的多条血糖数据，生成未来 30 分钟的预测曲线
  • 输出趋势判断（上升、下降、平稳及变化速度）与预估血糖范围
  • 通过数据点数量与趋势一致性计算预测置信度，为用户提供可信度参考
  • 评估潜在低血糖风险，并进行风险分级提示
  • 集成 OpenAI、Ollama 等多种 AI 服务，实现深度血糖数据解读
  • AI 分析时综合考虑血糖曲线、治疗方案、餐食记录与运动数据，生成个性化生活方式建议
  • 内置 AI 咨询入口，用于围绕血糖管理、饮食与运动的实时交流（仅供参考，不替代医生）


💊 治疗方案与生活方式管理

  • 支持配置多种口服降糖药物信息，为 AI 分析提供更完整的背景
  • 支持胰岛素治疗方案管理，包括剂量、频次及预设频次（每日 1～4 次）和自定义设置
  • 自动识别和展示 Nightscout 中的餐食、运动和指尖血糖记录
  • 分析碳水化合物、蛋白质、脂肪摄入结构，辅助理解饮食与血糖波动之间的关系
  • 将治疗方案、饮食和运动与血糖变化进行关联，形成更完整的数据画像


🚨 智能风险预警与通知系统

  • 基于预测结果对低血糖风险进行实时评估
  • 内置高风险、中风险、低风险三级预警机制
  • 页面顶部展示醒目预警横幅，协助用户及时关注异常情况
  • 支持浏览器 Web Push、邮件通知、微信等渠道的预警提醒（视实际配置而定）
  • 预警阈值可自定义，高风险默认 70 mg/dL（3.9 mmol/L），中风险默认 80 mg/dL（4.4 mmol/L）


📨 消息中心与报表归档

  • 所有 AI 生成的分析报告与咨询内容统一归档到消息中心
  • 支持未读消息标记、收藏、删除等管理操作
  • 消息按类型分类展示，方便快速查找和回顾历史分析
  • 主页提供未读消息数量提醒，减少漏看重要信息的风险


🔔 多通道智能通知

  • 浏览器实时通知，适合长时间在电脑前工作的用户
  • 邮件定时发送血糖分析报告与预警信息，便于长期留存和查阅
  • 支持 PWA 安装，可将应用添加到桌面或手机主屏幕，并在部分场景下离线使用
  • 用户可在配置界面自定义通知频率与方式


体验与部署方式


🚀 Docker 一键部署

对于熟悉容器化环境的用户，Glucose Buddy 提供了推荐的 Docker 部署方案：

  • 克隆项目代码仓库
  • 通过配置文件

    config.toml

    完成 Nightscout 连接、AI 服务与通知等基础设置
  • 使用

    quick-start.sh

    快速启动脚本或

    docker-compose up -d

    启动服务
  • 系统支持数据持久化，将配置、数据库和日志保存在本地目录，便于备份与迁移

访问

http://localhost:1338

即可打开 Web 界面并完成初始化配置。


💻 本地运行与开发者友好设计

对于倾向本地运行或二次开发的用户，项目提供：

  • Python 3.9+ 环境支持，通过

    pip install -r requirements.txt

    安装依赖
  • 直接运行

    python app.py

    启动应用
  • 完整的项目结构，包括模板、静态资源、脚本与规格文档，利于扩展功能
  • 清晰的 API 设计：

    • 数据接口：血糖数据、治疗数据、运动数据、统计数据、报表数据
    • 智能接口：预测分析、AI 报告、AI 咨询
    • 配置接口：连接测试、邮件配置验证、预警配置、消息管理等
  • 通过 Nginx 反向代理配置与 WebSocket 支持，实现更稳定的线上部署方案


适配体验与性能优化

  • 移动优先的响应式界面，兼容手机、平板与桌面设备
  • 使用 Bootstrap 5 与 Chart.js 打造现代化数据仪表盘体验
  • 支持键盘导航与屏幕阅读器，在无障碍访问方面更友好
  • 提供日志与诊断工具，协助排查数据同步、AI 服务与邮件系统的常见问题


使用说明与合规声明

  • Glucose Buddy（糖小助）为

    开源血糖数据管理与分析工具

    ，旨在帮助用户更直观地理解和管理血糖相关数据
  • 系统提供的所有分析结果、预测数据与 AI 建议仅供学习、记录和自我管理参考
  • 本工具不提供医疗诊断、不替代内分泌科医生或其他专业医疗人员的任何建议
  • 如遇血糖异常或身体不适，应立刻咨询专业医生或当地医疗机构


Glucose Buddy项目地址

GitHub 仓库：

https://github.com/flyhunterl/glucose-buddy