用途
Spooky's AutoMod Toolkit 是面向 AI 助手的命令行工具包,目标是以程序化方式创建和修改《上古卷轴5:天际》模组。它把常见的模组制作工作流组织为 CLI 模块,便于在用户自有的项目目录内进行自动化作者工作。上游仓库为 https://github.com/SpookyPirate/spookys-automod-toolkit。
主要能力
工具按模块划分能力:
- esp:ESP 插件相关操作,详见 skyrim-plugin-authoring 技能。
- papyrus:Papyrus 脚本相关工作,详见 skyrim-papyrus-modding 技能。
- mcm:MCM 菜单相关,无专门技能,参数需通过 --help 或参考文档查看。
- nif:NIF 模型相关,详见 skyrim-nif 技能。
- archive:归档处理,涉及 Forge bsarch 工具。
- audio:音频相关,详见 skyrim-audio 技能。
- skse:SKSE 相关,详见 skyrim-skse-commonlib / skse-plugin-authoring 技能。
命令形态为:从工具根目录执行 dotnet run --project src/SpookysAutomod.Cli -- <module> <command> [args] [options]。在非交互式 AI 运行中应始终传入 --json,以获得可解析输出。
安装与定位
工具根的解析顺序为:环境变量 SPOOKY_AUTOMOD_ROOT(若已设置且有效)、工具发现脚本的结果、用户提供的路径。若均缺失,应建议安装,而不是对不存在的目录树编造命令。
有效根目录的标志包括 SpookysAutomod.sln 和/或 src/SpookysAutomod.Cli。
安装方式二选一:
- 从 GitHub Releases 获取发布 zip 与 SpookysAutomodSetup.exe;
- 或
git clone后执行dotnet build SpookysAutomod.sln。
要求:Windows 与 .NET 8 SDK。验证命令:dotnet run --project src/SpookysAutomod.Cli -- --help。相关文档位于 references/README.md、references/llm-init-prompt.md、references/llm-guide.md。
使用方式与安全约束
只应在用户自有项目或版本快照中操作,不得触碰正在使用的 MO2 模组或游戏 Data 目录,除非用户明确将该路径作为项目。适当情况下优先使用 --light 的 ESL 友好插件,同时仍须遵守 HEDR/light-id 规则。Papyrus 头文件应来自用户的 Creation Kit,不要从随机网络镜像下载 Bethesda 源码。进行较大规模工具包工作前,每会话阅读一次 references/llm-init-prompt.md。各模块参数应查阅对应技能,不要臆造子命令,可运行 --help 或查阅参考文档。
与其他工具的取舍
- Spooky:在项目目录内进行全新 CLI 作者工作、BSA 手术、NIF CLI、SKSE 项目脚手架。
- houseCARL:针对实时加载顺序、冲突胜出者的问题,以及可审查的补丁写入 MO2。
- Forge:类型化多步校验、发布/FOMOD/Nexus 关卡、能力代理。
构建失败处理
确认 dotnet --version 为 8 及以上 SDK;若还原失败,可执行 dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org;如有安装向导可重新运行;最后可回退到 houseCARL/Forge/Papyrus 技能并报告阻塞原因。
限制
工具依赖 Windows 与 .NET 8 SDK;需要有效的工具根目录;模块参数与具体命令需以 --help 和参考文档为准,本介绍不展开未提供的细节。