#Allies

通过联盟流程以盟友身份申请加入你公会的同盟公会成员名单。位于 GUILD → Allies，紧跟在 #Members 之后。

只要以下任一条件成立，频道就会自动出现在侧边栏：

• 公会拥有者已在 设置 → 招募 → 盟友 上启用联盟功能（公会的盟友配置中存在至少一行），或
• 公会名单上至少有一名处于活跃状态的盟友。

如果你的公会不运营联盟，该频道会隐藏 — 无需授予任何权限，也无需切换任何开关，就是没有这个界面。

权限

可见性由上述自动显示条件 + 你正常的 #Members 可见性共同决定（频道显示后，公会任意成员都能看到它）。

每位盟友详情中的员工操作（将盟友重新关联到不同角色、移除盟友）需要 Manage Guild 权限。没有该权限的成员看到的是同样的名单，但没有操作按钮。

页面显示的内容

名单为空时，页面邀请拥有者生成盟友码或设置 Discord 流程。两条路径分别跳转到 设置 → 招募（盟友外标签）或 Discord 绑定（Integrations → 盟友子页）。

名单中有盟友时，空状态被盟友行列表替代，每行显示：

• Albion 角色 + 用户名 — 同盟公会成员的游戏角色 + 其 AO Master 用户名。已关联 Discord 的盟友还会显示一个小 Discord 标签。
• 本家公会 — 他们来自哪个同盟公会（Albion 公会名 + 链接）。
• 状态徽章 — 已链接（仍在本家同盟公会中）或 已离开联盟（已失联 — 其本家公会已退出你的联盟，或他们换到了非同盟公会）。
• 加入时间 — 盟友申请被批准的时间。

整行可点击 — 会打开 盟友详情 弹窗，员工可在此对该盟友采取操作（见下文）。

工具栏 — 筛选 + 搜索 + 刷新

页面顶部有三个控件：

• 状态筛选（多选）— 任意组合选择 已链接 / 已离开联盟。下拉菜单中每个选项带有彩色点和每状态的数量（例如 已链接（15） / 已离开联盟（2））。切换时旁边的可见数量会实时更新。
• 本家公会筛选（带内嵌搜索的多选）— 选择要显示哪些同盟公会的成员。名单上有多个同盟伙伴时很有用。下拉菜单列出所有不同的本家公会 + 每个公会的数量。
• 搜索框（右侧）— 按角色名、用户名和本家公会名进行字符串匹配。与上面两个筛选器联合生效。
• 刷新（图标按钮，最右侧）— 从服务器重新拉取名单。当有盟友申请、被批准或状态变化时，页面也会通过实时频道自动同步 — 很少需要手动刷新。

盟友详情弹窗（员工操作）

点击任意盟友行会打开 盟友详情 弹窗。弹窗显示完整的盟友资料，以及两项员工操作（需要 Manage Guild 权限）：

• 🖉 重新关联到不同角色 — 打开一个范围限定在你联盟伙伴的角色选择器。选择一个角色后，系统会从 Albion API 实时解析本家公会；用户账户不变。适合盟友换到同盟公会中的其他小号、你希望名单行跟随的情况。
• 移除盟友 — 需要输入确认文字。盟友行被软删除（状态翻转为 已离开联盟），关联的 Discord 盟友角色进入撤销队列，该角色在你公会内的所有 CTA 倒计时报名被清除。用户账户本身不受影响；他们可以通过盟友码或 Discord [Apply as Ally] 按钮重新申请。

盟友如何出现在这里

盟友在经历以下两条流程之一后会出现在名单上：

• Web — 他们访问 https://ao-master.com/ally/<code>，登录（或注册），选择角色并提交。申请出现在 #Join Requests（盟友侧）。拥有 Approve Enlist Members 权限的员工批准后，行出现在 #Allies 并将 Ally Role chip 附加到其角色上。
• Discord — 他们点击你 #🤝-ally-here 频道上的置顶 [Apply as Ally] 按钮；机器人打开一个 🤝-ally-… 工单；审核员运行 /ally review（并在批准后运行 /ally done）。最终结果相同：行出现在 #Allies，Ally Role chip 即刻生效。

成员视角的完整说明见 成员 — 联盟。Discord 端流程见 Discord — 盟友流程。

状态翻转为"已离开联盟"时

失联检查每天运行一次。对每位活跃盟友，它会检查：

1. 他们关联的角色是否仍在其本家同盟公会中？
2. 本家同盟公会是否仍在你的联盟中（还是已退出）？

任一答案为否，该盟友行就翻转为 已离开联盟。接下来发生什么取决于你的 Ally Role Sync 模式（在 Discord 绑定 → Integrations → 盟友 中设置）：

• 🟢 关闭 — 不自动清理 — Discord 盟友角色保留。该行在 #Allies 上继续显示 已离开联盟 徽章，直到你决定移除他们。
• 🟡 手动审核 — 该行加入 Stale Ally Roles 审核列表（在 Discord 绑定页面可见）。你选择一个子集剥离。
• 🔴 严格 — 立即清理 — 机器人在一分钟内剥离 Discord 盟友角色 + 向前盟友发私信。

每种模式下，检查触发后 #Allies 名单都会立即显示 已离开联盟 徽章。顶部的状态筛选器可以隐藏或聚焦这些行。

相关链接

• 成员 — 联盟 — 作为盟友的视角。
• 设置 → 招募 — 配置盟友申请问题 + Ally Role chip + 生成盟友码。
• Discord 绑定 — Integrations → 盟友子页（频道映射、Ally Role Sync 模式、同盟 Discord 角色）。
• Discord — 盟友流程 — Discord 端流程（管理盟友机器人面板、斜杠命令、归档对话记录）。
• #Join Requests — 员工批准/拒绝盟友申请的地方。