> For the complete documentation index, see [llms.txt](https://miulien.gitbook.io/bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miulien.gitbook.io/bot/utilities/role.md).

# 身份組管理（role）

使用 `/role` 開啟互動式身份組管理面板，無須輸入子指令。

## 手動賦予與移除

1. 選擇「賦予身份組」或「移除身份組」。
2. 使用 Discord 原生成員選擇器，一次選擇 **1～25 位成員**。
3. 使用身份組選擇器，一次選擇 **1～5 個身份組**。
4. Miulien 依序執行，回報成功、無須變更與失敗人數。個別操作失敗不會中止整批。

已擁有的身份組不會重複賦予，未擁有的身份組不會重複移除。批次選擇資料僅於互動期間暫存。

## 新成員自動身份組

按「自動身份組」管理規則。每個伺服器最多設定 **5 個自動身份組**，可分別指定：

* **僅 Bot 帳號**
* **僅一般使用者**
* **Bot 與一般使用者**

使用「新增／編輯規則」只會更新選取的身份組，**不會覆蓋其他既有規則**。「刪除指定規則」可單獨刪除選取規則；「全部清除」須再次確認。舊版已有的自動身份組保留，預設為「僅一般使用者」。

新成員加入伺服器時，Miulien 會依照設定及帳號類型，自動賦予對應的身份組。若身份組已被刪除或無法賦予，則會略過該身份組。

> 自動身份組只在新成員**加入**時觸發，不掃描既有成員。手動移除後不會立刻補發，要等成員重新加入才會再次套用。

## 權限與限制

* 操作者與 Miulien 都需要 Discord「管理身份組」權限。
* 不得管理 `@everyone` 或整合服務管理的身份組。
* 目標身份組必須**低於 Miulien 的最高身份組**。
* 一般操作者只能管理低於自己最高身份組的身份組。
* **伺服器擁有者**不受自己的最高身份組限制，即使沒有額外身份組也能設定，但仍受 Miulien 的身份組階層限制。
* 自動身份組設定在 Miulien 重新啟動後仍會保留。

如需讓成員透過表情符號領取身份組，請見 [反應身份組（reactionrole）](/bot/utilities/reactionrole.md)。
