Skip to content

About

常驻 Windows 托盘的文件监控工具:新文件落盘稳定后自动执行自定义命令(解压、归档、转外程序等)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FileMonitorTool

一个常驻 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
  • 单实例:命名互斥体防重复启动

使用

  1. 运行 FileMonitorTool.exe。程序目录下没有 config.ini 时会自动生成一份带完整注释和示例的配置,托盘出现图标即开始监控。
  2. 右键托盘 → “打开配置文件”,按下面的说明改 config.ini:先给要监控的文件夹写 Path,再往里加规则。
  3. 保存后右键托盘 → “重新加载配置”即可生效。

托盘菜单:打开配置文件 / 重新加载配置 / 打开日志 / 停止监控(或开始监控)/ 开机启动 / 退出。点“停止监控”后图标换成停止样式,再点“开始监控”恢复。

从 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] 之前会直接报错
  • 同一节内的同一个键只能出现一次,重复时只有最后一行生效并记一条告警

[Global](必需)

配置项 说明 默认
IncludeSub 是否递归监控子目录,可被文件夹节覆盖 false
WatchChanged 是否响应“已有文件内容被修改”,可被文件夹节覆盖 false
DebounceMs 去抖窗口(毫秒,最小 10),可被文件夹节覆盖 300
MaxConcurrentActions 同时执行的最大动作数(小于 1 按 1 处理),只能全局设置 4
LogUnmatched 没有命中任何规则的文件是否记一条日志,只能全局设置 true
LogFile 日志文件,相对路径基于程序目录,只能全局设置 monitor.log

[Global] 里除上面这些保留键之外的裸键,都会被当作全局规则解析,写法与文件夹内规则相同。

[Folder:名字]

每个要监控的文件夹写一个节,名字 自取,用于日志与气泡显示。节内保留键:

键 说明
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 内部缓冲区可能溢出,日志中会出现相应告警;可缩小监控范围或关闭子目录监控。

License

MIT © 小恐龙

About

常驻 Windows 托盘的文件监控工具:新文件落盘稳定后自动执行自定义命令(解压、归档、转外程序等)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages