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 却照旧甩出四个反问 —— 完全没消化用户的话，体验像"人工智障"。

现在的做法：内置一套 本地家庭医生引擎，由多层组成 ——

1. 紧急症状优先：胸痛、呼吸困难、意识模糊、大出血等关键词命中即先提醒拨打 120，不废话。
2. 疾病知识库匹配：49 条疾病条目，按标题、别名、标签、症状描述打分匹配，命中即输出"常见表现 + 居家措施 + 危险信号"。
3. 🆕 信息解读引擎：用户补充"一天了""一阵一阵""很疼""睡不着""以前没有"这类描述时，AI 会：
   • 把用户说过的话复述回去（"我记着你刚才说的「胃疼」，现在你又说「一天了」"）
   • 解读时长：不到一天 → 观察为主；超几天 → 别硬扛；拖几周 → 尽快就医
   • 解读规律：阵发性 → 多为功能性、可对症缓解；持续不断 → 需找根源
   • 解读疼痛程度、是否影响睡眠、是否已采取措施等
   • 给出现在就能做的三件事和就医红线信号
4. 健康档案个性化提醒：回答末尾结合你最近一次健康档案（血压/血糖/BMI/评分异常时）附加专属提醒。
5. 多轮追问：围绕同一话题深入补充，或切换到新症状。

💡 本引擎纯本地运行，无需任何 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 计算器