# 使用说明

> 概览见 [README](../README.md) ｜ 完整功能见 [功能清单](FEATURES.md)

## 快速上手

1. 在「网盘」页登录需要使用的网盘账号（推荐内嵌浏览器登录）
2. 在「解析」页粘贴分享链接（可带提取码，支持从剪贴板一键粘贴）
3. 浏览分享内容，点击文件加入下载
4. 在「下载」页查看进度，支持暂停 / 继续 / 删除 / 打开；进度同步显示在 Windows 通知中心

## 登录方式

| 方式 | 适用 | 说明 |
| --- | --- | --- |
| 内嵌浏览器登录（推荐） | 夸克 / UC / 百度 / 139 | 应用内打开真实 Chromium 页面，登录后自动检测并保存 Cookie |
| 一键导入本机浏览器 | 同上 | 扫描本机已装浏览器，用 Windows DPAPI 解密并导入其 Cookie（Chrome / Edge 较新版本受「应用绑定加密」限制可能读不到） |
| 手动粘贴 Cookie | 同上 | 兜底方式 |
| 账号密码 | 迅雷 / 123 | 迅雷为账号密码 + 短信验证（验证页由系统浏览器承载）；123 为账号密码换 JWT |

退出登录时会通过 CEF 的 `delete` 标志清除该平台的全部 Cookie。

## GitHub

GitHub 为代码托管平台，链接（仓库 / 账号 / 文件直链）在「解析」页粘贴即可识别、浏览与下载，README 以 GFM Markdown 渲染。

在「网盘」页底部的 **GitHub** 卡片可配置 **Personal Access Token**（可选）：仅用于提升 GitHub API 限额
（未认证 60 次/小时，认证后 5000 次/小时），经 AES-GCM 加密存储、输入框掩码显示；已配置后点击卡片可浏览当前 Token 账号的仓库。

**GitHub 下载镜像前缀**与 **网络代理**在设置页配置：镜像前缀留空则使用内置默认镜像；
代理有三种模式 —— **不使用代理（直连，默认）**、**使用系统代理**（读取 Windows 系统代理设置，
会显示实际解析结果）、**手动配置代理**（自行填写主机与端口，端口默认 7890）。
暂不支持 PAC 自动配置脚本，检测到 PAC 时按直连处理并在日志中说明。

## 设置项

| 分组 | 设置项 |
| --- | --- |
| 下载 | 下载线程数（按网盘平台，最高 512）、下载保存目录、最大同时下载任务数、下载速度限制、下载失败重试次数 |
| 系统 | 下载时阻止电脑休眠、通知中心下载进度、剪贴板分享链接检测、关闭主窗口时的行为 |
| 网络 | GitHub Token（提升 API 限额）、GitHub 下载镜像前缀、网络代理（不使用代理 / 使用系统代理 / 手动配置） |
| 实验性功能 | HTTP/2 开关（默认关闭）、下载读缓冲大小（默认 64KB）、慢连接抢占（默认开启，阈值 12KB/s、判定 15 秒）、主页快捷方式（默认关闭）；支持一键重置为默认值 |
| 外观与更新 | 深色 / 浅色模式与种子色、检查更新 |

## 数据目录

| 路径 | 内容 |
| --- | --- |
| `%USERPROFILE%\.yunx-desktop\` | 应用数据根目录（可用环境变量 `YUNX_DESKTOP_DATA_DIR` 覆盖） |
| `%USERPROFILE%\.yunx-desktop\yunx.db` | 任务与凭证库（SQLite） |
| `%USERPROFILE%\.yunx-desktop\credential.key` | 凭证加密密钥 |
| `%USERPROFILE%\.yunx-desktop\cache\download_tmp\` | 下载分片临时目录 |
| `%USERPROFILE%\.yunx-desktop\files\yunx-desktop.log` | 运行日志（设置页可导出） |
| 注册表 `HKEY_CURRENT_USER\Software\JavaSoft\Prefs\yunx` | 偏好设置 |

> 旧版本使用的 `%USERPROFILE%\.yunx-pc\` 会在首次启动时**自动整体迁移**为 `.yunx-desktop`
> （登录态、下载任务、分片一并保留），无需手动处理。

## 托盘与窗口

- **左键**托盘图标：恢复主窗口（包含从任务栏最小化状态恢复）
- **右键**托盘图标：原生菜单 —— 「显示主窗口」/「退出」
- 关闭主窗口时的行为可在设置中选择：每次询问 / 直接退出 / 最小化到系统托盘（下载继续）