Family Health Platform

高端家庭健康管理中台 · Family-grade Private Health Operations Console

产品定位

面向高净值家庭与专业健康管理场景，提供以隐私安全为核心的健康数据治理、临床 AI 协作与知识库增强问答能力。

隐私提示

上传前请认真检查姓名、电话、身份证号等敏感信息，确保你已获得本人授权并愿意用于 AI 问答。本平台默认以脱敏为先，仍需用户承担最终责任。

功能亮点

• 全链路脱敏预览与规则管理：选中即建规则、高亮命中、批量复用
• Chat + KB 双通路：聊天附件与知识库文档可独立入库或作为上下文
• RAG 增强问答：多模型/多检索策略可调，适配家庭健康场景
• 多用户隔离与双域存储：raw_vault 与 sanitized_workspace 严格分离

核心能力

• 多用户隔离：账号级独立模型、MCP、知识库、导出空间
• 聊天中心：会话管理、附件上传、流式问答、知识库增强 QA
• 模型中心：多供应商模型刷新与 Runtime Profile 管理
• MCP 中心：命令式接入、模板导入、Agent 绑定
• 知识库中心：文本/文档构建、检索策略与权重控制
• 导出中心：多类型打包下载，支持脱敏域治理
• 双域安全：raw_vault 与 sanitized_workspace 严格隔离

技术栈

• Backend: FastAPI, SQLAlchemy, SQLite, httpx, pytest, ruff
• Frontend: React, Vite, TypeScript
• 工程化: npm, uv

快速启动

一键启动（推荐）

python3 quickstart.py
# 内网访问前端时使用
python3 quickstart.py --lan

• 默认读取仓库根目录 .env 的 FH_SERVER_HOST/FH_SERVER_PORT
• 自动检查 uv 与 npm，安装依赖并同时启动前后端

Windows GUI 启动器（推荐）

双击项目根目录的 FamilyHealth.exe（或 python launcher.py），会打开可视化控制台：

• 自动检测并安装 uv 和 Node.js（无需预装）
• 一键启动后端 + 前端，实时滚动日志
• 前端就绪后自动打开浏览器 http://localhost:5173
• 勾选「LAN 模式」可让内网设备访问

打包 .exe：

pip install pyinstaller
.\build_launcher.bat
# 产出 dist/FamilyHealth.exe，复制到项目根目录即可

1) 后端

cd backend
uv venv
uv sync
uv run python -m app

端口统一从仓库根 .env 读取（参考 .env.example）：

FH_SERVER_HOST=127.0.0.1
FH_SERVER_PORT=8000

2) 前端

cd frontend
npm install
# npm run dev
# 内网其他设备访问前端开发服务:
npm run dev:lan

默认访问地址:

• Frontend: http://localhost:5173
• Backend: http://localhost:8000
• LAN Frontend（npm run dev:lan）: http://<你的局域网IP>:5173

提示：若需要修改后端端口，改 .env 中 FH_SERVER_PORT 即可，前端代理会自动跟随。

质量检查

Backend

cd backend
uv run ruff check .
uv run ruff format --check .
uv run pytest

Frontend

cd frontend
npm run lint
npm run build

文档入口

• 用户说明书: docs/USER_GUIDE.md
• API 文档: doc/api/README.md
• 部署说明: doc/DEPLOYMENT.md
• 联调脚本说明: scripts/README.md

协议

本项目采用 Apache License 2.0，详见 LICENSE。