# 功能清单

> 概览见 [README](../README.md) ｜ 桌面版与上游 Android 版的差异见 [与上游的差异](UPSTREAM-DIFF.md)

## 解析与下载

- **分享链接解析**：识别夸克 / UC / 迅雷 / 百度 / 139 / 123 的分享链接，自动匹配提取码（可直接粘贴带提取码的整段文本）；
  另支持 GitHub 仓库 / 账号 / 文件直链
- **高速下载**：Range 分片并发 + 断点续传 + 失败自动重试 + 全局限速（令牌桶）；弹性区按字节顺序分配，
  保证分片物理相邻、连接复用率稳定
- **下载线程数**：按网盘平台分别设置（最高 512），随时可调
- **任务并发控制**：限制同时下载的任务数（默认 1，前台任务吃满带宽，其余排队）
- **临时转存清理**：百度 / 迅雷取链后清理；夸克保留到下载完成或删除任务后清理
- **暂停 / 继续**：暂停时以磁盘分片实际大小为准回写进度，恢复后进度不跳变
- **任务持久化**：进度按时间节流落盘，重启后任务状态与进度可恢复

## GitHub 解析

GitHub 为代码托管平台（仓库 / 账号 / 文件直链），非网盘；其链接与网盘分享链接同入口解析。

- **链接识别**：识别仓库主页、账号（用户 / 组织）主页、仓库子路径（`tree` / `blob`）、`releases/latest`、
  发布资产直链与 `raw` 直链；可直接粘贴含 GitHub 链接的整段文本
- **浏览**：仓库文件树 / Releases / 账号（用户或组织）仓库列表；分页「加载更多」、显示 fork 来源、
  目录条目显示「最后提交时间」
- **README 渲染**：GFM Markdown（表格 / 代码 / 折叠 / 图片）；图片经自研加载器渲染（不使用 Coil），
  走 OkHttp 拉取 + Skia 解码，带内存缓存与加载中 / 失败占位，支持镜像前缀加速
- **下载**：GitHub 文件 / ZIP 加入现有下载任务，支持镜像前缀加速，失败可回退原始 GitHub 直链
- **Token（可选）**：Personal Access Token 仅用于提升 API 限额（未认证 60 次/小时，认证后 5000 次/小时）；
  经 AES-GCM 加密存储（桌面版密钥文件 `credential.key`）、输入框掩码显示、不写入日志；
  API 返回 401 时自动清除 Token 并提示

## 任务管理

- 暂停 / 继续 / 删除
- 打开文件 / 在资源管理器中显示（`explorer /select` 直接选中目标文件）
- 复制直链 / 复制分享链接
- 下载完成项一键定位「文件夹」

## 通知与保活

