AI-translated from English; not yet reviewed by a fluent editor.

# Удаление неактивных рабочих деревьев агентов VS Code без потери сессии

> Основанное на документации руководство по ручной очистке рабочих деревьев в VS Code 1.141: выбор по умолчанию, меры защиты, восстановление и отдельная автоматизация в предварительной версии.

By BIG CHANGE Editorial

Published: 2026-10-08T06:14:55.344Z
Updated: 2026-10-08T06:14:55.344Z
Canonical: https://bigchange.ai/blog/vscode-agent-worktree-cleanup-guide

![Conceptual charcoal illustration of a developer at a monitor with a desktop computer tower under the workbench.](https://bigchange.ai/api/media/file/vscode-worktree-storage-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no VS Code interface or measured result is depicted.

В Visual Studio Code 1.141 Stable, выпущенной 7 октября 2026 года, появился редактор для очистки сессий агентов, изолированных в рабочих деревьях. Если старые сессии оставили локальные рабочие деревья на диске, `Chat: Open Worktree Cleanup` он показывает подходящие сессии и примерный размер каждого рабочего дерева. Вы сами выбираете, что удалить. Руководство опирается на [заметки о выпуске Microsoft](https://code.visualstudio.com/updates/v1_141) и [документацию по управлению сессиями](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions); BIG CHANGE не запускала очистку и не измеряла экономию места.

## Проверьте выбранные рабочие деревья перед подтверждением

1. В VS Code 1.141 откройте палитру команд и запустите `Chat: Open Worktree Cleanup`.
2. Выберите период неактивности: 7, 15, 30, 60 или 90 дней. Он определяет, какие сессии считаются подходящими; это не таймер автоматического удаления.
3. Просмотрите каждую сессию и примерный размер её рабочего дерева. Подходящие рабочие деревья **выбраны по умолчанию**. Снимите выбор с любой сессии, которую хотите сохранить, в том числе с работы, ветку или файлы которой вы ещё не проверили.
4. Подтверждайте очистку только для оставшихся выбранных элементов.

VS Code помечает каждую выбранную сессию как завершённую и планирует удалить её рабочее дерево. Перед удалением он фиксирует незакоммиченные изменения в ветке этой сессии. Если сохранить изменения или удалить рабочее дерево не удаётся, оно остаётся на месте. История сессии и ветки сохраняется. Найдите сессию с помощью фильтра **Done** в окне Agents (или **Archived** в представлении Chat) и восстановите её, чтобы заново создать рабочее дерево из ветки. Документация описывает это сохранение, но не обещает удалить каждое подходящее рабочее дерево или освободить определённый объём места.

Редактор очистки не показывает активные, выполняющиеся, ожидающие ввода и закреплённые сессии. Он также исключает завершённые, архивированные, безымянные сессии и сессии с ошибками, сессии новее выбранного порога и рабочие деревья, размер которых VS Code не может измерить. Поэтому отсутствие сессии в редакторе не доказывает, что её рабочее дерево удалено.

## Не путайте очистку с удалением сессии

Ручная очистка рабочего дерева сохраняет сессию и ветку. **Delete** — другое действие: документация VS Code указывает, что удаление сессии необратимо. Для сессий Copilot оно также удаляет связанные рабочие деревья с учётом особенностей общих деревьев. Документация предупреждает: незакоммиченные файлы, существующие только в удалённом рабочем дереве, могут быть потеряны. Используйте редактор очистки для описанного восстанавливаемого сценария и заранее проверьте нужную работу.

## Предложения и автоматическая очистка предварительной версии

Необязательная настройка `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` показывает предложение в окне Agents, если неактивные рабочие деревья занимают не менее 5 GiB или подходят 20 рабочих деревьев. Предложение открывает тот же редактор проверки, но само ничего не удаляет. Его можно скрыть для текущего окна, выбрать **Don't Show Again** или запустить `Chat: Disable Session Storage Cleanup Suggestions`.

VS Code также описывает **автоматическую очистку сессий** как функцию предварительной версии. Две её настройки по умолчанию отключены. `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` задаёт период неактивности, после которого подходящая сессия Agent Host помечается завершённой. `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` задаёт отдельный льготный период перед окончательным удалением сессии, автоматически помеченной VS Code как завершённая. Для обеих настроек задаётся положительное целое число дней; `0` отключает этот этап. VS Code рекомендует `15` дней, но это рекомендация по настройке, а не фильтр ручного редактора на 7/15/30/60/90 дней.

Для автоматизации предварительной версии сессия должна быть не в процессе выполнения, превышать заданный порог с момента последнего изменения, иметь хотя бы один связанный объединённый pull request и не иметь связанных открытых pull request. Внешние сессии исключаются. При включённой настройке VS Code проверяет условия при запуске и каждый час. Сессия, которую вы сами пометили завершённой, не удаляется автоматически этим способом; восстановление автоматически завершённой сессии отменяет её право на удаление. Чтобы автоматическая очистка удалила рабочее дерево, его ветка должна отслеживать upstream и не иметь исходящих коммитов или незакоммиченных изменений. Неизвестное состояние Git или невыполненное условие оставляет рабочее дерево на месте. VS Code указывает, что процесс никогда не удаляет его принудительно.

Ручной редактор подходит, если нужно проверить размеры и самостоятельно выбрать старые рабочие деревья. Настройки предварительной версии относятся к более узкому жизненному циклу объединённых pull request и со временем могут удалить подходящие сессии. В этих документах VS Code не указывает отдельную плату за очистку. Фактически освобождённое место зависит от рабочих деревьев, которые подходят и удаляются.

## Главное изменение

- Разработчики с изолированными в рабочих деревьях сессиями агентов теперь могут видеть примерный размер каждого подходящего неактивного дерева в VS Code 1.141 и выбирать, что очистить.
- При ручной очистке выбранные сессии помечаются завершёнными, история ветки сохраняется, а незакоммиченные изменения фиксируются до удаления рабочего дерева. Если сохранить изменения или удалить дерево не удаётся, оно остаётся; восстановление сессии создаёт его заново.
- Подходящие рабочие деревья изначально выбраны. Проверьте список перед подтверждением. VS Code исключает активные, выполняющиеся, ожидающие ввода и закреплённые сессии, но эти меры не показывают, нужна ли вам работа из неактивной сессии.
- Автоматическая очистка предварительной версии использует отдельные правила объединённых pull request и может окончательно удалить сессии после заданного льготного периода. Её настройки изначально отключены.

## Источники и дополнительная информация

Заметки о выпуске VS Code 1.141 устанавливают, когда редактор очистки появился в Stable, и описывают его назначение. Документация Microsoft *Manage agent sessions in VS Code* подробно описывает фильтры, выбор по умолчанию, меры защиты, восстановление и отдельные правила автоматизации предварительной версии. Оба документа перечислены ниже в модуле источников.

## Sources

- [Заметки о выпуске Visual Studio Code 1.141](https://code.visualstudio.com/updates/v1_141) — Дата выпуска Stable и объявление ручной очистки рабочих деревьев.
- [Manage agent sessions in VS Code](https://code.visualstudio.com/docs/agents/run/sessions/manage-sessions) — Ручные фильтры, выбор, сохранение, исключения, восстановление, предложения и автоматическая очистка предварительной версии.