========================================
  dupe-cleaner 查重清理 使用说明
========================================

【这是什么】
扫描磁盘或文件夹，找出内容完全相同的重复文件，
可选择性删除到回收站，支持撤销恢复。


一、首次安装（只需一次）
────────────────────────
1. 解压本压缩包到任意目录
2. 在命令行进入 app 目录：
      cd dupe-cleaner查重清理/app
3. 执行启动脚本：
      python launcher.py
   → 首次会自动创建 Python 虚拟环境并安装依赖
   → 提示"服务已启动"即可

前提：电脑已装 Python 3.8 或以上版本
      下载地址：https://www.python.org/downloads/


二、启动工具
────────────────────────
重复执行：
      python launcher.py
→ 自动启动服务
→ 页面地址：http://127.0.0.1:5800

如果服务已经在运行，脚本会直接提示，无需重复启动。


三、在 WorkBuddy 中使用
────────────────────────
把本技能解压到：
      ~/.workbuddy/skills/dupe-cleaner查重清理/
然后对 WorkBuddy 说"打开查重工具"即可，AI 会自动完成启动。


四、使用步骤
────────────────────────
1. 选磁盘或输入路径（如 D:\、E:\照片）
2. 点「开始扫描」，等待完成（大磁盘需几分钟）
3. 扫描完自动显示重复文件列表

4. 工具栏按钮（仅影响当前已显示的分组）：
   ┌──────────────┬────────────────────────────┐
   │ 保留第一个    │ 每组保留最早文件，勾选其余    │
   │ 全留         │ 取消当前显示分组的所有勾选    │
   │ 全删         │ 勾选当前显示分组的全部文件    │
   │ 忽略勾选      │ 标记已处理，不删除，隐藏      │
   │ 确认删除勾选  │ 删除到回收站（先备份，可恢复） │
   └──────────────┴────────────────────────────┘

5. 底部「加载更多」展开后续分组
6. 左侧文件夹筛选栏可按目录过滤
7. 「显示已处理」可查看和恢复已删文件


五、安全机制
────────────────────────
- 删除前自动备份到 .dupe_backup 目录
- 可随时恢复，不会真正丢失文件
- 每次扫描数据独立存储，互不影响
- 操作范围限定：按钮只影响已展开的分组
  未展开或其他盘的文件不受影响


六、常见问题
────────────────────────
Q: 启动后页面打不开？
A: 等 3-5 秒让服务启动，再刷新浏览器

Q: 扫描很慢？
A: 正常，文件越多越慢。百万级文件可能需10分钟+

Q: 删除后后悔了？
A: 点「显示已处理」→ 勾选要恢复的文件 → 点「恢复勾选」

Q: 想换台电脑用？
A: 复制整个文件夹到新电脑，执行 python launcher.py 即可


七、环境要求
────────────────────────
- Windows 系统
- Python 3.8+
- 浏览器（Edge / Chrome / Firefox 均可）


========================================
  如有问题，随时反馈。
========================================
