更新日志
按能力维度记录 QS 的演进。当前版本 1.0.22。具体细节请配合各功能页阅读。
📌 本日志按"能力累积"组织而非逐日流水——给出里程碑而非精确日期。命令 / 字段以实际版本为准。
🏷️ 当前：1.0.22
单一运行时落定——旧的技能管线已彻底移除，全插件只跑唯一一条管线。文档不再有 v1/v2 之分，所有触发（物品按键 / 命令 / API / 被动）都汇入同一条：输入归一 → 状态机 → 图解析 → 执行计划 → 门控 → 执行 → 后处理。
| 维度 | 状态 |
|---|---|
| 运行时管线 | 单一，旧管线已移除 |
| 命令 | 11 个子命令（见 命令与权限） |
| 结果码 | 14 个 CastResult（见 结果码） |
| 被动触发 | 11 种 |
| 桥模式 | AUTO / API_MODE / YAML_STUB |
🧱 1.0.x 累积能力
下列能力在 1.0.x 系列中陆续成型，至 1.0.22 全部可用：
施放与门控
- 门控（Gate）系统 — 解锁 / 冷却 / 冷却组 / 充能 / 全局冷却(GCD) / 资源 / 生命饥饿(血祭) / 冲突组 / 声明式条件，按固定顺序逐项校验。
- 充能 charges —
>1时替代二元冷却，逐层恢复。 - 冷却组 cooldown_group — 同组技能共享冷却。
- GCD + ignore_gcd — 全局冷却与豁免（瞬发位移 / 打断技常用）。
- 冲突组 conflict_groups — 施放后同组短期互斥。
- 血祭 cost —
cost.health/hunger生命饥饿消耗。 - 声明式 conditions — 等级 / 血量 / 世界 / 目标等前置条件，未知键恒真不锁死。
- 冷却落盘 — 防重登刷冷却。
目标与索敌
- 5 种范围索敌 —
NEAREST/FARTHEST/LOWEST_HP(残血收割) /HIGHEST_HP(肉盾) /RANDOM，外加SELF/LOOK。 - 索敌过滤 filter —
ANY/LIVING/MONSTERS/PLAYERS/NOT_PLAYERS，配range/require_los/required。
施法模式
- toggle 开关 — 反复切换 on/off。
- channel 吟唱读条 — bossbar / actionbar / none 三种进度 UI，位移与受伤打断，起手或完成扣费。
- ready_notify — 二元冷却就绪提示（actionbar + 音效）。
连招与被动
- 连招 combo — 窗口内按出输入序列（如 右→右→左）触发终结技；
finalize_skill指向 graph node。 - 被动扩展（11 种） —
ON_DAMAGED/ON_ATTACK/ON_KILL/ON_LOW_HEALTH(边沿触发) /ON_SNEAK/ON_JUMP/ON_SPRINT/ON_BLOCK_BREAK/ON_RESPAWN/ON_FALL/TICK。被动自 1.0.16 起 schema 友好化，无需写trigger.primary。
控制与诊断
- silence 沉默 —
/qs silence/ API 封锁，盘活LOCKED状态。 - 协议 / 桥诊断 —
/qs protocol、/qs bridge。 - debug trace — 分阶段
[EVENT][PARSE][ROUTE][GATE][EXEC][POST][FALLBACK]定位，[BYPASS]架构冲突警告。
内容与对接
- 自带示例重写为带注释教程 — 8 个示例技能（fire_wave / blade_slash / demo_slash / demo_slash_charged / retaliate / dash / shield / fire_combo_finisher），默认仅缺失时释放、不覆盖修改。见 内置技能与示例。
- 跨插件对接示例 — QI 物品 handler / NI 命令桥 / MM 真实表现 / QC·MMOCore 职业层，释放到
integrations/。 - 等级成长 levels — 按等级覆盖冷却 / 消耗 / params，参数透传 MM。
- 脚本出口 —
pre_js拦截、post_js副作用（复用 QCL GraalJS）。
🚧 已知边界 / 计划
| 项 | 现状 |
|---|---|
| 法力 / 耐力资源池 | resource.mana 等为临时占位，将来归 QinhClass(QC) 接管 |
| GUI | qinhskills.gui 权限存在，但 GUI 为内部 / 预留，未绑定命令 |
| 事件链 CI | 内部回归测试，未对外开放命令（/qs test、/qs gen 不可用） |