> 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/introduction-to-shadefs.md). # ShadeFS 简介 ## **概览** ShadeFS 是一种云盘挂载解决方案，彻底改变你与云端存储媒体文件的交互方式。不同于传统云存储解决方案需要先完整下载文件才能访问（咳咳，Dropbox），ShadeFS 会实时流式传输你所需的片段，类似于 YouTube 提供视频内容的方式。这种方法让你可以立即访问媒体内容，同时优化带宽使用。 ## **主要功能** * ShadeFS 会将你的云盘变成一个本地文件夹，默认可通过“/Volumes”文件夹访问 * 当你挂载一个驱动器时，它会像物理硬盘一样出现在你的本地文件系统中，但额外具备智能流式传输和缓存的优势 * 系统会自动在所有用户之间同步文件树，确保团队中的每个人都能使用相同的内容结构，而不受所在地影响。 * 上传的文件会自动通过我们的代理生成和 AI 分析流水线 ## **系统要求** ShadeFS 需要满足一些条件，才能在你的机器上达到最佳工作状态。 * 对于处理 4K 视频内容，我们建议最低下载网速为 500Mbps * 带宽较低的用户应考虑使用代理文件或低于 4K 分辨率的内容进行工作 * 你的设备还应为缓存预留足够的存储空间，基础操作至少需要 10GB ## **入门** 当你下载并打开桌面应用后，可以在左侧面板中导航到任意驱动器，点击“...”菜单，并选择“挂载驱动器”来挂载它。无论你使用的是 Windows、macOS 还是 Linux，该驱动器都会出现在你的本地文件管理器中。 {% embed url="" %} ## **缓存配置** ShadeFS 使用缓存系统来优化媒体文件的性能。默认情况下，系统会在你的 **.shade** 用户根目录中的文件夹里创建 26GB 的缓存。不过，你可以自定义缓存位置和大小，以更好地满足你的需求。 [管理 ShadeFS 缓存](https://academy.shade.inc/shadefs/managing-the-shadefs-cache) ## **缓存目录** 要修改缓存目录，请在应用中前往“设置/偏好设置”。你可以在这里选择电脑上的任意文件夹或外接硬盘作为缓存位置。我们特别推荐使用高速外接 SSD，例如三星 T7，以获得最佳性能。 ## **ShadeFS 使用指南** ## **权限** ShadeFS 的访问和挂载功能仅限于工作区承包商、成员和管理员。当多个用户挂载同一个驱动器时，他们都会看到相同的文件树，这有助于远程团队之间实现无缝协作。 ## **上传** 对于超过 1000 个资产或 100GB 的大规模上传，我们建议使用网页版应用或桌面应用，而不是通过已挂载的驱动器上传。我们已针对大文件优化了通过应用界面的上传。无论你选择哪种上传方式，内容都会自动在网页版应用和桌面应用中可见，并触发我们的自动代理生成和 AI 处理系统。 文件可以通过先挂载多个驱动器，然后在电脑文件管理器中在这些驱动器之间移动文件来进行跨驱动器移动 ## **离线访问** ShadeFS 通过 **固定**提供离线访问功能。要在网络连接较弱（或完全没有网络）的情况下访问特定文件或文件夹，只需在应用中右键单击这些文件/文件夹，并选择“固定到缓存”。此操作会将所选内容的完整副本下载到本地缓存中，使其即使在离线状态下也能完全访问。你可以通过 **已固定项目** 页面查看你已固定的文件。 更多信息见 [离线固定文件](https://academy.shade.inc/shadefs/pinning-files-offline). ## **性能优化** 有几种方法可以最大化 ShadeFS 的性能。 * 使用外接 SSD 作为缓存存储，可显著提升访问速度和整体系统响应能力 * 我们建议根据你的典型工作集来配置缓存大小，以确保经常访问的文件始终可用 * 虽然 ShadeFS 的设计旨在高效利用可用带宽，但在使用挂载功能时请尽量保持稳定的互联网连接 * 对于在有限带宽下处理高分辨率内容的用户，我们建议创建代理文件 ## **与 Shade 生态系统集成** 不同于其他文件流式传输工具，ShadeFS 与网页版应用和桌面应用深度集成。当你通过已挂载的驱动器上传文件时，它们会自动编入 Shade 系统索引，并会立即在网页和桌面应用中可见。 --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://academy.shade.inc/shade-academy/shade-academy-zh/shadefs/introduction-to-shadefs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.