Tidy

Tidy 是一个本地照片/视频整理与去重工具：以内容哈希（hash）作为核心主键，把“内容资产（asset）”与“物理文件路径（file）”解耦管理，从而实现稳定去重、可恢复的一致性落盘操作。

定位（对外）

• 整理工具，不是相册 App：所有操作直接作用于文件系统，强调“可控/可恢复/可落盘”。
• 差异化：以 hash 为唯一内容主键，配合 file_ops 与对账任务保证一致性与崩溃恢复。

功能概览

• 扫描入库：递归扫描目录，提取元信息，计算内容 hash，生成缩略图（best-effort）。
• 内容去重：同一份内容可对应多个物理路径；整理时“保留一份，其余副本直接物理删除”（回收站仅用于用户删除的最后留底）。
• 可恢复一致性：通过操作日志与对账机制，处理中断/崩溃后的恢复。
• 重复项工具：主界面右上角扳手入口，支持 hash 完全重复 + pHash 相似重复分组处理。
• 大库浏览：前端虚拟列表 + 增量更新，能浏览大量文件。

架构

• Server：Node.js + Express + SQLite + Sharp
• Client：React + Vite + TailwindCSS + TanStack Query

文档

• docs/README.md（入口；包含“分形自指文档”规范与源码目录下钻入口）
• docs/README.md#3分钟上手（最短路径：扫目录 → 扫描 → 去重 → 归档 → 对账）
• docs/桌面分发.md（桌面分发：Win/macOS 安装形态、数据目录、更新策略）
• docs/图标设计.md（图标设计：创意说明 + AI 生成 prompt + Web/Desktop 入口）

许可与社区

• LICENSE（个人免费、商业付费的使用条款）
• NOTICE（归属说明）
• CONTRIBUTING.md（贡献指南）
• CODE_OF_CONDUCT.md（行为准则）
• SECURITY.md（安全报告）
• site/（GitHub Pages 主页）