Skip to content

Устранение неполадок ​

Если что-то пошло не так, начните с obit doctor. Команда только читает и ничего не записывает. Она проверяет установку, подключение агентов, фоновое расписание и ваши данные; каждая строка начинается с PASS, INFO, WARN или FAIL, дальше идут причина и что делать, а при наличии FAIL команда завершается с ненулевым кодом. Добавьте --json, чтобы передать результат другому человеку, или --verbose, чтобы увидеть, какие именно возможности есть у каждого агента.

Каждый раздел ниже построен одинаково: что вы видите, почему так происходит, что делать и как понять, что всё исправлено.

Оболочка не находит obit ​

Терминал пишет command not found, или PowerShell не распознаёт obit. Программа есть на диске, но её папки нет в PATH. Скрипт установки для Windows добавляет %LOCALAPPDATA%\Programs\obituary в пользовательский PATH, но уже открытый терминал нового PATH не видит. install.sh кладёт программы в ~/.local/bin и никогда не меняет PATH, а в некоторых системах этой папки в PATH изначально нет. .deb для Ubuntu кладёт их в /usr/libexec/obituary/, и её в PATH тоже нет.

В Windows закройте терминал и откройте новый. В macOS и Linux добавьте ~/.local/bin в настройки вашей оболочки: для zsh впишите в ~/.zshrc строку export PATH="$HOME/.local/bin:$PATH" и откройте новый терминал. Если вы установили только .deb, используйте полный путь /usr/libexec/obituary/obit или установите командную строку отдельно скриптом установки.

Исправлено, когда obit --version выводит версию, а строка path в obit doctor больше не WARN.

obit doctor не находит obitd ​

Строка FAIL obitd в obit doctor означает, что фоновой программы obitd нет рядом с obit. Obituary ищет её в той же папке, поэтому скопировать один obit недостаточно. Положите obit и obitd рядом или заново запустите установку тем способом, которым устанавливали. Когда obit doctor покажет в этой строке PASS, всё исправлено.

Скачанный файл не проходит проверку контрольной суммы ​

Если вы используете скрипт установки, он сам делает эту проверку и останавливается, ничего не установив, если хеш не совпал. Вручную проверять нужно, только когда вы сами скачали архив, DMG или .deb. Несовпадение обычно означает, что загрузка неполная, файл был изменён по дороге или checksums.txt относится к другому выпуску: хеши считаются для каждого выпуска отдельно.

Скачайте пакет и checksums.txt заново с той же страницы выпуска (из зеркала, если вы в материковом Китае) и проверьте ещё раз; если по-прежнему не совпадает, не запускайте. Замените VERSION и имя файла на те, что вы скачали. В Linux:

bash
file=obituary_VERSION_linux_amd64.deb
grep -F "  $file" checksums.txt | sha256sum --check --strict -

В macOS замените в последней строке sha256sum --check --strict - на shasum -a 256 -c -. В Windows PowerShell:

powershell
$file = "obituary_VERSION_windows_amd64.zip"
(Get-FileHash $file -Algorithm SHA256).Hash -eq ((Select-String -Path checksums.txt -SimpleMatch $file).Line -split '\s+')[0]

Если хеши совпадают, Linux и macOS выводят имя файла и OK, а PowerShell выводит True.

Windows показывает «Система Windows защитила ваш компьютер» ​

Windows SmartScreen может остановить архив, который вы скачали вручную через браузер, потому что у программ Obituary пока нет подписи кода. При установке через Scoop, winget или скрипт установки это бывает редко. Сначала проверьте SHA-256, как описано выше; если он совпал, выберите «Подробнее», а затем «Выполнить в любом случае». Если проверить не удаётся или Windows сообщает о вредоносной программе, а не просто о неизвестном издателе, не запускайте файл.

Окно в Windows не открывается ​

Щелчок по Obituary в меню «Пуск» или в области уведомлений ничего не делает, либо появляется сообщение, что не хватает среды выполнения. Окно отрисовывается средой Microsoft Edge WebView2 Runtime. В Windows 11 она есть, на большинстве компьютеров с Windows 10 тоже, но там, где её нет, окно не запустится. Скачайте и установите WebView2 Runtime с сайта Microsoft (версию Evergreen) и снова щёлкните Obituary; когда окно откроется, всё исправлено.

Окно пока существует только для x64. В архиве Windows для ARM64 нет obit-gui.exe, поэтому там используется командная строка. Если «Open Obituary» в меню значка в области уведомлений показывает уведомление, что программа окна не найдена, значит, obit-gui.exe лежит не рядом с obitd.exe; именно так устроен архив для ARM64. В x64 положите их в одну папку.

