1.1 启动与环境切换

法术助手通过您点击的入口智能识别并加载您所需的规则版本：

• 经典五版（5E）： 基于 2014 年《玩家手册》等核心规则的法术数据。界面呈现经典的深红色调。
• 全新五版（5R）： 基于 2024 年最新修订版规则的法术数据。界面呈现华丽的深金色调。

操作： 您可以通过主菜单的 [⚙️ 设置] -> [🔮 切换版本] 随时在两个版本之间切换。

1.2 界面布局概览

整个工作台主要分为两大区域，并针对不同设备进行了专门优化。

桌面端（PC）：

• 顶部控制栏：包含页面切换、全局搜索、一键重置、来源筛选和设置菜单。采用左右双栏布局。
• 左侧（法术库）：浏览、搜索和筛选所有可用法术的区域。
• 右侧（已选法术）：您组建的冒险队伍（或单个角色）当前所拥有的法术列表，也是进行法术位管理的区域。

移动端（手机/平板）：

• 顶部控制栏：精简为单行，来源筛选和重置按钮紧邻搜索框。右上角有一个齿轮图标(⚙️)，点击可展开设置菜单。
• 中部 Tab 栏：通过点击中部的 [法术库] 和 [已选法术] 按钮，在两个核心区域间无缝切换。

1.3 你的第一个法术

• 搜索法术：在顶部的搜索框中输入法术名称或关键词，例如输入 “火球” 或 “hq”。
• 筛选（可选）：点击搜索框上方的 [职业]、[环阶] 等按钮，勾选您角色的特质。例如，选择 “法师” 和 “3环”。
• 添加法术：在下方结果中，找到 “火球术”，点击其卡片右下角的 + 添加 按钮。
• 查看结果：切换至右侧（手机端点击中间偏上的 Tab）的 “已选法术” 面板，您会发现 “火球术” 已被成功添加。

第二章：法术库（浏览与搜索）

法术库包含了当前环境中所有可用的法术。我们提供了极其强大的筛选与阅览机制。它会根据您当前的筛选条件、搜索词和配置的来源扩展包，动态展示所有符合要求的法术。

2.1 视图模式切换

在法术库标题栏右侧（PC端）或导航右侧（移动端），您可以切换不同的视图：

• ⊞ 卡片模式： 默认模式，提供最佳的视觉质感与沉浸感。
• ≡ 表格模式： 极高的数据密度，适合快速查阅与横向对比。
• 〣 完整模式： 卡片单列全宽显示，适合长篇法术的精读。在手机端因为和卡片模式的体验相似，已隐藏该模式。

2.2 多维筛选器

顶部的按钮提供了多维度筛选，支持多选，所有筛选条件自动取交集：

• 职业 / 环阶 / 学派： 勾选后，仅显示符合条件的法术。
• 来源（DLC 扩展包）： 极其重要！控制着法术的可见性。若您正在跑特定的模组（如《塔莎的万事坩埚》），请务必在此处勾选对应的来源。如果您发现许多法术莫名消失，请检查此处的勾选状态。导入新存档后，系统也仅默认勾选该存档中包含的来源。
• 特殊筛选（三态逻辑）： 针对成分 (V/S/M)、施法时间、持续时间等特殊条件，我们引入了高级的“三态选项”：
  • [-] 灰色：忽略该条件（不作为筛选标准）。
  • [✓] 绿色：必须包含该属性。
  • [✗] 红色：必须排除该属性。

可筛选的特殊条件包括：

• 成分：言语 (V)、姿势 (S)、材料 (M)
• 施法时间：动作、附赠动作、反应、长时间施展
• 持续时间：立即、专注、非专注长时间
• 是否仪式：仪式

2.3 可视化高级搜索

搜索框不仅支持中文、拼音首字母、容错模糊匹配，还支持强大的组合指令（输入指令后敲击空格生成独立标签）：

• 普通词：默认匹配法术名称。
• all：生成 [🔍 全字段] 标签，将搜索范围扩大至法术的详细描述内容中。
• note：生成 [📝 仅备注] 标签，仅在您自己编写的法术备注中搜索。
• -关键词：生成 [🚫 排除] 标签，过滤掉名称包含该词汇的法术（例如输入 -火 按空格），可以排除掉全部名称里带火的法术。

2.4 法术详情弹窗与描述交互

点击任何法术名称，均可唤出详情弹窗：

• 关键词链接： 描述中出现的其他法术名称（带有下划线）可直接点击跳转。
• 掷骰模拟： 描述中带有涉及到骰子的伤害公式（如 8d6 或 2d6 + 4 或 1d8 + 1d6 等）可直接点击。系统将自动模拟掷骰过程并弹出完全随机的计算结果与明细。您可以在此窗口内点击 “再掷一次” 来反复投掷，快速获取优势/劣势修正。
• 伤害类型标签： 文本中的伤害类型（如火焰伤害、暗蚀伤害）会被自动标记为带有表情和颜色边框的专属徽章。
• 添加/移除：您可以从弹窗底部直接点击 + 添加 按钮，将法术添加到队伍，或是再次点击 ✓ 已添加 按钮，将已选法术移除。

