---
name: workspace-manager
version: "1.0.0"
category: tools
description: "当需要管理 AI 工作目录时使用：上下文管理、临时文件清理、工作区重置、上下文快照保存。不要用于业务代码的修改或 Git 操作。Use when you need to manage AI workspace: context management, temp file cleanup, workspace reset, context snapshot saving. Do NOT use for business code modification or git operations."
triggers:
  zh: ["清理工作区", "workspace", "上下文管理", "重置工作区", "清理临时文件", "保存上下文"]
  en: ["workspace", "context management", "clean workspace", "reset workdir", "cleanup temp files", "save context"]
---

# 工作区管理 / Workspace Manager

## Core Concept / 核心概念

**输入**: 工作区管理命令 | **输出**: 操作结果报告 | **不负责**: 业务代码修改、Git 操作

## Workflow / 工作流程

### Step 1: 识别工作区状态

扫描当前项目的工作区：
- 临时文件（`.tmp`, `.backup`, `.opencode/tmp/`）
- 缓存文件
- 上下文快照文件

### Step 2: 执行管理操作

根据用户意图执行对应操作：

| 操作 | 行为 |
|------|------|
| 清理 | 删除临时文件、过期缓存 |
| 重置 | 清空工作区，保留业务文件 |
| 快照 | 保存当前上下文状态 |
| 恢复 | 从快照恢复工作区 |

### Step 3: 生成操作报告

```
# Workspace Report
- Cleaned: 3 temp files
- Preserved: 12 business files
- Status: Ready
```

## Iron Law / 核心铁律

1. 绝不删除业务代码文件
2. 清理前确认用户意图
3. 保留 `.git/` 和 `.opencode/` 核心结构
4. 所有删除操作可恢复（移动到 .opencode/trash/）