macOS: приложение пишет, что несовместимо с этой версией ​

Окно для macOS в версии 1.6.0 (Obituary.app внутри DMG) требует macOS 26. В macOS 15 и более ранних при открытии появляется сообщение, что приложение несовместимо с этой версией macOS, и оно не запускается. Это ошибка упаковки в 1.6.0, исправленная в 1.6.1. До тех пор окну нужна macOS 26. Проблема есть только у окна внутри DMG. Когда у вас будет 1.6.1 или новее, приложение откроется — по этому вы и поймёте, что всё в порядке.

macOS: «не удаётся проверить разработчика» ​

У приложения из DMG нет подписи Developer ID, и оно не нотаризовано, поэтому при первом запуске Gatekeeper его останавливает. После проверки SHA-256 откройте его один раз обычным способом. Когда macOS скажет, что не может проверить разработчика, откройте «Системные настройки», затем «Конфиденциальность и безопасность», найдите Obituary внизу страницы, выберите «Всё равно открыть» и подтвердите ещё раз. Шаги описаны в разделе Первый запуск неподписанного app. Не отключайте для этого Gatekeeper глобально. Если macOS пишет, что приложение повреждено или содержит вредоносное ПО, это другое дело, и разрешать его не следует.

Значок не запускается при входе (macOS, Ubuntu) ​

После входа в систему значка Obituary нет ни в строке меню, ни в области уведомлений. Запуск при входе опирается на запись автозапуска: в macOS это пользовательский LaunchAgent site.woodfish.obituary.tray, в Ubuntu — ~/.config/autostart/obituary.desktop. Если переключатель в Settings окна выключен, приложение переместили или переключатель включили, пока приложение работало прямо из DMG, путь, записанный в этой записи, устарел, и при входе ничего не находится.

Откройте окно и в Settings выключите и снова включите «Start the tray at sign-in», чтобы Obituary переписал запись. В macOS launchctl list | grep obituary теперь должен показать site.woodfish.obituary.tray; в Ubuntu ls ~/.config/autostart/obituary.desktop должен найти файл, и значок появится при следующем входе.

Ubuntu: окно не открывается или нет значка в области уведомлений ​

Щелчок по Obituary в списке приложений ничего не делает — обычно это значит, что не хватает GTK 3 или WebKitGTK 4.1. apt install ./….deb ставит их сам; их нет только в том случае, если их потом удалили или установка прервалась на середине. В Ubuntu 24.04 пакет GTK 3 называется libgtk-3-0t64; имени без t64, libgtk-3-0, в этом выпуске не существует, поэтому команда, скопированная из старой инструкции, не сработает:

bash
sudo apt update
sudo apt install libgtk-3-0t64 libwebkit2gtk-4.1-0 xdg-utils

Снова откройте Obituary из списка приложений; когда окно появится, всё исправлено. Если окно открывается, а значка нет, это потому, что значку нужен рабочий стол, предоставляющий узел StatusNotifierItem, а GNOME по умолчанию его не предоставляет. То же окно можно открыть из списка приложений без каких-либо расширений; а чтобы появился значок, добавьте в GNOME расширение, которое его поддерживает, например AppIndicator.

Истёкшее не хоронится ​

Срок жизни файла давно истёк, а он всё лежит на прежнем месте, и строка runner: в obit daemon status показывает off. Истечение срока обрабатывает плановое задание, которое выполняется каждые 5 минут: «Obituary Runner» в Планировщике заданий Windows, пользовательский агент launchd в macOS, пользовательский таймер systemd obituary.timer в Linux. Если его не установили, выключили или установили для другого каталога данных, в нужный момент никто ничего не делает; тогда истёкшее ждёт следующего obit sweep или срабатывания хука агента, чтобы им занялись.

Выполните obit daemon enable, чтобы установить задание (в Windows это заодно установит запуск значка при входе), и obit sweep, если очистка нужна прямо сейчас. В Linux без пользовательской службы systemd, например в некоторых контейнерах и минимальных системах, obit daemon enable установить его не сможет; тогда запускайте через cron каждые 5 минут obitd --once --home <каталог данных> --config-dir <каталог конфигурации>, оба каталога покажет obit config. Когда строка runner в obit daemon status перестанет показывать off, всё исправлено; в Linux таймер можно увидеть и так: systemctl --user list-timers | grep obituary.

Срок истёк, но объект не похоронен ​