第三章：已选法术（队伍管理）

这是您的 “已知法术清单” 或 “准备法术清单”。

3.1 面板介绍与视图切换

在表格模式下，点击表头（如 “名称”、“环阶”、“距离”）即可对列表进行升序 ↑ 或降序 ↓ 排列，助您快速规划。

• 标题栏：显示当前法术数量。右侧提供 ↩ 撤销、🖨️ 打印（仅限PC）和 🗑 清空 功能。
• 视图切换：与法术库类似，PC端可以通过标题栏的 ≡、〣、⊞ 按钮，独立切换已选法术列表的视图模式。移动端则通过顶部的切换按钮，同时改变法术库和已选法术的视图。

3.2 焦点置顶（图钉）

点击法术卡片或表格行的 [📌] 按钮，该法术会被置顶并高亮显示（卡片边框发光）。这非常适合用来标记 “核心输出” 或 “救命法术”。

3.3 个性化备注

每个加入队伍的法术都带有一个输入框：

• 您可以输入诸如 豁免DC 15 或 仅限对亡灵使用 的个人笔记。
• 内容会自动实时保存，并在搜索时可通过 note 指令被检索。

3.4 队伍操作

• 移除： 点击右上角的 × （或移动端表格左侧的 🗑️），将法术移出清单。
• 撤销： 不小心删错了？点击区域右上角的 [↩ 撤销]，系统保留了您最近 10 次的操作历史记录。
• 清空： 点击 [🗑 清空] 可一键释放当前页面所有记忆的法术。

3.5 移动端特殊交互

• 表格首列模式切换：在手机端的“已选法术” 的表格视图下，由于屏幕非常窄，第一列操作按钮在 “置顶”📌 和 “删除”🗑️ 之间只能二选一。点击第一列表头的 [📌/🗑️] 按钮即可在其间切换。

第四章：法术位管理

告别纸笔涂改！法术助手内置了完备的法术位追踪系统。

4.1 法术位概览栏

在 “已选法术” 面板的标题下方，有一个显眼的横条，即 法术位区域。

• 它会集中展示您已设置了上限的环阶法术位，格式为 ① 1/4（表示1环法术位，当前剩余1，最大为4）。
• 点击此横条，会打开详细的管理弹窗。

4.2 设置法术位上限

• 在已选法术区顶部找到法术位概览栏，点击进入法术位管理弹窗。
• 点击右上角 [⚙️ 设置上限] 进入编辑模式。
• 此时，每个环阶旁边会出现 [ - ] 上限数值 [ + ] 的控件。点击加减号，设定该环阶的最大法术位数量。
• 点击 [✅ 完成设置] 保存。

4.3 追踪消耗

在冒险中，当您施放了一个法术，只需在法术位弹窗中点击对应环阶的 - 扣除消耗。当法术位耗尽时，界面会发出醒目的红色 0/X 警告。

4.4 营地长休

经过一夜的酣睡，点击法术位弹窗底部的 [🏕️ 长休（全部恢复）] 绿色按钮，在确认后，所有的法术位将瞬间补满。

第五章：页面管理（多法术表）

如果您是 DM，需要管理多个角色、怪物，或者您是一位兼职施法者（如法师/牧师），页面管理是非常好用的。

• 创建与切换： 顶部标题旁的栏位允许您创建多个独立的法术表。点击标签即可无缝切换。
• 独立数据： 每个法术表的筛选条件、搜索词、已选列表、使用的来源拓展包和法术位配置都是完全独立的。切换回一个页面时，您上次离开时的状态会被完美恢复。
• 管理页面：
  • 点击 + 新建法术表。
  • 点击 ✎ 重命名当前表（例如改为 “探索用”、“战斗用” 或 “角色：甘道夫”）。
  • 点击 - 删除当前表（至少需保留 2 个）。删除前，如果该页有已选法术，系统会要求您确认。

第六章：数据备份与恢复

心血不容丢失，我们提供了纯本地化的跨设备数据备份方案。

6.1 导出存档

• 点击右上角 [⚙️ 设置] -> [💾 备份与恢复]。
• 界面会生成一串高密度加密的文本存档码，包含：您当前所使用的大环境（5e / 5r），所有的法术表、每一张法术表的已选法术、备注笔记、法术位数据、所使用的来源拓展包等。
• 点击 [📄 一键全选存档码] 复制，保存到微信、备忘录或发送给跑团群友。

6.2 导入与数据合并

拿到存档码后，在同样的窗口执行操作：

• 点击 [📋 一键粘贴] 将代码放入输入框。
• 点击 [🔍 预览数据]，系统会解析存档码，并清晰展示其中包含了几个法术表，以及每个表中存有哪些法术。

您将面临两个选择：

• [➕ 追加导入]： 不影响您现有的数据，将导入的法术表作为新标签页接在末尾（推荐）。如果追加后总页数超过 99，追加按钮将不可用。
• [⚠️ 覆盖导入]： 将您现有的全部法术表替换为存档码中的数据。

6.3 跨版本覆盖导入

若您尝试将 5E 存档导入 5R 环境（或反之），系统将弹出跨版本覆盖导入警告。导入过程中，系统会自动执行兼容性检查，丢弃目标规则包中不存在的法术，以避免系统崩溃。若跨版本导入的法术在目标版本数据库中存在对应条目，系统将自动完成匹配。

理论上，由于从 5E 升级至 5R 时，核心法术仅进行了新增与调整，并未删减任何内容，因此将 5R 存档降级导入 5E 环境可能会出现法术丢失；反之，从 5E 升级导入 5R 环境则能完整保留所有法术。扩展包法术在两个版本间保持一一对应关系，导入时不会丢失。尽管我们不建议进行跨版本导入，但该功能确实可以满足玩家在跑团过程中中途升级版本，或是在开团前配置完全部法术才发现用错了规则书的需求。

第七章：设置与其他功能

7.1 沉浸感设置

在 [⚙️ 设置] 下拉菜单中，您可以自由切换：

• 🎲 掷骰功能：开启时，法术描述中的 8d6 等骰子表达式会变为可点击的金色链接。关闭则恢复为纯文本。
• 🩸 伤害Emoji：关闭后，文本中的 “XX伤害” 将不再带有图标和变色渲染。

7.2 打印功能

为满足线下跑团需求，我们内置了功能强大的 A4 纸排版引擎（仅限桌面 PC 端使用）：

• 在已选法术区上方点击 [🖨️ 打印] 按钮。
• 选择卡片尺寸：
  • 扑克牌（A4 纸 3×3 排版）： 适合普通套牌收纳，建议纵向打印。
  • 塔罗牌（A4 纸 2×4 排版）： 适合文本较长的法术，建议横向打印。
  • 明信片（A4 纸 2×2 排版）： 超大尺寸，适合包含长篇描述的法术，建议纵向打印。
• 选择超长文本处理方式：
  • 主副卡延展（推荐）： 自动生成 (1/2) 和 (2/2) 或更多张卡片，拼接展示完整长法术。
  • 极限压缩： 自动缩小字号至极限；若仍无法完整显示，则在文本底部截断。

7.3 版本切换与返回主页

在设置菜单中，您还可以：

• 🔮 切换版本：在两个版本之间自由切换。
• 🏠 返回主页：随时返回主页。

第八章：常见问题与高级技巧

Q1：为什么我搜不到某个法术库里明明有的法术？

排查 1： 请检查顶部的【来源】筛选器。默认情况下可能只勾选了 PHB（玩家手册）。如果该法术属于《塔莎的万事坩埚 (TCE) 》等扩展资料，您必须在来源中勾选对应选项。

排查 2： 请检查特殊筛选项（V, S, M 等）是否被误设为排除状态（红色的 [✗] 标识）。

实用技巧： 注意界面中弹出的提示语 ✦ 已过滤 X 个法术 [清除]，点击 [清除] 按钮可一键重置所有筛选条件，同时保留您输入的搜索关键词。

Q2：如何善用搜索的高级技巧？

当您只记得法术的部分描述时，可以在搜索框敲入：all 强酸 敏捷豁免。这将把所有法术名称和描述正文中包含 “强酸” 和 “敏捷豁免” 的法术全部筛出来。

Q3：为什么打印功能仅支持电脑端使用？

打印功能需要对 A4 纸张进行像素级的精确排版运算。移动设备的浏览器内核常对这些参数进行魔改，会导致打印出的卡片出现边距错乱、文本截断等问题。因此我们限定只可以在电脑端使用打印功能。此外，强烈建议在 PC 的 Chrome 或 Edge 浏览器中先导出为 PDF 文件，再进行打印，可获得最佳效果。

Q4：我的数据存储在哪里？卸载浏览器会导致数据丢失吗？

为保障您的数据安全并提供极致的加载速度与脱机使用体验，法术助手采用全本地 LocalStorage 存储方案。这意味着：

• 我们不会采集、上传或存储您的任何个人数据。
• 您的所有数据仅保存在当前设备的浏览器本地缓存中。

如果您使用了 “清理浏览器缓存 / Cookie” 功能，或者处于 “无痕模式” 下使用本工具，数据将会丢失。卸载浏览器也会清除所有本地存储的数据。请养成定期使用 [备份与恢复] 功能导出存档码的习惯，以防数据意外丢失。

附录：缩写与速查表

A. 规则与来源缩写对照表

B. 职业短称表（表格模式下呈现）

诗（吟游诗人）、牧（牧师）、德（德鲁伊）、帕（圣武士）、侠/软（游侠）、术（术士）、法（法师）、械（奇械师）、邪/锁（邪术师/魔契师）。

C. 高级搜索指令一览

• all +词语 ：也对法术的描述全文搜索
• note +词语 ：仅在笔记中搜索
• - +词语 ：在法术名中排除搜索结果