目录同步
快速比对两个文件夹（本地磁盘、移动硬盘、U盘、NAS）的新增与修改差异，一键执行高速增量备份或双向同步
插件界面截图
核心功能特性
单向增量备份
仅将源目录中 [新增] 和 [较新修改] 的文件复制到目标目录，绝不删除目标目录中已有的其他文件（最适合往移动硬盘/U盘追加备份）。
单向镜像克隆
使目标目录与源目录完全一致；目标目录中多出的文件在同步时安全移入系统回收站。
双向合并同步
两边各自新增的文件互相补齐，同名文件以最后修改时间（mtimeMs 差值 > 2000ms，兼容 FAT32/exFAT 2秒时间精度）较新的一方为准。
内置智能排除规则
默认可选排除 node_modules, .git, .svn, dist, .DS_Store, Thumbs.db, ~$*，避免成千上万个零碎依赖包拖慢备份。
差异标签清晰直观
右侧队列每一行明确标记 [+ 新增到目标]、[↑ 覆盖更新]、[← 反向补齐]、[- 目标端多余]，并展示文件大小与修改时间差。
源目录与目标目录互为父子目录拦截
若用户把 D:\Work 同步到 D:\Work\Backup（会导致无限递归套娃复制），服务层在比对前直接拦截并报错“源目录与目标目录不能互相包含”。
插件详细介绍与使用指南
功能概述
目录同步（插件标识：folder-sync）是 ZTools 极客桌面效率中枢面向 系统工具 场景打造的官方核心扩展。快速比对两个文件夹（本地磁盘、移动硬盘、U盘、NAS）的新增与修改差异，一键执行高速增量备份或双向同步。
- 底层核心痛点：用户把电脑上的「项目代码库 / 摄影素材 / 重要工作文档」定期备份到移动硬盘、U盘或局域网 NAS 时，如果用资源管理器直接 Ctrl+C / Ctrl+V 覆盖，不仅每次要把几十 GB 没改过的老文件重新复制一遍慢如蜗牛，还看不出两边到底新增了哪些文件、改了哪些文件、哪些文件在源目录已经被删掉了。
- 核心不变量与安全红线：① 先比对预览差异清单，用户勾选确认后再执行同步（绝不盲目静默覆写或误删目标盘数据）；② 默认采用安全的「单向增量追加更新（不删除目标端多余文件）」，只有用户显式切到「单向镜像同步」且确认后，才将目标端多余文件移入回收站（严禁直接物理
unlink）；③ 自动忽略node_modules、.git、Thumbs.db、.DS_Store等无价值缓存目录。 - 最简收敛路径：选用布局三（左侧同步参数与源/目标目录配置 + 右侧可勾选差异文件队列） → 毫秒级比对列出
[新增]、[已更新]、[仅目标端存在]差异文件 →Enter仅传输有变化的文件。
- 架构标准：
@ztools/declarative-ui声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：系统工具
---
核心功能特性
- 单向增量备份：仅将源目录中
[新增]和[较新修改]的文件复制到目标目录，绝不删除目标目录中已有的其他文件（最适合往移动硬盘/U盘追加备份）。 - 单向镜像克隆：使目标目录与源目录完全一致；目标目录中多出的文件在同步时安全移入系统回收站。
- 双向合并同步：两边各自新增的文件互相补齐，同名文件以最后修改时间（
mtimeMs差值> 2000ms，兼容 FAT32/exFAT 2秒时间精度）较新的一方为准。 - 内置智能排除规则：默认可选排除
node_modules, .git, .svn, dist, .DS_Store, Thumbs.db, ~$*，避免成千上万个零碎依赖包拖慢备份。 - 差异标签清晰直观：右侧队列每一行明确标记
[+ 新增到目标]、[↑ 覆盖更新]、[← 反向补齐]、[- 目标端多余]，并展示文件大小与修改时间差。 - 源目录与目标目录互为父子目录拦截：若用户把
D:\Work同步到D:\Work\Backup（会导致无限递归套娃复制），服务层在比对前直接拦截并报错“源目录与目标目录不能互相包含”。
---
典型高频使用场景
- 场景 1：比对源目录与目标目录差异并执行增量备份同步 — 当你需要快速执行该任务时，按下
Alt+Space输入目录同步/文件夹同步/增量备份/freefilesync/folder sync，回车即可直接进入folder-sync-workbench视图完成处理并一键复制或导出结果。 - 场景 2：快速比对两个文件夹中的新增、修改与缺失文件清单 — 当你需要快速执行该任务时，按下
Alt+Space输入文件夹比对/目录差异对比，回车即可直接进入folder-sync-compare视图完成处理并一键复制或导出结果。 - 纯净替代传统臃肿单机小工具：以轻量声明式扩展替代动辄上百 MB、带开机自启与推广弹窗的传统共享软件，保持操作系统常驻进程极致清爽。
---
唤醒指令与全键盘快捷操作指南
在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 目录同步 的对应功能模块：
功能命令标识 (featureCode) |
功能说明 | 推荐触发词 / 唤醒指令 (cmds) |
|---|---|---|
folder-sync-workbench |
比对源目录与目标目录差异并执行增量备份同步 | 目录同步 / 文件夹同步 / 增量备份 / freefilesync / folder sync |
folder-sync-compare |
快速比对两个文件夹中的新增、修改与缺失文件清单 | 文件夹比对 / 目录差异对比 |
全局高频键盘快捷键
| 快捷键 (Windows / macOS) | 交互行为说明 |
|---|---|
Alt + Space / Option + Space |
呼出 ZTools 主搜索框，输入 目录同步 直达本插件 |
↑ / ↓ |
在列表项、分类树或操作结果之间平滑移动键盘焦点 |
Enter |
对当前选中项执行默认主动作（打开、复制、执行或查看详情） |
Ctrl + Enter / ⌘ + Enter |
执行次要高频动作（如在资源管理器/Finder 中定位、复制次要字段） |
Ctrl + K / ⌘ + K |
展开当前选中项的完整动作面板（Action Panel），支持模糊筛选全部操作 |
Ctrl + F / ⌘ + F |
快速将光标聚焦至顶部搜索/过滤输入框 |
Esc |
关闭当前弹窗/动作面板，或从二级子视图安全返回上一级 |
---
架构性能与安全隐私保障
- 声明式 UI 零闪烁渲染：界面严格采用
@ztools/declarative-ui的List/Detail/Form/ActionPanel语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。 - 最小权限与沙箱隔离：本插件在清单（
plugin.json）中显式声明最小化权限集["fs", "dialog", "shell"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。 - Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。
---
延伸阅读与技术内链
关联技术与效率专栏文章
- C盘又红了别乱删！用这个清爽无捆绑的空间分析器，10秒揪出偷吃硬盘的元凶
- 电脑文件太多找半天？这款免费开源神器，100万个文件也能0.03秒瞬间搜出！
- 100 万文件检索仅需 0.035ms！基于 Rust 的 NTFS MFT 裸盘索引与 USN 增量追踪实战
- 卸载电脑里臃肿的广告软件吧！这一个不到100M的开源工具箱，顶替38款日常软件
同分类热门效率插件推荐（系统工具）
常见问题解答 (FAQ)
Q1: 如何最快唤醒并使用「目录同步」插件？
安装并启动 ZTools 客户端后，在任意界面按下 Alt + Space（macOS 为 Option + Space），在搜索框中输入 目录同步 或 folder-sync，按 Enter 即可在 0.1 秒内直达工作台。您也可以在 ZTools 设置中心为「目录同步」绑定独立的全局一键呼出快捷键。
Q2: 「目录同步」插件会将我的数据上传到云端服务器吗？
不会。ZTools 严格遵循 Local-First（本地优先）与隐私设计（Privacy by Design） 准则，「目录同步」的核心处理流程完全在您的本机离线执行，零广告干扰、零用户行为监控。
Q3: 在「目录同步」中如何不使用鼠标完成全部操作？
本插件针对全键盘流进行了深度优化：进入插件后可直接打字检索过滤，使用 ↑ / ↓ 键切换目标行，按 Enter 执行主操作，或按 Ctrl + K（macOS 为 ⌘ + K）呼出动作面板选择更多高级操作，按 Esc 即可逐级返回。
Q4: 插件支持哪些操作系统版本？是否开源免费？
完整支持 Windows 10 / Windows 11 (x64) 与 macOS 12+ 双平台（部分涉及 Windows 底层注册表或专属硬件驱动的特性在 macOS 下会自动适配原生等价实现）。本插件对个人用户 100% 永久免费开放，源码托管于 GitHub 官方仓库接受社区透明审计。 ---