一个常驻 Windows 系统托盘的文件监控小工具:监视你指定的文件夹,等新文件“落盘稳定”后,自动执行你配置的动作(复制、解压、归档、转码、调用外部程序……)。
基于 FileSystemWatcher + 去抖(Debounce)实现,整个程序没有主窗口,双击托盘图标即打开配置。
- 多文件夹同时监控:
[Folder:名字]节想写几个写几个,每个文件夹有自己的规则,也能单独覆盖子目录、监听修改、去抖窗口 - 只对新文件动手:默认只关注新放入 / 改名进来的文件,不理会内容修改(可通过
WatchChanged打开) - 去抖合并事件:复制大文件时 Windows 会连发几十个事件,静默
DebounceMs毫秒后才触发一次 - 文件就绪检测:触发前用独占读句柄试打开,仍被占用则自动延迟重试,避免处理半截文件
- 多规则分流:每条规则由「规则名 = 扩展名列表」+「规则名.Command = 命令」两行组成,按书写顺序决定优先级,第一条命中即生效
- 全局兜底规则:写在
[Global]里的规则,只有各文件夹自己的规则都不中时才会用到 - 并发有上限:
MaxConcurrentActions限制同时执行的动作数,一次落盘几百个文件也不会瞬间炸出一堆进程 - 配置有校验:结构性错误(缺
[Global]、[Folder:x]缺Path、布尔或数字非法、键值写在节外)直接拒绝启动,日志与托盘气泡写明原因;单条规则写错(漏.Command、规则名带点、模式为空)只跳过该条;某个文件夹路径不存在则跳过它、其余照常 - 动作模板:命令支持
{filepath}{filename}{basename}{directory}{ext}{timestamp}占位符 - 执行有兜底:
.exe/.com直接启动(避开 cmd 的引号剥离),其余交给cmd /c;单次执行 10 分钟超时会被结束,标准输出、错误输出与退出码都写进日志 - 配置热重载:改完
config.ini保存,右键托盘 → “重新加载配置”即可生效,无需重启 - 可随时暂停:托盘菜单有“停止监控 / 开始监控”开关,暂停期间不再处理新文件,程序仍常驻;重载配置会保持当前的运行或停止状态
- 图标随状态切换:运行中是程序图标,停止监控后托盘换成“已停止”图标,托盘提示文字同步显示“运行中 / 已停止”,一眼就能看出当前状态
- 开机自启:托盘菜单勾选即可,写入
HKCU\...\CurrentVersion\Run,不碰管理员权限 - 日志轮转:单个日志超过 1 MB 自动转存为
.1 - 单实例:命名互斥体防重复启动
- 运行
FileMonitorTool.exe。程序目录下没有config.ini时会自动生成一份带完整注释和示例的配置,托盘出现图标即开始监控。 - 右键托盘 → “打开配置文件”,按下面的说明改
config.ini:先给要监控的文件夹写Path,再往里加规则。 - 保存后右键托盘 → “重新加载配置”即可生效。
托盘菜单:打开配置文件 / 重新加载配置 / 打开日志 / 停止监控(或开始监控)/ 开机启动 / 退出。点“停止监控”后图标换成停止样式,再点“开始监控”恢复。
从 1.3.x 及更早版本升级:配置格式已整体更换,旧的
config.ini(顶层的WatchPath、FileFilter、Action.<N>.Ext等写法)不再被识别,程序会报“配置错误”。请先删掉旧的config.ini(可改名留档),让程序重新生成新格式,再把原来的目录和规则按新写法填回去。
配置文件是纯文本,用「节」组织:
[Global]
IncludeSub=false
WatchChanged=false
DebounceMs=300
[Folder:下载]
Path=D:\down
Zip=zip;rar;7z
Zip.Command="D:\Tools\UniExtract\UniExtract.exe" "{filepath}" /sub- 以
#或;开头的行是注释,空行忽略 - 所有键值都必须写在某个节内;写在
[Global]之前会直接报错 - 同一节内的同一个键只能出现一次,重复时只有最后一行生效并记一条告警
| 配置项 | 说明 | 默认 |
|---|---|---|
IncludeSub |
是否递归监控子目录,可被文件夹节覆盖 | false |
WatchChanged |
是否响应“已有文件内容被修改”,可被文件夹节覆盖 | false |
DebounceMs |
去抖窗口(毫秒,最小 10),可被文件夹节覆盖 | 300 |
MaxConcurrentActions |
同时执行的最大动作数(小于 1 按 1 处理),只能全局设置 | 4 |
LogUnmatched |
没有命中任何规则的文件是否记一条日志,只能全局设置 | true |
LogFile |
日志文件,相对路径基于程序目录,只能全局设置 | monitor.log |
[Global] 里除上面这些保留键之外的裸键,都会被当作全局规则解析,写法与文件夹内规则相同。
每个要监控的文件夹写一个节,名字 自取,用于日志与气泡显示。节内保留键:
| 键 | 说明 |
|---|---|
Path |
必填,监控目录的绝对路径;目录不存在时该文件夹被跳过,其余继续运行 |
IncludeSub |
可选,覆盖全局的同名设置 |
WatchChanged |
可选,覆盖全局的同名设置 |
DebounceMs |
可选,整数且 >= 10,覆盖全局的同名设置 |
节内其他键都是规则,必须成对出现,规则名不能含 .:
# 规则名=扩展名列表(分号或逗号分隔;* / *.* 表示全部;可写 pdf、*.pdf、d*、?df)
报表=pdf;xlsx
# 规则名.Command=命中后执行的命令
报表.Command="D:\Tools\MergeTool.exe" --input "{filepath}"- 优先级严格按书写顺序:越靠前越优先,第一条命中就停止;兜底
*规则务必放最后 - 扩展名不区分大小写,
pdf与.pdf都认;本版按扩展名判断,不再支持按完整文件名匹配 Command里.exe/.com直接启动,其余(内置命令、%VAR%、重定向、.bat)交给cmd /c- 占位符:
{filepath}完整路径、{filename}文件名(含扩展名)、{basename}文件名(不含扩展名)、{directory}所在目录、{ext}扩展名(不带点)、{timestamp}形如20261109_143012(提交动作时生成一次)
会被点名的问题:缺 .Command 的规则、规则名含 .、模式为空、孤立的 .Command 键会被跳过并记日志;某个文件夹 Path 不存在只跳过该文件夹;一条有效规则都没有时托盘弹“没有有效规则”。
- Visual Studio 2022(17.10 及以上,
.slnx解决方案格式) - 或命令行:
dotnet build -c Release(需要 .NET Framework 4.8 目标框架包),也可以直接双击仓库里的编译.bat
目标框架 net48,使用 WinForms;输出在 bin\Release\net48\。
FileMonitorTool.csproj 项目文件(net48 / WinExe)
FileMonitorTool.slnx 解决方案
Program.cs 入口,单实例互斥 + 消息循环
TrayApplication.cs 托盘图标、菜单、开机自启、配置重载
FileMonitor.cs FileSystemWatcher 封装、按文件夹监控、就绪检测
Debouncer.cs 按文件路径去抖
ActionExecutor.cs 命令模板展开与执行
ConfigReader.cs config.ini 解析(分节 + 规则)与默认配置
Logger.cs 线程安全日志与轮转
config.ini.example 默认配置模板(与首次运行生成的 config.ini 完全一致)
APP.ico / stop.ico 图标源文件
编译.bat 一行命令的 Release 构建脚本
- 只支持 Windows(依赖 WinForms、注册表、
FileSystemWatcher)。 Command最终会变成真实进程,配置即代码,请勿使用来路不明的配置。- 若动作程序需要 UAC 提权(Win32 错误 740),工具本身不会提权,日志里会给出对应提示。
- 监控网络盘或超大目录时,
FileSystemWatcher内部缓冲区可能溢出,日志中会出现相应告警;可缩小监控范围或关闭子目录监控。
MIT © 小恐龙