智能文件整理AI助手：告别手动整理，迎接AI驱动的文件管理新时代

 传统手动整理的核心痛点
def manual_file_organize(file_path):
     1. 打开文件查看内容
    content = open_file(file_path)
    
     2. 人脑判断分类依据
    if "合同" in content or "contract" in content:
        target_folder = "/合同文档"
    elif "财务" in content or "报表" in content:
        target_folder = "/财务报告"
    else:
        target_folder = "/待分类"   人工判断后仍需二次确认
    
     3. 手动移动文件、重命名
     问题：依赖人工判断、耗时耗力、分类标准不统一

import os
import json
import requests
from pathlib import Path
from typing import List, Dict, Optional

 1. 定义AI调用接口（以DeepSeek为例）
class AIFileOrganizer:
    def __init__(self, api_key: str, base_url: str = "https://api.deepseek.com"):
        self.api_key = api_key
        self.base_url = base_url
    
    def get_file_classification(self, filename: str, content_preview: str) -> Dict:
        """调用AI进行文件分类和标签提取"""
        prompt = f"""
        请分析以下文件，返回分类和标签结果。
        文件名：{filename}
        内容预览：{content_preview[:1000]}
        
        请以JSON格式返回：
        {{
            "category": "分类（如：合同文档/技术文档/财务报告/项目资料）",
            "tags": ["标签1", "标签2", "标签3"],
            "suggested_name": "建议的重命名（不含扩展名）"
        }}
        """
        
        response = requests.post(
            f"{self.base_url}/v1/chat/completions",
            headers={"Authorization": f"Bearer {self.api_key}"},
            json={
                "model": "deepseek-chat",
                "messages": [{"role": "user", "content": prompt}],
                "response_format": {"type": "json_object"}
            }
        )
        return json.loads(response.json()["choices"][0]["message"]["content"])
    
    def extract_file_content_preview(self, file_path: Path) -> str:
        """提取文件内容预览"""
        ext = file_path.suffix.lower()
        
        if ext in ['.txt', '.md', '.py', '.js', '.html', '.css']:
             文本文件直接读取前2000字符
            with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:
                return f.read(2000)
        elif ext == '.pdf':
             PDF需要额外解析库，此处简化
            return f"[PDF文件：{file_path.name}]"
        else:
             其他文件类型，返回文件名作为参考
            return f"[文件：{file_path.name}]"
    
    def organize_folder(self, folder_path: Path, dry_run: bool = True) -> List[Dict]:
        """整理指定文件夹中的文件"""
        results = []
        
        for file_path in folder_path.iterdir():
            if not file_path.is_file():
                continue
            
             跳过隐藏文件
            if file_path.name.startswith('.'):
                continue
            
            content_preview = self.extract_file_content_preview(file_path)
            
            try:
                classification = self.get_file_classification(
                    file_path.name, content_preview
                )
                
                 生成目标路径
                category = classification.get("category", "其他")
                target_dir = folder_path / category
                
                 生成新文件名
                ext = file_path.suffix
                new_name = classification.get("suggested_name", file_path.stem) + ext
                target_path = target_dir / new_name
                
                result = {
                    "original": str(file_path),
                    "category": category,
                    "tags": classification.get("tags", []),
                    "suggested_name": new_name,
                    "target_path": str(target_path)
                }
                
                if not dry_run:
                     创建目标目录
                    target_dir.mkdir(parents=True, exist_ok=True)
                     移动并重命名文件
                    file_path.rename(target_path)
                    result["status"] = "moved"
                else:
                    result["status"] = "preview"
                
                results.append(result)
                
            except Exception as e:
                results.append({
                    "original": str(file_path),
                    "error": str(e),
                    "status": "failed"
                })
        
        return results

 2. 使用示例
if __name__ == "__main__":
     初始化AI助手
    organizer = AIFileOrganizer(api_key="your-api-key-here")
    
     预览模式运行（不实际移动文件）
    print("🔍 预览模式：分析文件整理方案")
    results = organizer.organize_folder(Path("./待整理文件夹"), dry_run=True)
    
     输出整理方案
    for result in results:
        if result["status"] == "preview":
            print(f"\n📄 原始文件：{result['original']}")
            print(f"   → 分类：{result['category']}")
            print(f"   → 标签：{', '.join(result['tags'])}")
            print(f"   → 建议文件名：{result['suggested_name']}")
        elif "error" in result:
            print(f"\n❌ 处理失败：{result['original']} - {result['error']}")
    
     确认后执行
    confirm = input("\n确认执行以上整理操作？(y/n): ")
    if confirm.lower() == 'y':
        actual_results = organizer.organize_folder(Path("./待整理文件夹"), dry_run=False)
        print(f"✅ 已完成 {len([r for r in actual_results if r.get('status')=='moved'])} 个文件的整理")