MediAI 智能医疗助手
一个纯前端、零依赖的智能医疗助手平台 —— 无需服务器、无需 API Key，双击 HTML 即可使用，数据全程保存在浏览器本地。
🌐 在线体验：https://estrella7533.github.io/fengguangyueji_chuanzhibei/
📖 项目介绍
MediAI 是一款面向普通用户的智能医疗健康助手。它把「AI 问诊」「健康档案」「医疗知识库」「科普资讯」整合在同一个温暖、易用的界面里：
- 能听懂人话的家庭医生：内置 49 条疾病知识库与多层匹配引擎，能理解"胃疼→一天了→一阵一阵"这样的口语化描述，先共情、再分析，给出可执行的居家处理措施和就医红线信号。
- 会记事的健康管家：血压、血糖、BMI 一键归档，自动生成健康评分、趋势图和个性化建议，并按时推送复查、打卡等贴心提醒。
- 跨设备云同步：手机电脑登录同一账号，健康档案自动保持一致（数据存在你自己的 GitHub 私密 Gist 中）。
- 隐私优先：账号密码采用 PBKDF2 加盐哈希，明文永不落盘；健康数据默认只保存在你自己的浏览器里。
✨ 项目亮点
- 🩺 本地家庭医生引擎：内置 49 条疾病知识库与智能匹配，能真正"听懂"你的描述（时长、阵发性、疼痛程度、已采取措施等），给出阶段判断、可执行的居家处理措施和就医红线信号，并结合你的健康档案生成个性化提醒 —— 不再是复读反问的"人工智障"。
- 💬 多轮连续对话：AI 记得你前面说过什么，支持"胃疼→一天了→一阵一阵"这样的连续追问，回复带打字机逐字输出，像真人医生在和你聊天。
- 🌸 温馨动态封面：暖橙渐变背景、漂浮爱心/药丸/听诊器元素、脉动光晕，配"健康守护伙伴"暖心文案，底部数据带 7 项实时统计（知识条数、今日新增科普等），数字滚动动画，打开即被温柔包裹。
- ❤️ 会说话的健康通知：登录后自动生成个性化提醒（血压偏高复查、一周未录入数据、BMI 减重建议、每日健康贴士），不再是摆设。
- 📊 健康档案可视化：血压/血糖/体重记录、BMI 自动计算、健康评分环形图、指标变化趋势折线图。
- 📚 医疗知识库：12 大类常见疾病（心血管、内分泌、呼吸、消化等），每一条都带病因、表现、居家措施、危险信号。
- 📰 每日科普资讯：饮食、养生、科学、生活四大类科普文章，每日自动更新。
- 🔐 完整的账号体系：注册 / 登录 / 找回密码 / 游客模式，密码 PBKDF2 加盐哈希，账号与数据按用户隔离存储。
- ☁️ GitHub 云同步：账号与健康档案可跨设备同步（私密 Gist，仅上传哈希）。
🏗️ 技术架构
┌─────────────────────────────────────────────────┐
│ 界面层 │
│ index.html + yue.css：开场封面 / 六大板块 / 弹窗 │
├─────────────────────────────────────────────────┤
│ 逻辑层 │
│ 原生 JavaScript（零框架、零构建）： │
│ · 账号系统（PBKDF2 加盐哈希 + 会话管理） │
│ · 本地家庭医生引擎（紧急识别→知识库匹配→ │
│ 信息解读→多轮追问→健康档案个性化提醒） │
│ · 健康评分 / BMI 分析 / Canvas 图表 │
│ · 云同步（GitHub Gist，先拉后推、按时间戳合并） │
├─────────────────────────────────────────────────┤
│ 存储层 │
│ localStorage（账号/健康档案/对话/配置，按账号 │
│ 隔离）· sessionStorage（开场页单会话展示） │
│ 可选：GitHub 私密 Gist（云同步，跨设备互通） │
└─────────────────────────────────────────────────┘
目录结构
fengguangyueji_chuanzhibei/
├── index.html # 入口页面：全部结构与脚本（含各模块分区注释）
├── yue.css # 全部样式：主题变量 → 布局 → 组件 → 弹窗 → 开场页 → 响应式
├── README.md # 项目说明（本文件）
└── .env.example # 环境变量模板（当前版本无需环境变量，仅供扩展参考）
数据存储与安全
| 数据 | 存储位置 | 说明 |
|---|
| 账号（用户名、密码哈希） | localStorage mediai-users | PBKDF2 12 万次迭代 + 随机盐，明文不落盘 |
| 健康档案 / 血压趋势 | localStorage mediai-health-records_<用户> 等 | 按账号隔离，每日归档一次、不可篡改 |
| 对话记录 | localStorage mediai-chat-history | 仅保存最近 20 轮 |
| 云同步配置（令牌等） | localStorage mediai-sync-cfg | 仅本设备浏览器，只用于读写你自己的 Gist |
| 开场页展示标记 | sessionStorage | 每次新会话展示一次 |
☁️ 云同步机制
- 数据存放于你的 GitHub 私密 Gist（
MediAI云同步空间·<空间名>），仅你可见。
- 同步策略：先拉取云端合并到本机，再把合并结果推送（防止空设备覆盖云端数据）；冲突按
updatedAt 时间戳"新者胜"。
- 触发时机：开启云同步后，启动应用、登录、注册、录入健康数据时自动同步。
- 令牌权限最小化：仅需
gist 权限；密码只上传哈希，健康数据仅存于你的 Gist。
🧭 功能导览
| 模块 | 路径 | 说明 |
|---|
| 首页总览 | 侧边栏「首页总览」 | 免责声明、动态 Hero、数据统计、核心功能卡片 |
| AI 智能问诊 | 侧边栏「AI 智能问诊」 | 多轮对话，支持症状关键词、时长/阵发性解读、追问 |
| 健康档案 | 侧边栏「健康档案」 | 录入血压血糖体重、健康评分、趋势图 |
| 医疗知识库 | 侧边栏「医疗知识库」 | 12 大类疾病科普，可按分类筛选、关键词搜索 |
| BMI 计算器 | 侧边栏「BMI 计算器」 | 输入身高体重即时计算 BMI 与体型分类 |
| 科普资讯 | 侧边栏「科普资讯」 | 每日更新的健康科普文章 |
| 消息中心 | 顶栏「🔔 通知」 | 打卡/复查/科普更新/每日贴士等个性化提醒 |
| 云同步 | 左下角用户卡 →「☁️ 云同步」 | 跨设备账号与健康档案互通 |
🚀 安装运行指南
环境要求
- 任意现代浏览器（Chrome / Edge / Safari / Firefox 最新版），手机浏览器同样支持；
- 无需 Node.js、无需构建工具、无需任何运行时环境。
方式一：在线访问（推荐）
直接打开：https://estrella7533.github.io/fengguangyueji_chuanzhibei/
托管于 GitHub Pages，推送后自动部署，手机电脑通用。
方式二：直接打开文件
双击 index.html 即可在浏览器中运行，无需任何安装。
方式三：本地静态服务器（可选）
# 任选其一
python3 -m http.server 8080
# 或
npx serve .
然后访问 http://localhost:8080/
⚙️ 环境配置说明
环境变量
当前版本为纯静态站点，开箱即用，不需要任何环境变量、API Key 或密钥。
- 云同步所需的 GitHub 令牌不通过环境变量配置：登录后打开「左下角用户卡 → ☁️ 云同步」，在界面内粘贴并保存（仅存于本设备浏览器 localStorage）。
- 未来若接入后端服务，可参考仓库根目录的
.env.example 模板（见下）。
环境变量模板
见仓库文件 .env.example：
# MediAI 环境变量模板
# 当前版本（纯前端静态应用）无需任何环境变量，此模板仅供未来扩展参考。
# 云同步令牌在网页内配置：登录 → 左下角用户卡 → ☁️ 云同步 → 粘贴令牌
📦 依赖清单
| 类别 | 依赖 | 版本要求 |
|---|
| 运行时依赖 | 无（零外部依赖） | — |
| 构建/打包 | 无（零构建，直接打开即用） | — |
| 浏览器 API | localStorage / sessionStorage / Web Crypto (PBKDF2) / Canvas 2D / fetch（云同步时） | 现代浏览器内置 |
| 图标 | Emoji（系统自带） | — |
| 字体 | 系统默认字体栈 | — |
云同步为可选功能，仅在用户主动配置令牌后才发起网络请求（目标：api.github.com）。
🩺 AI 问诊是怎么"变聪明"的？
这是本项目最核心的部分。
以前的痛点：用户说"胃疼"，AI 答完；用户再补充"一天了""一阵一阵"，AI 却照旧甩出四个反问 —— 完全没消化用户的话，体验像"人工智障"。
现在的做法：内置一套 本地家庭医生引擎，由多层组成 ——
- 紧急症状优先：胸痛、呼吸困难、意识模糊、大出血等关键词命中即先提醒拨打 120，不废话。
- 疾病知识库匹配：49 条疾病条目，按标题、别名、标签、症状描述打分匹配，命中即输出"常见表现 + 居家措施 + 危险信号"。
- 🆕 信息解读引擎：用户补充"一天了""一阵一阵""很疼""睡不着""以前没有"这类描述时，AI 会：
- 把用户说过的话复述回去（"我记着你刚才说的「胃疼」，现在你又说「一天了」"）
- 解读时长：不到一天 → 观察为主；超几天 → 别硬扛；拖几周 → 尽快就医
- 解读规律：阵发性 → 多为功能性、可对症缓解；持续不断 → 需找根源
- 解读疼痛程度、是否影响睡眠、是否已采取措施等
- 给出现在就能做的三件事和就医红线信号
- 健康档案个性化提醒：回答末尾结合你最近一次健康档案（血压/血糖/BMI/评分异常时）附加专属提醒。
- 多轮追问：围绕同一话题深入补充，或切换到新症状。
💡 本引擎纯本地运行，无需任何 API Key——打开页面就能用，所有回答都来自内置知识库与规则引擎，数据不出浏览器。
🎨 封面与视觉
- 配色：暖橙 + 蜜桃 + 樱花粉 + 薄荷绿，告别冰冷科技蓝
- 动态元素：背景漂浮爱心、药丸、听诊器、草药杯、咖啡杯；光晕缓慢脉动；打字机文字循环切换"准备健康空间 / 加载知识库 / 校准评分模型"等
- 进入按钮：品牌蓝渐变胶囊按钮，带呼吸光圈与脉动光晕，文案为「🚪 进入 MediAI 医疗空间 →」
- 底部数据带：7 项平台实力实时统计（医疗知识条数、科普资讯篇数、疾病分类数、居家措施条数、核心功能数、今日新增科普、数据本地保存），数字动态滚动，与站内真实数据一致
🔔 通知中心是做什么的？
很多用户第一次看到「通知」会疑惑"我都登录了，通知有什么用"。其实它的定位是 你的健康生活小秘书，而不是聊天消息。
登录后打开通知中心，会自动收到以下个性化提醒：
| 类型 | 触发场景 | 示例 |
|---|
| 📋 症状提醒 | 根据你说过的身体状况 | "你上次提到胃部不适，持续两天以上建议就医" |
| 💉 复查提醒 | 血压偏高、血糖异常 | "近期血压偏高，建议近期复查并控制盐摄入" |
| 📅 系统公告 | 平台更新、科普推荐 | "今日新增 3 篇秋冬养生科普" |
| ⏰ 定时问候 | 早/午/晚按时段 | "早上好，记得吃早餐再出门哦" |
核心用法：配合 AI 问诊使用 —— 问诊后 AI 会建议"三天后还没好转就来找我"，届时通知中心会帮你把这条记下来。
👥 团队信息
| 角色 | 姓名 |
|---|
| 队名 | 风光霁月 |
| 指导老师 | 刘微 |
| 队长 | 郝梓萱 |
| 队员 | 王苗苗、李欣彤 |
⚠️ 免责声明
本平台仅供参考，不构成医疗建议。 AI 给出的分析基于内置知识库与规则匹配，不能替代专业医生的面诊与诊断。如有紧急情况，请立即拨打 120 急救电话或前往最近医院就诊
📝 更新日志
v1.4
- ☁️ 新增 GitHub 云同步：账号与健康档案跨设备互通（私密 Gist、先拉后推、时间戳合并）
- 📊 封面数据带改为实时统计：7 项数据全部来自站内真实数据，修复"居家处理措施显示 0"统计路径错误
- 📖 README 重构：补充技术架构、环境配置说明、依赖清单与团队信息
- ✨ 代码注释完善：入口文件与样式表增加结构说明注释
v1.3
- 🐛 修复左下角用户卡点击无效：游客点击直达登录，登录后点击展开账号菜单（消息中心 / 云同步 / 退出登录）
- 🩺 AI 问诊引擎再升级：回答结合你的健康档案（血压/血糖/BMI/评分异常时自动附加个性化提醒）；补充症状描述时结合之前提到的病症给出针对性危险信号提醒；新增"胃疼/反酸/烧心/嗓子疼"等口语别名
v1.2
- 🩺 AI 问诊升级：新增信息解读引擎，能真正消化用户补充的时长、阵发性、疼痛程度、已采取措施等信息，告别复读反问
- 🌸 封面翻新：暖橙配色、温馨文案、动态漂浮元素
- 📊 数据带扩容：底部统计扩展并动态滚动
- 🔔 通知中心：明确健康提醒定位，支持个性化提醒生成
- 🐛 修复：中文数字（一天/两天/半个月）时长解析、追问分支判定时机
v1.1
- 新增健康档案可视化（环形评分、趋势折线图）
- 新增科普资讯模块
- 完善账号体系（注册 / 登录 / 找回密码）
v1.0
- 初始版本：封面、登录注册、AI 问诊、知识库、BMI 计算器