- **Windows 通知中心进度**：下载进度显示为 toast 进度条，多任务自动聚合成一条，附带实时速度与完成度
  - 同一条通知**原地刷新**，不会每次刷新都弹横幅或响铃
  - **送达自检**：发送后核对 Windows 为应用维护的 `LastNotificationAddedTime`，若系统静默丢弃了通知，
    会自动创建带 AppUserModelID 的开始菜单快捷方式兜底（位于
    `%APPDATA%\Microsoft\Windows\Start Menu\Programs\`）；正常情况下不会改动开始菜单
  - 受系统通知设置影响，**不保证 100% 送达**
- **完成通知**：全部任务下载完成时额外提示一条
- **阻止电脑休眠**：下载期间通过 `SetThreadExecutionState` 阻止系统睡眠，任务结束自动恢复

## 登录与账号

- **内嵌浏览器登录（推荐）**：夸克 / UC / 百度 / 139 在应用内打开真实 Chromium 页面（JCEF 132），
  登录后自动检测并保存 Cookie，全程无感
- **一键导入本机浏览器 Cookie**：扫描 Chrome / Edge / Firefox / 360 / QQ 等，用 Windows DPAPI 解密导入
  （Chrome / Edge 较新版本受「应用绑定加密」限制可能读不到，Firefox / 360 等始终可用）
- **手动粘贴 Cookie**：兜底方式
- **迅雷**：账号密码 + 短信验证（验证页由系统浏览器承载）；**123 云盘**：账号密码换 JWT
- **登出彻底清除 Cookie**：通过 CEF 的 `delete` 标志清除该平台全部 Cookie，避免残留
- **认证备份**：用户口令派生密钥（PBKDF2）+ AES-GCM 加密 Cookie / JWT，导出 `.yunx` 备份文件，可跨设备恢复

## Windows 系统集成

- **系统托盘**：左键恢复主窗口（含从任务栏最小化状态恢复）；右键为 Win32 原生菜单，中文显示正常
- **菜单跟随系统配色**：深色 / 浅色切换后菜单随之变化（内置原生桥接层 `darkmode.dll`）
- **关闭行为可选**：每次询问 / 直接退出 / 最小化到系统托盘
- **原生文件对话框**：下载目录选择、备份导入 / 导出均为资源管理器同款样式（Vista+ COM `IFileDialog`）
- **下载目录解析**：经 Known Folder API 读取系统「下载」位置，支持用户重定向过的路径
- **剪贴板分享链接检测**：主窗口不在前台时检测剪贴板，发现分享链接在右下角弹出提示卡片，
  点击即打开解析（可在设置中关闭）
- **启动与关闭过渡**：启动闪屏 + 主窗口内容就绪后渐入；关闭时先淡出再销毁，避免白屏闪烁

## 界面与体验

- 深色模式 + 自定义种子色（Monet 风格动态取色）
- 链接收藏；解析链接历史（1 小时去重，支持搜索 / 复用提取码 / 删除 / 清空）
- 弹窗统一为窗口内覆盖层渲染，不创建原生窗口，避免阻塞 UI 线程与动画卡顿
- 渲染后端可选：默认 `OPENGL`（动画流畅且文字清晰），
  可用环境变量 `YUNXPC_RENDER_API=SOFTWARE|DIRECT3D|OPENGL` 切换
- 更新检测：**启动时自动检查**（网络失败 / 已是最新 / 已选「不再提示该版本」的版本静默不打扰，
  「不再提示」按版本记住、不是全局关闭），设置页也可手动检查；
  读取 GitHub Releases 并提示新版本，可自行选择安装包或便携包，更新说明以 Markdown 渲染
- **网络设置**：GitHub 下载镜像前缀（留空使用内置默认镜像）、网络代理（不使用代理 / 使用系统代理 / 手动配置，默认直连，启动与设置变更时装配）
- **实验性功能**（设置 → 实验性功能二级页）：集中管理高风险 / 可调下载参数，支持一键重置为默认值 ——
  HTTP/2 开关（默认关闭，仅使用 HTTP/1.1；开启后允许 ALPN 协商 h2）、
  下载读缓冲大小（默认 64KB；档位 16/32/64/128/256/512/1024 KB，也可直接输入 **16–4096 KB** 内任意值）、
  慢连接抢占（默认开启，默认 12KB/s · 15 秒；阈值 **4–10240 KB/s**、判定时长 **5–600 秒**，均支持档位选择或直接输入）、
  主页快捷方式（默认关闭，开启后在解析页以横向快捷方式展示收藏，点击直达解析）。
  ★ 每个数值项都分「**合理范围**」与「**硬上限**」两档：读缓冲合理 16–1024 KB、阈值合理 4–1024 KB/s、时长合理 5–120 秒；
  超出合理范围时会弹确认框提醒（仍可启用，但内存占用/速度/稳定性等风险与后果由使用者自行承担，开发者不对此负责）

## 诊断与日志

- **导出日志**（设置 → 导出日志）：导出运行日志文本（可「在文件夹中显示」或「保存到下载目录」），含系统 / Java 版本头部信息
- **诊断模式**（设置 → 关于云析 → 长按 → 开发调试 → 诊断模式，默认关闭）：开启后把
  `db / crypto / download / webview / network / operation` 六个模块的详细日志**按模块分文件**写进
  `<数据目录>/diagnostic_logs`，跨重启保留；带全局限流（300 行/秒）与自动轮转（单文件 2MB、每模块 5 份、总量上限 10MB），
  **关闭时一行都不写**（调用点零开销）。敏感信息经过脱敏：URL 走 `LogRedactor`、请求体/响应体只在
  非 200/206 或抛异常时记录（各截 1.5KB）、凭证只记用途与长度不记内容
- **导出诊断日志（zip）**：先 flush 再打包成 `yunx_diagnostic_logs_<时间戳>.zip`，便于把复现步骤对应的完整日志一次带走

## 数据与备份

数据目录与设置项说明见 [使用说明](USAGE.md)。