术语表
本页汇总 QinhCoreLib（QCL）及秦淮 RPG 生态体系中的常用术语。每条给出一句话解释并指向详细页面。大致按主题分组。
🧩 平台与生态
QCL（QinhCoreLib） —— 秦淮生态的核心底座 / 平台库。不实现玩法，提供统一物品源、经济、脚本、数据库、PDC、占位符、GUI、动作契约、桥接与诊断。主类 com.qinhuai.corelib.QinhCoreLib。详见 概览。
QI —— QinhItems，物品系统插件。负责物品定义/组装/显示，不直接管战斗数值与合成。硬依赖 QCL。
QS —— QinhSkills，施法/技能引擎。提供变量通道、被动、冷却、吟唱等；QI 的物品动作通过 QISkillUseEvent 把释放交给它（handlerId qinhskills:cast）。
QF —— QinhForge，锻造玩法插件。
QSt —— QinhStrengthen，强化玩法插件。
QCR —— 生态成员插件之一（按职责划分协作）。
QI / QS / QF / QSt / QCR 共同构成秦淮 RPG 生态，全部硬依赖 QCL；QCL 为它们提供统一物品源、属性管道、工具与桥接。
🏗️ 架构概念
模块（Module） —— QCL 中可独立 load/enable/disable/unload 的功能单元，由 ModuleManager 按 priority 升序管理。QCL 内置 22 个核心模块。详见 模块系统、核心概念。
ModuleManager —— 模块注册与生命周期管理器；loadAll() 按优先级加载，单模块异常只降级该模块、不影响全局。
CoreModules —— 注册全部 22 个核心模块的入口（registerAll）。
AbstractModule —— Module 接口的默认空实现基类，自定义模块可继承它只覆写需要的生命周期方法。
桥（Bridge） —— QCL 与某个外部插件对接的适配层（CraftEngine 方块桥、ModelEngine 模型桥、各物品源桥、经济桥等）。基于反射，软依赖未装时跳过并标 NO_HOOK。详见 外部插件对接。
软依赖（softdepend） —— plugin.yml 中声明的可选依赖：装了启用对应桥，不装则跳过、不报错，仅影响加载顺序。详见 FAQ。
降级（Degrade） —— 单个模块/桥异常或软依赖缺失时仅该项被标记不可用、核心仍正常运行的容错策略，对应健康码 DEGRADED。
启用 / 可用 —— 两层状态：enabled（开关是否开 + 加载是否成功）与 available（运行期是否真能工作）。详见 诊断码 · 两层状态。
API 边界 / apiJar / 公开包 / 内部包 —— QCL 对外发布的稳定 API 制品（apiJar）只暴露公开包；内部包是实现细节，子插件不应依赖。详见 API 概览。
📦 物品源
物品源（ItemSource） —— QCL 统一物品来源抽象，涵盖原版、CraftEngine、MMOItems、NeigeItems、QinhItems、MythicMobs、CustomFishing、MagicGem、ItemsAdder、Nexo 共 10 种。详见 物品源引用。
ItemSourceManager —— 物品源注册中心；parseItemReference 把引用串解析为 (源, 物品ID, 可选JSON参数) 并构建 ItemStack。
ItemSourceType —— 枚举所有物品源类型及其别名（如 mi/mmoitems、ia/itemsadder）。
引用（Reference） —— 指向某物品的字符串标识，形如 源:物品id 或 源-物品id，无前缀默认原版。详见 物品源引用。
别名（Alias） —— 同一物品源的多个简写，如原版的 vanilla/minecraft/mc/v。
JSON 参数（::） —— 引用串里 :: 之后追加的 JSON，传给物品源做构建参数，如 ni-blade::{"品质":"传说"}。
ResolveResult —— ItemManagerAPI.resolve(...) 的结构化返回（success/item/code/message/source/suggestion/traceId）。错误码见 诊断码。
ItemModule —— 外部物品模块接口（build/buildWithParams）；Groovy 脚本可实现它在 item-modules/ 注册新物品源。详见 物品 API。
ItemMetadata / TypeManager —— 在物品 PDC 上读写元数据与类型标记的便捷封装。
⚙️ 动作 / 条件 / 表达式
Handler（QinhActionHandler） —— 动作处理器：处理某类动作的回调入口（handlerId/isAvailable/dispatch）。QI→QS 的契约层。详见 动作与技能桥。
QinhActionContext —— 派发给 Handler 的上下文（trigger/player/item/itemId/handlerId/payload/triggerType/rawContext…）。
ActionDispatchResult —— 派发结果枚举：HANDLED / NOT_HANDLED / HANDLER_UNAVAILABLE。
Payload —— 随动作传递的不透明负载数据，QI 原样透传、Handler 自行解释。
TriggerType —— 统一触发类型枚举（右键/左键/潜行/双击/长按/命令/被动等），屏蔽 Bukkit 事件细节。
QISkillUseEvent —— QI/QS 共用的技能触发事件（Cancellable），带 skillHandled/castResult 等标志。
QISkillBridge —— 通过事件总线把动作派发给 QS 的桥，HANDLER_ID = qinhskills:cast。
ActionContext / ActionPipeline / ActionRegistry —— 动作执行的上下文、管道（链式或 DSL）与注册表。
条件（Condition）/ ConditionPipeline / CompositeCondition —— 条件判断接口、管道（AND/OR）与复合条件（LogicOperator）。操作符含 eq/neq/exists/notnull/contains/var_eq。详见 条件与表达式。
ExpressionEngine —— 基于 exp4j 的数学表达式求值器，含 randomDouble/randomInt/randomGaussian/randomExponential 等随机函数。
💰 经济
EconomyBridge —— 统一经济桥，自动在 Vault / ExcellentEconomy / PlayerPoints 间选源（economy.default-provider）。详见 经济 API。
EconomyProvider —— 某个经济后端的实现（id/isAvailable/getBalance/deposit/withdraw/setBalance）。
EconomyTransactionResult —— 经济操作返回（success/message/code/provider）。
Provider —— 泛指提供某类服务的实现方；经济语境即上面的 EconomyProvider。
货币（Currency） —— ExcellentEconomy 的多货币概念（money/silver/gold…）；Vault/PlayerPoints 为单货币，忽略该参数。
auto（自动选源） —— default-provider: auto 时的选择策略：指定货币优先 ExcellentEconomy，否则 Vault > ExcellentEconomy > PlayerPoints。
📜 脚本 / 数据 / 显示
GraalJS / GraalVM —— QCL 内嵌的 JavaScript 运行时；需 Paper/Purpur 拉取运行库。详见 脚本入门。
命名空间（Namespace） —— 脚本与物品引用中区分来源的前缀，如脚本 qinhitems:hooks/craft.js、物品 itemsadder:命名空间:id。
ScriptContext / qcl / ctx —— 脚本执行上下文，以及注入脚本的 API 对象（qcl）与上下文对象（ctx）。
ScriptExecutionResult —— 脚本执行返回（success/value/code/message），错误码见 诊断码。
PDC（PersistentDataContainer） —— Bukkit 持久化数据容器；QCL 的 PdcService 按命名空间封装读写（key 形如 qinhcorelib:命名空间_键名）。详见 数据存储与占位符。
占位符（Placeholder） —— 文本中可被动态替换的标记。QCL 提供 PapiBridge（PlaceholderAPI 桥，未装安全降级）与 GUI 内置 {xxx} 占位符。
QinhPlaceholderProvider —— 注册自定义 %标识_参数% 占位符的接口。
装配（Assembly）/ DisplayLayer —— 动态物品显示分层系统：把名称、Lore 等显示拆成可叠加的 DisplayLayer，按 priority 升序 apply 到 ItemMeta。详见 工具集。
语义规格（SemanticSpec） —— 对物品/技能/锻造等对象的语义层规格描述，用于跨源统一表达（ItemSpec/SkillSpec…）。
🧰 服务与工具
TaskScheduler —— 同步/异步任务调度封装（用 Runnable/Supplier 规避跨插件 LinkageError），兼容 Folia。附 CooldownManager（冷却）、ThrottledExecutor（节流）。详见 工具集。
HologramManager —— 基于 ArmorStand 的全息投影管理。
ServerCompat —— 服务端平台/版本检测与兼容工具（validateServer、多名降级解析声音/粒子/材质等）。
Folia —— Paper 的多线程区域化分支；QCL 调度走 Bukkit 调度器以保持兼容。
CustomBlock / CustomBlockProvider —— 自定义方块抽象与其后端供应商（内置 CraftEngineBlockProvider）。详见 自定义方块。
MiniMessage —— Adventure 的富文本标签格式（<red>、<bold> 等）；QCL 的 TextUtil.toComponent 同时支持它与旧版 &/§ 颜色码。
❤️ 诊断
健康码（HealthReport） —— 状态码：OK（正常）、NO_HOOK（无软依赖）、DEGRADED（降级可恢复）。详见 诊断码。
诊断（DiagnosticResult） —— 统一诊断结果容器（success/value/code/message/suggestion/traceId），用 ok()/fail() 构造。
BridgeStatus —— 单个桥的状态对象（available/enabled/source/recoverable/message）。
EcosystemStartupProbe / StartupReporter —— 启动探针与启动摘要打印器，汇总可用物品源、经济、已挂钩插件。