# 🧹 Очистка диска Mac — сводный гайд

Один документ: что не трогать, что можно удалять, быстрые команды, скрипты.  
**Скрипт:** [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)

---

## ❌ Что НЕ удалять

| Категория | Пути | Причина |
|-----------|------|---------|
| 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` | Артефакты сборки |

**Итого сохраняется:** ~9–10 GB (ориентир).

---

## ✅ Что безопасно удалять

Всё ниже — кэши или пересобираемое; не трогать пункты из таблицы выше.

### Кэши разработки

| Что | Путь | Ориентир |
|-----|------|----------|
| Colima | `~/.colima`, `~/Library/Caches/colima` | до ~30 GB |
| npm | `~/.npm`, `~/.npm/_npx` | 300–500 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 |
| com.brave.Browser | `~/Library/Caches/com.brave.Browser` | 423 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 | 1–16 GB | Вручную |
| Telegram, anytype | 1–2 GB | Не удалять |
| Library/Caches (ShipIt, anytype-updater, браузеры) | ~2 GB | Удалять по списку выше |
| .gradle, .cursor/extensions | ~1.5 GB | Не удалять |

Запуск сканирования: `./scripts/scan-cleanup-items.sh`.

---

## 🚀 Быстрые команды

**С закрытым Cursor** (освободит ~10–12 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/com.brave.Browser"
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), 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).

---

## 📁 Скрипты

| Файл | Назначение |
|------|------------|
| [cleanup-disk-now.sh](./cleanup-disk-now.sh) | Интерактивная безопасная очистка (согласовано с DO_NOT_DELETE) |
| [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, сокращение числа файлов.