Files
pixiv/README.md
T
2025-08-21 13:03:59 +08:00

118 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Pixiv 下载浏览管理器
一个简单易用的 Pixiv 作品下载和浏览管理工具,最近闲着没事逛逛p站,发现p站下载一个个手点累的很,看看现成的项目都比较久远或者是操作麻烦,干脆自己搞一个玩玩。
## 📋 项目介绍
Pixiv 下载浏览管理器是一个基于 Web 的应用程序,提供以下功能:
- 🔐 OAuth 2.0 登录认证
- 🔍 作品搜索和浏览
- 📥 作品下载管理
- 👤 作者搜索
- 🆔 作品ID搜索
## 🚀 快速开始
### 环境要求
- **Node.js** (版本 >= 16.0.0)
- **npm** 或 **pnpm** (推荐使用 pnpm)
### 安装步骤
1. **安装 Node.js**
- 访问 [Node.js 官网](https://nodejs.org/) 下载并安装
2. **解压前端文件**
- 进入 `ui` 目录
- 解压 `dist.zip` 文件到 `ui/dist` 目录
3. **安装依赖**
```bash
# 在项目根目录执行
npm install
# 或者使用 pnpm (推荐)
pnpm install
```
4. **启动应用**
- 修改代理端口,请用记事本打开 `start.bat` 文件,修改PROXY_PORT端口号
- 双击 `start.bat` 文件启动
5. **访问应用**
- 打开浏览器访问:http://localhost:3000
## 🌐 代理配置
当然既然能上P站,怎么上网就不多说了,代理别忘了配置,可以去软件里看(一定要改):
**修改代理端口**
1. 用记事本打开 `start.bat` 文件
2. 找到第6行:`set PROXY_PORT=xxxx`
3. 将 `xxxx` 改为你的代理端口号
**常见代理端口**
- Clash: 7890
- V2Ray: 10809
- Shadowsocks: 1080
- 其他代理软件请查看其设置页面获取端口号
## 🔐 登录认证
### 获取授权码
1. **访问 Pixiv 开发者页面(ui登录页面点击自动跳转)**
![获取授权码1](./pic/获取授权码1.png)
2. **创建应用并获取授权码**
![获取授权码2](./pic/获取授权码2.png)
3. **在应用中输入授权码完成登录(登录一次下次就不用登了)**
## 📱 功能展示
### 主界面
![脚本启动](./pic/脚本启动.png)
### 搜索功能
- **作品搜索**
![搜索作品](./pic/搜索作品.png)
- **作者搜索**
![作者搜索](./pic/作者搜索.png)
- **作品ID搜索**
![作品id搜索](./pic/作品id搜索.png)
### 下载管理
![下载管理](./pic/下载管理.png)
## 🛠️ 开发说明
本项目刚刚建立,很多功能还不够完善,欢迎大家一起参与开发!
### 技术栈
- **后端**: Node.js + Express
- **前端**: Vue3 + Vite
- **包管理**: pnpm (推荐)
### 项目结构
```
你的项目文件/
├── backend/ # 后端服务
├── ui/ # 前端应用
│ ├── dist/ # 打包后的前端文件
│ └── src/ # 前端源码
├── downloads/ # 下载目录
├── data/ # 数据存储
└── start.bat # 启动脚本
```
## 🤝 贡献
欢迎提交 Issue 和 Pull Request 来帮助改进这个项目!
## 许可证
MIT License