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

# 核心权限矩阵

> 快速查看 Admin、Manager、Member、Viewer 在页面可见性和操作权限上的差异

先看页面是否可见，再看能不能操作。很多“我能看到但不能点”的情况，都不是 bug，而是权限本来就是只读。

## 图例

| 图标                                                  | 含义  |
| --------------------------------------------------- | --- |
| <Tooltip tip="可查看，并可执行创建、编辑、删除、分配或发起操作">✅</Tooltip> | 可管理 |
| <Tooltip tip="可以看到页面或数据，但默认只能查看，不能修改">👀</Tooltip>  | 仅查看 |
| <Tooltip tip="默认不可见，或没有可用权限">⬜</Tooltip>            | 不可用 |

<Tip>
  先看“页面可见性”，再看“操作权限”。页面能进去，不代表按钮就能用。
</Tip>

## 页面可见性

| 页面 / 入口             | Admin                                          | Manager                                              | Member                                               | Viewer                                                | 说明                    |
| ------------------- | ---------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------- | --------------------- |
| 工作区设置（Settings）     | <Tooltip tip="可查看并修改工作区设置">✅</Tooltip>         | <Tooltip tip="可查看部分工作区信息，但不能保存配置">👀</Tooltip>       | <Tooltip tip="可查看部分工作区信息，但不能保存配置">👀</Tooltip>       | <Tooltip tip="默认不可访问工作区设置">⬜</Tooltip>                | Member 可以查看部分信息，但不能修改 |
| 工作区分析（Analytics）    | <Tooltip tip="可完整访问工作区级分析页面">✅</Tooltip>       | <Tooltip tip="默认不可访问工作区级分析页面">⬜</Tooltip>            | <Tooltip tip="默认不可访问工作区级分析页面">⬜</Tooltip>            | <Tooltip tip="默认不可访问工作区级分析页面">⬜</Tooltip>             | 这是工作区管理视角页面           |
| 概览（Overview）        | <Tooltip tip="可查看并管理全部矿场">✅</Tooltip>          | <Tooltip tip="可查看被分配的矿场，或被授予全部矿场范围">👀</Tooltip>     | <Tooltip tip="可查看被分配的矿场，或被授予全部矿场范围">👀</Tooltip>     | <Tooltip tip="可查看被分配的矿场，或被授予全部矿场范围">👀</Tooltip>      | 非 Admin 的可见范围受矿场分配限制  |
| 矿场列表（Farms List）    | <Tooltip tip="可查看并管理全部矿场">✅</Tooltip>          | <Tooltip tip="可查看被分配的矿场，或被授予全部矿场范围">👀</Tooltip>     | <Tooltip tip="可查看被分配的矿场，或被授予全部矿场范围">👀</Tooltip>     | <Tooltip tip="可查看被分配的矿场，或被授予全部矿场范围">👀</Tooltip>      | 非 Admin 的可见范围受矿场分配限制  |
| 矿场详情和运维页面           | <Tooltip tip="可查看矿场数据、任务、诊断、能源和机架">✅</Tooltip> | <Tooltip tip="可查看分配范围内的矿场数据、任务、诊断、能源和机架">✅</Tooltip> | <Tooltip tip="可查看分配范围内的矿场数据、任务、诊断、能源和机架">✅</Tooltip> | <Tooltip tip="可查看分配范围内的矿场数据、任务、诊断、能源和机架">👀</Tooltip> | 非 Admin 的可见范围受矿场分配限制  |
| 矿场设置（Farm Settings） | <Tooltip tip="可查看并修改矿场配置">✅</Tooltip>          | <Tooltip tip="可在被分配矿场范围内修改矿场配置">✅</Tooltip>          | <Tooltip tip="通常只能查看矿场配置，不能保存修改">👀</Tooltip>        | <Tooltip tip="通常只能查看矿场配置，不能保存修改">👀</Tooltip>         | Manager 的编辑能力受矿场范围限制  |
| 矿机页面（Miners）        | <Tooltip tip="可查看并管理全部矿机">✅</Tooltip>          | <Tooltip tip="可查看并管理分配范围内的矿机，含高风险操作">✅</Tooltip>     | <Tooltip tip="可查看并操作自己范围内的矿机">✅</Tooltip>            | <Tooltip tip="只能查看矿机状态和数据">👀</Tooltip>               | 非 Admin 的可操作范围受矿场分配限制 |

## 操作权限

