用途
该技能面向《上古卷轴5:天际》模组开发中需要编写或校验 Container Distribution Framework(CDF)JSON 规则的场景。其核心目标是帮助作者正确使用 CDF 的 JSON 语法,并明确区分 CDF 与其他容器/物品分发框架,避免因语法混用导致规则失效。
主要能力
- 识别并区分多个分发框架的典型契约:
- Container Distribution Framework / Dynamic Container Inventory Framework:SKSE 插件目录下的 JSON 规则。
- Container Item Distributor:
_CID.ini。 - SPID:
_DISTR.ini与 actor distribution。 - FormList Manipulator:
_FLM.ini或Data\FLM。 - Inventory Injector:其自身安装版本的配置。
- 锁定 CDF JSON 上游源码提交:
SeaSparrowOG/DynamicContainerInventoryFramework,提交38ca39282e24ed8f7f8423f106d0a660689673c6。 - 说明解析器读取路径:
Data\SKSE\Plugins\ContainerDistributionFramework\。 - 说明 JSON 结构:根对象包含
rules数组;每条规则需要string friendlyName、可选conditions、数组changes。 - 说明每个 change 的字段约束:
add必须是精确 form 字符串数组;remove必须是一个精确 form 字符串;removeByKeywords必须是精确 keyword 字符串数组;count存在时必须是无符号整数。
- 强调解析器不会将
*Claw、*Maul、*Katana等字符串展开为通配符搜索;每个add字符串都按 form 解析,一个未解析元素会导致该 change 条目被跳过。 - 依赖规则:使用
conditions.plugins使规则依赖已安装插件;缺失插件条件会跳过该规则,而不是导致框架级崩溃。 - 建议在按 keyword、EditorID 模式或记录类别选择大量武器时,先构建中间清单,再解析为精确 form。
- 明确 FLM 区别:FLM 有
*FormList、#Group、#Collection等有效特殊语法,但这不授权在 CDF JSON 中使用这些前缀;FLM 集合依赖精确 keyword 和预期的 KID/po3 Tweaks 排序。
使用方式
校验时运行:
scripts\lint_cdf_json.py <file-or-directory>
当可用时,通过 --forms 提供已部署的 form 清单。静态 schema 检查不能证明 EditorID 或插件限定 FormID 能够解析。测试后应检查框架日志。
适用场景
- 为 CDF 编写新的容器分发 JSON 规则。
- 校验已有 CDF JSON 是否符合字段与解析约束。
- 排查规则未生效问题,尤其是通配符误用、form 未解析、插件条件缺失等情况。
- 在 CDF、CID、SPID、FLM、Inventory Injector 之间做语法区分,避免跨框架迁移时带入不兼容写法。
限制
- 该技能锁定特定上游提交,其他版本行为可能不同。
- 解析器不展开通配符;
*Claw、*Maul、*Katana等不会被当作搜索模式。 - 每个 add/remove/keyword form 都必须针对已部署插件集解析;未解析元素会导致对应 change 条目被跳过。
- 不要使用文件名片段或美学类别名作为 form 选择器,除非已安装框架明确实现。
- 静态 schema 检查不能证明 EditorID 或插件限定 FormID 可解析,需要结合 form 清单与框架日志。
- 关于收费、价格、平台、效果等更多信息暂未提供。