✨ 云聚书，书载鸿，鸿成庆 ✨
🎓 一个基于现代化技术栈构建的智能教育协作平台，融合AI驱动的项目匹配、知识管理、在线学习和团队协作功能，为学生和教育者提供全方位的创新支持
鸿庆书云是一个集成了人工智能技术的现代化教育协作平台，专为高等教育环境设计。平台通过智能算法实现精准的项目-学生匹配，结合丰富的学习资源和协作工具，为学生创新项目、学术研究和技能提升提供全方位支持。
- 🤖 AI驱动匹配：基于技能、兴趣和项目需求的智能推荐系统
- 📚 一站式学习：从课程学习到项目实践的完整教育闭环
- 🌐 协作生态：支持多人协作的项目管理和团队沟通
- 💡 知识沉淀：结构化的知识库和笔记系统
- 🔧 跨平台支持：Web和桌面应用双重体验
|
|
| 技术栈 | 版本 | 描述 | 应用场景 |
|---|---|---|---|
 |
v3.4.0 |
现代化的 JavaScript 框架 | 组合式API、响应式数据管理 |
 |
v5.0.0 |
下一代前端构建工具 | 快速开发构建、热模块替换 |
 |
v4.x |
官方路由管理器 | SPA路由管理、导航守卫 |
 |
v2.1.0 |
轻量级状态管理库 | 全局状态、用户认证管理 |
 |
v2.4.0 |
企业级 UI 组件库 | 界面组件、表单验证 |
 |
v1.11.0 |
HTTP 客户端库 | API请求、拦截器处理 |
 |
v30.0.0 |
跨平台桌面应用框架 | 桌面应用打包、本地功能 |
| 工具 | 版本 | 用途 | 配置 |
|---|---|---|---|
| ESLint | latest |
代码质量检查 | JavaScript/Vue代码规范 |
| DOMPurify | v3.1.6 |
HTML安全处理 | 防XSS攻击、内容净化 |
| Marked | v12.0.2 |
Markdown解析 | 文档渲染、笔记处理 |
| Electron Builder | v24.13.3 |
应用打包工具 | 多平台桌面应用构建 |
| Concurrently | v9.0.0 |
并行任务执行 | 开发环境多进程管理 |
graph TB
A[用户界面层] --> B[路由管理层]
B --> C[状态管理层]
C --> D[服务层]
D --> E[数据持久层]
A1[Vue3 组合式API] --> A
A2[Element Plus UI] --> A
A3[响应式设计] --> A
B1[Vue Router] --> B
B2[导航守卫] --> B
B3[路由懒加载] --> B
C1[Pinia Store] --> C
C2[用户状态] --> C
C3[应用配置] --> C
D1[HTTP Client] --> D
D2[API Service] --> D
D3[缓存策略] --> D
E1[后端API] --> E
E2[本地存储] --> E
E3[文件系统] --> E
|
|
|
| 工具 | 版本要求 | 推荐版本 | 下载链接 |
|---|---|---|---|
 |
≥ 18.0.0 |
20.x LTS |
nodejs.org |
 |
≥ 9.0.0 |
latest |
随Node.js安装 |
 |
