<aside> ⚠️

小幫手會用 Twitch API 檢查成員是否訂閱指定頻道，以及目前是哪個 Tier，確認後自動同步 Discord 身分組。請先確認 Twitch 功能已開啟。

</aside>

設定流程

1. 先設定驗證紀錄頻道：

   /utility set-verification-log-channel log-channel:#驗證紀錄

   這個頻道會同時收到 YouTube 會員和 Twitch 訂閱驗證的紀錄。

2. 新增 Twitch 訂閱驗證頻道與共用身分組：

   /twitch-subscription-set add-subscription-check channel-url:<Twitch 頻道> role:<共用訂閱者身分組>

3. 設定完成後，成員可使用 /twitch-subscription check 驗證訂閱資格。

<aside> 💡

Twitch 頻道可以填完整網址或頻道名稱。同一個伺服器裡，每個頻道只能設定一次；再次新增同一個頻道時，會改成新的設定。

</aside>

身分組規則

• role 是驗證成功後給予的共用訂閱者身分組。
• 系統會另外建立並管理 Tier 1、Tier 2、Tier 3 身分組。
• Tier 身分組是依 Discord 身分組 ID 辨識，不看名稱。設定完成後可以自行改名，不會影響驗證或定期複驗。
• 請勿刪除後再建立同名身分組；新身分組的 ID 不同，既有設定不會自動改用新身分組。
• 再次執行 /twitch-subscription-set add-subscription-check 更新或修復同一個 Twitch 頻道時，系統會將 Tier 身分組名稱恢復為「共用身分組名稱 + Tier 1／2／3」。
• 小幫手只會保留目前訂閱等級的 Tier 身分組。
• Bot 必須有管理身分組的權限，而且 Bot 的最高身分組要放在共用身分組上方。
• 不可使用 @everyone 或 Discord managed 身分組。
• 共用身分組不會因移除驗證設定而刪除，避免影響其他功能；系統建立的 Tier 身分組會一併清理。

管理指令

• /twitch-subscription-set add-subscription-check：新增或更新 Twitch 訂閱驗證頻道。
• /twitch-subscription-set remove-subscription-check：移除 Twitch 訂閱驗證設定，並清理相關驗證紀錄與系統建立的 Tier 身分組。