SuperAPI AI 工具集

skyrim-container-distribution

编程与开发

查看项目

更新于 10-30 16:19

技能介绍

用途

该技能面向《上古卷轴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 清单与框架日志。
  • 关于收费、价格、平台、效果等更多信息暂未提供。