跳到主要内容

管理与运维指令

管理指令用于系统运维、图片数据同步、缓存更新与推送诊断。所有管理指令均以 /管理（或 /admin）开头。

账户诊断 (/管理 账户信息)​

用于查看当前触发会话的底层标识与权限判定结果。

语法格式​

/管理 账户信息

返回信息包含​

  • 用户 OpenID 与所在群聊 OpenID
  • 会话场景（群聊 / 私聊 / 频道）
  • 权限角色判定（超级管理员 / 机器人管理员 / 群主 / 群管理员 / 普通成员）
  • 主动消息推送通道支持状态

航海指南上传 (/管理 指南上传)​

用于将本地或网络图片持久化保存至服务器存储目录（/db/dailyReport），绑定触发别名，并可选择是否套用品牌 Header 与 Footer 模板。

语法格式​

/管理 指南上传 -password <密码> -name <指南名称> [-url <图片链接>] [-isTmp <true/false>]

参数标志说明​

参数标志别名形式是否必填说明
-password-passwrod, -passwd, -pwd, -p是上传鉴权密码，需与服务器配置中的密钥一致
-name-n是指南触发名称。支持以中英文逗号隔开多个别名（如 -name 设计A,设计B），后续 /指南 设计A 与 /指南 设计B 均可返回该图
-url-u, -link否图片网络下载直链（支持 http://、https:// 或 // 协议前缀）
-isTmp-istmp, -istemp, -temp, -tmp, -t否是否套用品牌模板渲染独立长图副本（默认 false 原图直出；设为 true 时自动生成带顶栏底栏的包装长图，不修改原图文件）

交互式上传模式（未携带 -url 时）​

若执行命令时未附加 -url 且当前消息未附带图片附件：

  • 机器人验证密码通过后，将提示：请在下方发送图片。 并进入 120 秒等待接收状态。
  • 用户在下方直接回复发送图片：可发送图片附件或直接粘贴图片 URL。
  • 机器人自动抓取回复中的图片并完成持久化存储、格式校验、别名记录与缓存刷新。
  • 退出等待状态：回复 取消 或直接发送新的斜杠指令可立即退出等待。

同名自动覆盖机制​

  • 若上传的指南名称或别名在系统中已存在，系统将自动覆盖旧文件与元数据。
  • 若新上传的文件格式与旧文件不同（如将旧的 .jpg 替换为新 .png），系统会自动清理旧格式文件，确保本地存储不残留冗余文件。
  • 覆盖成功后，将立即清除该指南及其所有别名在内存和 Redis 中的历史缓存。

使用示例​

  • 直接带 URL 上传/覆盖： 
    /管理 指南上传 -password 你的密码 -name 进阶航行技巧 -url https://glow-prow.top/assets/guide1.png
  • 绑定多个别名并开启模板渲染： 
    /管理 指南上传 -password 你的密码 -name 武器图鉴,火炮推荐 -url https://glow-prow.top/assets/cannons.png -isTmp true
  • 交互式回复上传： 
    # 发送指令
    /管理 指南上传 -password 你的密码 -name 藏宝图位置

    # 机器人回复：请在下方发送图片。

    # 在下方直接发送图片附件或链接即可完成上传

航海指南删除 (/管理 指南删除)​

用于从服务器本地磁盘中安全移除指定指南图片文件、删除数据库元数据记录，并即时同步清理缓存。

语法格式​

/管理 指南删除 -password <密码> -name <指南名称>

参数标志说明​

参数标志别名形式是否必填说明
-password-passwrod, -passwd, -pwd, -p是删除鉴权密码，需与服务器配置中的密钥一致
-name-n是需要删除的指南名称或别名（支持逗号分隔多个名称批量删除，如 -name 基础操作,进阶技巧）

使用示例​

  • 删除单个指南： 
    /管理 指南删除 -password 你的密码 -name 藏宝图位置
  • 批量删除多个指南别名： 
    /管理 指南删除 -password 你的密码 -name 武器图鉴,火炮推荐

指南缓存清理 (/管理 清理指南缓存)​

即时清空航海指南在内存和 Redis 中的所有 3 小时缓存数据。

语法格式​

/管理 清理指南缓存

支持的前缀别名​

  • /管理 清空指南缓存
  • /管理 指南清除缓存
  • /管理 clear_guide_cache

日报缓存清理 (/管理 清理日报缓存)​

清空今日航海日报的本地截图缓存与 Redis 键，并立即在后台重新触发 Playwright 渲染最新截图。

语法格式​

/管理 清理日报缓存

全局缓存清理 (/管理 清除缓存)​

清空全站 Redis 业务缓存与会话状态（仅限机器人超级管理员权限）。

语法格式​

/管理 清除缓存

掉宝诊断与通知 (/管理 掉宝通知 / 掉宝测试)​

  • 查询后端掉宝通知历史：

    /管理 掉宝通知

    查询后端服务当前已记录的 Twitch 掉宝事件列表与时间戳。

  • 触发掉宝推送演练：

    /管理 掉宝测试

    模拟触发一次掉宝上线通知，向所有已订阅的会话广播测试消息。

日报主动推送测试 (/管理 日报主动推送测试)​

模拟定时任务触发一次全量航海日报主动推送，用于验证通道连通性与推送排版效果。

语法格式​

/管理 日报主动推送测试

🛡️ 安全防暴力破解与账号锁定​

为防止敏感管理指令与密码被恶意撞库或洪泛调用，机器人系统内置了多层主动安全防护机制：

1. 密码试错与锁定策略​

  • 单日试错上限：单个用户在 1 天（自然日）内输错密码累计达 10 次 时，系统将自动触发安全拦截。
  • 锁定时长：自动对该账号施加 30 天（一个月） 的系统安全锁定。
  • 锁定限制：锁定期间该账号禁止调用任何 /管理 相关指令及密码鉴权功能，并会在尝试调用时提示锁定原因与剩余解封倒计时。

2. 高频暴力调用防护​

  • 短时洪泛监控：10 秒内连续发起超过 5 次管理请求，或 60 秒内连续发起超过 15 次管理请求时，系统将判定为恶意暴力调用。
  • 处置机制：立即中断后续处理并自动对该用户实施 30 天（一个月） 安全锁定。

3. 解除锁定与管理指令​

指令权限要求语法与说明
锁定列表机器人管理员 (admin)/管理 锁定列表：查看当前被安全锁定的账号名单、锁定原因、截止时间与剩余时长
解除锁定超级管理员 (super)/管理 解锁 <用户OpenID>：手动解除指定账号的安全锁定并重置试错计数
手动锁定超级管理员 (super)/管理 锁定 <用户OpenID> [天数] [原因]：手动对可疑违规账号施加安全锁定