用途 Tool Output Awareness 是一项操作层面的防护规则,用于处理《上古卷轴5》构建中由工具生成、而非人工编写的记录与资源。Reqtificator、ParallaxGen、DynDOLOD、Synthesis、TexGen、xLODGen 和 NPC Plugin Chooser 2 都会生成插件以及网格/贴图,用户每次重跑工具都会覆盖这些输出。该技能改变的是处理加载顺序胜者、冲突提取和补丁编写时的方式,防止把生成数据冻结进手写补丁。
核心规则 规则分两部分,同时适用于记录层(xEdit/插件记录)和文件层(模组文件夹中的松散网格与贴图):绝不把工具输出的变更复制进自己创建的补丁,包括其记录、计算字段值或对生成路径的重新指向;即使调试时也如此。除调试外,也不应以工具输出作为工作基础。创建补丁、制作新模组或研究模组工作原理时,应越过生成覆盖,查看下方真实作者记录。原因是工具输出位于作者加载顺序之上或由其重新生成,生成器再次运行会重新派生结果;应针对喂给生成器的源进行编写,让生成器重新生成,不冻结任何派生内容。
识别工具输出 按可靠性顺序识别:第一,固定插件文件名,如 Reqtificator 的 Requiem for the Indifferent.esp、ParallaxGen 的 PGPatcher.esp 与 PG_1.esp、DynDOLOD 的 DynDOLOD.esm、DynDOLOD.esp、Occlusion.esp。第二,生成标记文件,如 NPC Plugin Chooser 2 输出文件夹中的 NPC_Token.json,ParallaxGen 输出文件夹中的 ParallaxGen_Diff.json。第三,生成输出文件夹,需排除误报:Synthesis 输出模组中的所有插件均视为生成;TexGen 输出文件夹名含 texgen,仅贴图;xLODGen 输出文件夹名含 xlodgen,网格加贴图。
误报排除 仅文件夹名携带工具名的资源、修复、附加或补丁模组(如 DynDOLOD 3 Resources、DynDOLOD DLL NG and Scripts、DynDOLOD TexGen Fixes、DynDOLOD Add-On、下载的 xEdit-Synthesis Patch)是工具输入而非输出,应按普通模组打补丁。拥有 Nexus mod id 或下载来源并不代表不是工具输出,因为模组列表常预生成并重新分发这些输出;应依据固定插件名和标记文件判断。
编写与调试的区分 读写前先问:是在调试游戏内问题,还是在编写内容?调试崩溃、视觉错误、属性错误、黑脸、LOD 接缝、紫色网格时,工具输出是合法甚至首要嫌疑,可自由读取;但仍须遵守规则一,不把修正数据烘焙进手写补丁,而应修复源模组或工具配置并让用户重跑工具;若确需独立覆盖,应明确说明每次重新生成后必须重新应用或重跑工具。编写内容时,把工具输出视为透明,不以其为基础,不转发其数据。
针对源打补丁 当需打补丁的记录在加载顺序中的胜者是工具输出时,不要基于该胜者构建。使用冲突树读取(如 housecarl_read_record 或 housecarl_batch_record_detail 带 conflict_tree: true,或 housecarl_cross_plugin_query),标记工具输出覆盖,基于最高的非工具输出覆盖(真实作者胜者)及其 masters 编写修改(housecarl_set_field、housecarl_bulk_apply、housecarl_create_record),最后重跑生成器。Requiem 是典型例子:Requiem for the Indifferent.esp 是 Reqtificator 的合并输出,只可读取以了解目标值,补丁应针对源记录编写,再重跑 Reqtificator。
资源层同样规则 ParallaxGen、TexGen、xLODGen、DynDOLOD 和 NPC Plugin Chooser 2 也会重新生成网格与贴图。对 housecarl_place_asset、housecarl_bulk_place_asset、housecarl_asset_status 及 NIF 路径工作同样适用:不把生成资源当作复制或转发来源;不把记录重新指向生成资源路径(ParallaxGen 每次运行会重新分配路径);应修复原始模组中的源资源或工具设置,再重跑工具。调试生成资源时可读取诊断,但修复应落到源。
模组列表特定重命名 列表会重命名和重新包装生成器输出。三个按文件夹命名的工具允许用户自选名称,列表可能把 Reqtificator 结果折入自定义命名的逐模组补丁,或任意命名 NPC Chooser 输出。原则固定:携带生成器派生数据的插件即为该数据的工具输出,无论名称如何;具体名称属于模组列表属性,应从其 CLAUDE.md 或项目记忆中学习,不要在此硬编码。若插件看起来携带生成数据但无法按上述信号确认,应说明并询问。
常见错误 未检查胜者是什么就转发加载顺序胜者(最高频错误);读取工具输出以了解模组工作原理;对 Synthesis 依赖插件名识别;把 Resources/Fixes/Add-On 模组当作工具输出;用 Nexus id 排除工具输出状态;把生成资源烘焙进补丁或新模组来修复。
发布补丁前自检 检查每个记录的数据是否源自工具输出,若是则重新基于真实作者记录并确认生成器下次会重新应用;检查是否有字段持有生成路径(如 ParallaxGen 网格/贴图路径、DynDOLOD 注入引用),若有则移除并修复源后重新生成;检查补丁是否把工具输出插件加为 master(如 Requiem for the Indifferent.esp、DynDOLOD.esp),这是转发了派生数据的强信号,应重新基于源 master。
示例 某岩石 STAT 在 PGPatcher.esp(ParallaxGen)中胜出,其模型路径被改写为生成视差网格。要打材质/关键字补丁时,错误做法是转发 PGPatcher.esp 胜者并保留生成网格路径,下次 ParallaxGen 运行会生成不同路径导致链接失效;正确做法是拉取 conflict_tree: true,看到 PGPatcher.esp 在上、真实作者 STAT 在下,针对源记录修改关键字,保留模型路径不动,最后重跑 ParallaxGen 作为构建步骤。
备注 调试例外仅关于读取而非修复:工具输出可能是原因,可检查,但修复仍落在源/配置加重生成,绝不以冻结输出形式进入补丁。该防护规则与 facegen-diagnostics 组合使用,资源层修复(如黑脸 NPC 合并 facegen)应路由到源而非冻结补丁。实践中见过的生成标记文件 NPC_Token.json 和 ParallaxGen_Diff.json 是插件名不明确时最稳健的文件夹级信号。