照见自己，成为更好的自己。
开源专业心理测评与成长平台
功能特点 • 快速开始 • 项目介绍 • 技术栈 • 测评目录
心镜 MindMirror 是一个开源的心理测评与个人成长平台。我们致力于通过科学的心理测评工具，帮助用户更好地了解自己、探索内心世界、促进个人成长。
- 🧘 自我探索 - 通过专业测评深入了解自己
- 📊 数据可视化 - 直观的图表展示，让结果更易理解
- 🎯 个性化建议 - 根据测评结果提供具体的成长建议
- 🔒 隐私保护 - 本地计算，数据安全，尊重隐私
- 📱 移动端支持 - PWA 支持，随时随地测评
- 66+ 种专业心理测评，涵盖人格、能力、情绪、职业等多个维度
- 6 大测评分类，满足不同的探索需求
- 专业量表，基于科学心理学理论
- 现代化的深色主题设计
- 流畅的动画效果
- 响应式布局，支持多设备
- 精美的图表可视化展示
- 详细的维度分析
- 个性化的描述和建议
- 直观的雷达图、柱状图展示
- 支持结果分享和导出
- 渐进式 Web 应用 (PWA) 支持
- 快速的加载速度
- 离线访问能力
- 流畅的答题体验
- Node.js 18 或更高版本
- npm 或 yarn 或 pnpm 包管理器
# 1. 克隆项目
git clone <repository-url>
cd mindmirror
# 2. 安装依赖
npm install
# 3. 配置环境变量（可选）
cp .env.example .env.development
# 编辑 .env.development 文件配置你的环境变量
# 4. 启动开发服务器
npm run dev
# 5. 构建生产版本
npm run build# 启动开发服务器
npm run dev
# 构建生产版本
npm run build
# 预览生产构建
npm run preview
# 类型检查
npm run typecheck
# 代码检查
npm run lint
# 代码格式化
npm run format
# 清理构建缓存
npm run clean
# 分析包大小
npm run analyze- SBTI 人格测试 - 有趣又准的人格测评
- 大五人格测试 - 科学全面的人格模型
- 黑暗三人格测试 - 探索你的阴暗面
- 心理韧性测试 - 评估你的抗压能力
- 心理年龄测试 - 测测你的心理年龄
- 成长型思维测试 - 了解你的思维模式
- 元认知能力测试 - 评估你的自我反思能力
- 成人依恋类型测试 - 了解你的依恋模式
- 戈尔曼情商测试 - 全面评估你的情商
- 爱情动物测试 - 探索你的爱情风格
- 情感成熟度测试 - 评估你的情感成熟度
- 养育风格测试 - 了解你的育儿方式
- TKI 冲突管理模式测试 - 了解你处理冲突的方式
- 情绪劳动量表 - 评估情绪管理能力
- SAS 焦虑自评量表 - 专业焦虑评估
- SDS 抑郁自评量表 - 抑郁程度评估
- PSS 压力知觉量表 - 了解你的压力水平
- 职业倦怠测试 - 评估职业倦怠程度
- 网络成瘾测试 - 评估网络使用情况
- 症状自评量表 SCL-90 - 全面心理健康评估
- PSQI 睡眠质量指数 - 评估你的睡眠质量
- 组织公民行为量表 - 评估工作表现行为
- 霍兰德职业兴趣测试 - 探索适合的职业方向
- 学习风格测试 - 了解你的学习方式
- 领导力风格测试 - 评估你的领导能力
- 瑞文智力测验 - 测试你的逻辑推理能力
- 意识形态罗盘 - 了解你在不同社会议题上的立场
- 施瓦茨价值观测试 - 探索你的价值取向
- 道德基础量表 - 了解你的道德观念
- 心理资本问卷 - 评估你的心理资本
- 生命意义感量表 - 探索生命的意义
- 爱国情怀量表 - 评估国家认同感
- 福报指数测试 - 测测你的福报值
- 颜色潜意识测试 - 色彩揭示你的内心
- 吃货等级鉴定 - 看看你的吃货级别
- 海贼王悬赏金测试 - 你值多少赏金？
- PUA 抵抗力测试 - 测试你的防坑能力
| 技术 | 版本 | 说明 |
|---|---|---|
| React | 18.2.0 | 用户界面框架 |
| TypeScript | 5.2.2 | 类型安全的 JavaScript |
| Vite | 5.0.0 | 快速的构建工具 |
| React Router | 6.20.0 | 单页应用路由 |
| Zustand | 4.4.7 | 轻量级状态管理 |
- Tailwind CSS - 原子化 CSS 框架
- Framer Motion - 强大的动画库
- Lucide React - 美观的图标库
- Recharts - 强大的图表库
- Three.js - 3D 可视化
- html2canvas - 截图与导出
- jsPDF - PDF 生成
- zod - 数据验证
- uuid - 唯一 ID 生成
mindmirror/
├── public/ # 静态资源
├── src/
│ ├── components/ # 组件
│ │ ├── animations/ # 动画组件
│ │ ├── assessment/ # 测评相关组件
│ │ ├── charts/ # 图表组件
│ │ ├── layout/ # 布局组件
│ │ ├── report-templates/ # 报告模板
│ │ └── ui/ # UI 组件
│ ├── data/ # 数据
│ │ ├── assessments/ # 测评数据
│ │ └── entertainment/ # 趣味测评
│ ├── pages/ # 页面
│ ├── services/ # 服务
│ ├── store/ # 状态管理
│ ├── utils/ # 工具函数
│ │ └── calculators/ # 测评计算器
│ ├── App.tsx # 应用入口
│ └── main.tsx # 主入口
├── scripts/ # 脚本
├── tests/ # 测试
├── .env.example # 环境变量模板
├── .gitignore # Git 忽略文件
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
├── vite.config.ts # Vite 配置
└── tailwind.config.js # Tailwind 配置
项目使用以下环境变量（可在 .env.example 中查看完整说明）：
| 变量名 | 说明 | 默认值 |
|---|---|---|
VITE_APP_TITLE |
应用标题 | 心镜 MindMirror |
VITE_API_BASE_URL |
API 基础地址 | http://localhost:8000 |
VITE_USE_BACKEND_CALCULATION |
是否使用后端计算 | false |
VITE_ENABLE_USER_SYSTEM |
是否启用用户系统 | false |
VITE_CLOUD_SAVE_ENABLED |
是否启用云端保存 | false |
VITE_DEBUG_MODE |
是否启用调试模式 | true |
我们欢迎任何形式的贡献！
- Fork 本仓库
- 创建你的特性分支 (
git checkout -b feature/AmazingFeature) - 提交你的更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启一个 Pull Request
本项目仅供学习和个人使用。
感谢所有为这个项目做出贡献的人！
- 感谢心理学领域的研究者们提供的专业量表
- 感谢开源社区提供的优秀工具和库
✨ 照见自己，成为更好的自己 ✨