解密前需要准备以下文件：

1. encryption.json - 加密密钥文件（从主程序导出或备份）
2. mapping.json - 加密映射文件（批量解密时需要，可从主程序导出）
3. 加密的文件（.dat 文件）

# 恢复原始目录结构（使用映射文件中的原始路径）
decrypt-cli decrypt --key-file encryption.json --map mapping.json --in-dir ./encrypted --out-dir ./decrypted

# 镜像输入目录结构（按 --in-dir 的目录结构输出）
decrypt-cli decrypt --key-file encryption.json --map mapping.json --in-dir ./encrypted --out-dir ./decrypted --mirror

# 自动尝试所有密钥
decrypt-cli decrypt --key-file encryption.json --in file.dat --out file.txt

# 指定密钥版本
decrypt-cli decrypt --key-file encryption.json --in file.dat --out file.txt --key-version 2

• 每个文件加密后生成唯一的 UUID 文件名（如 a1b2c3d4-xxxx.dat）
• 映射关系：加密文件名 → 原始文件名 存储在数据库中

文件夹使用路径感知的加密映射策略：

加密时（原始名 → 加密名）：根据 (父路径, 文件夹名) 查询或生成 UUID

示例：
1. 首次遇到 /backup/a/docs：
   - 查询：parent=/backup/a, name=docs → 未找到
   - 生成新 UUID：abc-123-xxx
   - 保存映射：(/backup/a, docs) → abc-123-xxx

2. 首次遇到 /backup/b/docs：
   - 查询：parent=/backup/b, name=docs → 未找到
   - 生成新 UUID：def-456-xxx（不同路径，不同 UUID）
   - 保存映射：(/backup/b, docs) → def-456-xxx

3. 再次遇到 /backup/a/docs：
   - 查询：parent=/backup/a, name=docs → 找到 abc-123-xxx
   - 复用已有加密名（保持一致性）

解密时（加密名 → 原始名）：直接根据 UUID 查询，无需父路径（UUID 全局唯一）

这种设计确保：

• ✅ 不同路径下的同名文件夹使用不同的加密名，避免冲突
• ✅ 同一路径下的文件夹多次上传时复用同一加密名，保持一致性
• ✅ 解密时通过唯一的 UUID 直接还原原始文件夹名

问题修复：

• 🐛 修复下载管理器初始化时序问题：将等待队列监控和触发器的启动延迟到 persistence_manager 设置完成后，避免后台任务捕获到 None 导致持久化失败
• 🐛 修复下载管理批量继续/批量暂停文件夹状态未变更：批量暂停/继续子任务后，同步更新对应文件夹的状态为 Paused/Downloading，确保前端文件夹状态正确推送
• 🐛 修复分享直下临时文件夹重复创建：分享直下模式跳过对 save_path 父目录的重复 mkdir，避免百度静默重命名（加时间戳后缀）；临时目录不再写入 recent_save_path

新功能：

• ✨ 新增 Cookie 登录：支持直接粘贴浏览器 DevTools 复制的完整 Cookie 字符串完成登录
  • 解析 BDUSS/PTOKEN/STOKEN 等关键字段，验证通过后完整初始化所有管理器
  • 缺少 PTOKEN 时登录提示中明确说明受限功能，不阻断基础使用

问题修复：

• 🐛 修复下载任务级槽位刷新节流器，所有分片共享：同一任务所有分片共享同一 SlotTouchThrottler，防止分片切换时重置节流计时器；槽位分配后立即刷新，防止长准备阶段被误判超时
• 🐛 修复白名单文件夹配置不生效问题，补充校验以改进安全性
  • 新增 FilesystemConfig::validate() 方法，加载/保存配置时校验路径合法性
  • 修复 Windows 下裸驱动器根路径（C:/C:\/C:/）跳过白名单校验的 bug
  • 新增 enforce_allowlist_on_followed_symlinks 配置项防止符号链接绕过白名单
