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
安装依赖
pnpm install
开发模式
pnpm dev
构建生产版本
pnpm build
代码检查
pnpm lint
主要功能模块
1. 认证模块
- Pixiv OAuth 2.0 登录
- 登录状态管理
- 自动刷新 Token
2. 作品搜索
- 关键词搜索
- 标签筛选
- 排序选项
- 分页加载
3. 作品详情
- 作品信息展示
- 多页作品支持
- 下载功能
- 作者信息
4. 作者管理
- 作者信息展示
- 作品列表
- 关注/取消关注
- 批量下载
5. 下载管理
- 下载任务创建
- 进度跟踪
- 历史记录
- 任务取消
部署说明
环境变量
创建 .env 文件:
VITE_API_BASE_URL=http://localhost:3000
注意: 在生产环境中,前端会自动使用当前域名和端口,无需手动设置此环境变量。
构建部署
# 构建生产版本
pnpm build
# 部署到静态服务器
# dist/ 目录包含所有静态文件
许可证
本项目仅供学习和个人使用,请遵守 Pixiv 的服务条款。