Node Annotator 0.4.3 —— 节点树注释与文档（Blender 4.2+）

Node Annotator 是一个帮助记录与维护节点图的实用插件。它支持在任意节点编辑器的侧栏里一键创建、编辑带文字块的注释框，为复杂的节点树加上清晰说明；它还能利用 Blender 4.2 为节点组新增的描述属性——为节点组填写 tooltip，并在有描述的节点组标题上显示一个小信息图标，悬停/点击即可查看，方便团队理解与交接。

· 在任意节点编辑器侧栏一键创建注释框
· 注释框带文字块、可编辑
· 为节点组填写描述（tooltip）
· 有描述的节点组显示信息图标
· 帮助团队理解与交接节点树
· 可在偏好里关闭图标显示

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：在节点编辑器侧栏打开 Node annotator 分区，点「创建注释」生成黄色注释框并填文字；在节点组描述栏填写说明，标题栏即出现信息图标。

适合节点树复杂、需要交接或长期维护的项目：想给材质/几何节点加说明、减少「看不懂当初怎么连的」成本时使用。

Q：能注释所有节点编辑器吗？A：可以在任意节点编辑器的侧栏使用。Q：图标能关吗？A：可以，在偏好里关闭。

核心功能

· 在任意节点编辑器侧栏一键创建注释框
· 注释框带文字块、可编辑
· 为节点组填写描述（tooltip）
· 有描述的节点组显示信息图标
· 帮助团队理解与交接节点树
· 可在偏好里关闭图标显示

安装与用法

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：在节点编辑器侧栏打开 Node annotator 分区，点「创建注释」生成黄色注释框并填文字；在节点组描述栏填写说明，标题栏即出现信息图标。

适用场景

适合节点树复杂、需要交接或长期维护的项目：想给材质/几何节点加说明、减少「看不懂当初怎么连的」成本时使用。

常见问题

Q：能注释所有节点编辑器吗？A：可以在任意节点编辑器的侧栏使用。Q：图标能关吗？A：可以，在偏好里关闭。

深度解读

节点树越复杂，越容易出现「过几周自己也看不懂」的情况：为什么这样连、这个组干嘛的，全靠记忆。Node Annotator 把文档写进节点图本身：在侧栏一键创建黄色注释框，把意图、参数说明直接贴在节点旁；又借 Blender 4.2 的节点组描述属性，为组的标题栏挂上信息图标，鼠标一停就看到 tooltip。这样无论是回看自己的旧工程，还是把文件交给同事，理解成本都大幅降低。它轻量、不改变节点逻辑，只增加「可读性」这一层，对强调可维护性的着色器/几何节点项目尤其实用。

包内文件说明

本包为 Node Annotator 0.4.3（作者 FrankFirsching），解压后共 15 个文件、合计 67,976 字节。根目录含 blender_manifest.toml（id=node_annotator、version 0.4.3、blender_version_min 4.2.0）与 __init__.py 注册入口；顶层条目：LICENSE.md、__init__.py、annotate_ops.py、annotate_utils.py、annotation_painter.py、blender_manifest.toml、control_panel.py、deployment-version.txt、gpu_utils.py、images/、path_utils.py、preferences.py、refactor_ops.py、search_ops.py、utils.py。

原产品页：https://extensions.blender.org/add-ons/node-annotator/

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