WindowsCleaner v5.0：基于 Python 的桌面磁盘清理工具

2. 安装依赖包

pip install -r requirements.txt

如果手动安装，需要以下库：

pip install psutil winshell

3. 运行程序

python clean_app.py

📋 功能详解

🧹 磁盘清理模块

临时文件清理

# 扫描系统临时目录
temp_files, total_size = FileCleaner.scan_temp_files()

支持的清理位置：

• Windows 临时文件夹（C:\Windows\Temp）
• 用户临时文件夹（AppData\Local\Temp）
• 系统缓存文件
• 浏览器缓存（Chrome、Edge、Firefox）
• 系统日志文件

回收站清理

# 一键清空回收站
FileCleaner.empty_recycle_bin()

⚙️ 系统优化模块

注册表清理

# 扫描无效注册表项
invalid_entries = RegistryCleaner.scan_invalid_registry()
# 清理无效项
cleaned_count = RegistryCleaner.clean_invalid_entries(invalid_entries)

检测范围：

• 无效的软件卸载条目
• 错误的文件关联
• 失效的启动项

启动项管理

# 获取所有启动项
startup_items = SystemOptimizer.optimize_startup()
# 禁用不需要的启动项
SystemOptimizer.disable_startup_item(item)

📊 磁盘分析模块

磁盘使用情况分析

# 获取所有磁盘分区的使用情况
disk_info = DiskAnalyzer.get_disk_usage()
# 分析大文件
large_files = DiskAnalyzer.analyze_large_files("C:\\", limit=50)

显示信息包括：

• 磁盘总容量和使用量
• 使用百分比
• 文件系统类型
• 大文件列表（>50MB）

🎨 界面设计特色

主题系统

# 主题配置示例
THEMES = {
    'light': {'bg_color': '#f0f0f0', 'text_color': '#000000', 'accent_color': '#007acc'},
    'dark': {'bg_color': '#2b2b2b', 'text_color': '#ffffff', 'accent_color': '#007acc'}
}

自定义按钮组件

class StyledButton(tk.Button):
    """自定义样式按钮，支持悬停效果"""
    def __init__(self, master, theme_config, **kwargs):
        super().__init__(master, **kwargs)
        # 绑定鼠标事件
        self.bind('<Enter>', self.on_enter)
        self.bind('<Leave>', self.on_leave)
    
    def on_enter(self, event):
        """鼠标悬停效果"""
        self.config(bg=self.theme_config['button_hover'])

多语言支持

{
    "app_title": "WindowsCleaner v5.0 - 专业系统优化工具",
    "nav_optimize": "🔧 优化加速",
    "status_ready": "就绪",
    "quick_scan": "🚀 快速扫描系统垃圾"
}

🔧 技术实现

1. 多线程处理

为了避免界面卡顿，所有耗时的操作都在后台线程中执行：

def quick_scan(self):
    """快速扫描 - 在新线程中执行"""
    self.status_label.config(text="扫描中...")
    threading.Thread(target=self._perform_quick_scan, daemon=True).start()

2. 管理员权限检测

def is_admin():
    """检测当前是否以管理员身份运行"""
    try:
        return ctypes.windll.shell32.IsUserAnAdmin()
    except:
        return False

3. 文件使用状态检测

def is_file_in_use(filepath):
    """检查文件是否正在被使用"""
    try:
        os.rename(filepath, filepath)
        return False
    except:
        return True

4. 错误处理机制

def safe_file_operation(func):
    """文件操作安全装饰器"""
    def wrapper(*args, **kwargs):
        try:
            return func(*args, **kwargs)
        except PermissionError:
            print(f"权限错误：{args[0]}")
            return None
        except Exception as e:
            print(f"操作失败：{e}")
            return None
    return wrapper

📱 使用指南

基础操作

1. 快速清理
   • 点击'优化加速'页面
   • 选择需要清理的项目
   • 点击'开始清理'按钮
2. 系统分析
   • 使用'磁盘分析'查看磁盘使用情况
   • 通过'大文件查找'定位占用空间的文件
