用途
本技能用于在阅读或编写 Papyrus 脚本时,离线核验函数签名、参数形状、返回类型、标志以及文档注释。它聚焦 API 表面——函数签名与文档;从 modlist 读取实际的 .psc 源码、以及把 .psc 编译为 .pex,属于另外的工作,使用常规文件阅读与编译工具处理。
主要能力
- 离线查询 Papyrus 函数、事件、属性与结构成员的条目。
- 参考资料语料由 BellCube 的 papyrus-index 生成,并随技能以 references/ 目录分发。
- 索引位于 references/index.jsonl,采用 JSONL 格式,每行一个紧凑 JSON 条目(冒号后无空格)。
- 每个条目包含 name、qualified、source、file、kind、line_start、line_end;仅 Tier 2 条目包含 requires_plugin。
- 提供分级策略:Tier 1 为原版与 SKSE 基础脚本,始终可用;Tier 2 为受 modlist 内容约束的 SKSE 插件源码(约 45 个流行插件),需确认对应插件已启用;Tier 3 为《辐射4》与《星空》源码,未收录。
- 附带人工整理的 references/silent-biters.md,记录签名正确但运行期可能出问题的陷阱,例如 GetForm 对整个 ESL 范围返回 None、SendModEvent 的四参数处理器元数、FormList.HasForm 缺少 base-NPC_ 条目、混合存储后端、暂停菜单中的 Utility.Wait、字面量与文档字符串转义、常见名词类型冲突等。该文件独立于自动生成的签名语料,不会被索引查找解析。
使用方式
- 从调用点识别不带限定的函数名,例如 Self.GetActorValue("Health") 中的 GetActorValue,StringUtil.Substring(str, 0, 4) 中的 Substring。
- 在 references/index.jsonl 中查找。索引为紧凑 JSON,需匹配完整带引号的标记,如 "name":"GetActorValue";带空格的模式或缺少前引号的模式会匹配零行,造成与真实缺失无法区分的假阴性。若预期命中的查找返回空,先用确定存在的标记(如 "name":"OnInit")验证模式本身。
- 结果有三种形态:单一匹配,取条目的 file、line_start、line_end,确认签名、标志与文档注释;跨来源多重匹配,用调用点的来源限定符消歧,脚本体内的未限定调用依据调用脚本的 extends 链解析,全局调用以 Script.Function 限定符为准;索引中无匹配,进入“未收录即警告”流程。
- 只读取 line_start 到 line_end 的条目块(通常函数为 8–30 行),不要整文件加载。约 51% 的函数带文档注释,其余仅有签名,属正常情况。
- 事件、属性与结构成员同样通过索引处理,kind 字段区分 global、instance-method、event、property;事件位于 ## Events,属性位于 ## Properties,结构位于 ## Structs。
未收录时的处理
当索引中找不到所需函数时,应向用户发出明确警告:该函数不在随附语料中,且不会臆造签名。建议用户核对函数名拼写、确认函数是否位于未收录的 SKSE 插件中、通过 Creation Kit 或 Papyrus 模组社区及模组随附源码调查、按本技能的索引与块结构自建参考文件,或在该调用并非当前任务关键路径时跳过。不得臆造签名:错误但表述自信的签名可能导致代码编译通过但运行期行为异常,或被误报为上游缺陷。
适用场景
- 编写 .psc 时核对某个函数或事件的精确参数类型、默认值、返回类型与标志。
- 阅读现有 Papyrus 代码时确认 API 语义。
- 判断某函数是否依赖特定 SKSE 插件,并据此确认用户当前加载顺序中是否包含提供该函数的插件。
限制
- 不负责读取 modlist 中的实际 .psc 源码,也不负责编译 .pex。
- Tier 3 的《辐射4》与《星空》源码未包含在语料中。
- 新增或小众插件可能未被收录。
- 语料更新需从上游重新生成并刷新 references/ 与 index.jsonl;silent-biters.md 为人工维护,需在重新生成时保留。
- 事件由引擎调用而非用户调用,不应把事件当作可主动调用的函数。
- 索引条目的 file 字段为权威来源,若用户指定了不同文件,应先调查差异。