🕹️ 命令与权限
QCL 基于 Cloud 命令框架，命令根为 /qcl，别名 /qinhcorelib。本页给出完整命令树、用法示例、预期输出、权限节点表和推荐的权限组分配。
🌳 命令树总览
| 命令 | 别名 | 权限 | 作用 |
|---|---|---|---|
/qcl | — | 无 | 显示帮助 |
/qcl status | /qcl probe | qcl.status | 生态状态摘要 |
/qcl status detail | /qcl status full | qcl.status | 详细状态（逐模块/逐桥/脚本扩展行） |
/qcl reload | /qcl rl | qcl.admin | 重载 config + 经济 + 脚本 + 外部物品模块 + GUI |
/qcl gui <id> | — | qcl.gui | 打开自定义 GUI（仅玩家） |
/qcl attr | /qcl attribute | qcl.admin | 属性系统调试总览 |
/qcl attr list | — | qcl.admin | 列出全部已注册属性（按大类分组） |
/qcl attr show [玩家] | — | qcl.admin | 查看玩家属性合计（分源后总值） |
/qcl attr debug | — | qcl.admin | 开关命中伤害溯源（仅玩家） |
/qcl attr book | — | 无 | 打开属性面板书本（仅玩家） |
/qcl mobattr <key> <值> | — | qcl.admin | 给看向的怪物设置属性（测试用，仅玩家） |
/qinhcorelib是/qcl的完整别名，下方所有命令都可用/qinhcorelib前缀替代。
📜 /qcl — 帮助
直接输入 /qcl 显示帮助。无需任何权限。帮助输出固定格式：分隔线 +「秦淮核心库」+ status / reload / gui 三行说明。
————————————————————————
秦淮核心库
/qcl status - 查看生态与桥接状态
/qcl reload - 重新加载配置文件
/qcl gui <id> - 打开自定义GUI
/qcl attr - 属性系统调试 (list/show)
————————————————————————🔍 /qcl status — 状态摘要
权限：qcl.status 别名：/qcl probe
/qcl status输出整个秦淮生态的健康摘要：软依赖探测（物品源数量+列表、经济、属性插件、已接入插件）、平台状态与健康码、各模块健康码、脚本/经济/PAPI/数据库/PDC 各桥健康码、子插件状态（QI/QS/QF/QSt）、配置诊断码、API 边界码、物品引用诊断码等。
详细版
/qcl status detail别名：/qcl status full。在摘要基础上额外输出：桥接数、模块数、TraceId、逐模块（启用/未启用 + 可用/不可用 + 消息）、逐桥（启用/未启用 + 可用/不可用 + 来源 + 消息），以及脚本 global:qcl_status.js:formatStatus 追加的行。
🩺 每一项的含义、正常值、异常处理详见 诊断与排错。
🔄 /qcl reload — 重载
权限：qcl.admin 别名：/qcl rl
/qcl reload执行期间提示「正在重新加载…」，完成后提示「重载完成」。
📦 reload 重载了哪些东西
| 重载项 | 说明 |
|---|---|
| config | 重新读取 config.yml |
| 经济 | 重新初始化经济提供者 |
| 脚本 | 重新加载 JS 脚本 |
| 外部物品模块 | 重新探测/接入外部物品插件 |
| GUI | 重新加载自定义 GUI 定义 |
⚠️ 哪些改动 reload 不够、必须重启
| 改动 | reload 够吗？ |
|---|---|
database.type 或 MySQL 连接参数 | ❌ 必须重启（连接在启动时建立） |
modules 模块开关 | ❌ 建议重启（影响模块装载） |
debug / economy / 脚本内容 / GUI / 物品引用 | ✅ reload 即可 |
详见 配置文件 的「改动生效方式速查表」。
🖼️ /qcl gui <id> — 打开 GUI
权限：qcl.gui 仅玩家可用
/qcl gui 主菜单打开 id 为 主菜单 的自定义 GUI。若该 id 不存在，提示：
找不到GUI: 主菜单🔗 GUI 的定义与开发见 GUI编程API。
🗡️ /qcl attr — 属性系统调试
权限：qcl.admin（其中 book 子命令无需权限） 别名：/qcl attribute
| 子命令 | 作用 |
|---|---|
/qcl attr | 总览：配置后端 / 实际后端 / GraalJS 状态 / 已注册属性数 |
/qcl attr list | 列出全部属性，按大类分组，标注 原版 / 物品 / 存储 类型与伤害类型 |
/qcl attr show [玩家] | 查看某玩家属性合计（不填看自己；控制台必须指定玩家名） |
/qcl attr debug | 开关「命中伤害溯源」，开启后每次造成 / 受到伤害都打印属性结算过程（仅玩家） |
/qcl attr book | 打开属性面板书本（仅玩家，无需权限） |
🗡️ 属性怎么配、怎么写自定义属性（yml + JS）见 属性系统。
🐲 /qcl mobattr — 给怪物设属性（测试用）
权限：qcl.admin 仅玩家可用
/qcl mobattr <属性key> <数值> # 看向一只怪物（12 格内），给它设该属性
/qcl mobattr clear # 清除该怪物的全部属性调试自定义属性最快的方式：例如 /qcl mobattr defense 100 给怪 100 防御，再打它看减伤是否生效。
🔐 权限节点表
| 权限节点 | 控制的命令 | 性质 |
|---|---|---|
qcl.status | /qcl status、/qcl status detail | 查看类（只读） |
qcl.admin | /qcl reload、/qcl attr（含 list / show / debug）、/qcl mobattr | 管理类（有副作用 / 调试） |
qcl.gui | /qcl gui <id> | 玩家功能类 |
/qcl（帮助）与/qcl attr book无需任何权限，所有人可用。
👥 推荐权限组分配
🛡️ 管理员组（admin / op）
permissions:
- qcl.status # 查看生态状态
- qcl.admin # 重载配置
- qcl.gui # 打开 GUI🧑 普通玩家组（default）
permissions:
- qcl.gui # 仅允许打开 GUI（按需）💡
qcl.admin（reload）有副作用，只给信任的管理员。qcl.status一般也只给管理/运维，普通玩家通常只需要qcl.gui（甚至不给，由你的 GUI 子插件自行触发）。