WebDAVSync

项目概述

WebDAV Sync 是一款 Windows 桌面文件同步工具，监控本地目录，自动上传到 WebDAV 云盘（坚果云）。

主要功能

• 文件同步：手动/定时/自动同步，共享 mtime 变更检测，跳过未变更文件
• 目录监控：多目录同时监控，右键复制配置路径
• 压缩上传：可选 zip 压缩后上传，分段显示进度（拷贝→压缩→上传）
• 增量上传：手动同步基于 mtime 快照跳过未变更；auto 同步仅上传 watchdog 检测到的变更文件
• 同步热力图：GitHub 风格日历热力图，展示每日同步活跃度
• 同步历史：完整历史记录含时间、目录、类型、文件数、耗时
• 云端浏览：远程 WebDAV 目录浏览，支持下载到持久化目录
• 配置云同步：启动拉取 → 手动备份 → 退出上传
• 定时同步：可配置多个时间点
• 安全：凭据仅本地存储（config.json gitignored）

适用人群

• 需要将本地文件自动同步到 WebDAV 云盘的用户
• 使用坚果云、Nextcloud、群晖等 WebDAV 存储的用户
• Windows 用户

快速上手

1. 安装依赖：pip install pyqt6 qfluentwidgets webdav3 watchdog lxml requests python-dateutil
2. 在“WebDAV 设置”页面填写服务器地址、用户名、密码（坚果云需使用应用密码）
3. 在“监控目录”页面添加需要同步的本地目录
4. 选择手动同步、定时同步或自动同步开始使用

核心优势

• 基于 mtime 变更检测的增量上传，高效同步
• GitHub 风格同步热力图，直观展示活跃度
• 支持坚果云等 WebDAV 云盘
• 凭据仅本地存储，安全可靠

系统要求

• 操作系统：Windows
• 额外依赖：Python 3.10+、PyQt6、qfluentwidgets、webdav3、watchdog、lxml、requests、python-dateutil