# ai-study-companion

**Repository Path**: seventy--two/ai-study-companion

## Basic Information

- **Project Name**: ai-study-companion
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-19
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 学习伴侣 - 前端项目

## 项目简介
AI 学习伴侣是一个智能学习辅助系统，帮助用户更好地管理学习进度、分析学习数据，提供个性化的学习建议。

## 技术栈
- Vue 3
- TypeScript
- Element Plus
- Vue Router
- ECharts
- Sass

## 项目结构
frontend/
├── public/             # 静态资源
├── src/
│   ├── assets/        # 项目资源文件
│   ├── components/     # 组件
│   │   └── common/     # 通用组件
│   ├── plugins/        # 插件
│   ├── router/         # 路由配置
│   ├── views/          # 页面
│   │   └── hh/         # 学习数据相关页面
│   ├── App.vue         # 应用根组件
│   └── main.ts         # 应用入口
├── index.html          # HTML 模板
├── package.json        # 项目配置
├── tsconfig.json       # TypeScript 配置
└── vite.config.ts      # Vite 配置

## 环境要求
- Node.js 10.x
- npm 6.x 或更高版本

## 功能模块
1. **学习数据仪表盘** - 展示学习时长、进度等数据
2. **学习科目管理** - 管理不同学习科目
3. **学习数据统计** - 使用 ECharts 展示学习数据图表

## 开发指南

### 安装依赖

```bash
# 删除旧的依赖目录和锁文件（如果存在，不行就直接手动删除）
rmdir /s /q node_modules
if exist package-lock.json del package-lock.json

# 使用国内镜像安装依赖（推荐）
npm install --no-optional --registry=https://registry.npmmirror.com --force

### 开发环境运行
npm run dev

### 构建生产版本
npm run build

### 代码检查
npm run lint

## 项目说明
- 本项目使用 Vue 3 + TypeScript 开发
- 使用 Element Plus 作为 UI 框架
- 使用 ECharts 进行数据可视化
- 使用 Sass 作为 CSS 预处理器
- 项目结构清晰，便于维护和扩展
### Node.js 版本兼容问题
问题 ：运行时出现 Node.js 版本不兼容错误 解决方案 ：项目已配置为兼容 Node.js 10，禁用了 esbuild

### 4. Sass 依赖问题
问题 ：Sass 无法访问 Node.js 内置模块 解决方案 ：项目已在 vite.config.ts 中配置了 allowNodeBuiltins: ['sass']

## 项目说明
- 本项目使用 Vue 3 + TypeScript 开发
- 使用 Element Plus 作为 UI 框架
- 使用 ECharts 进行数据可视化
- 使用 Sass 作为 CSS 预处理器
- 项目结构清晰，便于维护和扩展
## 团队协作说明
1. 确保使用相同版本的 Node.js（10.x）
2. 严格按照上述依赖安装步骤操作
3. 如有问题，请参考常见问题解决方案
4. 开发完成后，运行 npm run build 确保项目可以正常构建

### 修改说明（1.21留）

1. **环境要求**：明确指定了 Node.js 10.x 版本要求，与你的环境一致

2. **依赖安装步骤**：
   - 添加了清理旧依赖的步骤
   - 明确使用国内镜像 `https://registry.npmmirror.com`
   - 添加了 `--no-optional` 和 `--force` 参数，解决可能的依赖问题

3. **常见问题解决方案**：
   - 添加了 fsevents 依赖问题的解决方案
   - 添加了 Element Plus 样式导入问题的解决方案
   - 添加了 Node.js 版本兼容问题的解决方案
   - 添加了 Sass 依赖问题的解决方案

4. **团队协作说明**：
   - 强调使用相同版本的 Node.js
   - 提供了清晰的安装步骤
   - 建议开发完成后运行构建命令确保项目可以正常构建

这些修改将确保你的队员能够顺利安装和运行项目，即使他们可能没有配置一些依赖。