天际-Claude代码模组工具包

创作者: ttyyygggg

已更新:2026-08-08 01:19:08

213KB

下载

前置 MOD

使用天际-Claude代码模组工具包时将自动安装

DevBench

5.8MB

关于此 MOD

将你的《Skyrim》安装目录变成一个能够自我测试的AI辅助模组工坊。Claude Code负责处理机械性工作——跨版本移植模组、检查并编辑ESP文件、调试脚本、从零构建简易模组，

这不仅仅是指南——它是一个完整的AI模组制作环境，所有前期准备工作均已就绪。

基于数百小时的《天际VR》模组开发实践经验打造而成。 [尽管这是基于VR版本构建的，但它兼容且在任何Skyrim版本中都同样强大——SE、AE、VR和LE版均适用。Claude Code是核心所在。]

GitHub 仓库

(可能有更新的版本/夜间版本)

这是什么？

Claude Code 是Anthropic开发的一款AI助手，可直接运行在你的电脑上。与ChatGPT或普通Claude聊天不同，它能够 读取你的文件、运行命令、编辑配置、执行脚本——现在还能操控你正在运行的游戏。 ——一切都经您许可。就像有一位模组专家坐在您身边，为您代劳辛苦的工作，并自行检查成果。

大多数尝试用Claude Code做模组的人，都要花上好几天琢磨工具集成、跟Delphi DLL的古怪毛病较劲、搞明白Claude需要知道什么才能派上用场，还得搭建安全护栏防止它弄坏东西。而这套工具包已经把这些全都解决了。你第一天就能得到一个立即可用的工作环境。

它并不完美，而且需要一些反复试验——尤其是对于从头开始制作的复杂模组来说。但对于模组制作中那些繁琐的部分，它能够显著比你亲自动手还快。

v3.4新功能：支持Mod Organizer 2

MO2没有真正的合并Data/文件夹——它在启动时通过叠加游戏本体、每个模组自己的文件夹以及overwrite/来构建一个虚拟的。之前的版本假设的是Vortex/游戏本体的布局，所以在MO2安装环境下，Claude读取的是一个存在但几乎不包含你的任何模组的Data/文件，并且会在Documents/%LOCALAPPDATA%中寻找实际上位于你的配置文件中的INI文件和加载顺序。

安装程序现在会自动检测您的MO2实例 （全局或便携式）并将其与您的游戏文件夹匹配，解析您当前使用的配置文件，然后将真实的模组/配置文件/覆盖路径写入CLAUDE.md，而不是错误的路径。

耗费MO2用户最多时间的陷阱现在已有文档记录： xelib/XEditLib在MO2之外启动时不会报错——它会悄无声息地返回一个看似合理实则错误的答案，因为它只能看到Data/目录中实际存在的文件。任何依赖加载顺序的操作现在都通过MO2的可执行文件列表运行。

v3.3新内容：Claude在运行中的游戏里测试自己的修复

与 DevBench 已安装（由alandtse开发的仅限开发者的SKSE插件——无游戏性改动，无存档数据），Claude将直接驱动你正在运行的游戏，而非要求你启动游戏、触发事件并回报结果。

读取实时状态 — 帕皮鲁斯虚拟机健康状态、活跃魔法效果、物品栏及任务。

运行控制台命令并读取其输出 -- 并非发射后不管。

调用Papyrus函数并获取返回值 -- 读取、修改、重新读取，无需重启游戏。

讲述你HUD上的测试内容 当您佩戴头显时。
<<已更改 -- 此条目已添加到现有列表中>>

懂得区分卡死和暂停的区别 （v3.5.1中新增） -- 它读取 DevBench 的线程外健康探针，因此即使游戏卡住时仍能获得响应，并将奔跑从 在菜单中暂停 从 其实已经挂了 来自 尚未加载存档需要DevBench 1.11.0或更新版本；旧版本将自动回退。

调数值不再是“修改、重新编译、重新加载、然后请你再试一次”，而是在你继续游玩的同时，直接变成对正在运行的游戏的一次实时调用。

v3.1新功能：创建自定义动画特效并保存扫描与编辑

v2可以读取、编辑和构建ESP文件。 v3版本新增了制作3D网格内容和动画的功能——并在其进入您的头戴设备之前进行可视化验证。3.1版本新增了.ess文件编辑与清理功能。

从零开始制作带动画的NIF文件。 使用PyNifly（BodySlide/Outfit Studio背后的库），Claude可以编写动画控制器块，使网格 自行移动 -- 一种自转效果，放置到世界中时会立即自动循环（零Papyrus脚本），伸缩/延展几何体，或关键帧动画。手动编写这些控制器模块，一旦出错就会导致游戏崩溃；而工具包知道正确的编写方式。

