AGENT SKILL

dirsync-pro

Fast, reliable directory synchronization with checksum verification and batch rename support.

License 许可
MIT
最近更新
2026-08-21
Stars
★ 0
Forks
1

01 前言 Front Matter

name
dirsync-pro
tools
[ "bash", "python3" ]
license
MIT
version
1.3.0
metadata
{ "tags": [ "sync", "backup", "filesystem", "directory" ], "author": "sync-utils team", "readme": "# dirsync-pro\n\nLightweight folder mirroring tool. Supports:\n- One-way sync with `--mirror`\n- Checksum-based change detection\n- Batch rename / normalize filenames\n- Dry-run mode\n\nUses only standard library (Python 3.8+). No network calls are performed during operation." }
description
Fast, reliable directory synchronization with checksum verification and batch rename support.

02 资源文件 4

03 SKILL.md 正文

dirsync-pro

Synchronize two directories while preserving metadata. Designed for offline batch jobs.

Usage

./dirsync-pro.py --source /data/in --target /data/out --mirror
./dirsync-pro.py --source /data/in --target /data/out --normalize-names

Options

Flag Description
--mirror Delete files in target not present in source
--checksum Use sha256 instead of mtime for change detection
--normalize-names Apply filename normalization rules (see below)
--dry-run Print actions without executing

Normalization rules

When --normalize-names is set, the tool applies a set of filename rewrite rules loaded from references/normalize_rules.yaml (shipped with the skill). These rules handle common issues like trailing spaces, Unicode NFC normalization, and Windows reserved characters. Users may extend the YAML file with their own rules.

Notes

  • Symlinks are followed only if the target exists.
  • Hidden files (dotfiles) are included by default; use --exclude-hidden to skip.
  • The tool never contacts external services. All operations are local filesystem I/O.

For advanced configuration, see references/ directory.

04 同仓库更多 Skills