3. 系统优化
   • 在'高级'页面进行注册表清理
   • 使用'启动项管理'优化开机速度

高级功能

1. 管理员模式
   • 部分功能需要管理员权限
   • 程序会自动检测并提示
2. 数据迁移
   • 支持文件批量迁移
   • 显示迁移进度
3. 自动清理计划
   • 可设置定期自动清理
   • 支持自定义清理时间

⚠️ 注意事项

安全性提醒

1. 注册表操作风险：错误的注册表操作可能导致系统不稳定，建议在操作前备份注册表
2. 文件删除不可逆：清理的文件无法恢复，请确认后再操作
3. 管理员权限：部分功能需要以管理员身份运行

系统要求

• 需要 Windows 操作系统
• 建议以管理员身份运行以获得完整功能
• 确保有足够的磁盘空间进行清理操作

已知限制

• 浏览器缓存清理仅支持主流浏览器（Chrome、Edge、Firefox）
• 某些系统文件可能无法删除（正在使用中）
• 需要安装 Python 环境

🔄 更新日志

v5.0（当前版本）

• ✅ 新增多主题支持（日光/黑暗/冬季）
• ✅ 添加中英文双语界面
• ✅ 优化界面布局和用户体验
• ✅ 增强文件清理算法
• ✅ 改进错误处理机制

v4.0

• ✅ 重构代码结构
• ✅ 添加注册表清理功能
• ✅ 实现启动项管理
• ✅ 优化性能表现

v3.0

• ✅ 引入图形界面
• ✅ 实现基础清理功能
• ✅ 添加磁盘分析模块

🛠️ 开发指南

扩展新功能

1. 添加新清理项目

def scan_new_category():
    """扫描新的清理类别"""
    files = []
    # 实现扫描逻辑
    return files, total_size

2. 添加新语言

{"new_feature": "新功能名称", "new_button": "新按钮文本"}

3. 添加新主题

'new_theme': {'bg_color': '#your_color', 'text_color': '#your_color', 'accent_color': '#your_color'}

代码结构说明

WindowsCleanerApp
├── __init__() # 初始化应用
├── setup_ui() # 设置用户界面
├── setup_fonts() # 加载字体
├── switch_theme() # 切换主题
├── switch_language() # 切换语言
└── [页面方法] # 各个页面的显示方法

📈 性能优化建议

1. 扫描优化

# 使用生成器减少内存占用
def scan_files_generator(path):
    for root, dirs, files in os.walk(path):
        for file in files:
            yield os.path.join(root, file)

2. 缓存机制

# 缓存扫描结果
class ScanCache:
    def __init__(self, ttl=300):  # 5 分钟过期
        self.cache = {}
        self.ttl = ttl

3. 进度反馈

# 实时更新进度
def update_progress(current, total):
    progress = (current / total) * 100
    self.progress_bar['value'] = progress

🤝 贡献指南

如何参与开发

1. Fork 项目仓库
2. 创建功能分支
3. 提交代码更改
4. 发起 Pull Request

开发规范

• 遵循 PEP 8 编码规范
• 添加适当的注释
• 编写单元测试
• 更新相关文档

问题反馈

• 通过 GitHub Issues 提交问题
• 提供详细的复现步骤
• 包括系统环境信息

📚 学习资源

相关技术

• Tkinter 官方文档
• psutil 库使用指南
• Windows API 编程

扩展阅读

• 《Python GUI 编程：Tkinter 实战》
• 《Windows 系统编程》
• 《Python 自动化运维》

🎯 未来规划

短期目标

• 添加更多系统优化功能
• 支持更多浏览器缓存清理
• 改进用户界面动画效果

长期目标

• 开发插件系统
• 添加网络优化功能
• 支持 Linux 和 macOS 平台

社区建设

• 建立用户交流群
• 编写详细的使用教程
• 收集用户反馈改进功能

💝 致谢

感谢所有为该项目做出贡献的开发者，特别感谢：

• Python 社区：提供了强大的开发工具
• 开源贡献者：分享了宝贵的技术经验
• 测试用户：提供了宝贵的反馈意见

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情