> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-zh/nei-rong/overview.md).

# 概述

你在 Decentraland 虚拟世界中能找到的一切都托管在一个分布式服务器网络上，这些服务器称为 Catalysts，它们提供（除其他外）内容 API。客户端正是通过它们上传和下载内容。

Catalyst 的完整 API 可在 [其自身的参考文档中](https://decentraland.github.io/catalyst-api-specs/)。在这里，我们将重点了解内容是如何组织的，以及如何发现和下载它。

下面提到的所有重要概念都在各自的页面中有进一步说明。

### 文件、实体、指针

Decentraland 的内容系统中有三层： [文件](https://github.com/decentraland/docs/tree/main/contributor/filesystem.md) 被打包在 [实体](https://github.com/decentraland/docs/tree/main/contributor/entities.md)中，而实体则通过以下方式发现： [指针](https://github.com/decentraland/docs/tree/main/contributor/pointers.md).

```mermaid
flowchart LR
    指针 --> 实体
    实体 --> 文件1["文件 1"]
    实体 --> 文件2["文件 2"]
    实体 --> 文件3["文件 3"]
```

[文件](https://github.com/decentraland/docs/tree/main/contributor/filesystem.md) 存储在一个类似于 IPFS 的去中心化文件系统中，并会在内容服务器之间自动同步。它们通过一个由文件内容计算得出的唯一字符串 ID 来标识，而标识符和内容都是 **不可变的**。不存在“更新文件”这种说法。相反，会上传替换文件并删除过期文件。

[实体](https://github.com/decentraland/docs/tree/main/contributor/entities.md) 是文件的原子包，代表世界中的实际内容，例如场景和可穿戴物品。它们至少有一个文件，称为 *清单*，其中包含一般描述和元数据。就像它们所包含的单个文件一样，它们是不可变的，并由一个唯一且确定性的字符串标识。所有实体都有一个所有者，所有者持有管理它们所需的私钥。

[指针](https://github.com/decentraland/docs/tree/main/contributor/pointers.md) 是可以解析为实体 ID 的稳定引用。当实体被替换时（即所有者上传一个新包，而旧包被删除），其中包含的文件和元数据会发生变化，其标识符也会变化，但指针保持不变，并会被重定向到新版本。

### 快照

内容服务器还托管大型以换行分隔的 JSON 文件，其中包含在某一时间点所有活跃实体（即当前被指针引用的实体）的摘要。这些文件称为 [快照](https://github.com/decentraland/docs/tree/main/contributor/snapshots.md)，可用于浏览所有可用内容。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/contributor/contributor-zh/nei-rong/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
