# 管理

## 列出沙盒

```bash
wp rudel list
```

当其他工具需要结构化输出时，请使用 `--format=json`。

## 检查单个沙盒

```bash
wp rudel info alpha-3be7
```

记录包含 ID、名称、路径、状态、引擎、表前缀、主题、保护状态、标签、最近活动、克隆元数据、大小、URL 和内容路径。

## 更新元数据

```bash
wp rudel update alpha-3be7 \
  --owner=dennis \
  --labels=qa,agent \
  --purpose="Regression run" \
  --ttl-days=3
```

元数据更新不会重写沙盒站点内容。`--ttl-days` 会将过期时间设为相对于当前时间的值；`--clear-expiry` 会将其移除。

## 保护沙盒

```bash
wp rudel update alpha-3be7 --protected
```

受保护的沙盒会被手动和定时清理跳过。使用 `--unprotected` 移除保护。

## 销毁沙盒

```bash
wp rudel destroy alpha-3be7
```

该命令会请求确认。在脚本中传入 `--force` 可跳过提示：

```bash
wp rudel destroy alpha-3be7 --force
```

此处保护状态不生效：`destroy` 也会移除受保护的沙盒。

销毁沙盒会删除其前缀下的所有数据表（包括快照表）、移除关联工作树和沙盒目录，并删除 Rudel 环境记录。