A project opened as a folder inside a repository mirrored that folder over every linked checkout, even where it does not exist. Pending-request recovery required each absent mirror, so the "questions and permissions not fully recovered" warning listed dozens of nonexistent worktree folders and never cleared. The native inventory now flags such checkouts `nestedFolderMissing` while keeping their ownership, so conversations placed there stay routed and accessible. Recovery no longer derives a required location from them (the selected conversation, active sessions and known requests stay required), and the worktree selector lists them only while selected. Creation checks before any native call that the starting revision tracks the opened folder and otherwise answers 409 `nested_folder_unavailable`, shown translated, leaving no checkout or branch behind. Covered by the nested-workspace Git fixture and a pending-recovery store test; dev-docs and the Projects help page (ten locales) describe the behavior.
15 KiB
Проекты и worktree
Вкладка проекта подключает CodeNomad к папке на компьютере серверной части. Открытие вкладки, просмотр рабочей копии и перемещение семейства разговоров — разные операции.
Открытие проекта
- Нажмите Новый экземпляр (
+), чтобы открыть главную страницу. - Выберите Обзор папок, укажите папку серверной части и откройте её; либо выберите запись в Недавние папки.
- Для копирования репозитория выберите Клонировать Git-репозиторий, заполните URL репозитория и Папка назначения, затем нажмите Клонировать. Папка назначения заполняется заранее: папка с именем репозитория в папке, где лежит последний клон, а без него — рядом с последним проектом. Обзор выбирает папку, в которой будет клон; путь, включая имя папки клона, можно изменить и вручную.
Просмотр удалённого сервера означает просмотр его файловой системы, а не телефона или ноутбука. Открытие проекта не создаёт отдельный демон OpenCode для каждой вкладки. Разговоры — нативные сессии OpenCode; их время жизни не совпадает со временем жизни вкладки.
Клонирование записывает репозиторий в папку назначения. Параметр Сначала удалить папку назначения, если она уже существует. разрушителен: включайте его, только если всё уже находящееся там можно удалить. Если не уверены, используйте новую папку. Неудачное клонирование не повод удалять существующий проект; перед повтором проверьте указанные папку назначения и ошибку.
Недавние записи — это ярлыки. Переименовать рабочее пространство меняет отображаемое имя; Убрать из недавних удаляет ярлык, но не файлы и разговоры. Щелчок по уже открытому недавнему проекту открывает новую вкладку; его кнопка Открыта (Перейти к открытому проекту) вместо этого выбирает существующую вкладку.
Меню нового экземпляра
- Удерживайте
+или щёлкните правой кнопкой; когда на ней фокус, используйте Alt+Down, Shift+F10 или клавишу Menu. - Найдите недавний проект либо выберите Обзор…, Временный или Клонировать….
Обычное нажатие по-прежнему открывает полную главную страницу. Меню — быстрый переход, а не средство управления: переименовывайте/удаляйте недавние проекты и управляйте закладками серверов на главной странице. Escape закрывает меню и возвращает фокус на +.
Закрытие вкладки проекта
- Нажмите кнопку закрытия вкладки или выполните Закрыть вкладку в палитре команд (
Ctrl/Cmd+Wв интерфейсе). - Закрытие вкладки закрывает этот проект в CodeNomad: он перестаёт следить за его событиями и запросами. Сессии продолжают работать в OpenCode.
- Снова откройте папку через обзор или недавние записи, чтобы найти эти разговоры.
| Действие | Область и эффект | Чего не делает |
|---|---|---|
| Закрыть вкладку | Убирает подключение CodeNomad к проекту этой вкладки; отдельно открытая вкладка той же папки не затрагивается | Не удаляет файлы проекта или нативную историю, не останавливает сессии и не выгружает Location из OpenCode |
| Остановить сессию | Выполнение выбранного разговора | Не закрывает проект и не удаляет историю |
Если то же подключение проекта показано в другом окне, его вкладка тоже закрывается, и это окно показывает уведомление. Окно, начавшее закрытие, уведомления не показывает. Закрытие происходит сразу; если серверная часть не может закрыть проект, появляется ошибка, а Перейти к открытому проекту на главной странице по-прежнему ведёт к нему. Автоматического повтора нет. Неотправленные черновики закрытой вкладки не сохраняются для восстановления при запуске.
Закрытие всего окна, выход или перезагрузка не закрывают его подключения проектов; обычное восстановление при запуске продолжает действовать. Если нужно убедиться в завершении выполнения, явно остановите соответствующие запуски. CodeNomad никогда не выгружает нативные Location; обслуживание общей службы описано в разделе настройки OpenCode.
Временные рабочие пространства
- Выберите Временный в меню или Новый временный экземпляр на главной странице.
- Работайте в пустой папке под управлением CodeNomad; Git автоматически не инициализируется.
- При закрытии вкладки выберите Сохранить, Удалить или Отмена. В меню вкладки также есть Сохранить как проект.
| Выбор | Эффект | Восстановление |
|---|---|---|
| Сохранить | Закрывает проект в CodeNomad, сохраняет папку и разговоры, убирает временный статус и добавляет недавний проект | Откройте из недавних; папка не перемещается |
| Удалить | Удаляет разговоры и файлы временного рабочего пространства | Отмены нет; сначала сохраните нужное в другом месте |
| Отмена | Оставляет временное рабочее пространство открытым | Продолжайте работу или решите позже |
Нетронутая временная вкладка без разговора, файлов и неотправленного черновика при закрытии удаляется без вопроса. Открытые временные вкладки участвуют в обычном восстановлении при запуске, но на главной странице нет отдельного списка для возврата к закрытым временным папкам.
Удаление запрещено, пока разговор выполняется или папка открыта в другой вкладке/окне. Сначала остановите запуск и закройте другие виды. При неудачном удалении пространство остаётся временным: устраните указанную проблему и повторите, а не удаляйте родительский каталог вручную.
Выбор или создание worktree
- Откройте родительский разговор и используйте переключатель worktree в поле ввода. На узких экранах это элемент только со стрелкой.
- Выберите найденный worktree или + Создать worktree.
- Для создания заполните Имя и выберите Создать и использовать worktree.
CodeNomad обнаруживает worktree через OpenCode и проверяет принадлежность открытому репозиторию. Если проект — папка внутри репозитория, показываются только worktree, содержащие эту папку. Чтобы создать worktree из такой папки, Git должен её отслеживать. Новая ветка начинается с HEAD выбранной рабочей копии. Имя существующей ветки использует её текущую ревизию; Git может отказать, если ветка уже открыта в другом месте. По умолчанию worktree размещаются в .codenomad/worktrees. Незакоммиченные изменения остаются в исходной рабочей копии; создание не копирует их в новый worktree.
Переключатель в поле ввода перемещает родительский разговор и всех его рекурсивных потомков как проверенное семейство. Подсессия не может менять этот переключатель независимо. Активные сессии блокируют операцию: дождитесь завершения семейства или сначала остановите его выполнение. Дождитесь завершения перемещения перед следующим; при ошибке проверьте обновлённое состояние разговора/worktree перед повтором.
Напротив, Просматриваемое рабочее дерево в разделе Файлы меняет только рабочую копию, читаемую панелью. Это не перемещает разговор, не переключает ветку и не меняет место выполнения следующей команды оболочки.
Удаление worktree
- В списке worktree поля ввода используйте Удалить worktree для удаляемого worktree ветки.
- Проверьте целевую папку. Не включайте Удалить принудительно (отбросить локальные изменения), если потеря локальных изменений недопустима.
- Подтвердите удаление и проверьте итоговый список.
Удаление убирает локальную папку worktree. Основная рабочая копия Git не подлежит такому удалению. CodeNomad возвращает затронутые семейства разговоров в корневую рабочую копию и проверяет их размещение перед удалением worktree; активные сессии могут блокировать удаление. Это не архив и не резервная копия незакоммиченных файлов.
Если Git отказывает из-за изменённых/неотслеживаемых файлов, сохраните или очистите их перед повтором. Принудительное удаление явно отбрасывает их. При блокировке каталога закройте использующие его терминалы, редакторы, наблюдатели и фоновые процессы. Если запись отсутствует, обновите worktree и проверьте путь перед повтором. Для передачи диагностики в окне ошибки есть Копировать обезличенную; сначала проверьте даже обезличенный текст.
Инициализация Git и работа без него
- Для обычной папки при доступном Git откройте Файлы → Изменения или Коммиты.
- Выберите Инициализировать Git. Действие выполняется сразу, без дополнительного подтверждения.
- Дождитесь обновления метаданных проекта и разговоров; используйте Обновить, если Git инициализирован вне CodeNomad.
Инициализация создаёт репозиторий в явно открытой папке, а не в родительской. Коммит не создаётся. При ошибке прочитайте сообщение и обновите состояние перед повтором: запрос с неопределённым ответом автоматически не повторяется.
Если серверная часть не может запустить Git, разговоры и ограниченный просмотр файлов остаются доступны для явно открытой папки в режиме только каталога. Операции worktree и инициализация Git требуют Git в этой серверной части. См. установку и файлы.