SkyPatcher Authoring 是一个用于编写、修复、解释和审查 SkyPatcher INI 运行时记录编辑与过滤器的技能。SkyPatcher 是一个 SKSE 插件,它通过纯文本 INI 文件在运行时编辑 Bethesda 记录,编辑本身不会生成 ESP/ESL。该技能的核心是一个补丁编写流程,并内置参考查询步骤,遵循“先查参考、绝不臆造”的原则:因为编造一个 SkyPatcher 令牌会静默失败。
用途与范围:本技能组合正确的 SkyPatcher 补丁字符串,并放置 INI 文件;所有过滤器、操作、值和示例均取自自带的语法参考 references/。它可回答某记录支持哪些过滤器与操作、有哪些合法转换类型等查询;只查参考、不写补丁也可以。范围边界:记录字段模式(如 WEAP 记录在 Mutagen/xEdit 层面的字段、类型、可写性)属于 mutagen-reference 技能;SPID(forms→NPCs)、KID(keywords→items)、CID(items→containers)是独立 INI 框架,语法与文件位置不同,负责分发而非编辑记录,若用户提及 SPID/KID/CID 或要求“分发”而非“编辑/补丁”,则不属于本技能。
主要能力与使用方式:编写或修复补丁前先打开语法参考:通过 references/index.jsonl 按名称、签名(xEdit 签名)、主过滤器、子文件夹或别名查找记录类型;阅读 references/grammar-core.md 了解共享语法(补丁字符串结构、Plugin|FormID 与 EditorID、过滤器系统、操作约定、文件放置、冲突解决);阅读匹配的 references/records/<type>.md 了解该类型的特定过滤器、操作、标志和示例;共享枚举(转换类型、actor 值、双足槽索引、原型、灵魂类型)在 references/value-tables.md。工作流包括:从用户目标识别记录类型;查语法;按 filter(s):operation(s) 组合补丁字符串;将 INI 放在 Data/SKSE/Plugins/SkyPatcher/<subfolder>/<file>.ini,其中子文件夹来自索引;以 SomePlugin.esp.ini 命名可按插件加载顺序自动门控,或使用普通名称始终加载;插件命名的 INI 应放在模组专用子文件夹,以免被模组管理器覆盖同名文件。最后通过阅读器验证:housecarl_skypatcher_read 检查目标记录的计算后状态是否按预期应用;housecarl_skypatcher_layer 做文件级检查(是否 APPLIED、应用顺序、同字段冲突、三类 ITM:文件内死写入、跨 INI 重复、无操作写入)。通过两项检查即表示已按实际语法和加载顺序验证,无需启动游戏。
适用场景:为武器加增益、调整药水、给容器添加战利品等 SkyPatcher 记录编辑;审查用户已有补丁;解释某个过滤或操作是否受支持。限制与注意事项:参考语料覆盖 27 种有文档的记录类型;对象修改(OMOD)在 SkyPatcher 中已启用但无文档、无已验证语法,应指出缺口而非猜测 OMOD 语法。参考语料基于 SkyPatcher 官方 Nexus 文档 v6.4.1,而 SkyPatcher 在 Nexus 上截至 2026-10-10 为 7.1.3,跨越一个大版本:应将每项操作视为仅经 6.4.1 验证,编写前检查用户安装版本及其文章,待 7.x 文章可用时重新推导语料。常见错误包括子文件夹放错、按类比臆造过滤器或操作、FormID 截断或错误、忘记玩家例外(种族和关键字过滤器始终排除玩家)、在仅支持 FormID 的操作上使用 EditorID、把 SkyPatcher 当成分发框架。冲突模型方面,同字段设置操作仍按文件名顺序解决(0→z),只有添加/移除操作真正累积;housecarl_skypatcher_layer 会报告整个加载顺序中的同字段设置冲突并指出胜者,housecarl_skypatcher_read 显示单条记录的解析后终态。