• 🐛 白名单文件夹配置问题边界修复：精确区分裸驱动器根路径与 drive-relative 路径，后者正确走 canonicalize() 流程
• 🐛 文件夹下载进度问题修复：新增 completed_downloaded_size / failed_count 字段，进度单调递增，失败子任务正确统计，支持从 Failed 状态恢复下载
• 🐛 普通转存与分享直下目录结构统一修复：分批转存按原始父目录名分组，本地目录结构与原始分享结构完全对应
• 🐛 下载目录不存在提示：启动时检查下载目录可访问性，目录不存在或无权限时输出清晰提示并优雅退出

问题修复：

• 🐛 修复转存异步不同目录同名文件分批处理：分享直下选择跨目录同名文件时，自动分批转存避免百度 API -30 冲突
  • 检测跨目录同名文件冲突，按 basename 无冲突分组，逐批转存到 group_N 临时子目录
  • 修复取消语义、冲突恢复路径适配、部分批次失败警告持久化等多项问题
• 🔧 修复 RefreshGuard 生命周期标注警告

问题修复：

• 🐛 修复异步转存错误兜底：补充百度异步转存 taskquery 失败场景的兜底处理
  • 识别 task_errno 并返回更明确的失败原因
  • 分享直下遇到 task_errno=-30（目标文件已存在）时，尝试恢复已转存结果
  • 减少"实际已转存但任务被误判失败"的情况

新功能：

• ✨ 文件冲突策略：系统设置新增上传/下载默认策略，单次上传和下载操作也可临时覆盖
  • 上传支持智能去重、自动重命名、覆盖
  • 下载支持覆盖、跳过、自动重命名
  • 文件、文件夹、批量任务和自动备份统一按策略处理同名文件

问题修复：

• 🐛 修复异步转存兼容性：兼容百度返回异步转存任务的场景

新功能：

• ✨ 网络代理支持：新增 HTTP 和 SOCKS5 代理配置功能
  • 支持 HTTP 代理和 SOCKS5 代理两种类型
  • 支持代理认证（用户名/密码）
  • 代理测试连接功能，实时检测代理可用性
  • 代理运行状态监控：显示代理状态（正常/已回退到直连/探测中）、抖动次数、下次探测倒计时
  • 自动回退机制：代理故障时自动回退到直连模式，可配置是否允许回退
  • 配置保存后立即生效，无需重启应用

功能增强：

• ✨ 批量任务操作：下载和上传管理页面新增批量操作功能
  • 下载管理：支持批量暂停/继续所有活跃任务，批量清除已完成/失败任务
  • 上传管理：支持批量暂停/继续所有活跃任务，批量清除已完成/失败任务
• ✨ 文件监听能力检测：自动备份设置页面新增文件监听能力状态卡片
• ✨ 设置页面优化：系统设置页面新增锚点导航，支持快速跳转到各个设置分区

问题修复：

• 🐛 修复自动备份大量文件卡顿问题：优化任务列表查询，使用轻量级克隆跳过大字段，显著提升响应速度

功能增强：

• ✨ 转存选择文件：转存分享链接时支持选择需要转存的文件，不再强制转存全部文件
• ✨ 分享直下选择文件：分享直下同样支持选择需要下载的文件
• ✨ 转存/分享直下批量下载：转存和分享直下支持同时下载多个文件

问题修复：

• 🐛 修复分片失败导致整个任务失败：修复网络不好时上传/下载单个分片失败导致整个任务失败的问题

主要更新：

• ✨ 分享直下功能：支持粘贴百度网盘分享链接并选择本地下载目录，后端会在网盘临时目录中完成转存，下载完成后按配置自动清理临时文件，避免长期占用网盘空间
• ✨ 分享管理页面：新增“分享管理”页面，集中查看我的分享记录，支持复制链接和提取码、单个/批量取消分享
• ✨ 独立解密工具 decrypt-cli：新增独立命令行解密工具，可在未部署主程序的环境下解密加密文件，支持批量解密和单文件解密，兼容 AES-256-GCM 与 ChaCha20-Poly1305
• 🔧 下载 0 速度场景修复

问题修复：