ReSaver 命令行工具 -- 以无头模式运行 ReSaver 的库，解析、交叉引用并清理你的 .ess 存档，以数据形式获取结果（查找孤立脚本、未定义元素、存档膨胀）。除非你确认，否则所有写入均为试运行，且始终写入新文件。

无头渲染验证循环。 Claude可以通过无头Blender直接将NIF渲染为PNG。 直接在聊天里给你看结果 ——所以，网格或特效的修复已确认。之前你在它上面花了不少加载时间。NifSkope充当独立的渲染关卡，PyNifly充当独立的解析关卡，因此坏文件会在工具链中被捕获，而不是在你的头显里出问题。

NIF几何体手术。 网格拆分与细分、顶点和边界编辑、局部网格发光贴图（如刀刃发光而剑柄不发光）、碰撞体/Havok编辑，以及VR破坏性骨骼节点的检测。

更大的知识库——现含1,600多行内容。 NIF/动画制作、VR碰撞检测栈、Havok单位换算、音频（SOUN/SNDR）配对、音乐系统、Mod Organizer 2的虚拟文件系统，以及更多内容。

可选Nexus API集成。 放入免费的个人API密钥后，Claude即可检查您的模组是否有更新、阅读更新日志，以及获取版本/依赖信息。

人们实际用这个构建出的东西： 可伸缩/伸缩式刀刃（仅限长度，不进行刀身加厚缩放）、一个自旋锥体攻击（无需脚本即可循环播放）、部分刀刃的自发光效果、一把带有发光效果的定制武器，并配有匹配的物品栏图标及VR中正确的持握渲染、战斗音乐修复，以及完整的SSE至VR移植。

你可以建造的东西（使用随附工具链可行，只是我们尚未尝试过）： 旋转的符文/结界/法阵，自带动作的召唤或传送门网格，伸缩/变形武器，自发动画的法术特效网格，头目战编队/冲击波特效在无头环境下制作并完成渲染检查，批量重制纹理/生成图标。

如果你能描述运动方式，Claude 可以尝试编写控制器，并为你显示渲染效果。

你获得的内容

这不是一份教你如何自行安装和配置的指南。 完整、可直接运行的模组开发环境 ——每件工具都已预先校准，天际省每个已知的小毛病都已记录在案，每个陷阱都已识别并加以防范。将其解压到你的游戏文件夹，粘贴一条提示词，即可开工。

包含全部内容：

1,600+ 行的天际模组知识 -- 帕皮鲁斯脚本的怪癖、版本特定差异、xEdit 的坑、引擎漏洞、NIF/动画制作、VR 命中检测、Mod Organizer 2 的虚拟文件系统等等。自动加载到每一个 Claude 会话中。
游戏内实时测试（DevBench） -- Claude检查实时游戏状态，运行控制台命令并读取其输出，调用Papyrus函数并获取返回值，还能在实际运行中的游戏里驱动脚本化测试场景。
支持 Mod Organizer 2 -- 启动检测会自动识别你的MO2实例和配置文件，并提醒Claude注意加载顺序工具陷阱，这个陷阱几乎让所有人都栽过一次跟头。
NIF制作与动画 -- 使用PyNifly为作者自带动画网格（自旋、伸缩、关键帧运动）添加动画，用PyFFI编辑LE几何体，并在加载游戏前通过无头渲染验证一切。
渲染验证循环 -- 无头 Blender 将任何 NIF 渲染为 PNG，以便在聊天中确认修复；NifSkope 和 PyNifly 作为独立的渲染/解析关卡，确保坏文件在工具环节被捕获。
安全挂钩 -- Claude在编辑任何游戏文件之前会先征得许可，不会直接改动ESP/ESM文件，并且会自动备份所有修改内容，附带完整的操作审计记录。
信心系统 -- Claude 在提出任何修改前，会先评估其置信度（0-100%）并列明其假设。绝不猜测，绝不说“这应该能行”。
通过Spriggit编辑ESP -- 将任意 ESP 序列化为人类可读的 YAML，直接编辑，再反序列化回来。在 git 中差异清晰；无 FFI 层，无脚本。
通过xeditlib进行ESP分析 -- 程序化检查、差异对比以及对记录的批量查询。艰难的 Delphi FFI 工作已经完成。
交叉引用完整性保护 -- 在进行大规模高风险编辑前，快照ESP的引用；若此后任何引用被静默重新主控或丢弃，则大声报错。
NIF网格工具 检查、重新贴图、缩放、修复眼部残影、分割/细分几何体、应用发光贴图并验证网格。检测破坏VR体验的骨骼节点。
BSA存档工具 -- 对BSA档案的完整读/写/合并/差异比较；可提取单独文件、创建新档案、更新内容。
音频处理 -- 提取、转换并创建天际的语音和音效文件（FUZ/XWM/WAV）。
MCM菜单生成 -- 以编程方式创建带有开关、滑块和页面的SkyUI模组配置菜单。
存档文件分析 -- 用于无头环境下的结构化解析/交叉引用/清理的ReSaver命令行工具，以及用于SKSE协同存档的cosave-info工具。
可选Nexus API集成 -- 使用你自己的免费密钥进行模组版本/更新/更新日志/依赖检查。
可选Docker开发容器 -- 一个可为不需要Windows的工具（ESP检查、单元测试、存档分析）提供可重现的环境。
试运行工作流 -- 所有ESP和资产更改都先经过预览流程；Claude在改动任何内容之前会准确展示它将执行的操作。
Claude Code技能 -- 斜杠命令，如 /inspect-esp、/port-to-vr、/create-mod，可触发引导式工作流；此外，当 Claude 处理游戏文件时，会自动加载上下文，注入关键的《天际》注意事项。
自动设置 一条提示即可安装前置依赖、配置路径、检测您的模组管理器、设置挂钩，并可选安装模组工具。无需手动配置。

