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

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages