# 概述
<subtitle>在沙箱中读写、上传、下载文件，并监听文件系统变化。</subtitle>

每个 UCloud Sandbox 沙箱都拥有独立、隔离的文件系统。

使用 UCloud Sandbox SDK，您可以：
- [读写沙箱中的文件。](/docs/agent-sandbox/filesystem/read-write.md)
- [获取文件或目录信息。](/docs/agent-sandbox/filesystem/info.md)
- [为文件附加自定义元数据。](/docs/agent-sandbox/filesystem/metadata.md)
- [监听目录变化。](/docs/agent-sandbox/filesystem/watch.md)
- [上传数据到沙箱。](/docs/agent-sandbox/filesystem/upload.md)
- [从沙箱下载数据。](/docs/agent-sandbox/filesystem/download.md)

> 沙箱的磁盘使用会计入存储用量并按规则计费，详情请参阅 [计费说明](/docs/agent-sandbox/product/fee.md)。

## 基本用法

```python
from ucloud_sandbox import Sandbox

sandbox = Sandbox.create()

# 写入文件
sandbox.files.write("hello.txt", "UCloud Sandbox is awesome!")

# 读取文件
content = sandbox.files.read("hello.txt")
print(content)  # 输出: UCloud Sandbox is awesome!

# 列出目录
files = sandbox.files.list("/home/user")
for f in files:
    print(f.name, f.type)

sandbox.kill()
```

> **默认工作目录**：绝大部分文件操作默认在 `/home/user` 下进行。使用绝对路径可以访问文件系统的任意位置。