119 lines
3.0 KiB
Markdown
119 lines
3.0 KiB
Markdown
# 玩玩云桌面客户端（Tauri + Vue + TypeScript）
|
||
|
||
这是玩玩云网盘的桌面端，基于 `Tauri 2 + Vue 3 + TypeScript` 开发。
|
||
|
||
默认对接地址：`https://cs.workyai.cn`。
|
||
|
||
## 功能概览
|
||
|
||
- 账号登录（复用网页端账号体系）
|
||
- 文件列表浏览、目录切换、全局搜索
|
||
- 新建文件夹、重命名、删除
|
||
- 分享链接 / 直链创建与管理
|
||
- 下载（支持断点续传）
|
||
- 本地目录同步（手动/定时）
|
||
- 客户端版本检测与更新下载
|
||
|
||
## 环境要求
|
||
|
||
- Node.js 18+（建议 20 LTS）
|
||
- Rust stable（建议通过 `rustup` 安装）
|
||
- Tauri CLI（项目已在 `package.json` 中声明）
|
||
|
||
可选：Linux 交叉编译 Windows 时还需要：
|
||
|
||
- `mingw-w64`
|
||
- `nsis`
|
||
|
||
## 开发运行
|
||
|
||
```bash
|
||
cd desktop-client
|
||
npm install
|
||
npm run tauri dev
|
||
```
|
||
|
||
## 对接你的网盘后端
|
||
|
||
### 1. 修改 API 基础地址
|
||
|
||
当前默认地址在 `desktop-client/src/App.vue`：
|
||
|
||
- `appConfig.baseUrl`（默认 `https://cs.workyai.cn`）
|
||
|
||
改成你的服务地址后重新运行/打包。
|
||
|
||
### 2. 后端需提供的核心接口
|
||
|
||
桌面端通过现有 Web API 工作，至少需要这些接口：
|
||
|
||
- `POST /api/login`
|
||
- `POST /api/logout`
|
||
- `GET /api/user/profile`
|
||
- `GET /api/files`
|
||
- `GET /api/files/search`
|
||
- `POST /api/files/mkdir`
|
||
- `POST /api/files/rename`
|
||
- `POST /api/files/delete`
|
||
- `POST /api/share/create`
|
||
- `GET /api/share/my`
|
||
- `DELETE /api/share/:id`
|
||
- `POST /api/direct-link/create`
|
||
- `GET /api/client/desktop-update`
|
||
- 分片上传相关接口（客户端走 `api_upload_file_resumable`）
|
||
|
||
### 3. 鉴权与跨域要求
|
||
|
||
- 使用 Cookie / Session 鉴权
|
||
- 服务端允许桌面端跨域并携带凭据（credentials）
|
||
- 建议启用 HTTPS
|
||
|
||
## 构建打包
|
||
|
||
```bash
|
||
cd desktop-client
|
||
npm install
|
||
npm run tauri build
|
||
```
|
||
|
||
构建产物示例：
|
||
|
||
- `desktop-client/src-tauri/target/release/bundle/nsis/*.exe`
|
||
|
||
## Linux 交叉编译 Windows（x64）
|
||
|
||
```bash
|
||
cd desktop-client
|
||
rustup target add x86_64-pc-windows-gnu
|
||
npm run tauri build -- --target x86_64-pc-windows-gnu
|
||
```
|
||
|
||
如需生成安装包，请确保系统安装 `mingw-w64` 与 `nsis`。
|
||
|
||
## 更新发布接入（与本项目后端配合）
|
||
|
||
1. 把新安装包上传到服务端下载目录（示例：`frontend/downloads/`）。
|
||
2. 在后台设置中更新：
|
||
- `desktop_update.latest_version`
|
||
- `desktop_update.installer_url`
|
||
- `desktop_update.release_notes`
|
||
3. 客户端会通过 `GET /api/client/desktop-update` 检查更新并下载新包。
|
||
|
||
## 常见问题
|
||
|
||
### Q1：改了接口地址但还是连旧地址？
|
||
|
||
确认修改的是 `desktop-client/src/App.vue` 中的 `appConfig.baseUrl`，并重新构建。
|
||
|
||
### Q2：为什么更新接口返回有新版本，但客户端不弹更新？
|
||
|
||
检查：
|
||
|
||
- `latest_version` 是否确实大于客户端当前版本
|
||
- `installer_url` 是否可访问
|
||
- 客户端能否访问后端 `desktop-update` 接口
|
||
|
||
### Q3：分享/直链重复创建问题
|
||
|
||
当前后端已支持“同一用户同一路径复用已有链接”。若要生成新链接，请先删除旧链接再创建。
|