139 lines
2.9 KiB
Markdown
139 lines
2.9 KiB
Markdown
# Pixiv Manager Frontend
|
|
|
|
Pixiv 作品管理前端应用，基于 Vue 3 + TypeScript + Vite + Pinia 构建。
|
|
|
|
## 技术栈
|
|
|
|
- **框架**: Vue 3 (Composition API)
|
|
- **语言**: TypeScript
|
|
- **构建工具**: Vite
|
|
- **状态管理**: Pinia
|
|
- **路由**: Vue Router 4
|
|
- **HTTP 客户端**: Axios
|
|
- **样式**: CSS3 + 响应式设计
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
src/
|
|
├── components/ # 组件目录
|
|
│ ├── common/ # 通用组件
|
|
│ │ ├── LoadingSpinner.vue
|
|
│ │ └── ErrorMessage.vue
|
|
│ └── artwork/ # 作品相关组件
|
|
│ └── ArtworkCard.vue
|
|
├── views/ # 页面组件
|
|
│ ├── HomeView.vue # 首页
|
|
│ ├── LoginView.vue # 登录页
|
|
│ ├── SearchView.vue # 搜索页
|
|
│ ├── ArtworkView.vue # 作品详情页
|
|
│ ├── ArtistView.vue # 作者详情页
|
|
│ ├── DownloadsView.vue # 下载管理页
|
|
│ └── ArtistsView.vue # 作者管理页
|
|
├── services/ # API 服务层
|
|
│ ├── api.ts # 基础 API 服务
|
|
│ ├── auth.ts # 认证相关 API
|
|
│ ├── artwork.ts # 作品相关 API
|
|
│ ├── artist.ts # 作者相关 API
|
|
│ └── download.ts # 下载相关 API
|
|
├── stores/ # Pinia 状态管理
|
|
│ └── auth.ts # 认证状态管理
|
|
├── types/ # TypeScript 类型定义
|
|
│ └── index.ts # 全局类型定义
|
|
├── router/ # 路由配置
|
|
│ └── index.ts # 路由定义
|
|
├── assets/ # 静态资源
|
|
│ └── main.css # 全局样式
|
|
├── App.vue # 根组件
|
|
└── main.ts # 应用入口
|
|
```
|
|
|
|
## 开发指南
|
|
|
|
### 环境要求
|
|
|
|
- Node.js >= 16
|
|
- pnpm >= 7
|
|
|
|
### 安装依赖
|
|
|
|
```bash
|
|
pnpm install
|
|
```
|
|
|
|
### 开发模式
|
|
|
|
```bash
|
|
pnpm dev
|
|
```
|
|
|
|
### 构建生产版本
|
|
|
|
```bash
|
|
pnpm build
|
|
```
|
|
|
|
### 代码检查
|
|
|
|
```bash
|
|
pnpm lint
|
|
```
|
|
|
|
## 主要功能模块
|
|
|
|
### 1. 认证模块
|
|
- Pixiv OAuth 2.0 登录
|
|
- 登录状态管理
|
|
- 自动刷新 Token
|
|
|
|
### 2. 作品搜索
|
|
- 关键词搜索
|
|
- 标签筛选
|
|
- 排序选项
|
|
- 分页加载
|
|
|
|
### 3. 作品详情
|
|
- 作品信息展示
|
|
- 多页作品支持
|
|
- 下载功能
|
|
- 作者信息
|
|
|
|
### 4. 作者管理
|
|
- 作者信息展示
|
|
- 作品列表
|
|
- 关注/取消关注
|
|
- 批量下载
|
|
|
|
### 5. 下载管理
|
|
- 下载任务创建
|
|
- 进度跟踪
|
|
- 历史记录
|
|
- 任务取消
|
|
|
|
## 部署说明
|
|
|
|
### 环境变量
|
|
|
|
创建 `.env` 文件：
|
|
|
|
```env
|
|
VITE_API_BASE_URL=http://localhost:3000
|
|
```
|
|
|
|
> **注意**: 在生产环境中，前端会自动使用当前域名和端口，无需手动设置此环境变量。
|
|
|
|
### 构建部署
|
|
|
|
```bash
|
|
# 构建生产版本
|
|
pnpm build
|
|
|
|
# 部署到静态服务器
|
|
# dist/ 目录包含所有静态文件
|
|
```
|
|
|
|
## 许可证
|
|
|
|
本项目仅供学习和个人使用，请遵守 Pixiv 的服务条款。
|
|
|