Объект виден на странице «For you» окна в разделе «Burials that failed», рядом указана причина. Часто файл открыт в редакторе, клиенте синхронизации или другой программе и остался на месте. Погребение — это перемещение файла, и оно не удаётся, если файл занят или не хватает прав. Obituary не действует силой: оригинал остаётся нетронутым, через некоторое время программа пробует снова, каждый раз ждёт дольше, а после нескольких неудач останавливается и ждёт вашего решения.

Закройте то, что держит файл, и нажмите «Retry» либо выполните obit sweep. Если вы больше не хотите, чтобы им занимались, нажмите «Stop tracking»: файл останется на месте, а отсчёт закончится. Когда объект исчезнет из «Burials that failed» и появится в obit graveyard, он похоронен.

У воскрешённого файла другое имя ​

obit resurrect не сообщил об ошибке, но файл вернулся с именем report (resurrected).txt, потому что на прежнем месте уже было что-то с таким именем. Воскрешение никогда ничего не перезаписывает: если имя занято, файл возвращается в ту же папку под другим именем, и обе копии остаются целыми. Сравните их, оставьте нужную и переименуйте.

В файле конфигурации ошибка ​

obit config пишет config file has errors, а дальше идут путь к файлу, номер строки и имя ключа. В config.toml есть ключ, которого Obituary не знает, или недопустимое значение. Obituary не игнорирует это молча, иначе при retention = 30 продолжал бы действовать срок хранения в 7 дней, а вы бы думали, что он изменился. Исправьте написание, кавычки или длительность в указанной строке и снова запустите obit config; когда он перестанет жаловаться, а строка config в obit doctor станет PASS, всё исправлено. Как записывается каждая настройка, описано в справочнике конфигурации.

Хук не срабатывает ​

После obit init агент смог удалить файл, и его никто не остановил, либо кажется, что ничего не происходит. Есть три частые причины: агент не был перезапущен и работает со старой конфигурацией; подключение этого агента установлено в другой области (глобально или в проекте); либо в окружении агента задана OBIT_DISABLED=1 (отключает все хуки) или OBIT_GUARD_RM=0 (отключает защиту удаления).

Сначала посмотрите, что установлено:

bash
obit init -g --show        # что установлено глобально
obit init --show           # что установлено в текущем проекте
obit doctor --verbose      # как подключён каждый агент

Если не установлено, установите командой obit init -g --agent <имя>, добавив --dry-run, если хотите сначала увидеть план. После этого перезапустите агента; в Codex ещё выполните /hooks и доверьте хукам Obituary. Чтобы увидеть, что хук получает на самом деле, задайте OBIT_HOOK_AUDIT=1 в терминале, из которого запускаете агента, поработайте с агентом какое-то время и выполните obit hook audit. Отклонённые команды удаления этого переключателя не требуют: они записываются всегда. Ошибки самого хука попадают в hook.log в каталоге данных, а строка hook-log в obit doctor считает ошибки за последние 24 часа.

Когда строка агента в obit doctor (например, claude) показывает PASS и integration is current, агент подключён; если вы пользуетесь защитой удаления, строка вроде claude-guard-rm должна показывать registered: yes. Запустите obit doctor в том же терминале, из которого стартует агент: если хуки отключила переменная окружения, эта строка станет WARN и назовёт переменную.

Предложение для контейнера Docker не удаётся одобрить ​

В окне «Approve» у предложения для контейнера неактивна, а на карточке написано «Docker is not running: start Docker to decide on this proposal.» Чтобы зарегистрировать контейнер, нужно спросить у Docker его полный идентификатор и время создания, а при выключенном Docker это невозможно. Запустите Docker Desktop или Docker Engine и одобрите снова; когда «Approve» можно нажать, а obit docker list показывает контейнер, всё получилось.

Когда срок контейнера истекает, Obituary лишь останавливает его и сохраняет его слой записи, а воскрешение запускает его снова; остановленный контейнер удаляется только после периода хранения. Образы, тома и сети никогда не затрагиваются.

Обновление не удаётся или загрузки из материкового Китая медленные ​

obit update --check сообщает об ошибке, либо скрипт установки работает медленно или падает; скорее всего, этот компьютер не достаёт до GitHub. Когда GitHub отвечает с задержкой, obit update --check и скрипт установки сами переключаются на зеркало в материковом Китае. Чтобы сразу использовать зеркало, выполните bash install.sh --mirror cn в macOS и Linux или .\install.ps1 -Mirror cn в Windows. Если вы скачиваете вручную, берите архив и checksums.txt из одного выпуска и из одного источника. Когда obit update --check выведет строку Latest:, всё исправлено.

MIT