latest |
latest |
git-scm.com |
# 📥 1. 克隆项目
git clone https://github.com/1fantasy1/vue.git
cd vue
# 📦 2. 安装依赖
npm install
# ⚙️ 3. 环境配置（可选）
cp .env.example .env
# 编辑 .env 文件设置API地址等配置
# 启动开发服务器
npm run dev
# 🌐 访问地址
# http://localhost:5173功能特性：
|
# 启动Electron开发模式
npm run electron:dev
# 📱 桌面应用体验
# 自动打开桌面应用窗口功能特性：
|
# 🌐 Web应用构建
npm run build
# 👀 预览构建结果
npm run preview
# 🖥️ 桌面应用打包
npm run build:app
# 生成的安装包位于 release/ 目录# 构建Docker镜像
docker build -t hongqing-shuyun .
# 运行容器
docker run -p 8080:80 hongqing-shuyun鸿庆书云/
├── 📄 index.html # 应用入口HTML
├── ⚙️ jsconfig.json # JavaScript配置
├── 📦 package.json # 项目依赖与脚本
├── 📖 README.md # 项目文档
├── 🛠️ vite.config.js # Vite构建配置
├── 🌍 .env # 环境变量配置
├── 🖥️ electron/ # Electron桌面应用
│ ├── ⚡ main.cjs # 主进程文件
│ └── 🔧 preload.cjs # 预加载脚本
├── 🌍 public/ # 公共静态资源
│ ├── 🎯 favicon.ico # 网站图标
│ └── 📜 layout-test.js # 布局测试脚本
├── 📦 release/ # 应用发布包
│ ├── 🖥️ 鸿庆书云 1.0.0.exe # Windows可执行文件
│ ├── 📦 鸿庆书云 Setup 1.0.0.exe # Windows安装程序
│ └── 📂 win-unpacked/ # Windows解包文件
└── 🎨 src/ # Vue应用源码
├── 🏠 App.vue # 根组件
├── 🚪 main.js # 应用入口
├── 🎨 assets/ # 静态资源
│ ├── 🎭 base.css # 基础样式
│ ├── 🖼️ logo.svg # 项目Logo
│ └── 💄 main.css # 主样式文件
├── 🧩 components/ # 通用组件库
│ ├── 🔧 APITestTool.vue # API测试工具组件
│ ├── ⭐ CollectButton.vue # 收藏按钮组件
│ ├── 📝 CollectionModal.vue # 收藏弹窗组件
│ ├── 📚 CourseRecommendations.vue # 课程推荐组件
│ ├── 🎉 HelloWorld.vue # 示例组件
│ ├── 🖼️ HtmlPreview.vue # HTML预览组件
│ ├── 🤖 LLMExampleComponent.vue # LLM示例组件
│ ├── 📄 MaterialDetailModal.vue # 资料详情弹窗
│ ├── 📚 MaterialManager.vue # 资料管理组件
│ ├── 📝 NoteModal.vue # 笔记弹窗组件
│ ├── 🎯 ProjectApplications.vue # 项目申请组件
│ ├── 📋 ProjectForm.vue # 项目表单组件
│ ├── 🎉 TheWelcome.vue # 欢迎组件
│ ├── 📋 WelcomeItem.vue # 欢迎项组件
│ ├── 🎭 icons/ # 图标组件集合
│ └── ⚙️ settings/ # 设置相关组件
├── 🎪 composables/ # 组合式函数
│ ├── 📡 useApiData.js # API数据处理钩子
│ ├── 🤖 useLLMConfig.js # LLM配置管理钩子
│ └── 💾 useLocalData.js # 本地数据管理钩子
├── ⚙️ config/ # 应用配置
│ └── 📝 index.js # 主配置文件
├── 🛣️ router/ # 路由管理
│ ├── 🎯 index.js # 当前路由配置
│ ├── 💾 index_backup.js # 路由配置备份
│ └── 🆕 index_new.js # 新路由配置
├── 🔗 services/ # 服务层
│ ├── 🌐 api.js # 统一API接口
│ ├── 💾 cache.js # 缓存服务
│ ├── 📡 httpClient.js # HTTP客户端
│ └── 🌍 remoteApi.js # 远程API服务
├── 🗃️ stores/ # 状态管理 (Pinia)
│ └── 🌍 global.js # 全局状态管理
├── 🔧 utils/ # 工具函数库
└── 📱 views/ # 页面视图组件
├── 🏠 Home.vue # 首页
├── 🌟 Plaza.vue # 广场页面
├── 👤 Profile.vue # 个人中心
├── 🔐 Login.vue # 登录页面
├── 🎯 MyProjects.vue # 我的项目
├── 📚 MyCourses.vue # 我的课程
├── ⭐ Favorites.vue # 收藏夹
├── 📖 KnowledgeBase.vue # 知识库
├── 🧠 KnowledgeHub.vue # 知识中心
├── � ChatRooms.vue # 聊天室
├── 📝 CourseNotes.vue # 课程笔记
├── ⚡ QuickNotes.vue # 快速笔记
├── 🛠️ DevTools.vue # 开发工具
├── 🧪 APITest.vue # API测试页面
├── 📊 ProjectDetail.vue # 项目详情
├── 📚 CourseDetail.vue # 课程详情
├── 📑 DocumentDetail.vue # 文档详情
├── 🏢 AllProjects.vue # 所有项目
├── 🎓 CourseBrowser.vue # 课程浏览
├── 🎛️ CourseManagement.vue # 课程管理
├── ⭐ CollectionDetail.vue # 收藏详情
├── 🎯 ProjectRecommendations.vue # 项目推荐
└── 📝 CourseNotes_new.vue # 新版课程笔记
|
|
| IDE | 插件 | 说明 | 配置 |
|---|---|---|---|
 |
