Inspiration
A public discussion about merging family photo archives raised a problem that a duplicate scanner alone cannot answer: which files can safely be left out?
Two identical photos might have different names. Two files with the same name might contain different edits. Metadata files can also belong beside a particular photo. Combining those folders needs care.
Photo Archive Merge grew from that problem.
What it does
The Skill is designed to compare two photo backup folders and prepare a consolidated copy while leaving the originals untouched.
It identifies byte-identical files using file sizes and full SHA-256 hashes. Differing versions stay. Files with uncertain companion relationships stay too.
Before copying, it shows the proposed destinations and explains each omitted duplicate. After platform approval, it checks the copied files and records their original locations. Failed or unverified copies must remain visible in the result.
How it was built
The project uses the official UGREEN Uliya Skill Developer Kit. Its Markdown instructions delegate file operations to the registered file-agent through supported UGOS capabilities.
The package contains SKILL.md and five linked references covering comparison, retention rules, copying, verification, reporting and development disclosures.
OpenAI Codex assisted with research, feasibility checks, writing and local validation. The workflow requires no custom backend or external API.
What I learned
Matching bytes does not settle every archive decision. An identical photo may have a companion file or folder context worth keeping.
UGREEN already provides hash deduplication, previews and confirmation. This project focuses on recording where files came from, explaining copy decisions and keeping uncertain relationships intact.
Challenges
The hardest part was defining what the Skill can safely promise before testing on a NAS.
Some runtime details, including path containment and handling existing destination files, still need verification. The instructions block copying when those prerequisites cannot be established and return a comparison report instead.
Current status
The official checker reports zero errors and zero warnings. Local checks also confirm the ZIP contents.
The Skill has not been installed or executed on Uliya/NAS. A synthetic test kit is ready for device testing, including renamed duplicates, edited versions, companion files and failure cases.
The first version is limited to two folders and 250 file entries. Visual similarity search, source cleanup and migration of app albums or face labels are outside its scope.
Built With
- markdown
- openai
- sha-256
- ugos
- ugreen
- uliya