命令与权限
QS 只注册一条主命令 /qs（别名 /qskills、/qskill），下挂 11 个子命令。本页是命令树与权限节点的速查。
📌 不带任何参数运行
/qs，会打印运行时协议状态 + 用法提示，等价于一次快速健康检查。
🌳 子命令总表
| 命令 | 参数 | 权限 | 说明 |
|---|---|---|---|
/qs reload | — | qinhskills.admin | 重载定义 / graph / 路由，并同步 Mythic 桥 |
/qs protocol | — | qinhskills.use | 查看运行时协议、桥状态、Mythic 可用性 |
/qs bridge | — | qinhskills.use | Mythic 桥诊断（bridgeId / available / 最近请求） |
/qs list | [玩家] | use（自己）/ admin（他人） | 列出全部技能：解锁 ✔/✘、等级、剩余冷却 |
/qs info | <技能> | qinhskills.use | 技能定义详情（类型 / MM 技能 / 触发 / 变量） |
/qs unlock | <技能> [玩家] | qinhskills.admin | 解锁技能 |
/qs lock | <技能> [玩家] | qinhskills.admin | 锁定（移除解锁） |
/qs level | <技能> <等级≥1> [玩家] | qinhskills.admin | 设置技能等级 |
/qs slot | <槽位1-5> <技能|clear> [玩家] | qinhskills.admin | 设置 / 清空技能槽（clear/none 清空） |
/qs cast | <技能> | qinhskills.cast | 命令施放（仅玩家，测试 / 命令桥用） |
/qs silence | <秒> [玩家] | qinhskills.admin | 封锁 N 秒内放不出技能（0=解除） |
⚠️
<>必填、[]可选。带[玩家]的命令缺省作用于发送者本人；操作他人一律需要qinhskills.admin。控制台没有"本人"，所有带玩家参数的命令在控制台必须显式写玩家名。
🔑 权限节点（plugin.yml）
| 权限 | 默认 | 作用 |
|---|---|---|
qinhskills.admin | op | reload、unlock、lock、level、slot、silence、操作他人 |
qinhskills.use | true | 基础使用：list（自己）、info、protocol、bridge |
qinhskills.cast | true | 通过 /qs cast 命令施放技能 |
qinhskills.gui | true | 技能槽 GUI（当前未绑定可用命令，内部 / 预留） |
qinhskills.ci | op | 内置事件链 CI（内部，未对外开放命令） |
qinhskills.ci.verbose | op | CI 失败时输出 trace（内部） |
💡
qinhskills.gui与qinhskills.ci/qinhskills.ci.verbose当前没有绑定任何可用的玩家命令——GUI 与 CI（事件链回归测试）属于内部 / 预留能力，不通过/qs暴露。文档中你看到的/qs test、/qs gen同理：未对外开放，请以上表 11 个子命令为准。
⌨️ Tab 补全规则
| 输入位置 | 补全内容 |
|---|---|
| 第 1 参 | 子命令名（reload protocol bridge list info unlock lock level slot cast） |
info/unlock/lock/level/cast 的技能位 | 已注册技能 id |
slot 的槽位 | 1 2 3 4 5 |
slot 的技能位 | 技能 id + clear |
list/unlock/lock 的玩家位 | 在线玩家名 |
level/slot 的玩家位 | 在线玩家名 |
silence不在补全列表里（避免误触），直接手输即可。
🧪 典型用法
bash
# 重载技能定义与 graph（改了 YAML 后必跑）
/qs reload
# 看某玩家全部技能状态
/qs list Steve
# 给玩家解锁并升级
/qs unlock fire_wave Steve
/qs level fire_wave 3 Steve
# 把技能绑到 2 号槽
/qs slot 2 fire_wave Steve
# 命令施放（测试技能能不能放出来）
/qs cast fire_wave
# 封锁玩家 5 秒 / 解除
/qs silence 5 Steve
/qs silence 0 Steve
# 桥与协议诊断
/qs protocol
/qs bridge继续阅读
- 消息文案速查 — 每条命令的回显原文
- 结果码 CastResult —
/qs cast输出的结果码含义 - 诊断排错 — 命令跑了没效果怎么查
- 术语表 — 桥 / 协议 / 门控等名词