> 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/quan-xian-biao.md).

# 权限表

Shade 的权限系统在三个层级上运作：工作区、驱动器，以及文件/文件夹。权限会从较高层级向下传递，除非在较低层级明确覆盖。

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

### 工作区级角色

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

### 驱动器级角色

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

### 关键概念

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

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

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

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

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

#### 云盘继承

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

#### 自动角色分配

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

#### 逐级访问

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

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 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/gong-xiang-yu-xie-zuo/quan-xian-biao.md?ask=<question>&goal=<endgoal>
```

`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.