# instinct-learning

**Repository Path**: 644504719/instinct-learning

## Basic Information

- **Project Name**: instinct-learning
- **Description**: 实训项目，校园实训项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 本能学习工坊 (Instinct Learning) - MVP 版

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Vue](https://img.shields.io/badge/Frontend-Vue%203-brightgreen.svg)](https://vuejs.org/)
[![Node.js](https://img.shields.io/badge/Backend-Node.js-blue.svg)](https://nodejs.org/)
[![DeepSeek](https://img.shields.io/badge/AI-DeepSeek%20API-orange.svg)](https://www.deepseek.com/)

**本能学习工坊** 是一款专为营销人员与演艺爱好者打造的 **AI 场景化实训平台**。通过集成 DeepSeek 大模型能力，模拟真实业务场景与演艺对白，为用户提供低成本、高效率的对话训练环境，并给出专业化的反馈建议与评分。

---

## 🌟 核心特性

### 1. 沉浸式 AI 场景实训
- **营销获客**：模拟真实的客户咨询与拒绝场景，训练销售话术与应变能力。
- **演艺指导**：模拟经典或自定义对白，AI 扮演对手戏角色，并对台词表现进行多维度评价。

### 2. 智能评估系统
- **实时评分**：基于 DeepSeek API，对用户的每一句输入进行 1-10 分的即时评分。
- **改进建议**：AI 会根据对话语境，提供具体的改进方案，帮助用户快速迭代技巧。

### 3. 个人数据看板
- **训练统计**：可视化展示近 7 天的训练频次，追踪学习进度。
- **成长曲线**：记录历史平均分，直观反馈用户的水平提升。

### 4. 轻量化架构
- **零配置数据库**：使用 SQLite3，无需安装复杂的数据库环境。
- **安全保障**：采用 JWT 令牌验证机制与 bcrypt 密码加密，确保用户数据安全。

---

## 🛠️ 技术栈

### 前端
- **框架**：Vue 3 (Composition API)
- **构建工具**：Vite
- **UI 组件库**：Element Plus
- **状态管理**：Pinia
- **图表库**：ECharts
- **网络请求**：Axios

### 后端
- **运行环境**：Node.js
- **Web 框架**：Express
- **数据库**：SQLite3
- **认证/安全**：JSON Web Token (JWT), bcryptjs
- **环境配置**：dotenv

---

## 🚀 快速启动

### 前置要求
- Node.js (v16.0.0+)
- npm (v8.0.0+)
- DeepSeek API Key ([获取地址](https://platform.deepseek.com/))

### 1. 克隆仓库
```bash
git clone https://gitee.com/goodmcksm/instinct-learning.git
cd instinct-learning
```

### 2. 后端部署
```bash
cd backend
npm install
# 准备环境配置文件
cp .env-example .env
```
> **注意**：请编辑 `backend/.env` 文件，填入您的 `DEEPSEEK_API_KEY`。

启动服务：
```bash
node index.js
```

### 3. 前端部署
```bash
cd ../frontend
npm install
npm run dev
```
访问 `http://localhost:5173` 即可开始训练。

---

## 📁 项目目录结构

```text
instinct-learning/
├── frontend/                # 前端 Vue3 项目
│   ├── src/
│   │   ├── api/             # Axios 接口封装
│   │   ├── router/          # 路由配置与权限守卫
│   │   ├── store/           # Pinia 状态管理 (用户信息)
│   │   ├── views/           # 页面组件 (训练、看板、登录等)
│   │   └── main.js          # 入口文件
├── backend/                 # 后端 Node.js 项目
│   ├── middleware/          # 身份验证中间件
│   ├── routes/              # API 业务路由 (用户、训练记录)
│   ├── database.js          # SQLite 数据库初始化逻辑
│   ├── .env-example         # 环境配置模板
│   └── index.js             # 服务入口
└── README.md                # 项目主说明文档
```

---

## 📅 迭代路线 (Roadmap)
- [x] **V1.0 (MVP)**: 核心训练流程、基础看板、SQLite 集成。
- [ ] **V1.1**: 训练记录批量管理、AI 反馈逻辑深度优化。
- [ ] **V1.2**: 增加学习资源模块（视频/图文）、第三方社交登录。
- [ ] **V1.3**: 管理员管理后台、接口防注入与请求频率限制加固。

---

## 📄 开源协议
本项目遵循 [MIT License](LICENSE) 开源协议。

## 🤝 贡献指南
欢迎提交 Issue 或 Pull Request 来完善这个项目！

1. Fork 本仓库
2. 新建 Feature 分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request