现实主义数值生成器快速入门（v3.15）

<NolebasePageProperties />

3 步完成一次生成

第 1 步：准备输入

将要处理的 JSON 放入 input/，支持子目录。

当前支持的输入格式：

• CURRENT_PATCH
• STANDARD
• CLONE
• ITEMTOCLONE
• VIR
• TEMPLATE_ID

第 2 步：运行生成器

Windows 直接双击：

• 现实主义数值生成器.bat

或命令行运行：

.\.venv\Scripts\python.exe generate_realism_patch.py

第 3 步：查看输出

结果写入 output/，并保持与 input/ 相同的目录结构。

命名规则：

• 默认：原文件名_realism_patch.json
• 当某输入文件内 CURRENT_PATCH 占比大于 50%：输出保持原名 原文件名.json

示例：

• 输入：input/attatchments/ScopeTemplates.json
• 常规输出：output/attatchments/ScopeTemplates_realism_patch.json
• CURRENT_PATCH 占多数时：output/attatchments/ScopeTemplates.json

可选第 4 步：做一次快速审计

.\.venv\Scripts\python.exe audit_output_rule_violations.py

默认报告输出到 audit_reports/output_rule_audit.json。

补充说明：

• consumable/cosmetic 不作为规则审计重点
• mod_profile_unresolved 类附件不会计入“未能校验附件范围”结果

运行后你应看到什么

控制台通常会输出：

• 模板加载进度
• 输入文件处理进度
• 跳过原因（模板缺失、格式不可识别、字段不足）
• 分类统计（武器、配件、子弹、装备、消耗品）
• 各源文件导出路径

30 秒自检清单

1. output/ 已刷新，旧文件已清理。
2. 关键输入文件都对应有输出文件。
3. 输出 JSON 能正常打开且结构完整。
4. 目标字段落在预期规则区间内。
5. 需要时已生成审计报告。

想改数值风格，先改哪里

优先改以下 4 个规则文件：

• weapon_rule_ranges.py
• weapon_refinement_rules.py
• attachment_rule_ranges.py
• ammo_rule_ranges.py

如果要改 parentId 映射、默认模板或字符串类型映射，再看 generator_static_data.py。

常见问题

Q：为什么有些文件名带 _realism_patch，有些没有？ A：当前输出策略固定如此。某源文件内 CURRENT_PATCH 占多数时，会按原文件名输出。

Q：终端提示“跳过某物品”怎么办？ A：先看提示原因。最常见的是模板缺失、格式不匹配或关键字段不足。

Q：如何确认名称回填逻辑没坏？ A：可以运行：

.\.venv\Scripts\python.exe -m unittest tests.test_name_extraction

下一步

1. 先用 1 到 2 个小样本验证规则修改。
2. 通过审计脚本检查越界项和未命中项。
3. 确认无误后再处理完整输入集。

贡献者

<NolebaseGitContributors />

文件历史

<NolebaseGitChangelog />