智能文件管家

任务目标

本 Skill 用于：从多个维度扫描识别重复文件，提供风险评估和智能整理建议，确保安全清理
能力包含：
- 多维度重复识别（内容、元数据、综合）
- 智能风险评估与分级建议
- 多策略文件整理（按类型、日期、大小）
- 四重安全保障（备份、确认、日志、撤销）
- OpenClaw SDK 标准化接口
触发条件：用户提到"重复文件"、"清理磁盘"、"整理照片"、"释放空间"、"文件分类"等需求

操作步骤

1. 扫描阶段

调用 scripts/duplicate_scanner.py 执行扫描：

python /workspace/projects/duplicate-file-cleaner/scripts/duplicate_scanner.py \
  --directory <扫描目录> \
  --strategy comprehensive \
  --output scan_report.json

参数说明：
- --directory：必填，要扫描的目录
- --strategy：识别策略（comprehensive/综合、content/内容、metadata/元数据）
- --output：输出报告文件路径
- --min-size：最小文件大小（字节），默认 1024
- --extensions：文件扩展名过滤（如 jpg,png,pdf）

2. 风险评估阶段

调用 scripts/risk_assessor.py 评估操作风险：

python /workspace/projects/duplicate-file-cleaner/scripts/risk_assessor.py \
  --input scan_report.json \
  --output risk_report.json

输出包含：
- 风险等级（low/medium/high）
- 风险评分（0-100）
- 风险因素列表
- 操作建议

3. 智能整理阶段（可选）

根据需要调用 scripts/file_organizer.py 整理文件：

python /workspace/projects/duplicate-file-cleaner/scripts/file_organizer.py \
  --directory <源目录> \
  --output <目标目录> \
  --strategy type \
  --dry-run

整理策略：
- type：按文件类型（图片、文档、音频等）
- date：按创建/修改日期
- size：按文件大小（小、中、大、超大）

4. 安全清理阶段

调用 scripts/safety_manager.py 执行安全删除：

python /workspace/projects/duplicate-file-cleaner/scripts/safety_manager.py \
  --delete \
  --files <文件列表> \
  --backup-first

安全功能：
- 删除前自动备份
- 支持一键恢复
- 操作日志记录
- 旧备份自动清理

5. 智能体分析阶段

智能体解读报告，提供个性化建议：
- 基于风险等级推荐清理策略
- 识别高价值文件建议保留
- 生成删除清单（标注高风险文件）
- 提供文件分类整理建议

资源索引

核心扫描：scripts/duplicate_scanner.py（用途：多维度重复文件扫描）
风险评估：scripts/risk_assessor.py（用途：评估清理操作风险）
文件整理：scripts/file_organizer.py（用途：按策略整理文件）
安全管理：scripts/safety_manager.py（用途：备份、恢复、安全删除）
参考指南：references/file-organization-guide.md（何时读取：需要了解文件整理最佳实践）

注意事项

⚠️ 高风险操作时，建议用户先使用 --dry-run 预览模式
⚠️ 系统目录（Windows/System32、Program Files）建议谨慎操作
⚠️ 删除操作默认启用备份功能，支持30天内撤销
扫描策略选择：
- comprehensive：最准确，速度较慢（推荐）
- content：仅识别内容完全相同的文件
- metadata：速度快，可能包含误报
智能体会基于文件路径、修改时间、类型提供保留建议

使用示例

示例1：扫描照片库并评估风险

# 综合扫描照片
python scripts/duplicate_scanner.py \
  --directory ~/Pictures \
  --strategy comprehensive \
  --output photos_report.json

# 评估风险
python scripts/risk_assessor.py \
  --input photos_report.json \
  --output photos_risk.json

智能体分析后建议保留拍摄时间最早的版本，并标注可能的重要照片。

示例2：安全清理下载目录

# 扫描下载目录
python scripts/duplicate_scanner.py \
  --directory ~/Downloads \
  --strategy content \
  --output downloads_report.json

# 安全删除（先备份）
python scripts/safety_manager.py \
  --delete \
  --files duplicate1.jpg,duplicate2.pdf \
  --backup-first

智能体会识别重复下载的资源文件，推荐删除多余副本，并保留原始文件。

示例3：整理工作文档

# 按文件类型预览整理
python scripts/file_organizer.py \
  --directory ~/Documents/Work \
  --output ~/Organized/Work \
  --strategy type \
  --dry-run

# 确认后执行
python scripts/file_organizer.py \
  --directory ~/Documents/Work \
  --output ~/Organized/Work \
  --strategy type \
  --execute

智能体会按文档、表格、演示文稿等分类整理，并提供文件移动预览。

示例4：全盘快速扫描

# 使用元数据策略快速扫描
python scripts/duplicate_scanner.py \
  --directory ~ \
  --strategy metadata \
  --min-size 102400 \
  --output full_scan.json

智能体会提示可能需要较长时间，并建议优先处理大文件和高风险目录。

OpenClaw SDK 兼容性

所有脚本输出 JSON 格式符合 OpenClaw SDK 2.0.0 规范
标准化状态码和错误处理
支持通过命令行参数集成
完整的参数文档和使用示例

安全保障机制

三级风险评估：low/medium/high 分级，动态调整确认流程
智能备份：默认备份删除文件，支持自定义备份位置
操作追溯：完整记录所有操作，支持一键恢复
撤销能力：30天内可随时撤销清理操作