• 🐛 修复任务槽超时释放问题：新增槽位刷新节流器（SlotTouchThrottler），在任务进度更新时定期刷新槽位时间戳，防止正常任务因长时间无进度更新被误判为过期而释放
  • 下载任务和上传任务在进度回调中自动刷新槽位时间戳（30秒节流间隔）
  • 当槽位因超时被自动释放时，自动将对应任务状态设置为失败，并通过 WebSocket 通知用户
  • 解决了大文件下载/上传时，因进度更新间隔较长导致槽位被误释放的问题

主要新功能：

• ✨ 离线下载功能：支持通过百度网盘服务器代为下载资源
  • 支持 HTTP/HTTPS/磁力链接/ed2k 等多种下载链接格式
  • 磁力链接自动标准化（Base32 转十六进制）
  • 任务列表查询、详情查看、取消和删除
  • 实时进度显示和状态更新（WebSocket 推送）
  • 自动下载功能：任务完成后可自动下载到本地（支持配置保存路径）
  • 智能轮询机制：根据任务进度动态调整轮询间隔，节省资源

问题修复：

• 🐛 修复文件夹下载完成计数问题：使用 counted_task_ids 集合避免重复计数，修复已完成任务从内存移除后进度显示错误的问题
• 🐛 修复已取消文件夹仍显示在列表中：取消文件夹时从内存 HashMap 中移除，避免已取消任务继续显示
• 🐛 修复文件夹下载进度统计：已完成任务从内存移除后，使用文件夹自身维护的 completed_count 和 downloaded_size 统计进度

技术改进：

• 🔧 自动备份轮询抖动：在间隔轮询和定时轮询中添加随机抖动（±20% 和 ±5 分钟），防止固定间隔被风控识别

1. 打开百度网盘 APP

   • 在手机上打开百度网盘 APP
   • 确保 APP 已登录你的账号

2. 扫描二维码

   • 在浏览器中访问应用（默认 http://localhost:18888）
   • 页面会自动显示登录二维码
   • 打开百度网盘 APP，点击"扫一扫"功能
   • 扫描网页上显示的二维码

3. 确认登录

   • 扫描成功后，APP 会弹出确认登录提示
   • 重要：在 APP 中点击确认登录
   • 重要：确认后，APP 不能关闭或切换到后台，否则登录会失败

4. 等待登录完成

   • 网页会自动轮询登录状态（通常 1-3 秒）
   • 登录成功后会自动跳转到文件管理页面

• APP 必须保持打开状态：确认登录后，不要立即在 APP 中点击确认，先稍等片刻，等待网页显示"扫码成功"后，再按提示继续操作。
• APP 不能关闭、不能退出、不能切换到后台，必须保持在前台运行，直到网页显示登录成功
• 原因说明：网页需要通过轮询机制查询登录状态，如果 APP 关闭，百度服务器可能无法正确返回登录状态，导致登录失败
• 登录失败处理：如果等待一段时间后仍无法登录，请：
  1. 刷新网页，重新获取二维码
  2. 重新执行上述操作步骤
  3. 确保 APP 在确认登录后保持打开状态

• 登录成功后，会话会自动保存到本地
• 下次启动应用时会自动恢复登录状态
• 如果会话过期，会自动跳转到登录页面重新登录

浏览和管理百度网盘中的文件和目录，支持目录导航、文件信息查看和下载操作。

加密文件和文件夹在文件列表中会显示"加密"标签，并自动还原显示原始文件名（通过查询本地加密映射表）。下载加密文件时会自动解密并恢复原始文件名。

实时查看下载进度，支持多任务并发下载，显示下载速度、进度百分比和剩余时间。

通过下载对话框确认下载任务的保存路径和任务信息，并可根据需要调整下载参数。

集中查看所有上传任务，实时展示进度、速度和剩余时间，支持暂停、继续和删除操作。

在转存管理页面集中查看所有分享链接转存任务的进度和状态，支持查看成功、失败任务，并进行删除等操作。

通过转存弹窗输入或粘贴百度网盘分享链接和提取码，选择转存目标目录，并发起转存任务。

通过内置的本地文件资源管理器选择文件或文件夹上传，支持目录导航、空态/错误态提示和分页加载。

在系统设置中配置上传相关参数（如并发策略等），与下载配置统一管理。

