SuperAPI AI 工具集

skyrim-runtime-log-forensics

测试与质量

查看项目

更新于 10-30 16:18

技能介绍

该技能面向《上古卷轴5:天际》模组运行日志的取证式分析,目标是在不误判字段、DLL、模组或依赖的前提下解释 SKSE、框架、资源、动画和运行时日志。\n\n用途与原则:日志是解析器或运行时的证据,不是自解释的结论。应先识别发出消息的组件,并核对该组件的确切源码或文档,再提出修改建议。\n\n必需工作流:记录游戏运行时、框架/DLL 版本、日志文件名、时间戳以及生成该行的实际部署文件;保留完整诊断行及足够相邻上下文;识别发出消息的解析阶段或子系统;按字段解析受影响配置,不得用整行 grep 判断分隔符;区分语法拒绝、未解析表单或依赖、可选规则跳过、功能禁用、安全钩子中止、确定性冲突胜者、缺失资源与普通信息噪声;在批量编辑前,用已安装源码/文档或匹配的上游源码证明根因;在所属模组的源码/输出中做最小可逆修正,重新部署并比较新日志;不要直接删除或编辑活动 Data,应修复所属模组或生成输出并通过模组管理器重新部署。\n\n高风险解读规则涉及 SPID、原生钩子、Community Shaders、缺失动画、BOS、缺失表单与依赖。例如 SPID 中不支持的 Weapon 表单类型表示分发键不受支持,分发武器或法杖应使用 Item 或通用 Form 键;invalid stoul 参数不足以归咎 Traits 或 Chance,需检查字段位置,如 LevelFilters 值 65/ 的范围端点为空属于格式错误;-D 是有效的 starts-dead 特质排除;Chance 末尾的 ! 如 18! 是有效确定性概率;超过七个管道分隔值段无效;逗号分隔的 TraitFilters 无效,斜杠分隔正确。原生钩子中,地址位于预期可执行文件 .text 段之外只能证明候选钩子目标对该安装无效,不能证明是哪个其他 DLL、重定位、vtable 布局或运行时版本不匹配造成,需模块归属、重定位/vtable 索引、运行时版本、目标字节和段边界才能指名元凶,安全中止优于安装未验证钩子。Community Shaders 中 <Feature>.ini failed to load, feature disabled 表示该功能自身描述符未加载,当前集成架构下描述符位于 Data\Shaders\Features\<FeatureShortName>.ini,预设覆盖无法使未加载功能生效,应检查胜出文件和功能版本。缺失 .hkx 动画不能靠 A-pose 抑制器修复,应解析动画路径到所属行为图和源模组;行为生成器可重新生成支持的行为输出,但不能凭空创造缺失的自定义生物动画。BOS 中按字母序最后的配置赢得冲突,但确定性胜者不证明获胜变换属于受影响的引用/世界空间,应检查具体引用、区段、条件和预期补丁,rotR(x,y,z) 等变换标记必须保持为单一标记。缺失表单与依赖应分类为硬性要求、条件要求、可选集成或过期配置,不得声称缺失可选插件会破坏整个框架,也不得在未知所有者与预期功能前自动删除配置。\n\n使用方式:阅读 references/LOG-CASEBOOK.md,运行 scripts/analyze_runtime_logs.py 做保守首轮分析,然后人工检查每一条报告行。