Repository navigation
Sync Tasks zh
zhugecaomao edited this page Nov 12, 2026
·
10 revisions
English · 中文
用 Windows 自带的 robocopy 让一个文件夹和另一个保持一致, 例如把服务器共享同步到 OneDrive。ALTRun 在后台运行它, 先检查危险的设置, 完成后告诉你结果。
偏好设置 → 文件夹同步 列出所有任务, 包括模式和文件夹。这一页只用来设置任务; 预览、运行和停止都在任务的窗口里 (见下面)。

- 添加、编辑 (或双击)、删除、复制一份 (复制后再改, 例如用于另一个文件夹)。
- 同步... 打开选中任务的窗口, 用的是列表里现在的内容 (不用先点应用)。只是打开窗口: 在窗口里点 预览 或 立即同步 才开始 (打开下面的选项时会马上开始预览)。任务正在运行时, 显示它的进度。
- 选项: 在搜索结果里显示任务; 打开任务窗口时自动开始预览 (默认关,
Features.Sync.AutoPreview: 预览只读取文件夹, 但文件夹很大或在网络上时比较要花一些时间; 不会这样自动运行同步); 搜索关键字 (sync)、日志保留天数、日志文件夹。
编辑窗口从上到下:

-
名称、源 和 目标 (⇅ 交换两者)、文件 (
*.*= 所有文件)。 - 模式: 镜像 (目标和源完全一致, 源中没有的会被删除)、更新 (只复制新的和更新过的文件, 不删除)、全部复制 (不同的都复制, 不删除)、只复制顶层。下面一行说明这个模式做什么, 镜像的说明是红色的。
- 何时运行: 只在你运行时, 或 持续同步 (robocopy 一直运行, 有变化后再同步)。镜像只在你运行时运行 (见下面)。
-
排除文件 / 排除文件夹, 用
;分隔。 - 高级: 重试次数和等待、线程、复制哪些文件和文件夹信息、日志文件、其他 robocopy 参数。
- 命令 显示任务生成的 robocopy 命令行, 输入时随时更新, 包括运行时用的日志 (日志文件 空着时是默认的日志)。复制命令 可以复制它。
- 预览 在保存前显示任务会改变什么。确定 时检查任务: 错误 (没有源、同一个文件夹、镜像到盘符根目录等) 必须改正; 目标和其他任务重叠时先询问。
每个任务有自己的窗口, 标题是 <任务名> - 文件夹同步。点预览或运行时马上打开, 一直跟到任务结束。按钮的位置固定: 预览、立即同步、停止 和 打开日志 只在能用的时候可以点。
-
检查中 (预览, 用
/L运行 robocopy, 不做任何改动): robocopy 找到的变化实时出现在列表里, 显示已找到多少项和用时。大文件夹比较要花一些时间, 这样能看到它在工作; 停止 可以结束。 - 预览: 运行时会做的事: 会复制多少个文件和它们的大小、会删除多少个文件和文件夹 (列表上方用红字说明), 以及每一项, 删除的排在前面, 带复制的原因 (复制 (较新)) 和大小。立即同步 在同一个窗口里按预览的内容运行。只有不用多线程时 (线程 设为 0) 才会数出要新建几个文件夹: 多线程时 robocopy 不列出文件夹。
- 同步中: robocopy 复制的文件实时出现在列表里; 预览过的 (镜像都会先预览) 进度条按已复制的字节数和预览时的总量显示; 更新和全部复制两种模式运行前不预览 (大文件夹不用比较两遍), 进度条来回滚动。停止 可以结束。
- 完成: 复制了多少个文件 (和大小)、删除了多少个、用时; 没能复制的文件用红字显示个数, 进度条变红 (停止时变黄)。
- 进度也显示在窗口的任务栏按钮上, 在别的程序里工作时也能看到 (窗口可以最小化)。
- 列表最多显示前 2000 项, 日志 (打开日志) 里有全部。路径显示不全时, 鼠标停在上面会显示完整路径; 双击一行会在资源管理器里显示这个文件。
- 窗口在上次关掉时的位置打开, 大小也一样, 关掉时是最大化的就最大化打开 (那个显示器已经拔掉时, 放回屏幕中间); 同时打开另一个任务的窗口时, 往右下错开一点, 不会完全盖住前一个。保存在
Features.Sync.Window。 - 关掉窗口不会停止任务: 在搜索窗口里对它按 Enter, 或在偏好设置里点 同步..., 会重新打开窗口。窗口不在最前面时, 结束时还有一条通知。

