docs(desktop): rewrite README in Chinese with integration and build guide

desktop-client/README.md

@@ -1,28 +1,118 @@
-# Wanwan Cloud Desktop Client
+# 玩玩云桌面客户端（Tauri + Vue + TypeScript）
 
-Desktop client for `https://cs.workyai.cn`, built with `Tauri + Vue + TypeScript`.
+这是玩玩云网盘的桌面端，基于 `Tauri 2 + Vue 3 + TypeScript` 开发。
 
-## Features
-- Login with existing web account
-- File list and folder navigation
-- Global search
-- Create folder / rename / delete
-- Download via backend generated direct URL
-- Persisted API server configuration (default: `https://cs.workyai.cn`)
+默认对接地址：`https://cs.workyai.cn`。
+
+## 功能概览
+
+- 账号登录（复用网页端账号体系）
+- 文件列表浏览、目录切换、全局搜索
+- 新建文件夹、重命名、删除
+- 分享链接 / 直链创建与管理
+- 下载（支持断点续传）
+- 本地目录同步（手动/定时）
+- 客户端版本检测与更新下载
+
+## 环境要求
+
+- Node.js 18+（建议 20 LTS）
+- Rust stable（建议通过 `rustup` 安装）
+- Tauri CLI（项目已在 `package.json` 中声明）
+
+可选：Linux 交叉编译 Windows 时还需要：
+
+- `mingw-w64`
+- `nsis`
+
+## 开发运行
 
-## Development
 ```bash
+cd desktop-client
 npm install
 npm run tauri dev
 ```
 
-## Build
+## 对接你的网盘后端
+
+### 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
 ```
 
-Windows cross build on Linux:
+构建产物示例：
+
+- `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：分享/直链重复创建问题
+
+当前后端已支持“同一用户同一路径复用已有链接”。若要生成新链接，请先删除旧链接再创建。