Skill 应用 05：电脑文件整理 Skill｜自动分类归档、去重清理、规整电脑杂乱文件

weixin_44922938

267人浏览 · 2026-09-13 20:40:28

weixin_44922938 · 2026-09-13 20:40:28 发布

系列说明：「Agent Skills 开发实战」专栏已全部完结。全新 Skill 应用 系列，主打开箱即用业务场景落地，不从零造轮子，每篇配套完整 SKILL.md、执行脚本、配置模板，小白复制即可部署。
配套资源包已上传本人主页资源区，本文可直接绑定资源包自助下载。

一、前言：桌面、下载文件夹乱糟糟，你是否也被文件管理折磨？

桌面堆满截图、安装包、文档、视频，下载文件夹日积月累塞满各种文件，几乎每个电脑用户都会遇到这些痛点：

文件杂乱无序：文档、图片、压缩包、安装包全部混在一起，找一个文件要翻很久；
大量重复文件：多次复制、解压，产生大量副本，占用磁盘空间，手动找重复文件效率极低；
网上脚本风险高：很多文件整理脚本直接执行移动 / 删除，一旦写错配置，有弄丢重要文件的风险；
缺少预览确认机制：执行就直接改动文件，不能先看整理方案，出问题无法回滚；
项目目录容易被破坏：整理时误处理node_modules、.git等工程目录，把项目搞坏；
想要重复复用规则难：网上零散脚本大多是一次性代码，不能保存分类规则，每次整理都要改代码。

市面上普通文件整理脚本大多直接改动文件，缺少方案预览、隔离重复文件、一键回滚、安全排除清单、可持久化配置规则的工程化 Agent Skill 方案。

本文带来 file‑organizer 电脑文件整理 Skill，完整流水线：目录只读扫描 → 生成预览整理方案 → 用户人工确认 → 批量分类归档 + 重复文件隔离 → 输出整理报告，支持一键回滚还原。全程只移动文件，不会直接删除任何文件，完美适配 Trae、OpenClaw等主流智能体，小白简单配置就可以规整桌面、下载目录、文档文件夹，安全治理电脑杂乱文件。

⚠️重要提示：虽然技能做了多重安全防护，处理重要目录前建议手动备份关键资料；重复文件只是移入隔离目录，确认无用后再自行删除。

✅ 读完本文你能收获

完整可落地文件整理 Agent Skill，包含 SKILL.md定义、organize.py主脚本、可编辑rules.json分类配置；
支持 Windows/macOS/Linux 跨平台，仅使用 Python 标准库，无需安装第三方依赖；
11 大类文件自动分类归档，支持「按类型」「类型 + 年份」两种归档布局；
三级哈希校验识别重复文件，只隔离不删除，避免误删重要资料；
执行前生成预览方案，确认之后才改动文件，支持一键完整回滚所有改动；
内置安全排除清单，自动跳过系统目录、代码仓库依赖目录、临时文件，保护项目工程；
Trae / OpenClaw 双平台完整部署教程，附带落地避坑清单；
全套资源包可下载，无需逐段复制代码。

二、file‑organizer Skill 核心能力一览

2.1 核心功能清单

1. 多类型自动分类归档
内置 11 大文件分类：文档、表格演示、图片、视频、音频、压缩包、安装包、代码、电子书、字体、其他；支持两种归档模式：仅按类型归档 / 按类型 + 修改年份归档。同名冲突自动追加_1/_2后缀，绝不覆盖原有文件。

2. 三级校验重复文件检测
判重逻辑：文件大小 → 首尾 64KB 快速指纹 → 完整 SHA‑256 哈希，规避 “大小相同但是内容不同” 的误判；重复文件默认移入_Duplicates隔离文件夹，脚本本身不执行删除操作，由人工确认后清理。

3. 预览先行，确认后再执行
scan只读扫描目录；plan生成preview.md可视化预览方案和机器可读plan.json，看到计划移动、隔离哪些文件，确认无误才执行 apply，不会悄悄改动本地文件。

