blender-ai-addon - 把 Blender 视口变成 OpenCode 智能体聊天窗口的插件

blender-ai-addon 是一个面向 Blender 的 AI 辅助插件，仓库由维护者 hitkeeen 托管在 GitHub。按项目自述，它把 Blender 的 3D 视口侧边栏改造成一个与 OpenCode 智能体对话的聊天面板：用户用自然语言描述，或附上一张参考图、视口截图，说明想要创建或修改什么，智能体便生成一段基于 bpy 的 Python 脚本，再由插件直接在场景中执行。它适合已经熟悉 Blender 基本操作、希望用对话方式快速完成建模或场景调整脚本的用户，也适合想观察「智能体写脚本、宿主软件执行」这一流程的开发者。

维护者与状态

该项目由 hitkeeen 维护，仓库创建于 2026-10-09，最后一次提交同样在 2026-10-09，也就是说目前只有一个时间点上的初始状态，尚未经过长期迭代。事实表显示，项目尚无正式 release，因此素材中提到的「从 Releases 下载 zip」这一安装路径，在当前仓库状态下并没有对应的正式发布包可循。截至 2026-10-24，仓库星标数为 218。

需要说明的是，素材中的安装说明与事实表存在出入：素材给出的克隆地址指向另一个账号下的同名仓库，而事实表中的仓库地址为 hitkeeen/blender-ai-addon。本文以事实表为准，安装与获取方式请以上述仓库为准。

主要能力

以下能力均据项目自述整理，未经实际运行验证：

• 便携式 OpenCode 运行时：插件首次启动时可自行从 GitHub Releases 下载便携版 OpenCode 二进制文件（项目称约 80 MB），解压到插件自己的数据目录并在后台启动，不向系统全局安装任何东西。
• 视口内聊天：在 Blender 侧边栏（N 面板）中提供对话界面，保留消息历史与智能体会话。
• 按图生成：支持附加图片文件或直接截取当前视口作为参考，交由具备视觉能力的模型理解。
• 自动执行与自动修复：生成的代码会被自动运行；若执行报错，错误日志会自动回传给智能体，由它自行修改脚本。
• 多模型提供商：项目说明中列出 OpenAI、OpenRouter、Anthropic、Groq、DeepSeek 以及本地 Ollama 等接入方式，各自通过对应的 API Key 配置；使用图片功能需要选择支持视觉的模型。
• 受限的智能体权限：据项目说明，默认配置禁止智能体调用 shell，文件修改被限制在工作目录内。

项目还描述了运行时文件布局：便携运行时、工作区（含场景上下文与参考图）、智能体配置、会话数据与服务器日志分别存放在 Blender 用户数据目录下的不同子目录中，便于排查问题。

使用入口

项目仓库地址为 hitkeeen/blender-ai-addon。

据项目说明，常规使用流程是：将插件以 zip 形式安装进 Blender（编辑 > 偏好设置 > 插件 > 安装），在 3D 视图中按 N 打开侧边栏并切换到对应标签页，点击安装 OpenCode 按钮等待运行时下载完成，然后在设置中填写提供商、API Key 与模型名称，启动本地服务，状态变为就绪后即可输入请求并发送。

从源码安装时，项目建议将仓库内容打包为 zip，并确保清单文件位于压缩包根目录，再按上述方式安装。由于当前尚无正式 release，源码打包是更现实的获取方式。

许可与限制

项目采用 MIT 许可证。

使用前需要注意的边界条件，多来自项目自述：

• 插件依赖外部模型服务，需要自备相应提供商的 API Key；本地 Ollama 方式则需自行准备本地模型。
• 图片相关功能要求所选模型具备视觉能力，纯文本模型无法处理参考图。
• 运行时下载依赖网络连通性，项目将下载失败列为常见问题之一；服务无法启动时，项目建议查看服务器日志，最常见原因是 API Key 配置有误。
• 本地服务默认占用 4096 端口，若端口被占用需在设置中更换。
• 若智能体只返回文字而未给出代码，项目建议在提示中明确要求返回完整的 Python 脚本。
• 项目自述的路线图中，取消当前会话、导出智能体产出、以及接入第三方图生 3D 服务等功能仍处于未完成状态。

此外，由于项目创建与最后提交时间相同且尚无正式发布，其稳定性、兼容的 Blender 版本范围以及实际生成质量，都还没有可供参考的公开记录，采用前建议先在非关键项目中试用。