跳到主要内容

架构总览

FolderRewind(存档时光机) 是一个基于 WinUI 3 的 Windows 备份管理工具,采用 MVVM 架构,通过静态服务层组织业务逻辑,支持插件扩展和远程命令协议。

技术栈

类别技术版本
框架.NET + Windows App SDK.NET 10 / WinAppSDK 2.1.3
UIWinUI 3
MVVMCommunityToolkit.Mvvm8.4.2
压缩引擎7-Zip(7za.exe)捆绑
云同步rclone用户自备
系统托盘H.NotifyIcon.WinUI2.4.1
序列化System.Text.Json + 源生成器
设置控件CommunityToolkit.WinUI.SettingsControls8.2.251219

架构鸟瞰

graph TB
subgraph Views["视图层 Views"]
ShellPage
HomePage
SettingsPage
OtherPages["其他页面 & Dialog"]
end

subgraph ViewModels["视图模型层"]
VM["各页面 ViewModel"]
end

subgraph Services["服务层 Services"]
ConfigService
BackupService
HistoryService
AutomationService
PluginService
OtherSvc["Navigation / Theme / Notification / ..."]
end

subgraph Models["数据模型层 Models"]
AppConfig
BackupConfig
ManagedFolder
OtherModel["HistoryItem / BackupMetadata / ..."]
end

subgraph Plugins["插件体系"]
IFolderRewindPlugin
KnotLink
MineRewind["MineRewind 插件"]
end

subgraph External["外部依赖"]
SevenZip["7za.exe"]
Rclone["rclone"]
end

Views --> ViewModels
ViewModels --> Services
Services --> Models
Services --> Plugins
Plugins --> External
BackupService --> SevenZip
CloudSyncService["CloudSyncService"] --> Rclone

文档导航

文档内容
目录结构项目文件树与各目录职责
架构模式MVVM、静态服务、Shell 导航等核心设计模式
命名空间参考命名空间划分与关键类速查
服务层概览40+ 服务按功能域分组说明
插件体系插件接口、生命周期与 KnotLink 协议
数据模型AppConfig 层级结构与序列化策略
视图层与导航页面列表、Dialog 与导航流程