> 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/gong-xiang-yu-xie-zuo/permissions-table.md).

# 权限表

Shade 的权限系统在三个层级上运作：工作区、驱动器和文件/文件夹。权限会从更高层级向下继承，除非在更低层级被明确覆盖。

{% embed url="<https://youtu.be/6t_-b4qu908?si=z5v-0mlRE-ZAQqca>" %}

### 工作区级角色

| 角色      | 工作区管理        | 驱动器管理                    | 驱动器挂载 | 创建驱动器 | 计费访问权限 | ShadeFS 访问权限 | 元数据访问权限 |
| ------- | ------------ | ------------------------ | ----- | ----- | ------ | ------------ | ------- |
| **所有者** | 完全控制；可以转移所有权 | 对所有驱动器拥有完全控制权            | ✓     | ✓     | 完全访问   | ✓            | ✓       |
| **管理员** | 完全控制；管理成员和设置 | 对所有驱动器拥有完全控制权；自动成为驱动器管理员 | ✓     | ✓     | 完全访问   | ✓            | ✓       |
| **成员**  | 查看工作区        | 访问权限由驱动器继承关系决定           | ✓     | ✓     | 无访问权限  | ✓            | ✓       |
| 贡献者     | 查看工作区        | 访问权限由驱动器继承关系决定           | ✓     | ✗     | 无访问权限  | ✓            | ✓       |
| 承包商     | 查看工作区        | 仅可访问特定驱动器/文件/文件夹         | ✓     | ✗     | 无访问权限  | ✓            | ✓       |
| **访客**  | 无工作区访问权限     | 仅可访问特定驱动器/文件/文件夹         | ✗     | ✗     | 无访问权限  | ✗            | ✗       |

### 驱动器级角色

| 角色       | 查看文件 | 下载 | 上传 | 编辑 | 删除 | 评论 | 重命名/移动 | 驱动器设置 | 权限管理 |
| -------- | ---- | -- | -- | -- | -- | -- | ------ | ----- | ---- |
| **管理员**  | ✓    | ✓  | ✓  | ✓  | ✓  | ✓  | ✓      | ✓     | ✓    |
| **完全访问** | ✓    | ✓  | ✓  | ✓  | ✓  | ✓  | ✓      | ✗     | ✗    |
| **编辑**   | ✓    | ✓  | ✓  | ✓  | ✓  | ✓  | ✓      | ✗     | ✗    |
| **评论**   | ✓    | ✓  | ✗  | ✗  | ✗  | ✓  | ✗      | ✗     | ✗    |
| **下载**   | ✓    | ✓  | ✗  | ✗  | ✗  | ✗  | ✗      | ✗     | ✗    |
| **查看**   | ✓    | ✗  | ✗  | ✗  | ✗  | ✗  | ✗      | ✗     | ✗    |
| **无**    | ✗    | ✗  | ✗  | ✗  | ✗  | ✗  | ✗      | ✗     | ✗    |

### 关键概念

#### 工作区成员与访客

**工作区成员** 是作为管理员或成员被明确添加到工作区的用户。他们可以：

* 通过 ShadeFS 挂载驱动器
* 访问元数据和 AI 功能
* 根据驱动器继承设置自动获得访问权限
* 创建新的驱动器
* 在计费中算作一个席位

**访客** 是仅可访问特定文件、文件夹或驱动器，但不具备工作区级权限的用户。他们可以：

* 根据其权限级别进行查看、编辑、评论或删除
* 仅可通过 Web/桌面应用界面访问资源
* 如果他们有权访问其中任何文件，则会在侧边栏中看到这些驱动器
* 不计入计费席位限制
* 无法挂载驱动器

#### 驱动器继承

每个驱动器都有一个 **默认继承** 用于确定所有工作区成员基础权限级别的设置。当某个工作区成员的权限不同于默认值时，他们会显示在驱动器的成员表中。

#### 自动角色分配

* 工作区管理员会自动成为所有驱动器的驱动器管理员
* 无法将工作区管理员显式邀请到具有不同权限级别的驱动器中
* 所有者在离开工作区前必须先将所有权转移给管理员

#### 渐进式访问

用户可以通过权限级别逐步提升：

1. 拥有文件/文件夹访问权限的访客
2. 拥有驱动器访问权限的访客
3. 工作区成员

### 常见场景

**外部协作者**: 作为驱动器、文件夹或文件级别的访客邀请，以获得特定项目访问权限

**长期承包商**: 作为工作区承包商邀请，以便仅对特定项目和文件夹拥有挂载访问权限

**客户审核**: 共享特定文件或文件夹，使其成为具有查看或评论权限的访客

**团队成员**: 作为工作区成员添加，其驱动器访问权限由继承决定


---

# 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/gong-xiang-yu-xie-zuo/permissions-table.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.