GNToolkit 0.4.4 —— 给 Blender 节点树做真正的版本控制（JSON diff / 审阅 / 合并 / Git）

Blender 的节点组（几何节点、着色器、合成器）本质是程序，但 .blend 是二进制，团队协作时无法像代码那样审阅改动。GNToolkit 的思路是把节点组「抽」出来：导出成规范化的 JSON 作为真源，二进制文件只保留为工作副本。

· 确定性 JSON 导出：规范化 SHA-256 哈希忽略节点位置与创建顺序，未改动即字节一致
· 最小 diff：改动只体现在真正变化的地方，重命名节点显示为「旧 → 新」而不是删一个加一个
· 五种状态一眼可见：已同步 / 本地已改 / JSON 已改 / 冲突 / .blend 中缺失，全部按内容计算
· JSON 历史浏览：挑一个旧版本，预览改动，一键还原
· 内置 Git 面板：列出所有改动过的受跟踪 JSON，逐个 Stage/Unstage，Commit staged 精确提交
· 覆盖几何节点、着色器、合成器三类节点树
· 附带语义化差异、几何校验与审计功能

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：在节点编辑器侧栏（N 面板）打开 GNToolkit，先把要跟踪的节点组加入跟踪列表，插件会导出对应 JSON；之后每次改动都可以看状态、看 diff、还原或提交。要协作时在 Git 面板里暂存并提交这些 JSON，团队成员拉取后再同步回 .blend。首次使用建议先在一个测试文件上熟悉状态含义。

团队共享几何节点资产库；节点组需要代码级审阅与回滚的项目；把节点逻辑纳入 Git 流水线；教学里演示节点组的结构化差异；多人同时改同一套节点时的冲突排查。

问：要钱吗？答：免费开源，GPL-3.0-or-later。问：需要哪个 Blender 版本？答：4.2 及以上。问：要装 Git 吗？答：不强制，插件自带 dulwich（纯 Python 的 Git 实现），但要和远程仓库协作仍建议本机有 Git。问：会破坏我的 .blend 吗？答：不会，它只读节点组并另存 JSON，.blend 始终是工作副本。问：哪些节点树支持？答：几何节点、着色器、合成器。

核心功能

· 确定性 JSON 导出：规范化 SHA-256 哈希忽略节点位置与创建顺序，未改动即字节一致
· 最小 diff：改动只体现在真正变化的地方，重命名节点显示为「旧 → 新」而不是删一个加一个
· 五种状态一眼可见：已同步 / 本地已改 / JSON 已改 / 冲突 / .blend 中缺失，全部按内容计算
· JSON 历史浏览：挑一个旧版本，预览改动，一键还原
· 内置 Git 面板：列出所有改动过的受跟踪 JSON，逐个 Stage/Unstage，Commit staged 精确提交
· 覆盖几何节点、着色器、合成器三类节点树
· 附带语义化差异、几何校验与审计功能

安装与用法

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：在节点编辑器侧栏（N 面板）打开 GNToolkit，先把要跟踪的节点组加入跟踪列表，插件会导出对应 JSON；之后每次改动都可以看状态、看 diff、还原或提交。要协作时在 Git 面板里暂存并提交这些 JSON，团队成员拉取后再同步回 .blend。首次使用建议先在一个测试文件上熟悉状态含义。

适用场景

团队共享几何节点资产库；节点组需要代码级审阅与回滚的项目；把节点逻辑纳入 Git 流水线；教学里演示节点组的结构化差异；多人同时改同一套节点时的冲突排查。

常见问题

问：要钱吗？答：免费开源，GPL-3.0-or-later。问：需要哪个 Blender 版本？答：4.2 及以上。问：要装 Git 吗？答：不强制，插件自带 dulwich（纯 Python 的 Git 实现），但要和远程仓库协作仍建议本机有 Git。问：会破坏我的 .blend 吗？答：不会，它只读节点组并另存 JSON，.blend 始终是工作副本。问：哪些节点树支持？答：几何节点、着色器、合成器。

深度解读

GNToolkit 切中的是 Blender 在工程化上的一个结构性短板：程序化资产已经变成「代码」，但承载它的文件格式还是二进制。它没有去改 .blend，而是承认现实、在旁边建一份可读的真源，这个做法和游戏引擎里「场景存 YAML/JSON」的思路一致。真正值钱的是那个规范化哈希——只有忽略节点位置和创建顺序，diff 才有意义，否则每次挪一下节点都会产生噪音改动。对做几何节点资产库的团队来说，这意味着节点组终于能进 code review 流程：谁能改、改了什么、为什么改，都有据可查。

包内文件说明

本包为 GNToolkit 0.4.4（作者 oobma），解压后共 40 个文件、合计 2,325,568 字节。根目录 blender_manifest.toml（id=gn_toolkit、version 0.4.4、blender_version_min 4.2.0）、__init__.py、LICENSE；importer.py / sync_manager.py / sync_operators.py / sync_ui.py / sync_metadata.py 负责导入与同步流程，git_backend_dulwich.py / git_integration.py / git_network_worker.py 为 Git 后端与网络，semantic_diff.py 做语义化差异，merge.py 处理合并，audit.py 与 graph_utils.py 做审计与图分析，geometry_validator.py 校验几何，hash_utils.py 生成规范哈希，credentials.py 管理凭据，error_tracker.py 记录错误；wheels/ 内含 dulwich、urllib3、typing_extensions 等纯 Python 依赖。

原产品页：https://extensions.blender.org/add-ons/gn-toolkit/

封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。