> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/shadefs/managing-the-shadefs-cache.md).
# 管理 ShadeFS 缓存
## **概述**
ShadeFS 使用本地缓存系统，让您能够流畅、高效地访问存储在云端的媒体文件。了解如何配置和管理此缓存，以优化工作流程性能并管理本地存储空间。
## **缓存基础**
默认情况下，ShadeFS 会在 `.shade` 文件夹中分配 26GB 的缓存空间，该文件夹位于您计算机的用户根目录内。此缓存用作流式媒体片段的临时存储位置，使您的文件资源管理器和非线性编辑软件能够即时访问媒体文件。
## **位置管理**
您可以将 ShadeFS 的缓存存储位置更改为计算机上的某个文件夹或外部设备：
1. 打开 **设置 > ShadeFS > 缓存管理** 在 Shade 桌面应用中（桌面应用版本 2.3.21 及更早版本，请打开 **设置 > ShadeFS > 配置** 作为替代）
2. 在 **缓存设置**下，点击 **ShadeFS 缓存目录** 字段
3. 选择您偏好的缓存目录
更改缓存位置后，ShadeFS 会在后台重新启动。
为获得最佳性能，我们建议使用高速外置 SSD（如 Samsung T7）作为缓存位置。这种配置能提供更高性能，也能让系统驱动器腾出空间用于其他操作。
由于 ShadeFS 为缓存文件使用稀疏文件，您的缓存驱动器必须格式化为 APFS（macOS）、NTFS 或 ReFS（Windows），或者 ext4、XFS 或 Btrfs（Linux）。格式化为 exFAT 或 Mac OS Extended（HFS+）的驱动器不能用于缓存。
更改缓存目录会移动您的缓存文件数据。ShadeFS 会将其驱动器数据库以及有关缓存内容的小型索引保留在您主目录中的 `.shade` 文件夹内，因此也请在系统驱动器上留出少量可用空间。
## **缓存大小**
缓存大小可通过 **缓存大小 (GB)** 中的设置进行更改，或通过 **设置 > ShadeFS > 缓存管理**或通过 **编辑缓存大小** 在“挂载驱动器”面板中进行更改。最小缓存大小为 1 GB。默认的 26GB 缓存足以满足基本操作需求，但您可以将其增加至计算机或所设缓存目录中的可用空间上限。调整这些设置时，请考虑您常规工作流程中的项目大小和可用存储空间。所有驱动器共用同一个缓存大小。如果同时挂载多个驱动器，它们将共用相同的缓存空间。
## **ShadeFS 如何自动释放空间**
ShadeFS 每 5 分钟检查一次缓存用量。如果超出您设定的缓存大小，它会移除最久未使用的文件，直至缓存恢复至上限的 90%。
* **移除的始终是完整文件，绝不会只移除文件的一部分。** 请将缓存大小设置得大于您处理的最大文件，否则该文件会不断被移除并重新下载。
* **缓存可能会暂时超出您的上限。** 由于清理每隔几分钟才会运行一次，高强度使用可能会使缓存超过设定大小，直到下一次清理。
* **某些文件永远不会被自动移除：** 已固定的文件、您在过去一分钟内打开过或仍在读取的文件、正在上传的文件，以及尚未同步更改的文件。
* **无论大小如何，旧副本都会被清理。** 不再属于任何驱动器的文件缓存副本，例如已删除的文件或已被替换文件的早期版本，将在下一次清理时移除。
## **缓存和磁盘空间提醒**
空间变得紧张时，桌面应用会通知您。点击通知以打开 **缓存管理**.
* **Shade 缓存即将满 / Shade 缓存已满**：您的缓存接近或已达到设定的缓存大小。Shade 会自动清除较旧的文件，但正在上传或打开的文件在完成前无法清除。如果这种情况持续发生，请增加缓存大小。
* **磁盘空间不足 / 磁盘即将满**：存放缓存的磁盘空间即将耗尽。磁盘接近满时，尚未缓存的文件可能无法打开，并且对已挂载驱动器的写入会暂停，直至释放出空间。
## **释放缓存空间**
该 **缓存管理** 页面会显示缓存使用量，并允许您进行清理：
* **使用情况** 显示已使用的缓存大小，以及已固定文件占用的磁盘空间。
* **可安全清除** 列出可移除的缓存文件。点击文件旁的 **移除** 以仅清除该文件，或点击 **全部清除** （然后点击 **确认全部清除**）以清除全部文件。
* **已固定** 列出您已固定的文件。点击 **取消固定** 文件旁的，或点击 **取消固定全部**。取消固定文件也会移除其缓存副本。
* **正在使用** 列出正在上传或有未同步更改的文件。这些文件无法清除。
* **未关联** 列出由不再位于此计算机上的驱动器遗留的文件。点击 **清除** 以将其移除。
* **危险区域 > 完全重置**: **清除所有缓存并重置** 会停止 ShadeFS 并删除缓存中的所有内容，包括固定项和未同步的更改。仅应将此操作作为最后手段。
## **离线访问**
在需要确保无需互联网连接也能访问特定文件的情况下，您可以将文件固定为离线可用。固定文件或文件夹时，ShadeFS 会下载完整副本并将其保留在缓存目录中，使其可离线使用。固定的文件不计入缓存大小上限，这意味着固定操作不会考虑您计算机的可用存储空间。如果您尝试固定的数据量超过可用存储空间，计算机将耗尽空间并出现问题。要固定内容：
1. 在 Shade 应用中导航至所需的文件或文件夹
2. 右键单击该项目
3. 选择“固定到缓存”
更多信息请参阅： [将文件固定为离线](/shade-academy/shade-academy-zh/shadefs/pinning-files-offline.md)
## **性能注意事项**
您的缓存配置会直接影响系统性能。为获得最佳体验：
* 为缓存位置使用高速存储设备；有关推荐硬件，请参阅 [为 Shade 缓存选择外置 SSD](https://academy.shade.inc/shadefs/choosing-an-external-ssd-for-shade-cache)
* 为您的典型工作集分配足够的缓存大小
* 监控缓存驱动器上的可用空间
* 考虑固定常用文件以确保稳定访问
请记住，虽然更大的缓存大小可以改善频繁访问文件时的性能，但也需要占用本地系统更多的存储空间。
---
# 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://academy.shade.inc/shade-academy/shade-academy-zh/shadefs/managing-the-shadefs-cache.md?ask=&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.
