GMI（Mental Illness Guide）是一个基于 MkDocs 与 mkdocs-material 构建的中文精神健康知识库。目标是为公众提供系统、可靠、易理解的精神疾病信息与就医指引，减少污名化，促进理解与支持。
精神健康是整体健康的重要组成部分，但在全球范围内，精神疾病的污名化仍然普遍存在。许多人对精神疾病缺乏正确的认识，导致患者不敢寻求帮助，家属不知道如何支持，社会缺乏理解和包容。
基于此 GMI 项目应运而生，光圈棱镜团队旨在通过提供准确、全面、易懂的精神健康信息，打破污名化，促进精神健康知识的普及，帮助患者、家属和专业人士获取可靠的资源和支持。
为公众提供系统、可靠、易理解的精神疾病信息与就医指引，减少污名化，促进理解与支持。
成为中文世界最权威、最全面、最易用的精神健康知识库，推动精神健康的普及和重视，构建更加包容和支持的社会环境。
- 疾病介绍：涵盖情绪障碍、焦虑障碍、神经发育障碍、进食障碍、物质使用障碍、睡眠障碍、性别认同与跨性别、LGBTQ+精神健康等多个领域
- 治疗方法：详细介绍心理治疗、药物治疗、物理治疗和综合管理
- 药物指南：提供药物分类、用法用量、安全监测和药理分类索引
- 诊断标准：基于DSM-5和ICD-11的权威诊断标准
- 实用资源：包括评估工具、支持热线、专业机构、自助策略等
- 基于最新的研究和临床指南
- 内容由专业人士审核
- 定期更新以反映最新的研究成果和治疗方法
- 分组导航：按专题分组，信息清晰易找
- 响应式设计：适配各种设备，包括桌面、平板和手机
- 暗黑模式：支持日间/夜间模式切换，保护视力
- 中文搜索：快速查找所需信息
- 现代体验：导航、代码复制、搜索高亮等增强特性
- 就医路径：为患者提供清晰的就医指引
- 自助清单：帮助患者和家属准备就医资料和自我管理
- 风险提示：药物安全监测和随访建议
- 紧急帮助：提供危机干预热线和资源
- 常见精神疾病：抑郁障碍、双相障碍、躁狂发作、双相障碍快速循环、精神分裂症、人格障碍
- 焦虑与创伤相关障碍：焦虑障碍总览、恐慌障碍、广泛性焦虑障碍、强迫障碍（OCD）、创伤后应激障碍（PTSD）、社交焦虑障碍、创伤与精神健康
- 躯体形式与相关障碍：躯体变形障碍
- 神经发育障碍：ADHD注意缺陷多动障碍、ASD自闭症谱系障碍
- 儿童青少年精神健康：总览、抽动障碍
- 老年人精神健康：总览、痴呆症、老年抑郁症
- 性别认同与跨性别：性别焦虑（Gender Dysphoria）、跨性别支持与资源（MTF/FTM）
- LGBTQ+精神健康：总览、出柜与精神健康、LGBTQ+青少年精神健康
- 其他精神障碍：进食障碍、物质使用障碍、睡眠障碍
- 治疗方法总览：心理治疗、物理治疗与综合管理
- 分疾病治疗：抑郁症治疗、焦虑症治疗、躁狂症治疗、双向情感障碍治疗、人格障碍治疗、精神分裂症治疗
- 心身医学：总览、慢性疾病与精神健康
- 药物分类总览：抗抑郁药、抗焦虑药、抗精神病药、心境稳定剂等
- 药理分类与安全监测：随访与风险提示
- 分疾病用药：抑郁症用药、焦虑症用药、躁狂症用药、双向情感障碍用药、人格障碍用药、精神分裂症用药
- 诊断标准：DSM-5和ICD-11国际权威诊断标准
- 评估工具：专业评估量表和自助筛查工具
- 治疗资源：专业机构、支持热线、在线平台等
- 学习资源：医学术语、评估工具、实际案例
- 患者：获取疾病信息、治疗方法和就医指引
- 家属：了解如何支持患者，获取照顾技巧
- 专业人士：参考最新的研究和临床指南
- 公众：学习精神健康知识，减少污名化
- 教育工作者：用于教学和培训
- Python 3.11+（建议）
- pip
pip install -r requirements.txt如本地中文搜索报错，请安装/升级以下依赖：
pip install --upgrade "lunr[languages]" nltk scikit-learn pandas numpymkdocs serve
# 仅本机访问：http://127.0.0.1:8000/若希望同一局域网多设备访问：
mkdocs serve -a 0.0.0.0:8000
# 其他设备使用 http://<你的IPv4地址>:8000/
# 如被阻止，请在 Windows 防火墙放行端口 8000 或允许 python.exe 网络访问提示：部分环境会阻断 Google Fonts 加载，属非关键资源，页面仍可正常使用。
| 命令 | 描述 |
|---|---|
mkdocs serve |
启动本地预览（仅本机访问） |
mkdocs serve -a 0.0.0.0:8000 |
启动本地预览（局域网访问） |
mkdocs build |
构建静态站点 |
mkdocs build --clean |
清理后重新构建 |
mkdocs build --strict |
严格模式构建（将警告视为错误） |
mkdocs --version |
查看版本与诊断 |
mkdocs gh-deploy --force |
手动部署到 GitHub Pages |
| 问题 | 解决方案 |
|---|---|
| 中文搜索报依赖错误 | pip install --upgrade "lunr[languages]" nltk scikit-learn pandas numpy |
| 局域网无法访问 | 使用 mkdocs serve -a 0.0.0.0:8000 并在防火墙允许端口 8000 |
| 日志提示 "no git logs" | 为未提交文件提示，不影响构建；已配置时间回退，正常使用 |
GMI/
├── .github/workflows/deploy.yml # GitHub Pages 自动部署配置
├── docs/ # 所有 Markdown 内容
│ ├── index.md # 首页与快速入口
│ ├── emergency.md # 紧急帮助
│ ├── anxiety/ # 焦虑障碍（OCD/PTSD/社交焦虑等）
│ ├── children-adolescents/ # 儿童青少年精神健康
│ ├── elderly/ # 老年人精神健康
│ ├── eating-disorders/ # 进食障碍（厌食/贪食/暴食）
│ ├── gender-identity/ # 性别焦虑与跨性别支持
│ ├── lgbtq/ # LGBTQ+精神健康
│ ├── medications/ # 药物指南与药理分类索引
│ ├── neurodevelopmental/ # 神经发育障碍（ADHD/ASD）
│ ├── psychosomatic/ # 心身医学
│ ├── substance-use/ # 物质使用障碍总览
│ ├── treatment-methods/ # 治疗方法分专题
│ └── ... # 其他疾病和资源
├── mkdocs.yml # 站点配置与导航
├── requirements.txt # Python 依赖
└── README.md # 项目说明
- 静态网站生成器：MkDocs
- 主题：mkdocs-material
- Markdown扩展：
- admonition：提示框
- footnotes：脚注
- tables：表格
- pymdownx.details：折叠块
- pymdownx.superfences：代码块增强
- pymdownx.tabbed：选项卡
- pymdownx.highlight：代码高亮
- pymdownx.emoji：表情符号
- search：搜索功能
- tags：标签功能
- git-revision-date-localized：基于Git日志的本地化日期
- GitHub Pages：自动部署
- Cloudflare Pages：备选部署方案
推送到 main 或 master 分支后，GitHub Actions 会自动构建并发布到 GitHub Pages（见 .github/workflows/deploy.yml）。
-
连接 GitHub 仓库（推荐）
- Build command:
pip install -r requirements.txt && mkdocs build - Output directory:
site - 环境：
Python 3.11；如需中文搜索，请在构建镜像里安装：pip install "lunr[languages]" nltk scikit-learn pandas numpy
- Build command:
-
本地命令发布（Wrangler）
# 1. 安装 Wrangler（需 Node.js/npm） npm install -g wrangler # 2. 构建静态站点 mkdocs build --clean # 3. 创建 Pages 项目（仅首次） wrangler pages project create gmi-guide # 4. 发布到 Pages wrangler pages publish ./site --project-name gmi-guide # 5. 绑定自定义域名（可选） wrangler pages domain add gmi-guide <your-domain>
- 若使用 API 令牌方式，需在环境中配置：
CLOUDFLARE_API_TOKEN与CLOUDFLARE_ACCOUNT_ID
- 若使用 API 令牌方式，需在环境中配置：
我们欢迎任何形式的贡献，包括但不限于：
- 内容补充：添加新的疾病、治疗方法、药物指南等
- 内容改进：优化现有内容，提高准确性和可读性
- 错误修正：纠正拼写错误、事实错误等
- 结构优化：改进导航结构，提高用户体验
- 功能增强：添加新的功能和特性
- Fork 仓库：点击 GitHub 页面右上角的 "Fork" 按钮
- 创建分支：
git checkout -b feature/your-feature - 开发与预览：
mkdocs serve - 提交更改：
git commit -m "feat: your change" - 推送分支：
git push origin feature/your-feature - 创建 Pull Request：在 GitHub 页面上提交 Pull Request
- 准确性：确保内容基于可靠的来源和最新的研究
- 可读性：使用清晰、易懂的语言，避免过多专业术语
- 一致性：保持与现有内容一致的风格和格式
- 引用：注明引用来源，确保版权合规
- 结构：遵循现有的内容结构和模板
我们是一群关注精神健康的专业人士和志愿者，致力于构建一个可靠、易用的精神健康知识库。
感谢所有为 GMI 项目做出贡献的人！您的支持和贡献是我们前进的动力。
- 感谢所有提供支持和反馈的用户
- 感谢精神健康领域的专业人士提供的指导和审核
- 感谢 MkDocs 和 mkdocs-material 团队提供的优秀工具
- 感谢所有开源项目的贡献者
本项目内容仅供教育与信息参考，不替代专业医疗建议、诊断或治疗。如果您或您认识的人正在经历精神健康问题，请立即寻求专业医疗帮助。
- 医疗急救：
120 - 全国心理危机干预热线：
400-161-9995 - 青少年心理咨询热线：
12355 - 全国统一心理援助热线：
12356
本项目采用 MIT License 开源。请在使用与分发时保留原始版权声明。
- 团队GitHub：点击跳转
- 邮箱：gmi@aprism.top
- 新增 LGBTQ+ 精神健康板块
- 扩展了性别认同与跨性别相关内容
- 优化了导航结构
- 修复了搜索功能
- 新增儿童青少年精神健康板块
- 新增老年人精神健康板块
- 新增心身医学板块
- 扩展了焦虑障碍相关内容
- 更新诊断标准手册
- 项目初始化
- 基本框架搭建
- 核心内容添加
本项目致力于减少精神健康的污名化，促进理解和支持。如果您对精神健康有任何疑问或需要帮助，请不要犹豫，寻求专业支持。