一款用于 Blender 的集合可见性动画插件。它可以递归处理集合及其子集合中的物体，一键同步视口与渲染可见性，并为相关属性插入关键帧。
适合制作分镜切换、模型分组显隐、场景阶段展示，以及需要批量控制集合可见性的动画工程。
- 一键将集合内物体的渲染可见性同步为当前视口可见性。
- 同时为
hide_viewport和hide_render插入关键帧。 - 递归处理所有子集合，并自动跳过重复链接的物体。
- 自动记录处理过的集合，便于后续快速显示或隐藏。
- 一键显示集合内全部物体并插入可见性关键帧。
- 一键隐藏集合内全部物体并插入可见性关键帧。
- 可单独清除集合内物体的可见性动画，不影响其他动画通道。
- 支持从历史记录移除集合，不会删除该集合已有的动画。
- 支持英文与简体中文界面。
- 支持 Blender 5.x 分层动作数据。
| 项目 | 要求 |
|---|---|
| Blender | 5.0.0 及以上 |
| 插件版本 | 1.0.1 |
| 操作系统 | Windows、macOS、Linux |
| 外部依赖 | 无 |
当前版本已在 Blender 5.1.2 和 Blender 5.2.0 中完成扩展验证与核心功能测试。
每次发布修改都必须递增版本号，并同步更新 blender_manifest.toml、__init__.py 和本 README。兼容性修复使用补丁版本号，新增功能使用次版本号，破坏性变更使用主版本号。
- 从仓库的“发布”页面下载
easy_collection_visibility_keyframes-1.0.1.zip。 - 打开 Blender，进入“编辑 > 偏好设置 > 扩展”。
- 点击右上角菜单，选择“从磁盘安装”。
- 选择下载的 ZIP 文件并完成安装。
- 确认扩展
Easy Collection Visibility Keyframes（简易集合开关动画）已经启用。
安装时直接选择 ZIP 文件，不要预先解压。
- 切换到目标关键帧所在的时间轴帧。
- 在 3D 视图中按
N打开侧边栏。 - 进入
Easy Collection选项卡。 - 在“集合”搜索框中选择目标集合。
- 点击“为目标集合插入可见性关键帧”。
插件会读取集合内每个物体当前的视口可见性，将渲染可见性设置为相同状态，然后为视口和渲染可见性分别插入关键帧。处理完成后，该集合会自动加入历史记录。
处理过的集合会显示在“已记录的集合”列表中。每个集合右侧提供以下操作：
| 图标 | 功能 | 行为 |
|---|---|---|
| 眼睛打开 | 显示并插入关键帧 | 将集合及子集合内的物体设为视口可见、渲染可见，并插入关键帧 |
| 眼睛关闭 | 隐藏并插入关键帧 | 将集合及子集合内的物体设为视口隐藏、渲染隐藏，并插入关键帧 |
| 垃圾桶 | 清除可见性动画 | 经确认后，删除集合内物体的 hide_viewport 与 hide_render 动画通道 |
| 叉号 | 移除历史记录 | 只从列表中移除集合，不修改物体状态，也不删除动画 |
列表中的眼睛按钮会根据集合当前的视口可见状态显示按下状态。如果集合内物体的状态不一致，两个按钮都不会显示为按下。
假设场景中有“方案一”和“方案二”两个集合，需要在第 1 帧显示方案一，在第 30 帧切换到方案二：
- 在第 1 帧将“方案一”选入集合搜索框，点击主操作按钮，为其插入可见关键帧。
- 将“方案二”选入搜索框，点击隐藏按钮并插入关键帧。
- 切换到第 30 帧，将“方案一”选入搜索框，点击隐藏按钮并插入关键帧。
- 将“方案二”选入搜索框，点击显示按钮并插入关键帧。
播放动画时，两个集合会在指定帧切换视口与渲染可见性。
- 主操作按钮处理的是面板“集合”搜索框中选定的集合，不依赖大纲视图当前选中项。
- 操作会递归影响目标集合的所有子集合。
- 同一个物体链接到多个相关集合时，每次操作只会处理一次。
- 可见性动画作用于物体的
hide_viewport和hide_render属性，不会为集合本身插入关键帧。 - “清除可见性动画”会删除目标集合内物体的完整可见性动画通道，而不只是删除当前帧的关键帧。该操作执行前会显示确认对话框。
- “移除历史记录”不会清除关键帧，也不会改变物体当前的可见状态。
- 历史记录保存在当前场景中；删除集合后，列表中会显示集合已丢失，可使用叉号移除该记录。
- 空集合可以被记录，但没有物体可供插入关键帧。
easy_collection_visibility_keyframes/
├── __init__.py
├── blender_manifest.toml
├── LICENSE
├── operators.py
├── properties.py
├── ui.py
└── translation/
├── __init__.py
└── zh_HANS.py
如遇到插件无法启用、集合无法识别或关键帧行为异常，请在仓库的“问题”页面提交反馈，并附上以下信息：
- Blender 的完整版本号。
- 插件版本号。
- 操作系统。
- 可复现问题的具体步骤。
- Blender 系统控制台中的完整报错信息。
项目地址：Witty-Ming/Simple-Collection-Switch-Animation
作者主页：WittyMing
本项目采用 GNU 通用公共许可证第 3 版或更高版本发布，详细条款见 LICENSE。