Initial commit: local_machine docs and scripts

2026-03-14 20:03:57 +03:00
commit a39ef89125
85 changed files with 14500 additions and 0 deletions
--- a/docs/disk_cleanup/DISK_CLEANUP.md
+++ b/docs/disk_cleanup/DISK_CLEANUP.md
@@ -0,0 +1,189 @@
+# 🧹 Очистка диска 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, сокращение числа файлов.