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

# 数据缓存

> 为您的 Web 应用添加托管的后端缓存，让服务器只需执行一次耗时工作，即可快速响应每位访问者。

## 简介

**数据缓存**让您的 Web 应用能够记住耗时工作的结果，并为每位访问者重复使用。您的应用服务器只需执行一次耗时工作，保存结果，然后将保存的结果提供给之后发起请求的所有人。

耗时工作可以是调用外部 API、从 Google Sheets 或 Notion 获取数据，或者执行繁重的数据库查询。没有数据缓存时，您的服务器会为每位访问者重复这些工作。有了数据缓存，大多数访问者都能立即获得已保存的结果。

数据缓存是一个托管的 Redis 实例，与您的应用服务器一同运行。您无需单独的账户、密钥或配置。Manus 会为您开启它，并编写使用它的代码。

> [!NOTE]
>
> 并非每个应用都需要数据缓存。当大量访问者请求相同的耗时数据时，它才能发挥价值。如果您的网站流量较小，或者页面已经足够快，您可能并不需要它。不确定？可以先[询问 Manus](#ask-manus-whether-your-app-will-benefit) 检查您的项目。

### 数据缓存适用的场景

#### 显示实时数据而不触及 API 限制

您的网站显示来自外部 API 的实时价格、天气或体育比分。每位访问者都会触发一次新的 API 调用，因此页面会随着流量增长而变慢。大多数 API 还会限制每分钟的调用次数，并可能屏蔽您的网站。

有了数据缓存，您的服务器每分钟最多调用一次 API，并从缓存中为每位访问者提供数据。无论有多少访问者，API 每分钟大约只会收到一次调用。

> "我的首页显示来自 \[API] 的实时价格。请使用 Manus 内置的数据缓存，每分钟最多获取一次价格，并从缓存中为每位访问者提供数据。"

#### 内容存放在 Google Sheets 或 Notion 时也能快速加载页面

您将菜单、产品列表、活动日程或博客文章保存在电子表格或 Notion 数据库中。每次页面浏览都会调用该服务，这会增加等待时间，并可能触及其限制。

有了数据缓存，您的服务器每隔几分钟获取一次内容，并向访问者提供已保存的副本。您的编辑仍会在几分钟内显示在网站上。

> "我的网站从 Google Sheets 加载菜单。请使用 Manus 内置的数据缓存，每 5 分钟最多获取一次菜单，并从缓存中为每位访问者提供数据。"

#### 保持快速的排行榜和"当前热门"列表

您的社区、测验或游戏会显示前 100 名排行榜、"本周最热门"列表或全站统计数据。生成这些列表需要繁重的数据库查询，而且查询会随着数据增长而变慢。

有了数据缓存，您的服务器每分钟生成一次列表，并提供已保存的副本。分数仍安全地保存在您的数据库中。

> "我的排行榜页面越来越慢。请使用 Manus 内置的数据缓存，每分钟生成一次前 100 名，并提供已保存的列表。"

#### 应用使用数据缓存的其他方式

* **仪表板汇总。** 每分钟计算一次"今日销售额"，而不是每次浏览页面时都计算。
* **短时间窗口限制。** 每个 IP 地址每分钟最多允许 20 次登录尝试。
* **会过期的验证码。** 存储 10 分钟后失效的电子邮件验证码。
* **自定义登录的会话。** 当您的应用拥有自己的登录系统时，保持用户的登录状态。默认的 Manus 登录不需要这样做。

### 您可能不需要数据缓存的情况

* **您的网站流量较小。** 如果访问者很少，可节省的重复工作也很少。
* **您的网站没有服务器代码。** 静态网站、落地页和作品集无法使用数据缓存。Manus 托管已经会缓存它们的文件。
* **您的页面已经足够快。** 小型数据库查询不需要缓存。
* **数据绝不能丢失。** 订单、账户、付款和用户内容应存放在您的数据库中。

## 使用方法

### 询问 Manus 您的应用是否能从中受益

**1. 打开数据缓存设置**

打开您的 Web 项目，进入 **设置 → 托管**（**Settings → Hosting**）。找到 **数据缓存**（**Data cache**）部分。在添加数据缓存之前，该部分显示 **添加数据缓存**（**Add a data cache**）。

![添加数据缓存之前，设置中托管页面的数据缓存部分，带有询问 Manus 按钮。](https://mintcdn.com/docs-manus/uRrLxOT2Ia6qhFvR/images/website-builder/data-cache-card-add.png?fit=max\&auto=format\&n=uRrLxOT2Ia6qhFvR\&q=85\&s=334cb36c96bbad66c8cdbce4fce00ceb)

**2. 询问 Manus**

选择 **询问 Manus**（**Ask Manus**）。Manus 会在聊天中起草一条提示词。发送该提示词。Manus 会检查您的项目，并告诉您哪些页面会变快、需要多少费用以及有哪些权衡。

**3. 批准数据缓存**

如果您同意，Manus 会开启数据缓存，并编写使用它的代码。

**4. 测试并发布**

在预览中测试您的应用，然后发布。详情请阅读[发布](https://manus.im/docs/zh-cn/website-builder/publishing.md)。

您也可以直接从聊天开始。描述较慢的页面，并让 Manus 使用"Manus 内置的数据缓存"。

### 管理您的数据缓存

添加数据缓存后，**数据缓存** 部分会显示其状态和已使用的存储空间。

![添加数据缓存之后的数据缓存部分，显示 Redis 状态、已使用的存储空间和清除缓存按钮。](https://mintcdn.com/docs-manus/uRrLxOT2Ia6qhFvR/images/website-builder/data-cache-card-active.png?fit=max\&auto=format\&n=uRrLxOT2Ia6qhFvR\&q=85\&s=6d01a190f35496ad979d64ab6f5c34a2)

* **清除所有缓存数据：** 选择 **清除缓存**（**Clear cache**）并确认。这会同时清除预览和已发布网站的数据。您需要拥有数据库写入权限。
* **关闭数据缓存：** 让 Manus 将其关闭。Manus 会先移除依赖它的代码，然后删除数据缓存及其数据。

## 注意事项

> [!WARNING]
>
> 缓存数据是临时的。它随时可能被删除，因此您的应用必须能够重新生成这些数据。请将重要记录保存在您的数据库中。

* **默认处于关闭状态。** 数据缓存按项目添加，并且只会加速应用中使用它的部分。
* **适用于带有服务器的 Web 应用。** 游戏或移动项目无法使用。如果您的 Web 项目还没有服务器，Manus 会为其添加一个。详情请阅读[云基础设施](https://manus.im/docs/zh-cn/website-builder/cloud-infrastructure.md)。
* **它不是页面缓存。** 它不会在浏览器中缓存您的 HTML 页面、图片或脚本。它加速的是服务器执行的工作。
* **预览和已发布网站共享同一个数据缓存。** 您在预览中测试时写入的数据，会在线上网站中可见。
* **发布不会清除数据缓存。** 请让 Manus 为缓存数据设置过期时间，使其自动刷新。
* **如果您的云余额耗尽，您的数据将被删除。** 充值后，您的应用将从一个空的数据缓存开始。
* **项目副本从空缓存开始。** 项目副本会获得自己的新数据缓存，并单独计费。详情请阅读[创建副本](https://manus.im/docs/zh-cn/website-builder/make-a-copy.md)。
* **费用从您的云余额中扣除，而不是 Agent 积分。** 费用会先使用您的免费云额度，然后使用您的付费云余额。详情请阅读[使用情况与定价](https://manus.im/docs/zh-cn/website-builder/getting-started/usage-and-pricing.md)。

| 项目 | 价格 |
| - | - |
| 月费 | 在 UTC 月末数据缓存处于开启状态的每个 UTC 月收取 \$0.75 |
| 命令 | 每 100,000 条命令 \$0.30 |
| 带宽 | 每 GB \$0.045 |
| 存储 | 每 GB-月 \$0.375 |

## 提示

* **告诉 Manus 您的流量情况。** 说明您预计有多少访问者，以及哪些页面感觉较慢。这样 Manus 就能判断数据缓存是否值得使用。
* **在提示词中指明该功能。** 写上"Manus 内置的数据缓存"。在较早的聊天会话中，Manus 否则可能会建议使用外部 Redis 提供商。
* **设置过期时间。** 实时数据适合设置为一分钟。来自电子表格的内容适合设置为几分钟。
* **不要过于频繁地轮询。** 每条命令都会计费。每秒检查一次每月大约花费 \$8.53，却没有实际好处。

## 常见问题

> [accordion] 如何知道我的应用是否需要数据缓存？
>
> 询问 Manus。在 **设置 → 托管 → 数据缓存** 中选择 **询问 Manus**，Manus 会检查您的项目。一般来说，当大量访问者加载相同的耗时数据时，数据缓存会有所帮助。

> [accordion] 数据缓存会让我的网站更快吗？
>
> 它会加速服务器处理的重复请求，例如外部 API 调用和繁重的查询。它不会改变静态文件或页面传送到浏览器的方式。

> [accordion] 费用是多少？
>
> 费用取决于您的应用发送的命令数量。以下估算基于标价，并非实测值：
>
> | 示例 | 每月命令数 | 每月预估费用 |
> | - | - | - |
> | 小型应用：20,000 次访问，每次 2 条命令 | 40,000 | 约 \$0.88 |
> | 繁忙应用：1,000,000 次请求，每次 3 条命令 | 3,000,000 | 约 \$10.06 |

> [accordion] 如何停止为它付费？
>
> 让 Manus 关闭数据缓存。如果您在 UTC 月末之前将其关闭，则无需支付当月的 \$0.75 月费。

> [accordion] 为什么发布后我的线上网站显示的是旧数据？
>
> 发布不会清除数据缓存。请让 Manus 为缓存数据设置过期时间，或选择 **清除缓存**。

> [accordion] 为什么清除数据缓存后我的用户被登出了？
>
> 您的应用可能将登录会话存储在数据缓存中。清除缓存会删除这些会话。默认的 Manus 登录不使用数据缓存，因此清除缓存不会影响它。

> [accordion] Manus 建议使用外部 Redis 提供商，我该怎么办？
>
> 在 **设置 → 托管 → 数据缓存** 中选择 **询问 Manus**，或在提示词中写上"Manus 内置的数据缓存"。

> [!TIP]
>
> **不确定缓存是否适合您的应用？** 前往 **设置 → 托管 → 数据缓存** 并选择 **询问 Manus**。Manus 会检查您的项目，并在您付费之前告诉您数据缓存是否有帮助。


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