# Anytype (macOS) — чёрный экран после загрузки, пустое окно

> **Проверенный кейс (2026-04):** интерфейс успевает показать контент, затем окно уходит в чёрный/пустой экран.  
> **Что сработало:** обновление клиента до актуальной стабильной версии через Homebrew Cask; данные в `~/Library/Application Support/anytype/data/` не трогались.

**Связано:** безопасная очистка кэшей и структура каталогов — [ANYTYPE_WORKSPACE_FIX.md](../../disk_cleanup/ANYTYPE_WORKSPACE_FIX.md). Официально про графику — [Troubleshooting (Anytype Docs)](https://doc.anytype.io/anytype-docs/advanced/troubleshooting).

---

## Содержание

1. [Симптомы](#1-симптомы)
2. [Диагностика](#2-диагностика)
3. [Что нельзя удалять (данные)](#3-что-нельзя-удалять-данные)
4. [Шаг 1 (опционально): только кэши UI](#4-шаг-1-опционально-только-кэши-ui)
5. [Шаг 2 (основной): обновить приложение](#5-шаг-2-основной-обновить-приложение)
6. [Если после обновления снова IncompatibleVersion](#6-если-после-обновления-снова-incompatibleversion)
7. [Сброс профиля Electron с сохранением vault](#7-сброс-профиля-electron-с-сохранением-vault)
8. [Ссылки](#8-ссылки)

---

## 1. Симптомы

- Окно Anytype **сначала отрисовывается**, затем **чёрный или пустой** экран.
- Несколько окон / фон / сон Mac — иногда усугубляют (Electron), но **не всегда** являются первопричиной.
- В логах ядра при работе с сетью возможны ошибки **`IncompatibleVersion`** (несовпадение версии клиента с ожиданиями координации Anytype).

---

## 2. Диагностика

### Версия установленного приложения

```bash
/usr/libexec/PlistBuddy -c 'Print CFBundleShortVersionString' /Applications/Anytype.app/Contents/Info.plist
```

### Логи клиента (Electron)

```bash
tail -n 200 "$HOME/Library/Application Support/anytype/logs/log.log"
```

### Логи middleware («сердце» / синхронизация)

```bash
grep -n 'IncompatibleVersion' "$HOME/Library/Application Support/anytype/common/logs/anytype.log" | tail -20
```

Если **`IncompatibleVersion`** повторяется на свежем запуске — в первую очередь **обновите клиент** до версии не старше рекомендуемой сетью (стабильный cask Homebrew обычно достаточен).

### Место на диске

Переполненный том ломает **автообновление** (обрыв загрузки, checksum mismatch, `ENOSPC` в логах). Перед установкой DMG/ZIP оставьте запас свободного места на томе с `/Users` (ориентир: не держать системный том постоянно **>~95%** занятым).

---

## 3. Что нельзя удалять (данные)

Локальный vault и ключи лежат под:

```text
~/Library/Application Support/anytype/data/
```

Внутри каталога аккаунта — как минимум `localstore`, `spaceStoreNew`, `objectstore`, `config.json`, `device.key` и т.д. Подробная схема — в [ANYTYPE_WORKSPACE_FIX.md](../../disk_cleanup/ANYTYPE_WORKSPACE_FIX.md).

**Страховка перед любыми действиями:**

```bash
mkdir -p "$HOME/Desktop/anytype-backups"
cp -a "$HOME/Library/Application Support/anytype/data" \
  "$HOME/Desktop/anytype-backups/data-$(date +%Y%m%d_%H%M%S)"
```

---

## 4. Шаг 1 (опционально): только кэши UI

Пока Anytype **полностью закрыт** (`Anytype` → Quit или `killall Anytype`), можно удалить **только** кэши Chromium/Electron — **не** трогая `data/`. Готовый набор команд — в [ANYTYPE_WORKSPACE_FIX.md § Безопасная очистка](../../disk_cleanup/ANYTYPE_WORKSPACE_FIX.md#-безопасная-очистка-кэша-anytype).

Официальная подсказка для графики (Linux-путь в доке; на macOS аналог — те же папки под `Application Support/anytype`): удалить **`GPUCache`** — см. [Troubleshooting](https://doc.anytype.io/anytype-docs/advanced/troubleshooting).

---

## 5. Шаг 2 (основной): обновить приложение

Рекомендуемый способ на macOS — **Homebrew Cask** (версия совпадает с тем, что проверяет сообщество; URL — официальный CDN Anytype в формуле cask).

### 5.1. Закрыть приложение

```bash
killall Anytype 2>/dev/null || true
sleep 1
```

### 5.2. Установка / обновление

```bash
HOMEBREW_NO_AUTO_UPDATE=1 brew install --cask anytype
```

Если Brew сообщает, что **`Anytype.app` уже есть в `/Applications`** и установка **прерывается**, старое приложение нужно **убрать из пути** (переименовать — безопасно, это не данные):

```bash
killall Anytype 2>/dev/null || true
sleep 1
ts=$(date +%Y%m%d_%H%M%S)
mv /Applications/Anytype.app "/Applications/Anytype.app.backup-$ts"
HOMEBREW_NO_AUTO_UPDATE=1 brew install --cask anytype
```

Проверка версии:

```bash
/usr/libexec/PlistBuddy -c 'Print CFBundleShortVersionString' /Applications/Anytype.app/Contents/Info.plist
```

Запуск:

```bash
open -a Anytype
```

После проверки резервную копию `Anytype.app.backup-*` можно удалить.

**Важно:** установка/замена **`.app`** не удаляет `~/Library/Application Support/anytype/data/` — локальные пространства и объекты сохраняются.

---

## 6. Если после обновления снова IncompatibleVersion

1. Убедиться, что действительно запускается **новый** бинарь (версия в Info.plist, один экземпляр в `/Applications`).
2. Освободить место на диске и повторить обновление.
3. При необходимости поставить более свежую ветку (**alpha**), если она доступна отдельным cask и не конфликтует со стабильным (см. `brew search anytype` и описание cask’ов).

---

## 7. Сброс профиля Electron с сохранением vault

Если обновление **помогло по версии**, но UI всё ещё «ломается», можно пересоздать кэш/Local Storage **всего каталога поддержки**, оставив только `data/` (как и раньше — **сначала полная копия** `data/` в безопасное место).

Пока Anytype **закрыт**:

```bash
killall Anytype 2>/dev/null || true
BASE="$HOME/Library/Application Support/anytype"
cp -a "$BASE/data" "$HOME/Desktop/anytype-backups/data-manual-$(date +%Y%m%d_%H%M%S)"
mv "$BASE" "${BASE}_profile_backup_$(date +%Y%m%d_%H%M%S)"
mkdir -p "$BASE"
mv "${BASE}_profile_backup_"*/data "$BASE/"
open -a Anytype
```

Не удаляйте каталог `*_profile_backup_*`, пока не убедитесь, что приложение снова стабильно открывается.

---

## 8. Ссылки

- [Anytype — Troubleshooting](https://doc.anytype.io/anytype-docs/advanced/troubleshooting)
- [anytype-ts releases (GitHub)](https://github.com/anyproto/anytype-ts/releases)
- [Homebrew Cask `anytype`](https://formulae.brew.sh/cask/anytype)
