Windows SpaceOps

AI-assisted аудит и безопасная послойная очистка диска C: с помощью WizTree и PowerShell.

Этот repository помогает найти крупные программы, пользовательские данные, cache, temp, старые версии, developer runtimes и остатки удалённых приложений. Сначала AI assistant проводит read-only аудит, а затем предлагает точные слои очистки. Перед каждым destructive layer требуется отдельное подтверждение пользователя.

Это не универсальный cleanup script. Repository специально не содержит команды «удалить всё». Конкретный whitelist создаётся только после анализа конкретного компьютера.

Подходит для ChatGPT, Gemini, Claude, Codex и других AI-чатов. Локальный агент может выполнять read-only проверки самостоятельно. Обычный чат должен выдавать безопасные PowerShell-команды и анализировать вставленный пользователем вывод, не притворяясь, что видит компьютер напрямую.

Что здесь есть

• MASTER-PROMPT.md - готовый prompt для любого AI assistant.
• GUIDE.md - подробный разбор всего процесса: от WizTree CSV до проверки реального прироста свободного места.

Устанавливать plugin, skill или локальный agent не обязательно. Master prompt самодостаточен.

Как пользоваться

1. Сделайте снимок C: в WizTree

1. Скачайте WizTree с официального сайта.
2. Запустите его от имени Administrator.
3. Выберите диск C: и выполните Scan.
4. Выберите корень C:\.
5. Нажмите Ctrl+Alt+E и экспортируйте результат в CSV.

CSV является снимком на момент экспорта. AI assistant обязательно должен сверить крупные значения с текущим состоянием диска.

2. Настройте prompt

Откройте MASTER-PROMPT.md и заполните верхний блок:

- Целевой диск: C:
- Цель освобождения: 50 GB
- Режим: максимальное освобождение
- WizTree CSV: C:\Users\<USER>\Documents\WizTree_C.csv
- Полностью исключить: WSL, VHD/VHDX, другие диски
- Обязательно сохранить: Chrome, Steam, рабочие приложения

Добавьте свои protected apps. Если приложение указано как protected, его install roots, user data, processes, services, updater и tasks не должны попасть в cleanup whitelist.

3. Вставьте prompt в AI-чат

Прикрепите CSV, вставьте master prompt целиком и разрешите только read-only аудит. Если AI не имеет доступа к компьютеру, запускайте только предложенные read-only команды и возвращайте их вывод в чат.

AI assistant должен:

• измерить текущие total, used и free GB;
• проверить возраст и полноту WizTree CSV;
• сверить snapshot с live-состоянием;
• отдельно разобрать AppData и разрешённые пользовательские папки;
• разделить объекты по назначению;
• показать точные paths, размеры, последствия и confidence;
• собрать план слоями;
• остановиться перед первым изменением.

4. Подтверждайте слои отдельно

Пример confirmation token:

DELETE-LAYER-1

Такой ответ разрешает только показанный Layer 1. Layer 2 требует нового отчёта и нового подтверждения.

5. Проверяйте фактический результат

После каждого слоя сравнивайте:

FreeBeforeGB
FreeAfterGB
ActualFreeSpaceGainGB
FailedOrLockedFiles
RemainingTargetPaths
Errors

Размер выбранных папок не равен гарантированно освобождённому месту. Итог считается по изменению свободного места на C:.

Как классифицируются данные

Категория	Примеры	Базовое действие
Programs	Program Files, AppData\Local\Programs	Штатный uninstaller
User data	Documents, recordings, projects, backups, profiles	Решение владельца
Cache	Code Cache, GPUCache, package downloads	Только точечные подпапки
Temp	Старые temp-файлы, crash dumps, diagnostic logs	Проверка возраста и locks
Old versions	Старые runtimes, installers, staging	Проверить активную версию
Orphan residue	Папки удалённых приложений	Сначала проверить все связи
Developer and AI	IDE, Python, Node, venv, models	Отдельный слой с последствиями
System or excluded	WSL, VHDX, WinSxS, pagefile	Отдельная процедура

Модель слоёв

1. Layer 1 - старые temp, crash dumps, узкие подтверждённые cache и завершённый installer staging.
2. Layer 2 - cache закрытых приложений и отдельно одобренные заменяемые данные.
3. Layer 3A - ненужные приложения через штатные uninstallers, затем проверенные остатки.
4. Layer 3B - developer runtimes, IDE, package stores, models, profiles и virtual environments.
5. Layer 3C - остальные приложения, games и launchers.
6. Layer 4 - recordings, backups, projects, profiles и другие stateful user data.
7. Separate procedure - WSL, VHDX, hibernation, restore points и system-managed storage.

Safety guarantees prompt

Master prompt требует:

• read-only аудит до любых изменений;
• exact absolute paths;
• whitelist вместо широких deletion commands;
• проверку processes, services, tasks, startup, uninstallers и PATH;
• проверку reparse points до обхода дочерних объектов;
• запрет перехода во внешние junction targets;
• отдельную защиту protected apps;
• uninstaller перед ручным удалением программы;
• отдельный confirmation token для каждого слоя;
• измерение реального результата через FreeBefore и FreeAfter;
• остановку вместо обхода terminal policy или permissions.

Чего repository намеренно не делает

• Не удаляет файлы автоматически.
• Не содержит универсальный список «безопасного мусора».
• Не объявляет весь AppData или Temp безопасным.
• Не удаляет browser profiles целиком.
• Не сканирует содержимое WSL/VHDX.
• Не принимает за пользователя решение об удалении recordings, backups и projects.
• Не обещает конкретное количество освобождённых GB.

Подробный процесс

Полный разбор, AppData taxonomy, работа с Documents, ошибки uninstallers, locks, permissions, junctions и реальные результаты послойной очистки находятся в GUIDE.md.

Disclaimer

Удаление файлов и приложений необратимо. Проверяйте whitelist и последствия каждого слоя. Перед работой с незаменимыми данными сделайте backup на исправный накопитель. Авторы repository не отвечают за потерю данных из-за изменённого prompt, непроверенного script или подтверждения неправильного target.

License

MIT