> 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/threads.md).

# 討論串管理（threads）

使用 `/threads` 或 `m!threads` 開啟 **Threads 討論串管理面板**，在同一個介面瀏覽、建立與管理目前文字頻道的討論串。

## 開啟與瀏覽面板

* 在伺服器**文字頻道**輸入 `/threads` 或 `m!threads`。也可以在討論串內使用，面板會對應其所屬的文字頻道。
* **活躍討論串／已封存**：切換目前頻道的討論串清單。
* **選擇討論串**：使用下拉選單指定操作對象。
* **上一頁／下一頁**：每頁最多顯示 **25 個討論串**。
* **重新整理**：重新取得面板資料，尤其適合在其他人更改討論串後使用。

面板只接受**開啟面板的使用者**操作，並會在 **10 分鐘**後停用。其他人可自行執行指令，開啟自己的面板。

## 建立討論串

點選「**建立公開**」或「**建立私人**」，在彈出視窗輸入討論串名稱。建立成功後會顯示新討論串。

* 公開討論串：使用者與 Miulien 都需要具有「建立公開討論串」權限。
* 私人討論串：使用者與 Miulien 都需要具有「建立私人討論串」權限，機器人會嘗試邀請建立者加入。
* 名稱最多 **100 個字元**。

已停用舊版 `m!thread` 指令。請統一使用 `/threads` 或 `m!threads`，透過管理面板建立討論串。

{% hint style="info" %}
由 Miulien 建立的討論串，在 Discord 系統中會顯示機器人為建立者。Miulien 會另外記錄實際發出建立指令的使用者，供自己的討論串管理權限判定使用。功能更新以前由機器人建立的討論串不會自動補記建立者。
{% endhint %}

## 更名、封存與重新開啟

選取討論串後：

* **更名**：開啟名稱輸入視窗。
* **封存**：將活躍討論串移到已封存清單。
* **重新開啟**：從已封存清單恢復討論串。
* **鎖定／解鎖**：管理討論串的鎖定狀態。

封存、重新開啟、鎖定與解鎖操作會出現確認視窗，避免誤操作。確認視窗約 **60 秒**後逾時。

## 權限判定

| 操作               | 使用者所需權限               |
| ---------------- | --------------------- |
| 建立公開討論串          | 建立公開討論串               |
| 建立私人討論串          | 建立私人討論串               |
| 更名、封存自己的活躍討論串    | 討論串建立者；討論串未鎖定         |
| 重新開啟未鎖定的公開討論串    | 可查看頻道，且具備討論串傳訊權限或為建立者 |
| 重新開啟未鎖定的私人討論串    | 此面板已確認的建立者            |
| 鎖定／解鎖，或管理其他人的討論串 | 管理討論串                 |

上述限制是 **Miulien 面板自身的權限檢查**；操作仍須通過 Discord API 驗證。Miulien 必須擁有足以執行對應操作的頻道權限，其中更名、封存、重新開啟與鎖定操作會檢查機器人的「管理討論串」權限。

### 私人討論串的可見性

為避免將機器人有權讀取、但操作者無權查看的私人討論串暴露在面板中，沒有「管理討論串」權限的使用者只會在面板中看到**能確認由自己建立的私人討論串**。這表示受邀加入別人建立的私人討論串，不一定會出現在此管理面板。

## 補充限制

* 此功能目前適用於一般**文字頻道**及其討論串，不支援直接在論壇頻道使用面板。
* 面板目前沒有刪除討論串、釘選論壇貼文或釘選討論串內訊息的操作。
* 已鎖定的討論串若需要重新開啟、解除鎖定或修改，須具備「管理討論串」權限。
* 如果 Discord 拒絕某項操作，請確認頻道覆寫權限、機器人權限，以及目標討論串的狀態。

相關說明：[指令權限設定（permissions）](/bot/utilities/permissions.md)。
