vue-driven-cloud-storage/desktop-client

玩玩云桌面客户端（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

开发运行

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

构建打包

cd desktop-client
npm install
npm run tauri build

构建产物示例：

• desktop-client/src-tauri/target/release/bundle/nsis/*.exe

Linux 交叉编译 Windows（x64）

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：分享/直链重复创建问题

当前后端已支持“同一用户同一路径复用已有链接”。若要生成新链接，请先删除旧链接再创建。