Guanya-GUI

项目概述

Guanya-GUI 是光鸭云盘的第三方 Windows 桌面客户端。前端使用 React、TypeScript 与 Vite，桌面层使用 Tauri 2，云盘访问、稳定流代理与 MPV 进程管理则由 Rust 负责。它把音视频统一交给外部 mpv-lazy 播放，不在 WebView 里内嵌播放器，安装包已内置轻量的 MPV 运行时与默认配置，装上即可使用。

用桌面客户端管理网盘，用 MPV 的素质播放音视频。

主要功能

• 登录与会话：支持短信验证码登录、本地会话保持与凭据管理
• 文件管理：文件浏览、目录缓存、移动、复制、删除与下载
• 离线下载：支持把资源离线下载到云盘
• 外部播放：音视频统一交给外部 mpv-lazy 播放，不在 WebView 内嵌播放器
• 流代理：Rust 本地 Range 流代理，签名链接过期后自动刷新并重试
• 播放列表：支持单文件播放、当前列表播放、追加播放与上一项、下一项切换
• MPV 管理：使用单一默认配置，提供启动预热、状态监控与播放列表控制

适用人群

• 使用光鸭云盘管理文件的用户
• 希望用 MPV 播放网盘音视频的用户
• 需要稳定流代理与断链重试的用户

快速上手

1. 从 Releases 下载 Guanya-GUI_0.02_x64-setup.exe 并安装，安装包已内置轻量 MPV
2. 打开应用，用短信验证码登录光鸭云盘账号
3. 在文件列表中浏览目录，按需执行移动、复制、删除或下载
4. 选中音视频文件，调用外部 MPV 开始播放
5. 需要连续观看时，用播放列表把多个文件加入队列并切换上下项

核心优势

• 播放素质：借助 MPV 解码与渲染，画质与格式兼容性更有保障
• 链接稳定：签名链接过期时流代理自动刷新并重试，长片播放不易中断
• 开箱可用：安装包内置 MPV 运行时与默认配置，无需另行安装
• 职责清晰：界面、代理与播放进程各司其职，播放不将就于 WebView

系统要求

项目	要求
操作系统	Windows 10 / 11（x64）
运行环境	安装包已内置轻量 MPV，无需另装
安装方式	Guanya-GUI_0.02_x64-setup.exe 安装程序

注意事项

• 本项目为第三方客户端，与光鸭云盘官方无关
• 登录会话、日志、播放历史与缓存均为本机数据，请勿提交到公开仓库
• 补帧、着色器、Python 与 VapourSynth 等增强组件不包含在运行时内
• 源码开发需要 Node.js 20 及以上、Rust stable 与 Python 3.10 及以上