- 输入任务名, 或输入
sync列出所有任务 (sync proj只搜任务)。Enter 只打开任务的窗口 (在窗口里点 预览 或 立即同步 才开始; 打开了 打开任务窗口时自动开始预览 时马上开始预览); 运行中按 Enter 显示进度。 -
→打开操作: 立即同步 (直接运行; 镜像仍会先预览, 要删除东西时先确认)、预览 (不做任何改动)、打开日志、打开源 / 目标文件夹; 运行中是 显示进度 和 停止。 - 结果里显示任务做什么、现在怎样: 10:05 开始运行、10:05 开始持续同步、上次 09:30: 成功。
- 任务结束时在它的窗口里显示结果 (复制和删除了多少文件), 窗口不在最前面时还有一条通知。没有窗口时失败, 可以直接打开日志。
-
镜像 (
/MIR) 让目标和源完全一致: 目标里源中没有的文件会被删除。镜像运行前, ALTRun 先预览 (/L, 不做任何改动); 如果会删除东西, 预览窗口列出要删除的文件, 点 同步并删除 才会运行 (Enter 或 Esc 关闭窗口)。- 窗口在预览完成后打开。如果这时你已经在别的程序里工作, 它不能自己跳到最前面 (Windows 不让后台程序抢焦点): 它在任务栏里闪烁, 并有通知说它在等待确认。
- 每个任务有自己的窗口: 预览别的任务不会关掉还在等待的窗口。
- 窗口开着超过 5 分钟后再点 同步并删除, 会重新预览一次, 因为目标可能已经变了。
- 被排除的文件和文件夹不会从目标里删除, 镜像也一样。robocopy 仍然会把目标里有、源里没有的这类文件算进汇总的 "Extras"; ALTRun 不把它们算作删除, 并说明它们会保留。
- 源文件夹找不到或是空的 (例如服务器共享没连上) 时不运行镜像, 否则会把目标清空。
- 源和目标是同一个文件夹、一个在另一个里面, 或者镜像到盘符、共享、OneDrive 文件夹、用户文件夹的根目录 (会删掉那里其他所有东西) 时, 不运行。
- 源和目标必须是完整路径 (
D:\Sync\Projects、\\server\share\folder)。相对路径、\folder(当前盘的根目录) 或这台电脑上没有的环境变量 (没装 OneDrive 时的%OneDrive%) 会让 robocopy 在别的文件夹里操作, 所以这样的任务不会运行。 - 其他 robocopy 参数原样使用。里面有
/MIR或/PURGE时会像镜像一样删除, 所以不管模式选的是什么, 这样的任务都按镜像对待: 同样先预览、删除前询问, 上面的检查也都做。有/MOV或/MOVE(robocopy 复制完会删掉源里的文件) 时, 保存任务时会提醒。 - 镜像不能 持续同步: robocopy 之后每一轮都会删除, 却没有上面这些检查 (服务器共享突然看起来是空的, 就会清空目标)。要持续同步请用 更新 模式, 或者由你自己运行镜像。
-
持续同步 (
/MON、/MOT) 的任务会一直运行, 有变化后再同步。退出 ALTRun 时会停止; ALTRun 只是重新启动 (改了设置、升级) 时会继续运行。
每次运行都有日志: 写到任务自己的日志文件, 或 %TEMP%\ALTRun\SyncLogs\<任务名>_<日期>.log。打开日志 打开当天的日志。
- 日志不放在 Data 文件夹里: Data 在 OneDrive 里时, 不断变大的日志会一直上传。
- 日志用 Unicode 写 (
/UNILOG), 任何语言的文件名都能正确显示。 -
%TEMP%\ALTRun\SyncLogs里超过 30 天的日志在运行任务时自动删除 (Features.Sync.KeepLogDays,0= 全部保留)。任务自己的日志文件不会删除。 - 每次运行在
ALTRun.log里记一行: 什么时候开始、结果怎样 (复制、删除了多少文件, 或退出码)。
路径可以用 %环境变量%; 日志文件名可以用 {date} (yyyyMMdd) 和 {time} (HHmmss)。
ALTRun · GPL-3.0 · Something wrong or unclear? Open an issue or edit docs/wiki · 文档有误或不清楚? 欢迎提交 Issue 或修改 docs/wiki
English
- Getting started
- Installation and upgrades
- Search and shortcuts
- Pinned and recent items
- File search
- Browser bookmarks
- Web search
- Window switching
- Custom commands
- Snippets
- Clipboard history
- Calculator
- System commands and terminal
- Scripts
- Custom hotkeys
- Delayed start
- Folder sync
- Themes
- Quick Switch
- Dialog Folder Panel
- Date Stamp
- PT Tools
- Extensions
- Settings reference
- Data files
- Privacy and network access
- FAQ
- Development guide
- Contributing
- 5 分钟上手
- 安装与升级
- 搜索与快捷键
- 置顶和最近使用
- 文件搜索
- 浏览器书签
- 网页搜索
- 窗口切换
- 自定义命令
- 文字片段
- 剪贴板历史
- 计算器
- 系统命令和终端
- 脚本扩展
- 自定义热键
- 延迟启动
- 文件夹同步
- 主题
- 对话框快速跳转
- 对话框文件夹面板
- 一键加日期
- PT 工具箱
- 扩展功能
- 设置文件参考
- 数据文件
- 隐私与网络访问
- 常见问题
- 开发指南
- 参与贡献