Skip to content

Repository files navigation

Albion KOOK Bot

面向《Albion Online》EU / ASIA 公会的 KOOK 运营机器人。它把成员绑定、战斗信息、补装审批和日常运营集中在 KOOK 内完成,让成员自助处理高频事项,让管理员把精力放在需要判断的环节。

项目价值

  • 减少重复操作:成员绑定、身份组发放、退会复查、击杀与阵亡播报由机器人持续处理。
  • 缩短信息链路:战绩、估值、市场、战役、战报和出勤快照可以直接在 KOOK 查询。
  • 规范补装协作:申请、审批、拒绝、待发放和已发放都有明确状态与通知。
  • 保持关键操作可控:AI、黑名单和招新审查只提供只读辅助,不自动审批、发组、撤组、改金额或标记发放。

核心能力

公会与成员

  • 管理员绑定 Albion 公会,初始化当前区服的运营与补装频道。
  • 成员自助绑定角色,可同步 KOOK 昵称并由管理员审批。
  • 绑定通过后自动发放会员身份组;退会复查会撤销身份组并清理绑定。
  • EU / ASIA 共用一套服务,数据源、频道前缀和业务数据按区服隔离。

战斗与市场

  • 查询角色战绩、最近阵亡估值、物价、金价、公会榜单和 ZvZ 战役。
  • 自动播报本会击杀与阵亡,并对大额损失和名单命中做醒目标记。
  • 聚合 ZvZ 战报、参战规模与成员表现;可选 AI 生成只读摘要。
  • 提供近期战斗参与快照,辅助了解成员参与情况。

补装闭环

  • 从成员最近阵亡记录发起补装,自动生成装备明细与估值。
  • 支持审核员审批、拒绝、标记发放,并向申请人同步状态。
  • 补装金额只计算穿戴装备,背包物品仅展示在完整损失中。
  • AI 可以解释金额、缺价和异常点,但不会给出审批决定。

运营辅助

  • 黑名单与招新审查覆盖玩家、公会和联盟,只做风险提示。
  • 只读看板汇总运行状态、高声望事件、榜单、金价和出勤快照。
  • 每次部署新功能后,机器人会向当前区服的审批频道推送本次更新介绍;同一期内容不会因普通重启重复发送。

指令

输入 /帮助 会按当前身份展示常用指令;管理员可用 /帮助 配置 查看缺失配置和下一条建议命令。

成员

指令 用途
/绑定 <角色名> [自定义昵称] 申请绑定角色并同步 KOOK 昵称
/解绑 解除自己的角色绑定
/战绩 [角色名] 查看角色近期战绩
/估值 [角色名] 估算最近一次阵亡损失
/物价 <物品名或 ID> 查询市场价格
/金价 查看金币价格
/榜单 [pvp|pve] 查看公会榜单
/战役 查看绑定公会近期战役
/战报 [日期] 查看战报;可按日期查询夜间窗口
/出勤 [5-50] 查看近期战斗参与快照
/补装 从最近阵亡中发起补装
/补装状态 查看自己的补装进度
/助手 <问题> 使用只读 AI 查询与指令引导

审核员

指令 用途
/补装 待处理 查看待审核补装
/补装 待发放 查看已通过、待发放补装
/补装 拒绝 #申请号 理由 拒绝补装并记录原因
/补装 发放 #申请号 银币|装备|物品 [备注] 标记补装已发放
/补装解释 <申请号> 查看只读 AI 金额说明
/补装审核 申请补装审核员身份

管理员

指令 用途
/绑定公会 <公会名> 绑定当前 KOOK 服务器与 Albion 公会
/解绑公会 解除当前公会绑定
/设置 运营初始化频道 创建并写入运营频道配置
/设置 补装初始化频道 创建并写入补装频道配置
/设置 会员身份组 @身份组 配置绑定通过后发放的身份组
/设置 可信身份组 @身份组... 配置可快速通过绑定的身份组
/设置 补装审核身份组 @身份组... 配置补装审核权限
/黑名单 列表|添加|重点|禁用|查询 管理只读审查名单
/招新审查 <角色名> 查看新人及其公会、联盟的名单命中
/帮助 配置 检查当前服务器配置

使用说明

管理员首次配置

  1. 邀请机器人,并授予读取消息、发送卡片、管理目标身份组和修改成员昵称所需权限。
  2. 在当前区服频道执行 /绑定公会 <公会名>,从候选结果中确认正确公会。
  3. 执行 /设置 会员身份组 @身份组
  4. 执行 /设置 运营初始化频道/设置 补装初始化频道
  5. 执行 /设置 补装审核身份组 @身份组...
  6. 使用 /帮助 配置 检查未完成项。

EU bot 使用 eu- 前缀频道,ASIA bot 使用 asia- 前缀频道。频道被删除、重建或改成其他区服前缀后,需要重新执行对应 /设置 指令。

成员日常使用

  1. 通过 /绑定 <角色名> [自定义昵称] 提交角色绑定。
  2. 管理员审批通过后,机器人发放会员身份组并尝试同步昵称。
  3. 使用 /战绩/估值/物价/金价/战役/战报/出勤 获取日常信息。
  4. 需要补装时输入 /补装,从最近阵亡中选择对应记录。

补装处理

待审批 -> 待发放 -> 已发放
待审批 -> 已拒绝

审核员在补装审核频道处理申请,通过后在发放频道完成线下发放并标记结果。申请人可以随时使用 /补装状态 查看进度,状态变化也会发送到补装通知频道。

AI 与自然语言

AI 默认只作为可选的说明层。开启后可以使用 /助手 <问题>/战报 [日期]/补装解释 <申请号>,也可以通过 @机器人 <自然语言> 调用白名单内的只读查询。绑定、设置、审批、身份组变更、金额修改和发放标记始终由现有指令、规则与管理员确认完成。

更完整的管理员配置、补装操作和故障检查见 使用说明书

开发迭代中

线上观察

  • 真实 KOOK 频道中的指令、按钮和权限兼容性。
  • 自动战报、AI 摘要、死亡播报与后台采集任务的长期稳定性。
  • 双区运行下频道隔离、消息去重和外部数据源波动。

已规划

  • 个人档案中的出勤率、近期参与趋势和战斗表现摘要。

待公会规则确认

  • CTA 活动创建、报名、请假、到场确认和正式出勤口径。
  • 指挥、审核员与成员在活动流程中的权限边界。

长期候选

  • 公会经济结算与更完整的补装统计。
  • 武器 Meta、配装趋势和战斗复盘。
  • 实时玩家搜索与更丰富的公会运营看板。

文档

许可证

MIT,详见 LICENSE

About

Albion Online guild KOOK bot for member binding, battle reports, death broadcasts, regear workflow, market estimates, and ops dashboard.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages