SuperAPI AI 工具集

spid-authoring

编程与开发

查看项目

更新于 10-30 16:18

技能介绍

用途

SPID Authoring 用于编写、修复、解读或审计 SPID(Spell Perk Item Distributor,作者 powerofthree)的 _DISTR.ini 运行时分发规则,目标对象是《天际》的 NPC。SPID 是一个 SKSE 插件,能够在游戏运行时向 NPC 分发法术、专长、物品、龙吼、关键词、服装、阵营与 AI 包等表单,分发由纯文本 _DISTR.ini 文件驱动。它不写入插件或存档,每次启动都从头重新分发,因此添加或移除 SPID 模组不会留下痕迹。

主要能力

该技能是一个带有参考查询核心的流程型技能,遵循“先查证、不虚构”的原则。它能够:识别要分发的 FormType;确定目标 NPC 并选择对应过滤段;按统一的行语法组合分发行;设置数量、索引与概率;并将文件放置在 Data/ 目录下、以 _DISTR.ini 结尾。SPID 语法在所有 10 种表单类型上形态统一,因此无需按类型分别解析。技能还可通过同一套参考回答单纯查询类问题,例如某个技能对应的索引、某个特质字母代表的含义,或包列表类型有哪些。

使用方式

第一步是打开语法参考。首先阅读 references/grammar-core.md,其中包含行语法(七个竖线分段)、文件发现、分发顺序、FormID/EditorID 形式、输入归一化、过滤组合逻辑、数量/索引与概率;几乎每项任务都需要它。随后按需阅读 references/form-types.md(可分发的 10 类表单、签名与特殊情况,如 FormList 必须为 Packages、动态关键词、无法推断的 SleepOutfit/Skin)、references/filters.md(四类过滤段:字符串、表单、等级、特质,各自匹配对象、修饰符与示例)、references/value-tables.md(技能索引 0–17、特质字母代码、包列表类型、签名、分发顺序与默认值)。references/index.jsonl 是便于 grep 的路由表,每行一个 JSON 条目,可将主题、表单类型、过滤器或数值表映射到文件。建议只读 grammar-core 加一到两个相关主题文件,不要一次性全部加载。

组合分发行的流程为:先确定 FormType(法术→Spell,药水/武器/金币→Item,AI 包→Package,自定义标签→Keyword 可由 SPID 即时创建);通用 Form 会从命名记录推断类型,但 SleepOutfit 与 Skin 必须显式命名。接着确定目标 NPC 并选择过滤段:按名称/EditorID/关键词/种族关键词/模板→字符串过滤(第 1 位);按种族/阵营/职业/战斗风格/声音/已知法术/编辑位置/插件/特定 NPC→表单过滤(第 2 位);按等级或技能→等级过滤(第 3 位,会进入等级分发);按性别/唯一/可召唤/儿童/等级化/队友/死亡→特质过滤(第 4 位)。然后按统一行语法组合:FormType = FormOrEditorID | StringFilters | FormFilters | LevelFilters | TraitFilters | CountOrPackageIndex | Chance;以 EditorID(稳定,优先)或 0x123~Plugin.esp(后缀波浪号)引用表单;每段按位置解析,注意竖线数量,未使用的中间段留空(||)或写 NONE,末尾未用段可省略;同段内为 OR、段间为 AND、排除项(-X)始终为 AND;需要多组并集时对同一表单写多行。最后按需设置 Count/Index/Chance(物品数量或最小-最大范围、从 0 开始的包索引、包列表类型 0–4、0–100 概率,默认 100;在概率后追加 ! 可让结果确定性,对同一 NPC 与存档跨会话保持一致)。文件须放在 Data/<name>_DISTR.ini,_DISTR 后缀为强制要求,缺失则该文件永远不会被读取;文件按字母 A→Z 加载,每个文件自上而下;用 ; 注释行。完成前应确认:FormType 与记录匹配、过滤逻辑符合用户意图(可读作“当(…)AND(…)时给予 X”)、竖线位置正确、文件名以 _DISTR.ini 结尾。

适用场景

适合为 NPC 批量分发法术、专长、物品、关键词、服装、阵营或 AI 包;解读现有 _DISTR.ini 行的含义;审计规则是否正确;以及查询 SPID 的数值表与语法细节。它也提供跨工具路由:当目标不明确时,判断依据是“谁接收改动”——NPC 用 SPID,物品用 KID,容器用 CID,记录自身字段用 SkyPatcher。修改记录自身字段(如武器伤害、NPC 生命、记录上的关键词)属于 SkyPatcher;向物品分发关键词属于 KID;向容器增删物品属于 CID。

限制

参考文档对应 SPID 7.3.0 的完整已发布语法。若某表单类型、过滤器、特质或行为不在参考中,应明确说明而非编造;因为 SPID 的失败是静默的——无法解析的行、未知过滤词或无法解析的表单会被跳过而不报错,日志中也没有线索。如果用户使用的 SPID 版本高于 7.3.0 且询问参考中没有的特性,应提示参考可能滞后。常见错误包括:竖线位置数错、混用 SkyPatcher 的 FormID 形式(SPID 用 0x123~Plugin.esp,SkyPatcher 用 Plugin.esp|0x123)、期望 Form = 推断 SleepOutfit 或 Skin、Package 下的 FormList 含非 Package 项(很可能导致游戏崩溃)、在字符串或表单表达式中混用两个修饰符(仅特质段允许混用)、用错目标工具、忘记 _DISTR 后缀或误以为有按类型的子文件夹、凭类比臆造过滤器(实际只有四个过滤段)。此外,参考资料自 “SPID: The Complete Reference”(Nexus 文章 6617,SPID 7.3.0)重建,并与 MIT 源码交叉核对;版本升级后应重新推导。注释语法 ; 属于所用 INI 库的默认行为,而非 SPID 的专门保证。验证方面提供 scripts/validate_spid.py 离线校验,以及 references 中固定的 7.3.1 语法/解析器权威文档(在 7.3.3 中复核未变)。