用途
Bulk Record Jobs 处理的是“多记录输入、单一结构化交付物输出”的任务，例如：装备目录、制作图谱、冲突调查、整模审计、兼容补丁重建，或返回 JSON 的扇出提取。它把这类任务映射到 houseCARL 工具原语上，并携带二进制格式本身不包含的游戏层约定，同时定义统一的交付物结构，让多个并行代理产出一致 schema。
主要能力
- 规模估算：用
group_by=在housecarl_cross_plugin_query上一次性聚合所有匹配为计数表，例如group_by="defined_in"、group_by="winner"、group_by="type"，在制定逐行计划前先判断任务是 40 条还是 4000 条记录。 - 范围语义控制：
defined_in=true只取定义而非覆盖，避免把补丁/替换插件的覆盖记录重复计入目录；winner_fields=true取实时值而非被限定插件自身版本的值，避免输出“看似合理但时代错误”的统计。 - 循环消除映射：提供原语替代逐记录循环，例如
references=接受列表（OR 语义，通过matches=报告命中目标）、housecarl_batch_record_detail批量读取、housecarl_resolve批量解析身份、resolve_names=true内联标注 FormLink、format="json"直接输出结构化文档、housecarl_diff_record比较两个插件版本、verb:"CopyFrom"移植字段、composes=[...]一次追加或替换整个列表。 - 配方化流程：给出目录、链接图谱、补丁重建、扇出四类任务的配方步骤。
- 统一交付物结构：定义“多记录→单文档”的规范形状，包含
job、scope、total、complete、notes、records等字段，并规定 formid 使用完整 wire token、身份四键（type/editorid/name/winner）、解析链接保留 token 与身份、字段值原样保留、会计字段强制携带、分类使用封闭枚举。
使用方式
- 先用计数而非转储来估算范围。
- 在提取前写下交付物 schema，尤其是交给子代理之前。
- 根据任务形态选择对应配方：目录、链接图谱、补丁重建或扇出。
- 使用批量原语而非逐记录循环。
- 尊重会计字段：
total、rendered、capped、truncated、notes随文档传递，capped=true时提高limit=或缩小范围分页。
适用场景
- 枚举某模组集新增的某类型全部记录，带实时统计与解析名称。
- 构建链接图谱，例如某武器的制作配方图。
- 针对目标模组新版本重新推导旧兼容补丁。
- 任务扇出到多个子代理时固定 schema，避免漂移。
限制
housecarl_cross_plugin_query没有depth=，列表展开必须通过housecarl_batch_record_detail或housecarl_read_record。- 约定只是约定，数据可能脏；应从字段分类并标记不一致，而非盲信 EditorID 或显示名。
- 无制作站或条件不可能的配方是常见模组禁用惯用法，其含义属于该模组自身技能范畴，本技能只报告结构不猜测意图。
- 具体收费、价格、平台等信息暂未提供。