Markdown 版本

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

# 清理不活躍的 VS Code 代理程式工作樹，同時保留工作階段

> 根據文件撰寫的指南，說明 VS Code 1.141 手動清理工作樹的方式，包括預設選取、安全措施、還原，以及獨立的 Preview 自動清理。

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.

2026 年 10 月 7 日推出的 Visual Studio Code 1.141 Stable 新增工作階段清理編輯器，可清理隔離在工作樹中的代理程式工作階段。如果舊工作階段在磁碟留下本機工作樹， `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 會將每個選取的工作階段標示為已完成，並排定移除其工作樹。移除前，VS Code 會將未提交的變更提交至該工作階段的分支。如果無法保留變更或移除工作樹，工作樹就會留下。工作階段與分支歷史仍可使用。可透過 Agents 視窗中的 **Done** 篩選條件（或 Chat 檢視中的 **Archived** 篩選條件）找到工作階段並還原，從分支重新建立工作樹。文件說明了這項保留行為，但不保證每個符合資格的工作樹都會移除，也不保證能回收特定容量的磁碟空間。

清理編輯器不會顯示使用中、執行中、等待輸入或釘選的工作階段。它也會排除已完成、已封存、未命名或處於錯誤狀態的工作階段，超過所選門檻的新工作階段，以及 VS Code 無法測量大小的工作樹。因此，工作階段未出現在編輯器中，並不能證明工作樹已不存在。

## 將清理與刪除工作階段分開看待

手動清理工作樹會保留工作階段與分支。 **Delete** 是另一種操作：VS Code 文件指出，刪除工作階段是永久且無法復原的。對 Copilot 工作階段而言，也會移除相關工作樹，但共用工作樹另有行為。文件提醒，只存在於已移除工作樹中的未提交檔案可能會遺失。若要使用文件所述可復原的工作樹路徑，請使用清理編輯器，並在選取前檢查所需工作。

## 建議與 Preview 自動清理

選用的 `chat.agentSessions.sessionStorageCleanupSuggestion.enabled` 設定會在不活躍工作樹至少占用 5 GiB 或有 20 個工作樹符合資格時，在 Agents 視窗顯示建議。建議會開啟相同的檢查編輯器，但不會自行移除工作樹。你可以在目前視窗中關閉建議、選取 **Don't Show Again**，或執行 `Chat: Disable Session Storage Cleanup Suggestions`。

VS Code 也將 **自動清理工作階段** 列為 Preview 功能。兩個設定預設都關閉。 `chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays` 設定符合資格的 Agent Host 工作階段被標示為已完成前的閒置時間。 `chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays` 設定 VS Code 自動標示為已完成的工作階段，在永久刪除前的另一段寬限期。兩者都接受正整數天數； `0` 會停用該階段。VS Code 建議設為 `15` 天，但這是設定建議，不是手動編輯器的 7/15/30/60/90 天篩選條件。

使用 Preview 自動化時，工作階段必須不在處理中、超過設定的最後修改時間門檻、至少關聯一個已合併的 pull request，而且沒有相關的開啟中 pull request。外部工作階段會排除。設定啟用後，VS Code 會在啟動時及每小時檢查。使用者自行標示完成的工作階段不會透過此路徑自動刪除；還原自動完成的工作階段會取消其刪除資格。要讓自動清理移除工作樹，其分支必須追蹤 upstream，且沒有待推出的提交或未提交變更。Git 狀態不明或未符合任一條件時，工作樹會保留。VS Code 表示此流程不會強制移除工作樹。

若想查看大小並自行選擇舊工作樹，手動編輯器才是適當方式。Preview 設定處理的是範圍較窄、以已合併 PR 為條件的生命週期，最終可能永久刪除符合資格的工作階段。這些 VS Code 文件沒有列出清理功能的額外費用。實際回收的空間取決於符合條件並遭移除的工作樹。

## 重大變化

- 使用工作樹隔離代理程式工作階段的開發人員，現在可在 VS Code 1.141 查看每個符合資格的不活躍工作樹估計大小，並選擇要清理的項目。
- 手動清理會將已選工作階段標示為完成、保留分支歷史，並在移除工作樹前提交未提交的變更。若保留或移除失敗，工作樹會留下；還原工作階段即可重新建立。
- 符合資格的工作樹一開始已選取。確認前請檢查清單。VS Code 會排除使用中、執行中、等待輸入與釘選的工作階段，但這些保護措施無法判斷你是否仍需要不活躍工作階段中的工作。
- Preview 自動清理遵循合併 pull request 的獨立規則，並可在設定的寬限期後永久刪除工作階段。其設定起初關閉。

## 來源與延伸閱讀

VS Code 1.141 版本資訊說明清理編輯器何時進入 Stable 版及其用途。Microsoft 的 *Manage agent sessions in VS Code* 文件提供詳細篩選條件、預設選取、安全措施、還原步驟，以及獨立的 Preview 自動化規則。兩份文件都列在下方來源模組。

## 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) — 手動篩選、選取、保留、排除、還原、建議及 Preview 自動清理。