SuperAPI AI 工具集

skyrim-skse-commonlib

编程与开发

查看项目

更新于 10-30 16:20

技能介绍

用途

该技能面向 SKSE 与 CommonLib 生态,用于创建、移植、诊断或优化原生 SKSE DLL 插件,支持 CommonLibSSE 或 CommonLibSSE-NG。其目标运行时可包括 SE、AE、GOG、VR 或明确指定的子集。

主要能力

  • 在编辑前复现当前的配置与构建流程。
  • 固定确切的 CommonLib 分支与提交(仅凭仓库名不足以确定版本)。
  • 优先使用公开事件、消息与 API,而非钩子。
  • 在必须挂钩时,记录调用约定、被覆盖字节、跳板大小、生命周期与运行时覆盖范围。
  • 使用重定位与版本检查,而非原始偏移。
  • 将仅限游戏线程的 API 保持在游戏线程上。
  • 避免在热钩子中进行分配、加锁、文件系统访问与日志记录,除非经过测量。
  • 提供包含插件版本与检测到的运行时的确定性日志。
  • 构建所有受支持的目标,并检查 DLL 的导入/导出。
  • 测试缺失依赖与不支持运行时的失败行为。
  • 以 scripts/build_commonlib.ps1 作为参数化起点,然后遵循项目的预设。

使用方式

所需输入包括:受支持的游戏运行时(SE、AE、GOG、VR 或明确子集);SKSE、Address Library 与 CommonLib 分支/修订版本;CMake 预设、vcpkg 清单、编译器工具集与依赖锁定;钩子位置、重定位策略与预期线程上下文;用于诊断的崩溃日志与符号文件。

工作流要求:先复现配置与构建;固定确切的 CommonLib 分支与提交;优先使用公开事件、消息与 API;挂钩时记录调用约定、被覆盖字节、跳板大小、生命周期与运行时覆盖;使用重定位与版本检查;保持游戏线程 API 在游戏线程;避免热钩子中的重操作;提供确定性日志;构建所有受支持目标并检查 DLL 导入/导出;测试失败行为;使用 scripts/build_commonlib.ps1 作为参数化起点并遵循项目预设。

适用场景

适用于需要创建、移植、诊断或优化 SKSE DLL 插件的开发场景,尤其是涉及 CommonLibSSE 或 CommonLibSSE-NG、CMake、vcpkg、Address Library、钩子与运行时安全的工作。

限制与约束

优化标准要求先测量,报告基线、工作负载、分析或计时方法、变更与回归风险。硬件特定调优必须保留安全回退,且不得声称软件能显式控制 CPU 缓存、SSD DRAM 或 Resizable BAR。

证据标准要求按以下层级处理版本敏感事实:活动项目的 ENVIRONMENT.md、TASK.md、已安装框架版本与构建文件;该确切版本的官方上游文档或源码;用户已安装模组库中的已知良好文件(只读);直接检查相关 ESM、ESP、DLL、脚本、日志或归档。不得用记忆、旧示例或看似合理的 token 替代。在 VALIDATION.md 中记录证据路径或 URL。

证据驱动的原生代码控制要求:针对确切的 CommonLib 分支与检出编译每个审查驱动的变更;保持 DllMain 最小化,将设置 I/O、日志设置、库/API 解析、钩子、UI、SetupAPI 及其他重工作推迟到框架初始化;在移动或版本复制项目后从干净构建目录重新配置;使用镜像游戏根目录与 Data\SKSE\Plugins 依赖布局的运行时形状测试装置;证明钩子范围、句柄所有权、引用生命周期与线程上下文,并在转换后与副作用前重新验证存储的句柄;不得声称直接控制 X3D 缓存、ReBAR、RAM 时序或 SSD 内部,软件只能在测量到的地方检测与适应。

钩子目标所有权门禁要求在安装任何 vtable、调用点或函数钩子之前:解析运行时与重定位/vtable 索引;确定目标地址;查询其所属内存模块;验证预期游戏代码目标位于 SkyrimSE.exe 及其可执行 .text 段内;捕获目标字节与预期函数契约;任何检查失败时安全中止。地址位于预期 .text 段之外只能证明候选目标对预期钩子无效,不能证明某个具名战斗 DLL 先挂钩。可能类别包括运行时不匹配、错误重定位、过时 vtable 索引、对象布局变化、槽位已被修改或由另一模块拥有。

必需失败日志格式:

runtime=<...> relocation_or_vtable=<...> candidate=<...> owner_module=<...> expected_module=SkyrimSE.exe text_range=<start-end> bytes=<...> action=ABORTED

将失败的可选功能禁用作为可逆缓解措施,然后执行模块所有权与隔离测试。不得仅基于模组类别发布罪魁祸首列表。