4. 一键回滚机制
执行时生成manifest.json操作清单，调用 undo 命令可以原路把全部文件还原回原始位置，操作失误可以无损恢复。

5. 安全防护排除清单
默认自动跳过系统目录、node_modules、.git、.venv、__pycache__、临时缓存文件、隐藏文件；支持命令行额外指定需要排除的目录，保护你的代码项目不被打散。

6. 洞察统计报告
扫描识别大文件（>500MB）、长期陈旧文件（超过 365 天未修改）；执行完成输出 markdown 整理报告，统计归档分布、重复隔离数量、跳过文件明细。

7. 可自定义规则配置
rules.json配置文件，可自行增删扩展名、调整分类、修改去重保留策略、调整归档布局，一套规则可以反复多次运行。

8. 跨平台零第三方依赖
只使用 Python 标准库，Windows、macOS、Linux 全部兼容，不需要额外 pip 安装第三方包。

2.2 适合人群

普通办公用户：整理混乱桌面、下载文件夹、文档目录；

开发者：整理电脑散落资源，又不希望破坏本地代码项目；

学生：归档课件、资料、图片视频，清理大量重复下载文件；

使用 Trae / OpenClaw 搭建本地 Agent 自动化工作流的开发者。

三、Skill 完整架构与执行流程

3.1 技能目录结构

Plain Text
.trae/skills/file-organizer/
├── SKILL.md              # 本文件：整理协议 + 分类模板 + 安全规则
├── scripts/
│   ├── organize.py       # 扫描/方案/执行/回滚/去重（仅标准库）
│   └── rules.json        # 分类模板 + 排除清单 + 去重保留策略（可自行修改）
└── .gitignore

运行后在目标被整理目录生成产物：

Plain Text
<目标目录>/
├── _Organized/           # 整理归档后的文件：<类别>/<年份>/文件
├── _Duplicates/          # 重复文件隔离区（人工确认后自行删除）
└── _Organize/            # 方案与报告：plan.json / preview.md / manifest.json / 整理报告_<日期>.md

3.2 完整五步工作链路

1、第一步：scan 只读扫描（完全不改动文件）
遍历目标目录，统计文件数量、分类分布、大文件、陈旧文件、重复文件分组。

bash
python scripts/organize.py scan --target "D:\Download"

2、第二步：plan 生成整理预览方案（依旧不改动文件）
产出plan.json机器方案 + preview.md可读预览报告，你可以打开 markdown 查看哪些文件要移动、哪些重复文件要隔离。

bash
python scripts/organize.py plan --target "D:\Download"

3、第三步：人工核对确认
阅读 preview.md，确认移动数量、重复隔离数量，如果不符合预期，可以修改 rules.json 或者增加排除目录，重新生成方案。没有确认不要执行 apply。

4、第四步：apply 执行整理
传入 plan 方案文件，加上--yes确认，脚本开始批量移动归档、隔离重复文件；同名冲突自动加序号，生成 manifest.json 操作清单与整理报告。

bash
python scripts/organize.py apply --plan "D:\Download\_Organize\plan.json" --yes

5、第五步：undo 一键回滚（需要恢复时执行）
如果整理效果不满意，使用 manifest.json 原路全部还原文件。

bash
python scripts/organize.py undo --manifest "D:\Download\_Organize\manifest.json"

3.3 preview.md 预览报告片段示例

markdown
# 文件整理方案预览（未执行，不改动任何文件）
- 目标目录：`D:\Download`
- 归档目录：`D:\Download\_Organized`（布局：by‑type‑date）
- 生成时间：2026‑09‑11 15:20:00

## 一、总览
| 项目 | 数量 |
|------|------|
| 扫描文件总数 | 126 |
| 计划移动归档 | 112 |
| 重复文件组 | 4 |
| 计划隔离（重复冗余） | 8（约1.2GB） |