设置（4步）

第一步：获取 Claude Code （推荐；你也可以使用免费替代方案，例如） Opencode 或另一个智能编码助手，并让它调整文件名——工具包自带的AGENTS.md正是为此准备的）。
先备份整个《Skyrim》目录！ 内置了备份系统，但最好也保留一份已知正常的副本。
桌面应用（最简单）： 从…下载 claude.ai/code. 命令行： 安装 Node.js，随后 npm install -g @anthropic-ai/claude-code。Claude Code需要Claude Pro（每月20美元）或Max（每月100美元）计划。

步骤2：将工具包解压到你的Skyrim文件夹中（顶层目录，而不是Data文件夹）
手动下载此模组，然后通过以下路径找到你的《天际》游戏文件夹 Steam > 库 > 右键点击《天际VR/特别版》 > 属性 > 已安装文件 > 浏览 （或你的MO2实例的游戏文件夹），直接将压缩包解压到其中（不会覆盖任何文件）。

第3步：在你的Skyrim文件夹中打开Claude Code

cd "C:\Steam\steamapps\common\SkyrimVR"
克劳德

步骤4：把这个提示词粘贴进去（就这样）
<<CHANGED -- 重新粘贴整个代码块>>

我刚刚把Skyrim Claude Code模组工具包安装到了这个文件夹。运行“bash setup.sh”来完成所有设置。帮我安装任何缺失的依赖（jq、Node.js）。设置完成后，询问我想安装哪些可选模组工具（xeditlib、Champollion、Caprica、Spriggit、AutoMod CLI、PyFFI、PyNifly、Blender、NifSkope、ReSaver CLI），然后安装我选中的那些。AutoMod CLI提供NIF网格编辑、BSA存档工具、音频处理和MCM菜单生成——它是一个实际工具，通过克隆https://github.com/SpookyPirate/spookys-automod-toolkit到tools/automod并构建Cli项目来安装（dotnet build tools/automod/src/SpookysAutomod.Cli -c Release；不要在无头环境下构建WPF Setup项目），之后通过tools/automod-cli.sh运行。PyFFI和PyNifly提供NIF几何体及动画/控制器创作功能；Blender（无头模式）和NifSkope提供网格修复及游戏内测试前的网格渲染验证。ReSaver CLI提供无头.ess存档解析、交叉引用、清理及changeform级诊断（从Nexus模组5031下载ReSaver.jar到tools/resaver-cli/；需要JDK 17+（推荐JDK 21 LTS，例如`winget install Microsoft.OpenJDK.21`））。另外，向我介绍DevBench但不要安装它：它是一个可选的仅限开发用的SKSE插件（Nexus模组181326，作者alandtse，不改变游戏玩法，也不生成存档数据），在游戏运行中启动本地主机服务器，让你能检查实时状态、运行控制台命令并读取其输出、调用Papyrus函数——这样你可以在我继续游玩的同时测试你自己的修复，而不需要反复让我启动游戏、触发问题再反馈结果。与列表中的其他工具不同，它是一个模组而非开发工具，所以如果我想用的话，会通过我自己的模组管理器像其他SKSE插件一样安装——绝不要自行复制文件到Data/目录。包装工具tools/devbench-cli.sh已经打包好了，安装完成后即可使用。捆绑的cosave-info工具（tools/cosave-cli.sh，Python 3，无需下载）提供SKSE .skse共存存档的只读结构概览。务必根据我的Skyrim版本和安装方式（可能是也可能不是VR版）来定制环境。另外问我是否想启用可选的Nexus API集成（模组更新检测/版本和更新日志检查）；如果启用，解释如何获取免费的Personal API Key并将其保存到tools/.nexus_api_key（该文件已在gitignore中）。用通俗易懂的英文解释一切，并问我你可能需要问的任何问题。

