houseCARL 是一个面向《上古卷轴5:天际》特别版(Skyrim Special Edition)数据层模组制作的技能,通过已配置的 houseCARL MCP 服务器实现。它主要用于读取 Mod Organizer 2(MO2)实例、解析加载顺序中真正胜出的记录,并将修改写入可审查的补丁插件,而不会编辑原始来源模组。
用途方面,houseCARL 适用于读取或编辑天际加载顺序记录、检查冲突、查询插件、编写补丁,以及路由到相关子技能(如 SkyPatcher、SPID、KID 等)。
主要能力包括:确认上下文(如通过 housecarl_load_order_status 检查档案/插件状态,或通过 housecarl_set_mo2_instance 设置新的 MO2 实例文件夹);在写入记录前先读取(使用 mutagen-reference 验证字段名、可写性、枚举值和组合结构形状,使用 housecarl_read_record 或 housecarl_batch_record_detail 检查当前胜出记录,必要时添加 conflict_tree=true,使用 housecarl_cross_plugin_query 跨加载顺序定位记录或引用);选择最窄的写入工具(housecarl_set_field 用于单个标量或简单集合编辑,housecarl_bulk_apply 用于一次补丁中的多个编辑、字典合并、等级列表条目、效果等,housecarl_create_record 用于创建新的顶级记录(需要 EditorID),housecarl_remove_record 仅用于从 houseCARL 拥有的补丁中删除记录或覆盖,绝不从来源模组中删除);首次写入返回补丁名后,可使用 into=<patch filename> 将相关编辑累积到一个补丁中。
使用方式上,houseCARL 工具使用 XXXXXX:Plugin.esp 格式的 FormID(六个十六进制数字加定义该记录的主文件名)。SkyPatcher、SPID 和 KID 各自使用不同的 FormID 语法,编写 INI 行前应查阅其技能。houseCARL 补丁是可审查的输出模组,应告知用户创建或扩展了哪个补丁。不要虚构模式或字段路径;如果 mutagen-reference 中没有某类型的条目,应直接说明而不是猜测。当用户明确想要无 ESP/运行时分发文件时,不要进行记录编辑,而应使用 SkyPatcher、SPID 或 KID。
安装与配置:需要获取 houseCARL 分发版(houseCARL-Setup.exe + housecarl\ 文件夹),安装 .NET 9 运行时和 ASP.NET Core 运行时 9(可从 https://dotnet.microsoft.com/download/dotnet/9.0 下载,或使用 winget install Microsoft.DotNet.Runtime.9 和 winget install Microsoft.DotNet.AspNetCore.9),运行 houseCARL-Setup.exe(更新时先退出 AI 应用),完全重启 AI 应用,设置 MO2 实例(包含 ModOrganizer.ini 的文件夹),并通过加载顺序问题验证。V5 版本支持多提供商和自动设置,附带 Setup-HouseCarl.ps1 脚本,可自动查找 housecarl-mcp.exe、检查运行时、选择 MO2 或 Vortex(Vortex 需创建 shim),设置用户环境变量并配置 MCP。Vortex 用户需注意 plugins.txt 顺序是权威的,生成的 modlist.txt 松散文件优先级是近似的,补丁落在 staging 下需导入 Vortex 并部署,若需精确的松散文件冲突编写,最好使用真实的 MO2。
适用场景:天际模组制作者需要检查加载顺序冲突、查询插件记录、编写可审查补丁,或使用运行时 INI 框架分发内容时。限制:依赖 houseCARL MCP 服务器和 MO2 实例;Vortex 支持通过 shim 实现但有上述注意事项;不编辑来源模组;不虚构字段或加载顺序胜出者;MCP 工具缺失时需运行设置脚本并重启 AI 应用。