## 二、分类归集计划
| 类别 | 文件数 |
|------|--------|
| 文档 | 32 |
| 图片 | 28 |
| 安装包 | 21 |
……

> 重复文件仅隔离到 `_Duplicates/`，本技能不执行删除；确认无误后请自行清理。

四、SKILL.md核心定义（完整文件资源包下载）

4.1 Frontmatter 基础定义

yaml
---
name: "file-organizer"
description: "电脑文件整理：扫描本地目录并按固定分类模板批量归档文档/图片/视频/安装包/代码，检测并隔离重复文件，支持方案预览、一键执行与回滚。当用户要整理桌面/文件夹、清理重复文件、分类归档或规整杂乱文件时触发。"
---

4.2 Agent 自动触发指令

向 Agent 发送如下指令，即可调用本 Skill：

帮我整理桌面文件夹，先输出整理方案；
整理 D 盘 Download 目录，分类归档，隔离重复文件；
列出这个目录下面所有重复文件；
trae 任务指令示例：使用file‑organizer整理D:\Download，按类型+年份归档，重复文件隔离，先给我看方案

4.3 核心分类简要说明

类别	说明
文档	pdf doc docx txt md 等
表格演示	xlsx csv pptx 等
图片	jpg png gif webp svg 等
视频	mp4 mkv avi mov 等
代码	py java js go cpp sql vue html css 等
其他	未能匹配扩展名全部归入

五、双平台小白部署实操教程

方案 1：Trae部署

1、将完整file‑organizer文件夹放置项目路径 .trae/skills/；

2、新建任务，任务描述示例：

Plain Text
使用 file‑organizer 整理 D:\Download，按类型+年份归档，重复文件隔离，先给我看方案

3、先执行得到 preview.md 预览，确认之后再执行 apply；需要还原执行 undo 回滚指令。

方案 2：OpenClaw 部署

1、将技能文件夹复制到 ~/.openclaw/skills/file‑organizer/；

2、终端执行扫描与生成方案：

bash
python scripts/organize.py plan --target "$HOME/Desktop" -o "$HOME/Desktop/_Organize"

3、在对话输入指令：确认执行本次文件整理方案；

4、如需回滚执行 undo 命令，文件全部原路返回。

依赖安装提示：仅需要 Python3.9 及以上版本，无第三方 pip 依赖，直接运行脚本即可。

六、organize.py 脚本核心骨架（资源包提供完整可运行源码）

python
# -*- coding: utf-8 -*-
"""电脑文件整理（file‑organizer）‑ 扫描 / 分类归档 / 去重隔离 / 一键回滚
仅使用 Python 标准库，全程本地处理，不联网、不删除文件。
子命令：scan / plan / apply / undo / dupes
"""
import argparse
import fnmatch
import hashlib
import json
import logging
import os
import shutil
import sys
from datetime import datetime
from pathlib import Path

def setup_logging():
    ...
def load_rules(path=None, layout=None, include_hidden=False) -> dict:
    """加载rules.json配置"""
    ...
def scan_files(target: Path, rules: dict, extra_skip=()):
    """遍历目录，过滤排除目录与临时文件"""
    ...
def quick_hash(path: Path, size: int, kb: int = 64) -> str:
    """文件首尾快速指纹"""
    ...
def full_hash(path: Path) -> str:
    """完整SHA‑256哈希，用于判重"""
    ...
def find_duplicates(entries, rules: dict):
    """三级校验查找重复文件分组"""
    ...
def build_actions(target: Path, dest: Path, entries, dups, rules: dict):
    """生成移动、隔离动作列表"""
    ...
def write_preview(path: Path, target: Path, dest: Path, entries, dups, actions, rules: dict):
    """输出preview.md预览报告"""
    ...

def main():
    parser = argparse.ArgumentParser(description="电脑文件整理")
    # 子命令 scan / plan / apply / undo / dupes
    ...

if __name__ == "__main__":
    main()