| 操作                    | Admin                                        | Manager                                        | Member                                         | Viewer                                         | 说明                     |
| --------------------- | -------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- | ---------------------- |
| 查看成员信息                | <Tooltip tip="可查看并管理全部成员信息">✅</Tooltip>      | <Tooltip tip="可只读查看成员信息">👀</Tooltip>          | <Tooltip tip="可只读查看成员信息">👀</Tooltip>          | <Tooltip tip="默认不可查看成员信息">⬜</Tooltip>          | Member 只能查看，不能执行成员管理动作 |
| 查看邀请列表                | <Tooltip tip="可查看并管理邀请记录">✅</Tooltip>        | <Tooltip tip="不可查看邀请列表">⬜</Tooltip>            | <Tooltip tip="不可查看邀请列表">⬜</Tooltip>            | <Tooltip tip="不可查看邀请列表">⬜</Tooltip>            | 邀请管理仅对 Admin 开放        |
| 邀请成员 / 撤销邀请           | <Tooltip tip="可邀请成员并撤销邀请">✅</Tooltip>        | <Tooltip tip="不可邀请成员或撤销邀请">⬜</Tooltip>         | <Tooltip tip="不可邀请成员或撤销邀请">⬜</Tooltip>         | <Tooltip tip="不可邀请成员或撤销邀请">⬜</Tooltip>         | 属于团队治理权限               |
| 修改角色 / 移除成员           | <Tooltip tip="可调整角色并移除成员">✅</Tooltip>        | <Tooltip tip="不可修改角色或移除成员">⬜</Tooltip>         | <Tooltip tip="不可修改角色或移除成员">⬜</Tooltip>         | <Tooltip tip="不可修改角色或移除成员">⬜</Tooltip>         | 只有 Admin 可以调整访问边界      |
| 管理成员的矿场范围             | <Tooltip tip="可分配和调整成员的矿场范围">✅</Tooltip>     | <Tooltip tip="不可分配矿场范围">⬜</Tooltip>            | <Tooltip tip="不可分配矿场范围">⬜</Tooltip>            | <Tooltip tip="不可分配矿场范围">⬜</Tooltip>            | 只有 Admin 可以控制资源覆盖范围    |
| 查看工作区设置               | <Tooltip tip="可查看并管理工作区设置">✅</Tooltip>       | <Tooltip tip="可只读查看部分工作区设置">👀</Tooltip>       | <Tooltip tip="可只读查看部分工作区设置">👀</Tooltip>       | <Tooltip tip="默认不可查看工作区设置">⬜</Tooltip>         | Member 可见不代表可编辑        |
| 查看通知和告警配置             | <Tooltip tip="可查看并管理通知和告警配置">✅</Tooltip>     | <Tooltip tip="可查看通知和告警配置">👀</Tooltip>         | <Tooltip tip="可查看通知和告警配置">👀</Tooltip>         | <Tooltip tip="默认不可查看通知和告警配置">⬜</Tooltip>       | 非 Admin 只能查看，不能保存修改    |
| 管理通知和告警配置             | <Tooltip tip="可创建和修改通知、告警配置">✅</Tooltip>     | <Tooltip tip="不可保存通知或告警修改">⬜</Tooltip>         | <Tooltip tip="不可保存通知或告警修改">⬜</Tooltip>         | <Tooltip tip="不可保存通知或告警修改">⬜</Tooltip>         | 通知管理属于 Admin 权限        |
| 创建 / 撤销 API Key       | <Tooltip tip="可创建、撤销或轮换 API Key">✅</Tooltip> | <Tooltip tip="不可创建或撤销 API Key">⬜</Tooltip>     | <Tooltip tip="不可创建或撤销 API Key">⬜</Tooltip>     | <Tooltip tip="不可创建或撤销 API Key">⬜</Tooltip>     | API Key 由 Admin 管理     |
| 查看矿场列表和详情             | <Tooltip tip="可查看并管理全部矿场">✅</Tooltip>        | <Tooltip tip="可查看被分配范围内的矿场">👀</Tooltip>       | <Tooltip tip="可查看被分配范围内的矿场">👀</Tooltip>       | <Tooltip tip="可查看被分配范围内的矿场">👀</Tooltip>       | 非 Admin 仅能查看授权矿场       |
| 创建 / 删除 / 归档 / 取消归档矿场 | <Tooltip tip="可管理矿场生命周期">✅</Tooltip>         | <Tooltip tip="不可创建、删除、归档或取消归档矿场">⬜</Tooltip>   | <Tooltip tip="不可创建、删除、归档或取消归档矿场">⬜</Tooltip>   | <Tooltip tip="不可创建、删除、归档或取消归档矿场">⬜</Tooltip>   | 矿场生命周期管理属于 Admin 权限    |
| 修改矿场配置                | <Tooltip tip="可管理矿场配置">✅</Tooltip>           | <Tooltip tip="可在被分配矿场范围内管理矿场配置">✅</Tooltip>    | <Tooltip tip="不可保存矿场配置修改">⬜</Tooltip>          | <Tooltip tip="不可保存矿场配置修改">⬜</Tooltip>          | 矿场配置和矿场生命周期是不同权限边界     |
| 查看矿机列表、详情、历史、日志和机架    | <Tooltip tip="可查看并管理全部矿机数据和历史">✅</Tooltip>   | <Tooltip tip="可查看分配范围内的矿机数据和历史">👀</Tooltip>   | <Tooltip tip="可查看分配范围内的矿机数据和历史">👀</Tooltip>   | <Tooltip tip="可查看分配范围内的矿机数据和历史">👀</Tooltip>   | 范围由矿场分配决定              |
| 导出矿机列表                | <Tooltip tip="可导出矿机列表">✅</Tooltip>           | <Tooltip tip="可导出分配范围内的矿机列表">✅</Tooltip>       | <Tooltip tip="可导出分配范围内的矿机列表">✅</Tooltip>       | <Tooltip tip="可导出分配范围内的矿机列表">✅</Tooltip>       | 导出跟随矿机可见范围             |
| 导入矿机                  | <Tooltip tip="可导入矿机">✅</Tooltip>             | <Tooltip tip="可在分配范围内导入矿机">✅</Tooltip>         | <Tooltip tip="可在分配范围内导入矿机">✅</Tooltip>         | <Tooltip tip="不可导入矿机">⬜</Tooltip>              | 导入属于操作人员能力             |
| 执行常规矿机操作和发起任务         | <Tooltip tip="可执行常规矿机操作并发起任务">✅</Tooltip>    | <Tooltip tip="可在分配范围内执行常规矿机操作和任务">✅</Tooltip>  | <Tooltip tip="可在分配范围内执行常规矿机操作和任务">✅</Tooltip>  | <Tooltip tip="不能执行矿机操作或发起任务">⬜</Tooltip>       | Member 的执行边界受矿场范围约束    |
| 矿场管理类矿机操作             | <Tooltip tip="可执行矿场管理类矿机操作">✅</Tooltip>      | <Tooltip tip="可在分配范围内执行矿场管理类矿机操作">✅</Tooltip>  | <Tooltip tip="不可执行矿场管理类矿机操作">⬜</Tooltip>       | <Tooltip tip="不可执行矿场管理类矿机操作">⬜</Tooltip>       | 这些操作跟随矿场配置管理权限         |
| 高风险矿机操作（删除、归档）        | <Tooltip tip="可执行全部高风险矿机操作">✅</Tooltip>      | <Tooltip tip="可在分配范围内执行高风险矿机操作">✅</Tooltip>    | <Tooltip tip="不可执行高风险矿机操作">⬜</Tooltip>         | <Tooltip tip="不可执行高风险矿机操作">⬜</Tooltip>         | Manager 与 Member 的核心差异 |
| 跨矿场无差别访问              | <Tooltip tip="默认可访问全部矿场和矿机">✅</Tooltip>      | <Tooltip tip="不能默认访问全部矿场，需要显式授权范围">⬜</Tooltip> | <Tooltip tip="不能默认访问全部矿场，需要显式授权范围">⬜</Tooltip> | <Tooltip tip="不能默认访问全部矿场，需要显式授权范围">⬜</Tooltip> | 非 Admin 默认遵循最小授权原则     |

## 如何使用这张表

* 如果你要管理成员、邀请或 API Key，选择 **Admin**
* 如果你要管理被分配矿场的配置、固件或矿池操作，并执行高风险矿机操作，选择 **Manager**
* 如果你要执行常规矿机操作和任务，但不负责矿场配置或团队治理，选择 **Member**
* 如果你只需要查看状态、报表和结果，选择 **Viewer**

<Info>
  如果某个用户“应该能操作但现在只能看”，通常不是角色写错，而是角色不对，或矿场范围还没分对。
</Info>