app_data_manager

项目概述

软件数据迁移助手是一款面向 Windows 10 / 11 换机场景的桌面工具。它会扫描本机已安装的软件，推断散落在 %APPDATA%、%LOCALAPPDATA%、%PROGRAMDATA% 等处的用户数据目录，把「软件 ↔ 数据」对应成清单，帮助你在重装或换机前先备份、再删除。工具坚持安全红线：只读注册表、只操作用户数据目录，绝不触碰系统目录。

换机前先把软件的配置与缓存摸清楚，再决定哪些备份、哪些删除。

主要功能

• 五步工作流：扫描 → 查看筛选 → 人工校正 → 备份 → 删除/卸载
• 扫描推断：读取注册表卸载项与 MSIX/商店应用，枚举数据目录并推断归属与占用大小
• 筛选查看：支持关键字搜索、内容类型、识别状态与 Top-N 大目录，超大目录会高亮提示
• 人工校正：归属错误可取消归属或手动指派，指派结果持久化到下次扫描
• 备份打包：勾选条目打包为 ZIP，内含 manifest.json 清单与对应目录结构
• 安全删除：删除前需通过四道确认闸门，默认提供移入回收站的可撤销方式
• 卸载软件：直接调用软件自带的卸载命令，可选静默参数
• 清单导出：扫描结果可导出 CSV（Excel 不乱码）或 JSON

适用人群

• 准备重装系统或更换电脑的用户
• 需要清理软件残留数据的人
• 帮助他人迁移电脑数据的运维人员
• 关注数据安全、担心误删系统目录的用户

快速上手

1. 安装 Python 3.10 及以上，执行 pip install -r requirements.txt 安装依赖
2. 运行 python run.py 启动工具，或执行 python -m src.main
3. 点击左上角「扫描」执行注册表、MSIX、数据目录与大小推断
4. 在筛选栏定位条目，必要时右键手动指派归属
5. 勾选条目后「备份选中」，确认无误再执行删除或卸载

核心优势

• 安全优先：系统关键目录黑名单在展示层与执行层各校验一次，换个写法也无法绕过
• 推断引擎：L1 到 L6 分层归属推断，含中英文别名表与冲突裁决
• 可撤销删除：默认移入回收站，避免误删无法恢复
• 可打包分发：提供 PyInstaller 配置，可生成免安装的绿色目录版程序

系统要求

项目	要求
操作系统	Windows 10 / 11（x64）
运行环境	Python 3.10 及以上
依赖	PySide6-Essentials 6.8.3，其余功能使用标准库

注意事项

• 读取更完整的 MSIX 列表或卸载系统级软件建议以管理员身份运行
• 备份还原功能尚未实现，备份归档为标准 ZIP，可手工解压取回数据
• 卸载后的注册表残留清理尚未实现，可在卸载后用「残留扫描」手动清理
• 识别率受软件构成影响，绿色软件与通用目录仍可能落入「未识别」，可手动指派