Volar | Vue 3 语言支持 | 替代Vetur插件 |
|
ESLint | 代码质量检查 | 自动修复和格式化 |
|
Prettier | 代码格式化 | 统一代码风格 |
项目已配置推荐扩展，VS Code会自动提示安装：
{
"recommendations": [
"Vue.volar",
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode",
"bradlc.vscode-tailwindcss"
]
}项目支持多环境配置，创建相应环境文件：
| 文件 | 环境 | 用途 | 示例配置 |
|---|---|---|---|
.env |
通用 | 所有环境通用配置 | VITE_APP_TITLE=鸿庆书云 |
.env.development |
开发 | 开发环境专用配置 | VITE_API_BASE_URL=http://localhost:8001 |
.env.production |
生产 | 生产环境专用配置 | VITE_API_BASE_URL=https://api.hongqing.com |
.env.local |
本地 | 本地开发个人配置 | 不会被git跟踪 |
# API配置
VITE_API_BASE_URL=http://localhost:8000 # 后端API地址
VITE_WS_BASE_URL=ws://localhost:8000/ws # WebSocket地址
# 应用配置
VITE_APP_NAME=鸿庆书云 # 应用名称
VITE_APP_VERSION=1.0.0 # 应用版本
VITE_APP_DESCRIPTION=智能创新协作平台 # 应用描述
# 功能开关
VITE_ENABLE_RAG=true # 启用RAG功能
VITE_ENABLE_RECOMMENDATION=true # 启用推荐系统
VITE_ENABLE_SEARCH=true # 启用搜索功能
VITE_ENABLE_AI_CHAT=true # 启用AI聊天
# 文件上传配置
VITE_MAX_FILE_SIZE=10485760 # 最大文件大小(10MB)
VITE_SUPPORTED_FILE_TYPES=.txt,.pdf,.doc,.docx # 支持的文件类型
# 开发配置
VITE_DEV_TOOLS=true # 开发工具
VITE_DEBUG_MODE=true # 调试模式
|
|
|
graph TD
A[用户界面] --> B[状态管理]
B --> C[API服务层]
C --> D[HTTP客户端]
D --> E[后端API]
F[缓存层] --> C
C --> F
G[本地存储] --> B
B --> G
H[WebSocket] --> B
I[AI服务] --> C
J[文件系统] --> C
subgraph "前端架构"
A
B
F
G
end
subgraph "服务层"
C
D
H
end
subgraph "外部服务"
E
I
J
end
项目采用前后端分离架构，支持灵活的API配置和多环境部署。
// vite.config.js - 开发代理
export default {
server: {
proxy: {
'/api': {
target: 'http://127.0.0.1:8001',
changeOrigin: true,
secure: false,
rewrite: (path) => path.replace(/^\/api/, '')
}
}
}
}特性：
|
# .env.production
VITE_API_BASE_URL=https://api.hongqing.com
VITE_WS_BASE_URL=wss://api.hongqing.com/ws
VITE_CDN_BASE_URL=https://cdn.hongqing.com特性：
|
// 统一API服务封装
export class ApiService {
// 项目管理API
static async getProjects(filters) { /* ... */ }
static async createProject(data) { /* ... */ }
static async updateProject(id, data) { /* ... */ }
// 课程学习API
static async getCourses(params) { /* ... */ }
static async getCourseDetail(id) { /* ... */ }
static async submitNote(courseId, note) { /* ... */ }
// 用户管理API
static async login(credentials) { /* ... */ }
static async getProfile() { /* ... */ }
static async updateProfile(data) { /* ... */ }
// AI集成API
static async chatWithAI(message, context) { /* ... */ }
static async getRecommendations(type, params) { /* ... */ }
}| 模块 | 端点 | 功能 | 认证 |
|---|---|---|---|
| 用户管理 | /users/* |
注册、登录、资料管理 | 🔓/🔒 |
| 项目管理 | /projects/* |
项目CRUD、申请、匹配 | 🔒 |
| 课程系统 | /courses/* |
课程浏览、学习记录 | 🔒 |
| 知识库 | /knowledge/* |
文档管理、搜索 | 🔒 |
| 聊天系统 | /chat/* |
消息发送、群组管理 | 🔒 |
| 文件管理 | /files/* |
上传、下载、预览 | 🔒 |
| AI服务 | /ai/* |
对话、推荐、分析 | 🔒 |
| MCP集成 | /mcp/* |
MCP服务器管理 | 🔒 |
|
|
|
|
|
|
|
|
# 1. 环境准备
node --version # 需要 >= 18.0.0
npm --version # 需要 >= 9.0.0
# 2. 安装依赖
npm install
# 3. 启动开发服务器
npm run dev
# 4. 代码检查
npm run lint
# 5. 构建测试
npm run build| 优先级 | 领域 | 描述 | 技能要求 |
|---|---|---|---|
| 🔥 高 | AI功能优化 | 智能推荐算法改进 | Python, 机器学习 |
| 🔥 高 | 性能优化 | 前端性能和用户体验 | Vue.js, 性能分析 |
| 🔥 高 | 移动端适配 | 响应式设计完善 | CSS, 移动端开发 |
| 🔶 中 | 测试覆盖 | 单元和集成测试 | Jest, Vue Test Utils |
| 🔶 中 | 国际化 | 多语言支持 | i18n, 翻译 |
| 🔵 低 | 文档完善 | 开发文档和教程 | 技术写作 |
- 💬 讨论区：GitHub Discussions
- 🐛 问题报告：GitHub Issues
- 📧 邮件联系：fantasy@example.com
- 💬 即时通讯：项目内聊天室功能
|
🌟 重大里程碑 - 正式发布 ✨ 核心功能
🔧 技术成就
📊 数据指标
|
🎊 项目启动 - 基础搭建 🏗️ 基础架构
🎯 初始功能
📈 技术债务
|
|
预计发布: 2025-09-01 🎯 主要特性
🛠️ 技术改进
|
预计发布: 2025-10-01 🤖 AI功能增强
🎨 用户体验
|
预计发布: 2025-11-01 🌐 扩展功能
🏢 企业级特性
|
预计发布: 2025-12-01 🎮 下一代体验
🏗️ 架构升级
|
|
前端技术
开发工具
|
智能化水平
平台生态
|
我们欢迎社区参与到以下版本的开发中：
- 🔥 即刻参与：v1.1.0 用户认证系统开发
- 🌟 提前规划：v1.2.0 AI功能设计讨论
- 🚀 长期合作：v2.0.0 架构设计和技术选型
MIT License 授权您：
- ✅ 商业使用：可用于商业项目
- ✅ 修改代码：可自由修改源代码
- ✅ 分发代码：可重新分发
- ✅ 私人使用：可用于个人项目
- ✅ 专利使用：包含专利授权
但需要：
- 📄 保留版权声明
- 📋 包含许可证副本
不承担：
- 🚫 任何形式的责任和担保
 Fantasy 项目创始人 & 首席开发 💻 🎨 📖 🔧 |
贡献领域
技术专长
|
感谢所有贡献者的付出！ ❤️
|
|
|
适用场景
|
适用场景
|
适用场景
|
适用场景
|
|
|
| 问题类型 | 响应时间 | 处理周期 | 优先级 |
|---|---|---|---|
| 🚨 安全漏洞 | < 2小时 | 24小时内修复 | 🔴 最高 |
| 🐛 严重Bug | < 4小时 | 48小时内修复 | 🟠 高 |
| 💡 功能请求 | < 24小时 | 1-2周评估 | 🟡 中 |
| 📝 文档问题 | < 12小时 | 3-5天修复 | 🟢 低 |
| 🤔 使用咨询 | < 8小时 | 当天回复 | 🔵 普通 |
其他支持方式：
- 🔀 Fork项目：参与代码贡献
- 📢 推荐分享：向朋友推荐项目
- 📝 撰写教程：分享使用经验
- 🐛 反馈问题：帮助改进产品质量
- 💡 提出建议：参与产品规划讨论