SpellBook Abridged - 夜月修复版

插件说明

巫妖王之怒版本更新说明

由于暴雪在原生界面中新增了法术等级过滤功能，本插件已移除该功能模块。同时，插件已启动基础本地化工作（开发中），并修复了法术自动升级功能。

燃烧的远征版本更新说明

我已完成基础测试，在燃烧的远征怀旧服（BCC）当前版本中，未发现《法术书精简》（Spellbook Abridged）插件存在任何错误。v2.6.4a 版本更新仅修改了 TOC 文件，确保插件在燃烧的远征怀旧服中被识别为最新版本。

v2.6.4a 测试版（Beta）与上述版本功能完全一致，唯一区别是战斗期间不会锁定法术书。原版在战斗中锁定法术书的原因是，游戏的污染机制会阻止战斗中的部分界面更新操作，进而导致报错。

重要通知：我已退出《魔兽世界》，且无意以任何理由回归。此后，插件的维护工作将由 Artscout375 接手。

序章：我为何制作此插件？

本插件专为《魔兽世界》经典怀旧服与燃烧的远征怀旧服设计，在《魔兽世界》正式服中完全无用。

我仍记得 “巫妖王之怒” 版本之前的日子 —— 当时我玩的法师，法术书里寥寥几个核心法术的所有等级占了好几页。仅火焰法术分类就占了约 6 页，而其中独特的法术不过 5 个。随着经典怀旧服上线，翻找法术书的烦恼也再度袭来。若经典怀旧服后续更新至巫妖王之怒版本，本插件将再次变得过时。

据我回忆，在经典旧世与燃烧的远征时代，总计仅有 2 款插件尝试修改游戏原生法术书，且前一款的生命周期十分短暂。在数百万玩家与数千款改善游戏体验的插件中，我几乎是唯一为优化法术书整理体验而开发相关功能的人。这一现状也从侧面反映出，暴雪在为第三方插件提供功能支持的 UI 层面上，几乎毫无作为。

插件功能介绍

1. 等级过滤（Rank Filter）

本插件为法术书新增 **“等级过滤”选项。勾选该复选框后，你可以在显示全部法术与仅显示最高等级法术 ** 之间切换。

2. 法术自动升级（Auto Up-Rank Spells）

插件同时内置了基础的自动升级功能。当你学会某一法术的更高等级时，该功能会自动将你动作条上所有对应法术的上一等级替换为最新等级。

示例：当你学会 “火球术等级 5” 后，动作条上所有的 “火球术等级 4” 都会被替换为 “火球术等级 5”，而等级 1、2、3 的火球术则不会被改动。

该自动升级功能不影响宏命令，且仅在学习新法术时触发。我设计的是基础版功能，初衷只是解决自己常忘记更新低等级法术的问题。我的设计逻辑是：若某一低等级法术被保留在动作条上，且其等级低于你已掌握的最高等级，则默认是你刻意保留（例如用于控蓝）。

3. 皮肤插件适配：按钮位置自定义（Relocate Toggle Buttons for Skinning Addons）

若你不满意 “等级过滤” 与 “自动升级” 按钮的默认位置，可通过 「Ctrl + 鼠标右键」 拖动任意按钮进行位置调整。

如需重置按钮位置，输入斜杠命令 /sba 即可。

按钮的启用状态会在游戏关闭时自动保存，因此若你不需要自动升级功能，可直接永久禁用。

4. 基于当前姿态的限定法术高亮（Highlighting Stance Limited Spells Based on Current Stance）

针对战士、德鲁伊（以及同理适用的潜行者），插件新增了一项功能：检测法术是否需要特定变形形态或姿态，并根据你当前是否处于该形态 / 姿态，改变法术名称的颜色。

注意：该功能仅对法术提示框（tooltip）中明确标注 “需要特定变形形态 / 姿态” 的法术生效。

由于我无法确定适合的高亮颜色方案，插件已添加颜色自定义选项。你可通过法术书底部新增的 **「选项」标签页 ** 进行设置：

• 普通：提示框中未标注形态 / 姿态要求的法术，显示默认颜色。
• 处于形态 / 姿态时：需要特定形态 / 姿态，且当前已满足条件的法术，显示自定义颜色。
• 未处于形态 / 姿态时：需要特定形态 / 姿态，但当前未满足条件的法术，显示自定义颜色。
• 该功能默认处于禁用状态，你只需在选项标签页中勾选所需的高亮选项即可启用。所有设置均按角色独立保存。

插件局限性

由于《魔兽世界》的 UI 机制会限制第三方插件对游戏进行过多自动化操作，要让本插件在战斗期间正常工作，难度极大且流程复杂。本插件仅修改原生法术书，而非完全替换，这一设计旨在最大程度减少与其他插件的兼容性问题。

战斗期间的核心问题是：法术书页面可以翻页，但法术按钮的交互功能无法同步更新，进而会产生部分报错。游戏 UI 在战斗中对动作按钮功能的修改极为敏感，目前最接近可行的解决方案，会对插件间的兼容性造成灾难性影响。

为解决战斗中的报错问题，我设计了战斗期间锁定法术书的机制。这是符合《魔兽世界》常规插件开发规范的最合理方案。

v2.6.4a 测试版（Beta）与 v2.6.4、v2.6.4a 功能完全一致，唯一例外是移除了战斗锁定机制，该版本是应特殊需求开发。

在姿态限定法术高亮功能上，插件通过解析法术提示框中的描述文本，检索关键词来判断每个法术的姿态限制。若该功能失效，意味着我需要重新设计检测逻辑，届时需向我提供具体的职业与法术名称。

需要特别说明的是：若姿态限制仅在姿态的提示框中说明，而非在法术的提示框中标注，本插件将无法检测到该限制。