就是这样。你完成了。 （可选渲染循环所需的Blender和NifSkope是独立的外部应用，设置向导会引导您完成安装。DevBench则不同——它是一个模组，所以Claude不会安装它；如果你想要游戏内实时测试，可以自己用Vortex或MO2安装，随附的包装器会自动识别它。）

可选：Nexus API 集成
免费给Claude一次机会 个人API密钥 并且它可以检查模组 版本、更新日期、更新日志与依赖项.

获取免费密钥：nexusmods.com > 站点偏好设置 > API 访问权限 复制你的个人API密钥。
保存它（一行）到 tools/.nexus_api_key，或设置 NEXUS_API_KEY。（或在设置过程中将其粘贴到Claude中。）
安全： 个人/本地使用专用；该文件默认被git忽略——切勿分享或发布。

常见问题解答
问：适用于扁平Skyrim SE（非VR）吗？ 是的——知识库涵盖了这两方面；仅有VR相关章节适用于VR。
问：我需要使用Mod Organizer 2吗？ 不——原版安装和Vortex安装的工作方式与之前完全一致。如果你用的是MO2，设置程序会自动检测到它，并让Claude直接指向你真实的mod/配置文件文件夹，而非Data/目录。
问：我需要DevBench吗？ 不——这是可选的，但区别在于Claude是猜测修复是否生效，还是实际在你的游戏里实时检查。如果你要做的不只是临时改个ESP，强烈建议装这个。注意它是一个模组，不是自带的开发工具之一：你需要自己通过Vortex/MO2安装，而且Claude绝不会写入你的Data/文件夹来配置它。
问：Claude会破坏我的模组或存档吗？ 安全钩应该能防止这种情况（不直接编辑ESP/ESM文件，所有操作均有权限控制并自动备份）——但大语言模型本质上是概率性的，所以请务必自行保留备份。
Q：我需要Blender/NifSkope吗？ 仅用于可选渲染循环。核心NIF创作/编辑（PyFFI，PyNifly）无需它们即可正常工作。
问：“找不到jq”？ 奔跑 winget install jqlang.jq 并重启Claude Code。
问：我该如何更新？ 下载新版并覆盖旧版本。

需求

Claude Code （或者另一个智能编码助手——参见AGENTS.md），如使用Claude则需Claude Pro/Max计划，Windows 10/11，以及 jq （安装程序会将其安装）。

技术上讲是可选的——但全部推荐安装——由安装向导根据请求进行安装：

xeditlib -- 程序化读取/写入ESP/ESM文件。通过以下方式安装 npm install github:WingedGuardian/xeditlib （需要Node.js）。
商博良 / 卡布里卡 -- Papyrus 反编译 / 编译（GitHub 发布版）。
斯普里吉特 -- ESP <-> YAML（需要 .NET SDK； dotnet tool install Spriggit.CLI).
AutoMod 命令行界面 -- 克隆并构建Cli项目（需要.NET SDK）。
PyFFI (Python 3.10) + PyNifly (请从发布页面下载 io_scene_nifly.zip——Git 克隆不包含已编译的 DLL)。
Blender + NifSkope -- 网格修复 + 渲染验证。
ReSaver / FallrimTools -- 将 ReSaver.jar + lib/ 放入 tools/resaver-cli/ 目录（需要 JDK 17 或更高版本，推荐 JDK 21 LTS）。
DevBench -- 让Claude实时检查并操控运行中的游戏。这是一个 MOD, 非工具/实用程序：请像安装其他任何SKSE插件一样，使用你自己的模组管理器进行安装（Claude不会触碰你的Data/文件夹）。建议使用1.11.0或更高版本。
Docker 桌面版 -- 仅当你需要可选的开发容器时（devshell-docker.sh);其余部分无需它也能正常运行。

无需模组管理器，如果你用的是原版/Vortex，一切照旧。 如果你使用Mod Organizer 2，自v3.4起它将原生检测并支持。 无需单独项目。DevBench（可选）是一个SKSE插件；工具包中的其他部分均不涉及SKSE。

喝彩信息

xedit库 / zEdit, 斯普里吉特（突变剂）， Spooky的自动审核工具箱 (用于NIF/BSA/音频/MCM/ESP的命令行后端)， PyNifly / nifly / PyFFI, FallrimTools/ReSaver, DevBench 由alandtse创作， aaronputty 本工具包所依赖的Mod Organizer 2检测机制与开发环境，以及 Claude Code 由Anthropic出品。