管理与运维指令

管理指令用于系统运维、图片数据同步、缓存更新与推送诊断。所有管理指令均以 /管理（或 /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 掉宝事件列表与时间戳。
触发掉宝推送演练：
```
/管理 掉宝测试
```
模拟触发一次掉宝上线通知，向所有已订阅的会话广播测试消息。

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

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

语法格式

/管理 日报主动推送测试

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

语法格式​

返回信息包含​

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

语法格式​

参数标志说明​

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

同名自动覆盖机制​

使用示例​

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

语法格式​

参数标志说明​

使用示例​

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

语法格式​

支持的前缀别名​

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

语法格式​

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

语法格式​

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

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

语法格式​

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

语法格式

返回信息包含

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

语法格式

参数标志说明

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

同名自动覆盖机制

使用示例

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

语法格式

参数标志说明

使用示例

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

语法格式

支持的前缀别名

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

语法格式

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

语法格式

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

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

语法格式