在转存设置中配置与分享链接转存相关的参数，例如默认转存目录、是否自动在转存完成后创建下载任务等。

配置服务器参数和下载选项，包括线程数、分片大小、下载目录等。

集中管理所有备份配置，查看备份状态、活跃任务数和加密状态，支持手动触发备份、禁用/启用和删除操作。

配置备份触发方式，包括文件系统监听（实时检测文件变化）、轮询兜底设置和下载备份轮询模式。

在系统设置中配置客户端侧加密，支持生成、导出和删除加密密钥，使用 AES-256-GCM 算法保护文件隐私。

在系统设置中配置 Web 访问认证，支持密码保护和 TOTP 双因素认证，防止未授权访问 Web 界面。

说明：

• Docker 容器内，后端 API 服务和前端静态文件服务运行在同一个进程中
• 只需要暴露一个端口（18888）即可访问完整应用
• 前端页面和 API 调用都通过 http://localhost:18888 访问
• 前端在容器内部通过 http://localhost:18888/api/v1 调用后端 API
• 挂载目录说明：
  • config：配置文件目录，包含以下重要文件：
    • encryption.json：加密密钥文件
    • baidu-pcs.db：SQLite 数据库（历史记录、加密映射表等）
    • autobackup_configs.json：自动备份配置
  • downloads：下载文件保存目录
  • data：会话数据目录（登录信息、会话持久化）
  • logs：日志文件目录（应用运行日志，支持滚动）
  • wal：WAL 目录（任务持久化数据，支持断点恢复）
• ⚠️ 重要提示：如果启用了客户端侧加密功能，请务必备份以下文件：
  • config/encryption.json：加密密钥，丢失后将无法解密已加密的文件！
  • config/baidu-pcs.db：包含加密文件映射表，用于解密时查找原始文件名
• 预构建镜像自动发布在以下位置：
  • GitHub Container Registry - ghcr.io/komorebicarry/baidupcs-rust:latest（推荐，无需额外注册）
  • Docker Hub - komorebicarry/baidupcs-rust:latest（可选，需要配置 secrets）
• 当创建 Git 标签（如 v1.0.0）时，GitHub Actions 会自动构建并推送 Docker 镜像
• Linux 用户推荐使用 Docker Hub 镜像（更通用，无需登录）：komorebicarry/baidupcs-rust:latest
• 如果镜像拉取较慢，也可以从 GitHub Releases 页面直接下载 Docker 镜像文件（BaiduPCS-Rust-{版本号}-docker.tar.gz），然后使用以下命令加载：

  # 下载镜像文件后，加载镜像
  docker load < BaiduPCS-Rust-v1.7.0-docker.tar.gz
  
  # 加载后可以使用镜像运行容器
  docker run -d \
    --name baidu-netdisk-rust \
    -p 18888:18888 \
    -v $(pwd)/config:/app/config \
    -v $(pwd)/downloads:/app/downloads \
    -v $(pwd)/data:/app/data \
    -v $(pwd)/logs:/app/logs \
    -v $(pwd)/wal:/app/wal \
    --restart unless-stopped \
    baidupcs-rust:v1.7.0

• max_global_threads: 全局最大线程数（所有下载任务共享的并发分片数）
• max_concurrent_tasks: 最大同时下载文件数
• chunk_size_mb: 每个分片的大小（单位: MB）
• max_retries: 下载失败后的最大重试次数

普通用户请将全局最大线程数（max_global_threads）和最大同时下载数（max_concurrent_tasks）都设置为 1。

[download]
max_global_threads = 1
max_concurrent_tasks = 1

⚠️ 注意：调大线程数只会在短时间内提升下载速度，且极易很快触发限速，导致几小时至几天内账号在各客户端都接近 0 速。

SVIP 用户建议全局最大线程数（max_global_threads）设置为 10 以上，根据实际带宽可调大，但不建议超过 20。可以配合最大同时下载数（max_concurrent_tasks）调整，注意最大同时下载数越大不代表速度越快。

[download]
max_global_threads = 10    # 建议 10-20
max_concurrent_tasks = 2    # 可根据需求调整