# 快码

**Repository Path**: XY1912/quick-code

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-21
- **Last Updated**: 2025-11-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快分享 - 二维码分享工具

## 项目简介

**快分享**是一个基于Vue 3开发的高效二维码分享工具，旨在提供简单、便捷的内容分享方式。用户可以通过选择链接、图片、文件或媒体内容，快速生成对应二维码，方便在不同设备间传输和分享信息。

## 核心功能

- **多类型内容支持**：链接、图片、文件、媒体等多种内容类型分享
- **二维码生成**：自动为选定内容生成高质量二维码
- **历史记录管理**：保存和管理历史分享记录
- **响应式设计**：适配桌面端、平板和移动设备
- **深色模式支持**：根据系统设置自动切换主题
- **错误处理机制**：完善的通知和错误提示系统
- **文件上传进度显示**：支持大文件上传进度可视化

## 技术栈

- **前端框架**：Vue 3 + Composition API + `<script setup>`
- **状态管理**：Pinia
- **构建工具**：Vite
- **编程语言**：TypeScript
- **二维码生成**：qrcode.vue
- **网络请求**：axios
- **路由管理**：vue-router
- **测试框架**：Vitest + @vue/test-utils

## 项目结构

```
src/
├── assets/           # 静态资源文件
├── components/       # Vue组件
│   ├── ContentSelector.vue     # 内容选择组件
│   ├── QRCodePreview.vue       # 二维码预览组件
│   ├── ShareHistory.vue        # 历史记录组件
│   ├── NotificationManager.vue # 通知管理组件
│   └── ErrorNotification.vue   # 错误通知组件
├── services/         # 服务层
│   └── errorService.ts         # 错误处理服务
├── stores/           # Pinia状态管理
│   └── shareStore.ts           # 分享相关状态
├── App.vue           # 根组件
├── main.ts           # 应用入口
└── style.css         # 全局样式
```

## 安装与运行

### 前提条件

- Node.js 16.x 或更高版本
- npm 或 yarn 包管理器

### 安装步骤

1. 克隆项目仓库
```bash
git clone https://gitee.com/XY1912/quick-code.git
cd KUAI
```

2. 安装依赖
```bash
npm install
# 或
yarn install
```

3. 启动开发服务器
```bash
npm run dev
# 或
yarn dev
```

4. 构建生产版本
```bash
npm run build
# 或
yarn build
```

5. 运行单元测试
```bash
npm run test
# 或
yarn test
```

6. 预览生产版本
```bash
npm run preview
# 或
yarn preview
```

## 使用指南

1. **分享新内容**
   - 在主页选择内容类型（链接、图片、文件等）
   - 根据选择的类型输入或上传内容
   - 系统自动生成二维码
   - 使用手机或其他设备扫描二维码获取内容

2. **查看历史记录**
   - 点击页面顶部的"历史记录"按钮
   - 浏览之前分享过的内容
   - 点击任意历史记录项可重新生成对应二维码

3. **支持的内容类型**
   - **链接**：网页URL、文档链接等
   - **图片**：JPG、PNG、GIF等常见图片格式
   - **文件**：PDF、Office文档、文本文件等（限制10MB以内）
   - **媒体**：视频文件（限制50MB以内）

## 开发说明

### 组件开发

项目使用Vue 3的组合式API和`<script setup>`语法糖进行组件开发。每个组件负责单一功能，保持高内聚低耦合。

### 状态管理

使用Pinia进行状态管理，主要状态集中在`shareStore.ts`中，包括：
- 当前选择的内容
- 历史记录数据
- 错误状态管理

### 错误处理

通过`errorService.ts`提供统一的错误处理机制，支持：
- 显示用户友好的错误通知
- 错误日志记录
- 全局错误捕获

## 性能优化

- 使用Vue 3的响应式系统优化渲染性能
- 实现文件上传进度监控
- 优化二维码生成过程
- 响应式布局适配不同设备

## 浏览器兼容性

支持以下主流浏览器：
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

## 许可证

MIT License

## 致谢

- [Vue.js](https://vuejs.org/) - 渐进式JavaScript框架
- [Pinia](https://pinia.vuejs.org/) - Vue的新一代状态管理库
- [qrcode.vue](https://github.com/scopewu/qrcode.vue) - Vue二维码组件
- [Vite](https://vitejs.dev/) - 下一代前端构建工具

---

© 2024 快分享 - 轻松分享，便捷连接