Discord 上的盟友流程
盟友（Ally） 流程是合作公會成員在 Discord 上申請成為盟友的正統方式。它是 入會申請流程 的結構孿生 — 申請者點擊一次即開啟私密的審核工單，審核員執行一段精簡精靈確認申請者要以哪個角色申請，完成後封存對話記錄到論壇中。
這頁從每個角色的視角說明整個流程 — 設定它的擁有者、點擊按鈕的盟友申請者、執行斜線指令的審核員。結構與入會申請高度相似；與入會申請的差異一節在接近末尾處列出盟友專屬的部分。
前置條件
- 機器人已配對到你的 AO Master 公會 — 請看 安裝 + 配對。
- 你的公會達到 Pro 階級或以上（聯盟流程依階級解鎖）。
- 設定此功能的人是 Discord 伺服器擁有者，或在 AO Master 中持有 Manage Integrations 權限。
- 至少有一個 Discord 身分組將作為「審核員」— 持有該身分組的任何人都可以處理工單。若你還沒有，請先在 Discord 中建立一個。
1. 擁有者 — 設定盟友中樞
盟友中樞從與入會申請相同的 #⚙️-guild-settings 頻道啟動。釘選的 Guild Settings 訊息第一列現在有四個按鈕：[🔍 View Config] [🎯 Manage Enlist] [💰 Manage Regear] [🤝 Enable Ally]。
點擊綠色的 🤝 Enable Ally 按鈕。彈出一個短暫可見的面板，顯示「Not set up」狀態和唯一一個可用按鈕 — ⚙ Setup。
設定精靈（2 步驟）
精靈的結構與入會申請設定完全相同（與 入會申請流程 上記錄的 2 步驟模式相同）：
- 選擇審核員 Discord 身分組 — 含即時成員計數的多選下拉選單。精靈拒絕
@everyone和受管理的機器人身分組。持有其中一個選中身分組的任何人都能看到盟友工單，並被允許執行/ally review//ally reject//ally done。 - 確認 — 簡短的確認卡列出將建立的內容：
#🤝-ally-here頻道 +🤝 Ally分類，以及釘選的[Apply as Ally]按鈕。點擊 ✅ Confirm。
約 5 秒後，面板重新渲染為完整的 Manage Ally 儀表板。
Manage Ally 儀表板
設定後的面板鏡像 Manage Enlist 儀表板，底部加上盟友專屬的額外內容。按鈕包括：
- ⚙ Reconfigure — 重新執行審核員身分組選擇器。
- ? Edit Questions — 修改盟友申請者被詢問的申請問題。（共用編輯器；相同問題也顯示在 web 的
/ally/<code>頁面上。） - 📝 Edit Template / ✏️ Edit Ally Message / ✏️ Edit Ticket Message / ✏️ Edit Ally Button — 自訂釘選訊息內容、每個工單內的歡迎訊息、按鈕標籤。
- 📋 Map Ally Channel / 📂 Map Ticket Category — 將釘選按鈕或新工單指向現有的 Discord 頻道 / 分類，而非自動建立的那些。
- 🚫 Pause Ally — 停止接受新申請者，但讓進行中的工單繼續。
- 🔄 Refresh Pinned — 重新渲染
#🤝-ally-here中釘選的[Apply as Ally]訊息。 - 🎮 Auto-Name: OFF / ON — 切換核准時的 Discord 暱稱重新命名（預設為開啟）。
- 🔧 Rebuild — 自動拒絕每個待處理的盟友申請者 + 清除
#🤝-ally-here頻道和🤝 Ally分類 + 重新建立。審核員身分組 + 訊息自訂保留。 - 🗑 Disable Ally — 清除整個盟友 Discord 側設定。Discord 頻道保留但變為不受管理。可透過重新執行設定來復原。
每個設定也可在網頁上的 #Discord Integration → Integrations → Ally 編輯（請看 Discord 整合）。變更雙向即時同步。
2. 盟友申請者 — 點擊 [Apply as Ally]
對公會外的每個人來說，他們在 🤝 Ally 分類內唯一能看到的頻道是 #🤝-ally-here。釘選訊息上有 [Apply as Ally] 按鈕（或你的自訂標籤）。
申請者點擊按鈕時：
- 機器人依工單頻道名稱範本（預設
🤝-ally-<discord-username>）建立一個私密頻道。只有申請者 + 審核員身分組能看到。 - 機器人在工單頂部發布歡迎訊息 — 主公會自訂的簡介 + 主公會設定的任何申請問題。
- 機器人回覆一則短暫可見的提示，引導申請者在工單中回答問題。
申請者以一般 Discord 訊息輸入答案。審核員在工單中看到這些訊息；答案不儲存在 AO Master 資料庫（它們只存在於 Discord 對話記錄中）。
3. 審核員 — /ally review、/ally reject、/ally done
三個斜線指令涵蓋整個審核員側。全部三個都以 Manage Ally 面板中設定的審核員身分組為存取門檻。
/ally review
在盟友工單頻道內執行。開啟精靈：
- 從聯盟中選擇角色 — 列出來自你的聯盟合作公會的角色下拉選單。申請者聲明他們以哪個角色申請；選擇器的範圍限定在聯盟合作公會，避免審核員不小心核准來自非合作公會的人。
- 確認 — 摘要卡顯示選中的角色 + 其主要合作公會（即時從 Albion 的資料取得）。點擊 ✅ Confirm。
確認後：
- 盟友列新增到 AO Master 網頁側的
#Allies（狀態：Linked）。 - 機器人為申請者的 Discord 帳號新增 AO Ally 身分組（第一次啟用盟友功能時自動建立；顏色對應你設定的 Ally Role chip）。
- 如果針對選中主公會存在合作夥伴身分組對應，機器人也會授予該身分組（例如，來自「Cozy Chilipi」的申請者同時獲得 AO Ally + 一個 Cozy Chilipi 身分組）。
- 如果 Auto-Name 為開啟，機器人將申請者的 Discord 暱稱重新命名以對應選中的 Albion 角色。
/ally reject
在審核員可以發文的任何地方執行（通常在工單內）。用法：
/ally reject user:@<申請者> reason:<選填原因>- 申請者的待處理入會申請翻轉為 Rejected。
- 機器人傳送私訊給申請者，附上原因（或你略過時的預設原因）。
- 工單立即關閉；對話記錄不會封存（拒絕關閉的工單依設計略過封存論壇 — 被拒絕的工單是雜訊）。
/ally done
在 /ally review 核准申請者之後，在工單內執行。發生兩件事：
- 完整的工單對話被鏡像 — 含原作者名稱 + 頭像 + 每個附加檔案 — 到
🗄-ally-archive論壇頻道的私密論壇討論串中。論壇 + 機器人用來發文的 webhook 會在第一次執行/ally done時自動建立（從未封存過的公會不需要留著空論壇）。 - 工單頻道被刪除。
封存討論串的標題與工單頻道名稱相符，讓審核員之後可以按使用者名稱搜尋論壇。
4. 與入會申請的差異
兩條流程共用同一個結構骨架，但盟友有幾個入會申請沒有的差異：
| 面向 | 入會申請 | 盟友 |
|---|---|---|
| 階級門檻 | Free 階級及以上 | Pro 階級及以上 |
| 角色選擇器 | Albion 中的自由文字搜尋 | 聯盟名冊選擇器（範圍限定在合作公會） |
| 核准時授予的身分組 | 來自對應表的 Discord 身分組 | AO Ally 通用身分組 + 依主公會的可選合作夥伴身分組 |
| 網頁上的視覺標記 | 一般 AO Master 身分組 | Ally Role chip（標籤 + 顏色） |
| 網頁上的名冊頻道 | #Members | #Allies |
| 失聯檢查 | 無 | 每日檢查；盟友的主公會離開聯盟時翻轉狀態為 Left alliance — 請看 盟友身分組同步 |
| 斜線指令 | /enlist review、/enlist reject、/enlist done | /ally review、/ally reject、/ally done |
| 釘選頻道預設 | #📋-enlist-here | #🤝-ally-here |
| 工單頻道前綴 | 🎯-enlist-… | 🤝-ally-… |
| 封存論壇 | apply-archive | 🗄-ally-archive |
表格中沒有的所有內容運作方式完全相同 — 相同的設定精靈結構、相同的面板配置、相同的封存對話記錄流程、相同的暫停 / 重建 / 停用語義。
5. 聯盟功能被「保留」時
聯盟依階級鎖定為 Pro。如果你的公會從 Pro 降到較低階級（訂閱到期、降級），流程進入保留模式：
#⚙️-guild-settings上的 🤝 Enable Ally 按鈕被置灰的[🔒 Alliance — Pro tier needed]狀態取代。- 現有的盟友工單保持開啟，但沒有新申請者可以申請。
- 失聯檢查暫停（你的名冊不會因為你降了階級而流失成員）。
- 現有的盟友保留其 AO Ally 身分組和名冊列。
恢復 Pro 階級會自動讓流程回到活躍狀態 — 不需要重新設定。
6. 網頁側鏡像
Manage Ally Discord 面板上的每個設定也在網頁的 #Discord Integration → Integrations → Ally 中（請看 Discord 整合）。跨介面設定（Receive new applicants 開關、自訂申請問題、Ally Role chip）位於 設定 → 招募（Recruitment）（Ally 外分頁），也在 Discord 整合盟友子頁的 Related settings 卡中呈現。
選最方便的介面 — 它們透過相同的頻道即時同步。
相關連結
- Discord 上的入會申請流程 — 成員側的等效流程（含每個步驟的完整 Discord 截圖；盟友的結構鏡像它）。
- 設定 → 招募（Recruitment） — Ally 外分頁（申請問題 + Ally Role chip + 邀請代碼）。
- Discord 整合 — 配對後的中樞（Ally 子頁位於 Integrations 分頁下）。
- #Allies 頻道參考 — 主公會側的名冊頁面。
- 成員 — 聯盟（Alliance） — 申請者側的視角。
- Discord — 斜線指令附錄 — 每個斜線指令的完整參考，包括
/ally review//ally reject//ally done。