Персональная агентская средаServer / Codex

Гайд 06 / 06 · При необходимости

Сохраняйте работу.
Продолжайте спокойно.

Устройства, ключи, резерв, восстановление и помощь при ошибках.

Что получится

Цель настройки: отдельный доступ для каждого устройства, внешний резерв важных файлов и проверенное восстановление на копии.

Перед серьёзным изменением

Попросите помощника сделать проверенный снимок. Копия должна уйти во внешнее хранилище: резерв на том же диске сервера не защищает от его потери.

Создать резерв
Сделай резерв по system/workflows/backup-restore.md. Включи shared, state, agents и projects, а также изменяемые системные файлы. Не добавляй секреты, кэши и старые backups. Создай уникальный снимок и манифест, проверь хеши и подготовь копирование во внешнее хранилище. Покажи состав и результат проверки.

Если нужно восстановить

Сначала восстановите снимок в отдельный каталог и сравните его с рабочей папкой.

Пробное восстановление
Прочитай system/workflows/backup-restore.md и манифест снимка [путь]. Проверь целостность, восстанови выбранные файлы в отдельную новую папку и сравни результат. Рабочую папку пока не заменяй.

SSH-ключи, токены и авторизация Codex не входят в файловый резерв AI Workspace. Для каждого устройства используйте отдельный ключ, который можно отозвать независимо.

Если что-то не работает

СитуацияЧто сделать
Ноутбук не подключаетсяСверьте данные подключения; передайте установщику текст ошибки, если вход не восстановился.
Codex не видит папкуСверьте серверный путь. Попросите установщика проверить запуск Codex при SSH-входе.
Телефон не подключаетсяСверьте адрес, порт, имя пользователя и ключ именно этого телефона.
Специалист не видит sharedПусть назовёт точный недоступный путь; роль специалиста должна остаться основной.
Неизвестная ошибкаСкопируйте текст ошибки и запустите диагностику ниже.
Проверить без автоматических исправлений
Проведи диагностику по system/workflows/check-workspace.md. Скажи, что исправно, что неисправно и что не проверено на сервере и этом клиенте. Для проблемы укажи точный путь, наблюдение и один следующий шаг. Не применяй исправления во время диагностики.

Новое устройство

Не копируйте рабочую папку. Выдайте устройству отдельный SSH-ключ, добавьте подключение к тому же серверу и откройте канонический проект через Codex Desktop. На iPhone добавьте SSH-хост прямо в Remote. На Android сначала проверьте наличие Add → SSH; связь через включённый Codex Desktop — запасной вариант после проверки.

Одновременная работа требует одного автора на файл и перечитывания перед записью. При конфликте агент сохраняет предложение, а не затирает чужое изменение.

Спокойный порядок действий при сбое

Сначала определите, доступен ли серверный чат. От этого зависит, может ли агент помочь внутри среды или понадобится установщик.

Соединения нет

Проверьте сеть и попробуйте другое уже настроенное устройство. Если второе подключается, сообщите установщику, на каком устройстве возник сбой и что написано в ошибке. Если не подключается ни одно, нужны проверка сервера и SSH со стороны установщика. Не удаляйте рабочую папку и не проходите онбординг заново.

Чат работает, но результат пропал или неверен

Назовите дело и ожидаемый документ. Попросите найти файл, проверить CURRENT.md и историю изменений. При ошибочной записи сначала сохраните текущее состояние, затем восстановите нужную версию в отдельной папке и сравните. Замена рабочих файлов — следующий отдельный шаг после проверки.

Резерв готов, когда его можно восстановить

После настройки попросите показать дату последней копии, её внешний адрес, состав и результат пробного восстановления. «Архив создан» подтверждает только создание архива. Срок хранения и расписание согласуются при установке; готовый комплект сам по себе ещё не означает работающий автоматический резерв.

Пример приёмки: из внешнего снимка восстановили отдельную папку, нашли нужное дело, сравнили файлы и прочитали точку продолжения. История чатов, вход в аккаунт и ключи требуют отдельного плана — файловая копия среды их не заменяет.

Новое или потерянное устройство

Для нового устройства установщик настраивает отдельный ключ и проверяет вход в тот же серверный проект. При потере попросите отозвать ключ именно этого устройства и проверить доступ к аккаунту приложения. Отзыв SSH-ключа и завершение сессий аккаунта — разные действия.

Две задачи одновременно

Не поручайте двум чатам менять один файл одновременно. Назначьте одному запись итогов, другому — подготовку предложения. Если обнаружен конфликт, сохраните обе версии и поручите сравнение. Автоматической защиты от всех конфликтов в этой файловой системе не обещается.

После устранения сбоя повторите действие, которое не работало: откройте проект, прочитайте нужный файл или продолжите задачу. Успешный вход ещё не проверяет сохранность конкретного результата.