[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82720":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":12,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":8,"rankLanguage":8,"license":16,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":8,"pushedAt":8,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":12,"lastSyncTime":24,"discoverSource":25},82720,"yuhutong","zq779\u002Fyuhutong","zq779",null,"Python",113,6,2,1,0,39.74,"MIT License",false,"main",true,[],"2026-06-12 04:01:38","# 语护通：养老院护理记录与交接工作台\n\n## 项目简介\n\n语护通是一套面向养老院护理场景的护理记录与交接辅助系统，主要服务于一线护理员、院方管理员和老人家属。系统围绕养老护理工作中“记录不完整、交接不清晰、家属沟通重复、隐私边界不明确”等问题，提供护理记录录入、语音快速记录、AI结构化整理、个性化异常关注、班次交接文档生成、家属端同步和安全隐私保护等功能。\n\n\n## 项目地址\n\n```text\nhttps:\u002F\u002Fgithub.com\u002Fzq779\u002Fyuhutong\n```\n\n## 主要功能\n\n### 1. 护理记录录入\n\n护理员可以选择老人，录入体温、血压、血氧、心率、血糖、进食、睡眠、精神状态和观察备注等信息。系统会按时间线保存护理记录，便于后续查询和追溯。\n\n### 2. 语音快速录入\n\n系统支持浏览器录音上传。后端可接入 DashScope Paraformer 语音识别服务，将护理员口述内容转写为文本，减少手工填写护理文书的负担。\n\n### 3. AI护理信息结构化整理\n\n系统可接入 Qwen-plus大模型，对护理文本中的体征、症状、进食、情绪、处理措施和注意事项进行结构化抽取，形成更便于检索、统计和交接的护理记录。\n\n未配置外部 AI 密钥时，系统仍保留本地规则兜底能力，可用于离线演示和基础功能测试。\n\n### 4. 个性化异常关注\n\n系统根据每位老人的历史护理记录和个人基线，结合最新护理内容，对血压升高、进食减少、精神状态变化、胸闷、头晕、跌倒风险等情况进行辅助判断，并生成重点关注事项。\n\n### 5. 班次交接文档生成\n\n系统可根据本班次护理记录、异常事件和备忘事项生成交接文档，帮助接班护理员快速了解老人状态、已采取措施和后续注意事项，减少单纯依赖口头交接导致的信息遗漏。\n\n### 6. 家属端同步\n\n系统提供家属端界面。家属账号只能查看绑定老人的今日状态、最新体征和经过确认的日报内容，不能查看其他老人数据，也不能直接访问护理员内部交接内容。\n\n\n### 7. 权限隔离与操作留痕\n\n系统区分护理员、院方管理员和家属三类角色，不同角色拥有不同访问权限。系统会记录登录、护理记录创建、报告生成、异常事件处理和试用数据清理等关键操作，便于后续追踪。\n\n## 技术栈\n\n```text\n前端：HTML + CSS + JavaScript\n后端：FastAPI\n数据库：SQLite，支持扩展为 PostgreSQL\n认证：JWT\nAI能力：Qwen 文本模型、DashScope Paraformer 语音识别\n部署方式：本地运行 \u002F Docker Compose \u002F Nginx 反向代理\n```\n\n## 目录结构\n\n```text\nyuhutong\u002F\n├── backend\u002F\n│   ├── app\u002F\n│   │   ├── api\u002F                  # 后端接口路由\n│   │   ├── core\u002F                 # 配置、安全认证、安全响应头\n│   │   ├── db\u002F                   # 数据库连接\n│   │   ├── services\u002F             # 业务服务、AI调用、隐私保护\n│   │   ├── static\u002F               # 前端页面、样式和交互脚本\n│   │   ├── uploads\u002F              # 上传文件目录\n│   │   ├── main.py               # FastAPI应用入口\n│   │   ├── models.py             # 数据库模型\n│   │   └── schemas.py            # 接口数据结构\n│   ├── requirements.txt          # Python依赖\n│   ├── run.py                    # 后端启动入口\n│   └── Dockerfile\n├── docs\u002F\n│   ├── api_design.md             # API设计说明\n│   ├── database_design.md        # 数据库设计说明\n│   └── security_privacy_protocol.md   #个性化本地差分隐私保护\n├── .env.example                  # 环境变量模板\n├── .gitignore\n├── docker-compose.yml\n├── start_linux_mac.sh\n├── start_windows.ps1\n├── SECURITY.md\n├── LICENSE\n└── README.md\n```\n\n## 本地运行\n\n### 1. 克隆项目\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fzq779\u002Fyuhutong.git\ncd yuhutong\u002Fbackend\n```\n\n### 2. 创建虚拟环境\n\n```bash\npython3 -m venv .venv\nsource .venv\u002Fbin\u002Factivate\n```\n\nWindows PowerShell 可使用：\n\n```powershell\npython -m venv .venv\n.\\.venv\\Scripts\\Activate.ps1\n```\n\n### 3. 安装依赖\n\n```bash\npython3 -m pip install --upgrade pip\npython3 -m pip install -r requirements.txt\n```\n\n### 4. 配置环境变量\n\n```bash\ncp ..\u002F.env.example .env\nnano .env\n```\n\n如果只是本地演示，可以先不填写 AI 密钥，系统会使用基础本地规则兜底。\n\n如果需要调用 Qwen 和 DashScope，请在 `.env` 中填写：\n\n```env\nAI_PROVIDER=qwen\nQWEN_API_KEY=你的API_KEY\nDASHSCOPE_API_KEY=你的API_KEY\nQWEN_BASE_URL=https:\u002F\u002Fdashscope.aliyuncs.com\u002Fcompatible-mode\u002Fv1\nQWEN_TEXT_MODEL=qwen-plus\nDASHSCOPE_ASR_MODEL=paraformer-realtime-v2\nDASHSCOPE_ASR_SAMPLE_RATE=16000\n```\n\n### 5. 启动系统\n\n```bash\npython3 run.py\n```\n\n浏览器访问：\n\n```text\nhttp:\u002F\u002F127.0.0.1:8000\n```\n\n## 一键启动脚本\n\nLinux \u002F macOS：\n\n```bash\nbash start_linux_mac.sh\n```\n\nWindows PowerShell：\n\n```powershell\n.\\start_windows.ps1\n```\n\n## 演示账号\n\n系统启动时会自动初始化演示数据。默认账号如下：\n\n```text\n护理员账号：nurse \u002F 123456\n管理员账号：admin \u002F 123456\n家属账号一：family_zhang \u002F 123456\n家属账号二：family_li \u002F 123456\n```\n\n## AI调用说明\n\n本项目的 AI 调用代码位于：\n\n```text\nbackend\u002Fapp\u002Fservices\u002Fai_provider.py\n```\n\n主要包括以下能力：\n\n1. 护理文本结构化整理；\n2. 护理风险辅助评估；\n3. 班次交接文档生成；\n4. 家属日报生成；\n5. 语音转写。\n\n当 `.env` 中未配置 `QWEN_API_KEY` 或 `DASHSCOPE_API_KEY` 时，系统不会调用外部 AI 服务，而是使用本地规则进行基础整理。因此，如果发现 AI 平台额度没有变化，通常是因为密钥未配置、配置文件位置不正确，或后端没有在修改 `.env` 后重启。\n\n## 个性化本地差分隐私保护\n\n系统实现了个性化本地差分隐私保护模块，核心代码位于：\n\n```text\nbackend\u002Fapp\u002Fservices\u002Fprivacy_protection.py\n```\n\n该模块用于数据发送到外部文本整理服务前的本地保护处理，不改变院内数据库中由护理人员确认的原始记录。\n\n主要处理方式包括：\n\n1. 身份替换：老人姓名、床位、联系方式等直接标识在出站请求中替换为临时编号；\n2. 类别泛化：疾病标签、风险标签和症状描述按护理业务类别进行泛化；\n3. 数值扰动：体温、血压、心率、血糖等体征数值在本地加入拉普拉斯噪声；\n4. 个性化预算：不同字段使用不同隐私预算，身份标识和健康标签保护更强，体征数据保留更高可用性；\n5. 本地还原：交接文档和家属同步内容在本地生成最终展示文本，外部服务不接收真实姓名和床位。\n\n相关配置位于 `.env.example`：\n\n```env\nPERSONALIZED_LDP_ENABLED=true\nLDP_EPSILON_IDENTIFIER=0.8\nLDP_EPSILON_HEALTH_TAG=1.0\nLDP_EPSILON_VITAL=3.0\nLDP_EPSILON_TEXT=2.0\nLDP_EPSILON_REPORT=2.5\n```\n\n## 安全设计\n\n项目包含以下安全设计：\n\n1. JWT 登录认证；\n2. 护理员、管理员、家属三类角色权限隔离；\n3. 家属端最小化展示，只允许访问绑定老人数据；\n4. 真实 API Key 存放在 `backend\u002F.env`，不提交到公开仓库；\n5. 数据库文件、虚拟环境、上传音频和缓存文件通过 `.gitignore` 排除；\n6. 上传音频格式和大小限制；\n7. 安全响应头配置；\n8. 关键操作审计日志；\n9. 管理员试用数据清理功能；\n10. 外部 AI 调用前的本地隐私保护处理。\n\n更多说明见：\n\n```text\nSECURITY.md\ndocs\u002Fsecurity_privacy_protocol.md\n```\n\n## Docker部署\n\n项目提供 `docker-compose.yml`，可用于容器化部署。\n\n```bash\ndocker compose up --build\n```\n\n启动后访问：\n\n```text\nhttp:\u002F\u002F127.0.0.1:8000\n```\n\n## API文档\n\n启动后可访问 FastAPI 自动生成的接口文档：\n\n```text\nhttp:\u002F\u002F127.0.0.1:8000\u002Fdocs\n```\n\n主要接口包括：\n\n```text\n\u002Fapi\u002Fauth\u002Flogin              用户登录\n\u002Fapi\u002Fauth\u002Fme                 获取当前用户信息\n\u002Fapi\u002Fresidents               老人信息管理\n\u002Fapi\u002Frecords\u002Ftext            提交文本护理记录\n\u002Fapi\u002Frecords\u002Faudio           上传音频护理记录\n\u002Fapi\u002Fabnormal                异常事件查询与处理\n\u002Fapi\u002Freports                 交接报告和家属日报\n\u002Fapi\u002Fdashboard               试用概况统计\n\u002Fapi\u002Fsecurity-center         安全中心与隐私配置\n```\n\n\n## 开源协议\n\n本项目采用 MIT License。\n\n## 免责声明\n\n本项目用于养老护理记录整理、班次交接辅助和开源学习展示，不作为医疗诊断、治疗建议或医疗决策依据。实际部署到养老机构时，应结合机构内部制度、数据合规要求、隐私保护要求和人工审核流程共同使用。\n\n","语护通是一套面向养老院护理场景的护理记录与交接辅助系统，主要服务于一线护理员、院方管理员和老人家属。其核心功能包括护理记录录入、语音快速记录、AI结构化整理、个性化异常关注、班次交接文档生成以及家属端同步等。该系统利用Qwen-plus大模型进行护理信息的结构化处理，并通过DashScope Paraformer实现语音识别，从而提高护理记录的准确性和效率。此外，语护通还注重数据安全与隐私保护，确保不同用户角色间的信息隔离。适用于需要高效管理护理记录、提升交接流程透明度及加强与家属沟通的养老机构。","2026-06-11 04:09:00","CREATED_QUERY"]