SuperAPI AI 工具集

papyrus-optimization

编程与开发

查看项目

更新于 10-30 16:19

技能介绍

用途

本技能用于审查和优化《上古卷轴5:天际》的 Papyrus(.psc)脚本,重点关注延迟、轮询、栈压力、存档膨胀、热循环以及可避免的原生调用。它通过阅读脚本源码,对每部分代码进行性能分级,并给出具体修复建议,从而发现签名查询无法看到的性能问题。

主要能力

  • 三级分类:将代码标记为 🔴 损坏、🟡 次优或 🟢 干净。
  • 成本模型:基于“成本 = 运行频率 × 每次运行的潜在/原生工作量”判断严重程度。
  • 触发分析:首先确定代码的触发方式(一次性事件、真实引擎事件或周期性更新),以设定成本乘数。
  • 审查清单:涵盖事件契约、轮询安全、潜在循环、缓存、持久化、清理对称性、热路径负担、工具选择、状态与标志、日志门控及微优化。
  • 症状对照表:提供症状、分级、原因和修复的对应关系。
  • 可辩护结论:要求给出带原因和修复的分类,或明确说明无法判断及需要检查的内容。

使用方式

  1. 阅读脚本源码,确定触发方式。
  2. 按审查清单逐项检查,对每部分代码进行分级。
  3. 根据症状对照表定位问题并给出修复建议。
  4. 在结论中说明触发方式,使严重程度可审计。

适用场景

  • 审查或优化 Papyrus 脚本的性能问题。
  • 识别可能导致游戏冻结、存档膨胀或虚拟机饱和的代码。
  • 发现轮询、热循环、原生调用等性能瓶颈。
  • 与 papyrus-reference 技能配合使用,后者提供函数签名,本技能提供成本与习惯评估。

限制

  • 仅适用于 Papyrus 脚本源码,需要可读的 .psc 文件;若只有 .pex,需先提取并反编译。
  • 严重程度取决于触发频率,需结合上下文判断。
  • 部分基准数据来自社区测量,方向正确但非精确值。
  • 某些行为需确认函数语义,不能凭记忆断言。
  • 不推荐通过修改 INI 来修复脚本问题。