> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapxagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MapX 项目中的文件

> MapX 如何在项目中保存上传的数据集、文档与 AI 生成的数据，以及如何在数据面板中预览、引用、查找和管理文件。

MapX 的每个项目都包含文件——你上传的数据集与文档，以及 AI 处理数据时生成的内容。文件随项目存储在服务端，重新打开项目时内容始终可用。

## 什么算作文件

* **上传的数据与文档**——CSV、Excel、GeoJSON/JSON、Shapefile、GeoTIFF 影像，以及 TXT、Markdown、Word、PDF 等文档。完整清单见[支持的文件格式](/zh/uploading-data#支持的文件格式)。
* **AI 生成的数据**——AI 在分析过程中创建的数据集，例如清洗后的副本、转换结果或中间产物。它们与上传文件一样保存在项目中。

报告**不是**数据文件。报告是打包地图、图表与洞察的交付物——它在独立的**报告**面板中管理，相关内容见[报告](/zh/concepts/reports)页面。

## 文件与图层的关系

文件与图层相关但不同：

* **文件**是项目中的存储数据。
* **图层**是渲染在地图上的数据。

上传表格或矢量数据后，MapX 会识别位置列并渲染为图层，文件仍作为该图层的来源保留在项目中。分析结果（缓冲区、热力图、空间连接、选址评分）同样会成为图层；GeoTIFF 影像会成为栅格图层。文档永远不会成为图层——AI 会把它当作分析与报告可读取的素材。

已绑定图层的文件会从数据面板移到图层面板，作为该图层的来源；在那里可以打开属性表，编辑行、字段或几何——见[编辑数据与几何](/zh/concepts/layers#编辑数据与几何)。

工作区按资源类型拆分面板：

* **图层**——当前渲染在地图上的所有内容，包括图层来源文件与分析结果。见[图层](/zh/concepts/layers)。
* **数据**——尚未绑定到图层的项目文件，例如文档、未映射的数据集与 AI 生成的数据。
* **图表**与**报告**——可视化与交付物，各有独立面板。

## 数据面板

每个文件行显示格式图标与名称，以及格式、大小、时间与来源（上传或 AI 生成）。用工具条快速查找：

* **搜索**——按文件名筛选。
* **类型筛选**——在全部、表格、文档、文本与其他之间切换；每个标签会显示项目中该类文件的数量。
* **排序**——按最新、名称或大小。

在数据面板中，你可以：

* **上传文件**——为项目添加新的数据或文档。
* **预览文件**——点击行即可在预览画布中打开（见下文）。
* **在对话中引用文件**——点击行上的引用按钮把文件附着到对话，或在输入框用 **@** 插入文件名。
* **下载文件**——单个文件下载在付费套餐可用。
* **批量管理**——进入多选模式后可批量下载或删除文件。

<img src="https://mintcdn.com/mapx/Gm8Sq4rHk_eRSOvo/images/concepts/data-panel.png?fit=max&auto=format&n=Gm8Sq4rHk_eRSOvo&q=85&s=16072947187784f3029364c3921b4260" alt="数据面板：列出 AI 生成的 CSV 表格文件，标注格式、大小、日期与来源" width="1440" height="720" data-path="images/concepts/data-panel.png" />

## 预览文件

点击文件行（或其引用按钮）会打开预览画布，并把文件附着到对话——之后的追问会自动作用于该文件。

预览按文件类型呈现：

* **CSV、Excel 与表格数据**——以数据表渲染（默认展示前 200 行）。
* **TXT、Markdown 与 JSON**——以文本渲染，内容过长时显示可见行数或条目数。
* **PDF 与 Word 文档**——页面的只读预览。

<img src="https://mintcdn.com/mapx/Gm8Sq4rHk_eRSOvo/images/concepts/file-preview-table.png?fit=max&auto=format&n=Gm8Sq4rHk_eRSOvo&q=85&s=821ab921dab5a033a66c729f16846f17" alt="预览画布中以表格展示 CSV 文件——一行一条记录，首行为表头" width="1440" height="900" data-path="images/concepts/file-preview-table.png" />

<img src="https://mintcdn.com/mapx/Gm8Sq4rHk_eRSOvo/images/concepts/file-preview.png?fit=max&auto=format&n=Gm8Sq4rHk_eRSOvo&q=85&s=bb03978dcc8dafe8ca7625dbcce9e42e" alt="预览画布中以文本展示 Markdown 文档，保留标题、列表与表格排版" width="1440" height="900" data-path="images/concepts/file-preview.png" />

文件内容存储在服务端并按需流式传输，大文件也能保持流畅。AI 处理文件时，会在对话中返回带同一预览的文件卡片。

## 删除文件

删除文件是永久操作。数据面板中的文件是独立存储的——删除不会影响已经渲染的图层，图层来源请在图层面板中管理。如果还需要内容，请先下载（付费套餐）或导出[项目清单](/zh/sharing/exporting)作为备份。

<Note>
  文件存储计入套餐配额。存储上限见[套餐页面](/zh/account/plans)，用量计费见 [Credits](/zh/account/credits)。
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.