Files
local_machine/docs/disk_cleanup/DISK_CLEANUP.md

200 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🧹 Очистка диска Mac — сводный гайд
Один документ: что не трогать, что можно удалять, быстрые команды, скрипты.
**Запрещено удалять:** [DO_NOT_DELETE.md](./DO_NOT_DELETE.md) · **Скрипт:** [cleanup-disk-now.sh](./cleanup-disk-now.sh) · **Спец. фикс:** [ANYTYPE_WORKSPACE_FIX.md](./ANYTYPE_WORKSPACE_FIX.md) · **История:** [CHANGELOG.md](./CHANGELOG.md)
---
## Содержание
1. [❌ Что НЕ удалять](#-что-не-удалять)
2. [✅ Что безопасно удалять](#-что-безопасно-удалять)
3. [📊 Кто отжирает диск](#-кто-отжирает-диск)
4. [🚀 Быстрые команды](#-быстрые-команды)
5. [🔄 Регулярность очистки](#-регулярность-очистки)
6. [🔧 Anytype: не удалять папку целиком](#-anytype-не-удалять-папку-целиком)
7. [📁 Скрипты](#-скрипты)
8. [📋 Changelog](#-changelog)
---
## ❌ Что НЕ удалять
**Полный белый список:** [DO_NOT_DELETE.md](./DO_NOT_DELETE.md)
Краткая выжимка:
| Категория | Пути | Причина |
|-----------|------|---------|
| **Thunderbird** | `~/Library/Thunderbird/`, `Profiles/*/Mail/*/Inbox` | Почта, не кэш |
| Brave | `~/Library/Application Support/BraveSoftware`, `~/Library/Caches/BraveSoftware` | Настройки, закладки, история |
| Cursor History | `~/Library/Application Support/Cursor/User/History` | История изменений файлов |
| Cursor workspaceStorage | `~/Library/Application Support/Cursor/User/workspaceStorage` | Настройки workspace |
| Cursor extensions | `~/.cursor/extensions` | Кэш расширений, переустановка при удалении |
| Cursor logs / CachedData / ai-tracking | `.../Cursor/logs`, `.../Cursor/CachedData`, `~/.cursor/ai-tracking` | Производительность |
| direct-commander | `~/Library/Application Support/direct-commander` | Настройки файлового менеджера |
| anytype | Вся папка `~/Library/Application Support/anytype` | Данные workspace'ов (localstore, spaceStoreNew и др.) |
| Android SDK | `~/Library/Android/sdk` | Разработка Android |
| Бэкапы в bots | `~/code/bots/backup_*`, `~/code/bots/archives_*` | Восстановление проектов |
| Telegram Desktop | `~/Library/Application Support/Telegram Desktop` | Данные и кэш Telegram |
| Старые архивы | `~/code/methatron/pics/tablecloth/1-7.zip`, архивы в legal | Могут понадобиться |
| pnpm | `~/Library/pnpm`, `~/Library/Caches/pnpm` | Повторная загрузка 967+ пакетов |
| node_modules (frontend) | `~/code/hunabapp-dev/frontend/node_modules` | То же |
| .gradle | `~/.gradle` | Кэш сборки Android/Java |
| Android build | `~/code/hunabapp-dev/frontend/android/app/build` | Артефакты сборки |
**Итого сохраняется:** ~910 GB (ориентир).
---
## ✅ Что безопасно удалять
Всё ниже — кэши или пересобираемое; не трогать пункты из таблицы выше.
### Кэши разработки
| Что | Путь | Ориентир |
|-----|------|----------|
| Colima | `~/.colima`, `~/Library/Caches/colima` | до ~30 GB |
| npm | `~/.npm`, `~/.npm/_npx` | 300500 MB |
| node-gyp | `~/Library/Caches/node-gyp` | — |
| TypeScript | `~/Library/Caches/typescript` | — |
| pip | `~/Library/Caches/pip` | — |
| .yarn | `~/.yarn` | — |
| Windsurf полностью | `~/.codeium/windsurf`, `~/.windsurf`, `~/Library/Application Support/Windsurf` | — |
### Library/Caches (без Brave)
| Что | Путь | Ориентир |
|-----|------|----------|
| ShipIt (Cursor) | `~/Library/Caches/com.todesktop.230313mzl4w4u92.ShipIt` | 768 MB |
| anytype-updater | `~/Library/Caches/anytype-updater` | 453 MB |
| ms-playwright | `~/Library/Caches/ms-playwright` | ~800 MB |
| responsivelyapp-updater | `~/Library/Caches/responsivelyapp-updater` | ~100 MB |
| ResponsivelyApp | `~/Library/Application Support/ResponsivelyApp` | ~90 MB |
| GeoServices | `~/Library/Caches/GeoServices` | ~45 MB |
| Firefox | `~/Library/Caches/Firefox` | 83 MB |
| Google | `~/Library/Caches/Google` | — |
| Homebrew | `~/Library/Caches/Homebrew` | — |
### Кэши приложений (не Telegram)
Notion, zoom.us, LibreOffice, Movavi, Ledger Live, Syncthing (если не нужен):
`~/Library/Application Support/{Notion,zoom.us,LibreOffice,Movavi,Ledger Live,Syncthing}`
### Cursor — только эти кэши и файлы
| Что | Путь | Ориентир |
|-----|------|----------|
| **state.vscdb.backup** | `.../Cursor/User/globalStorage/state.vscdb.backup` | **~10 GB** |
| ShipIt | см. выше в Library/Caches | 768 MB |
| WebStorage | `.../Cursor/WebStorage` | — |
| Partitions | `.../Cursor/Partitions` | — |
| projects | `~/.cursor/projects` | — |
**Опционально (~13 GB):** удаление `state.vscdb` + `-wal` + `-shm` в том же каталоге сбрасывает глобальное состояние редактора. **Закрыть Cursor перед удалением.**
### Прочее
- `~/.cache`
- Пустые логи: `find ~/Library/Logs -type f -size 0 -delete`
- Записи экрана: `~/Library/ScreenRecordings/*` (проверить вручную)
### Build-артефакты в ~/code
Исключить: `*/hunabapp-dev/frontend/android/*`, `*/node_modules/*`, `*/venv/*`, `*/site-packages/*`.
```bash
find ~/code -type d \( -name "build" -o -name "dist" -o -name ".next" -o -name "out" \) \
-not -path "*/node_modules/*" -not -path "*/venv/*" -not -path "*/.venv/*" \
-not -path "*/site-packages/*" -not -path "*/hunabapp-dev/frontend/android/*" \
-exec rm -rf {} + 2>/dev/null
```
### node_modules (опционально)
Исключить: `~/code/hunabapp-dev/frontend/node_modules`. После удаления — `pnpm install` в нужных проектах.
---
## 📊 Кто отжирает диск
Типичные крупные потребители (ориентир):
| Путь | Размер | Действие |
|------|--------|----------|
| Cursor User/globalStorage (state.vscdb + .backup) | ~23 GB | .backup — удалить; state.vscdb — опционально |
| ~/code/legal, hunabapp-dev, archive, backups | 116 GB | Вручную |
| Telegram, anytype | 12 GB | Не удалять |
| Library/Caches (ShipIt, anytype-updater, браузеры) | ~2 GB | Удалять по списку выше |
| .gradle, .cursor/extensions | ~1.5 GB | Не удалять |
Запуск сканирования: `./scripts/scan-cleanup-items.sh`.
---
## 🚀 Быстрые команды
**С закрытым Cursor** (освободит ~1012 GB):
```bash
# Cursor state backup
rm -f "$HOME/Library/Application Support/Cursor/User/globalStorage/state.vscdb.backup"
# Library/Caches (не Brave)
rm -rf "$HOME/Library/Caches/com.todesktop.230313mzl4w4u92.ShipIt"
rm -rf "$HOME/Library/Caches/anytype-updater"
rm -rf "$HOME/Library/Caches/ms-playwright"
rm -rf "$HOME/Library/Caches/responsivelyapp-updater"
rm -rf "$HOME/Library/Caches/Firefox"
rm -rf "$HOME/Library/Caches/Google"
rm -rf "$HOME/Library/Caches/Homebrew"
# Cursor кэши
rm -rf "$HOME/Library/Application Support/Cursor/WebStorage"
rm -rf "$HOME/.cursor/projects"
# Прочее
rm -rf "$HOME/.cache"
find "$HOME/Library/Logs" -type f -size 0 -delete 2>/dev/null
```
Полная безопасная очистка по категориям — в [cleanup-disk-now.sh](./cleanup-disk-now.sh).
---
## 🔄 Регулярность очистки
- **Еженедельно:** build-артефакты, пустые логи.
- **Ежемесячно:** кэши разработки (npm, node-gyp, TypeScript, pip, .yarn), Library/Caches (Google, Firefox, ShipIt, anytype-updater, ms-playwright), Cursor WebStorage/Partitions/projects.
- **При заполнении диска >80%:** всё из ежемесячного + Colima (если не нужен), state.vscdb.backup, приложения (Notion, zoom, LibreOffice, Movavi, Ledger), записи экрана.
---
## 🔧 Anytype: не удалять папку целиком
В `~/Library/Application Support/anytype` лежат и кэши, и **данные workspace'ов** (localstore, spaceStoreNew, objectstore и др.). Удаление всей папки ломает загрузку workspace'ов. Подробное восстановление: [ANYTYPE_WORKSPACE_FIX.md](./ANYTYPE_WORKSPACE_FIX.md).
---
## 📁 Скрипты
| Файл | Назначение |
|------|------------|
| [DO_NOT_DELETE.md](./DO_NOT_DELETE.md) | **Запрещено удалять** — белый список |
| [cleanup-disk-now.sh](./cleanup-disk-now.sh) | Интерактивная безопасная очистка (см. DO_NOT_DELETE.md) |
| [scripts/scan-cleanup-items.sh](./scripts/scan-cleanup-items.sh) | Сканирование: что можно удалить и размеры |
| [scripts/compress-screenrecordings.sh](./scripts/compress-screenrecordings.sh) | Сжатие записей экрана |
| [scripts/quick-cleanup-asahi.sh](./scripts/quick-cleanup-asahi.sh) | Быстрая очистка под Asahi |
| [scripts/scan-move-candidates.sh](./scripts/scan-move-candidates.sh) | Кандидаты на перенос на внешний диск |
| [find-external-disks.sh](./find-external-disks.sh) | Поиск внешних дисков |
| [diagnose-external-disk.sh](./diagnose-external-disk.sh) | Диагностика внешнего диска |
---
## 📋 Changelog
См. [CHANGELOG.md](./CHANGELOG.md).
**Последнее обновление:** 2025-03-14 — консолидация документации, один главный файл DISK_CLEANUP.md, сокращение числа файлов.