Initial UNC file watcher web console

2026-04-17 17:08:49 +08:00
commit 1d283d540c
10 changed files with 1931 additions and 0 deletions
@@ -0,0 +1,116 @@
+# UNC File Watcher
+
+This project is a Go-based local web console for watching files in UNC paths and copying or moving them to local directories.
+
+After build, the program is a single `exe`. The target machine does not need Go installed.
+
+## Features
+
+The program supports two rule types at the same time:
+
+- Archive rule
+  Watches `.tar.gz`
+  Copies or moves files to a `zip` directory
+  Skips when the `zip` directory already has a file with the same name
+  Skips when the `unzip` directory already has an extracted folder with the same name
+
+- Generic file rule
+  Watches other file types by extension list
+  Only needs `UNC source path + local target path`
+  Does not use `unzip`
+  Supports two dedupe modes
+
+## Generic File Dedupe
+
+The generic file rule supports these dedupe modes:
+
+- `Same name and same size`
+  This is the default mode
+  If the target directory already has a file with the same name and the same size, the file is skipped
+  If the target directory already has a file with the same name but a different size, it is treated as a conflict and skipped without overwrite
+
+- `Same name and same hash`
+  When the target directory already has a file with the same name, the program computes SHA-256 for source and target
+  If the hashes match, the file is skipped
+  If the hashes do not match, it is treated as a conflict and skipped without overwrite
+
+## Stable File Detection
+
+To avoid processing a file while another service is still writing it in the UNC path, the program checks both conditions:
+
+- `size + modified time` stay unchanged across multiple scans
+- the last modified time is older than `stable_for`
+
+Suggested starting values:
+
+```text
+scan interval: 15s
+stable_for: 1m
+stable_scans: 3
+```
+
+## Build
+
+```powershell
+go build -o unc_tar_watcher.exe .
+```
+
+## Run
+
+```powershell
+.\unc_tar_watcher.exe
+```
+
+Default listen address:
+
+```text
+http://127.0.0.1:18080
+```
+
+To change the port:
+
+```powershell
+.\unc_tar_watcher.exe -listen 127.0.0.1:19090
+```
+
+## Web UI Settings
+
+### Archive Rule
+
+- Enable archive rule
+- Archive UNC source path
+- Zip path
+- Unzip path
+
+### Generic File Rule
+
+- Enable generic file rule
+- Generic file UNC source path
+- Local target path
+- Extension list, for example `.csv,.txt,.pdf`
+- Dedupe mode
+
+### Shared Settings
+
+- Scan interval
+- Stable duration
+- Stable scan count
+- Transfer mode: `copy` or `move`
+- Recursive scan
+
+## Local Settings File
+
+The web UI saves settings automatically next to the executable:
+
+```text
+unc_tar_watcher_settings.json
+```
+
+When you open the page again, the last saved settings are loaded automatically.
+
+## Runtime Notes
+
+- In `copy` mode, source files remain in the UNC path
+- In `move` mode, the program copies first and then removes the source file
+- The generic file rule never overwrites an existing target file when a conflict is detected
+- The archive rule only handles `.tar.gz`