🌌 BlenderVibeBridge

\[！警告\] 实验与开发中\ 该项目目前是一个活跃的研究原型。API、安全协议和核心逻辑都会发生快速、突破性的变化。该软件在3D场景上执行突变； 强制备份 使用前需要。

“一键式”3D创作与精通技术总监

*生产级AI控制界面，用于确定性、撤销安全的搅拌机操作。*

BlenderVibeBridge允许外部工具和AI系统安全地控制Blender，而无需让它们不受限制地访问Python。

它是一个专业级的智能界面，将Blender转化为 受控几何核它允许AI代理与Blender的核心引擎进行安全、确定和艺术的交互，将自然语言意图转化为专业的生产操作。

能力	特性
🛡️ 铁盒	通过AST审计、行为断路器和本地绑定实现零信任安全。
⚛️ 内核完整性	实时不变强制（无负标度，无非流形几何）。
👻 幽灵审计	通过自动Git检查点和LFS跟踪，仅本地取证历史。
⚡ 反射弧	用于无阻塞引擎同步的2-Agent架构（工头+操作员）。
🏃 稳定运动	线程安全主回路调度 `bpy.app.timers` （无碰撞）。
🧠 认知控制	真相和解工具，防止人工智能对场景状态产生幻觉。

🎯 目标受众

技术总监和管道工程师 寻求安全的人工智能自动化。
人工智能系统研究人员 探索受控LLM到工具的接口。
3D内容创作者 他们希望在不冒场景损坏风险的情况下使用人工智能。

⚡ 快速入门（用法概览）

... 5\. 提示：让你的AI“检查我的Blender场景”来验证握手。

______________________________________________________________________

🤖 人工智能操作协议（强制性）

此存储库是受管几何内核。 为了保持网桥的稳定性，AI代理必须遵循 目录授权:

当地法律优先：子目录中的指令（例如。， blender_addon/.gemini)覆盖根级别规则。
路径发现：在修改任何子目录中的代码之前，请阅读本地 .gemini 或 README.md 调和不变量。
工作量证明：所有提交都需要 rationale_check 匹配电流 scene_hash。参见 commit_transaction 文档。

______________________________________________________________________

🔰 不是技术？从这里开始！\ 如果你是人工智能辅助Blender工作流程的新手，别担心。我们创建了一个 完整的初学者手册 这一步一步地解释了从设置到安全使用的一切。

______________________________________________________________________

🖼️ 预览

______________________________________________________________________

⚠️ 先读这个（为什么存在）

BlenderVibeBridge 它不是玩具、提示包装或“神奇的人工智能按钮”

它是一个 人工智能辅助系统设计的参考实现 在高保真、有状态的环境中。它允许大型语言模型（LLM）在Blender内安全运行，而不会冒场景损坏、数据泄露或执行失控的风险。

该项目回答了一个关键的工程问题：

*你如何让人工智能在一个复杂的、有状态的应用程序中行动——而不信任它？*

答案是：你没有。你约束它。

______________________________________________________________________

🧠 本项目展示了什么（面向工程师和招聘经理）

如果你作为一名工程师或招聘经理正在评估这个项目，这个存储库是一个工作演示 人工智能系统工程:

控制平面与执行平面分离：LLM生成 *意图* （机械意图），从不执行原始代码。
铁盒安全：通过本地绑定、静态AST审计和基于标头的心跳来加强。
事务状态突变：每个操作都包含在撤消安全的原子块中。 一个AI请求=一个撤销步骤。
确定性资产操纵：对材质槽、颜色和层次的控制是机械地处理的，消除了原始脚本的脆弱性。
真相和解循环：工具如 reconcile_state 允许代理在一次往返中验证关于场景的多个假设。

______________________________________________________________________

🛠️ 完整的工具参考（详尽）

1.🧠 认识论与认知治理（反幻觉）

reconcile_state：强制代理根据实际Blender状态验证其假设。
assert_scene_facts：在高影响突变之前声明和验证基本事实。
request_human_confirmation：暂停对价值判断或破坏性行为进行人为仲裁。
停滞会话警卫：如果Blender重新启动，则自动使信念无效（SESSION_ID跟踪）。

2.🛡️ 内核和完整性（护栏）

validate_scene_integrity：检查比例是否正常、缺少摄像头和空网格。
get_mesh_metrics：N-Gon、非流形边和顶点计数的数值分析。
manage_object_locks：颗粒轴锁定（定位/旋转/缩放）和“冻结”（隐藏/不可选）模式。
begin_transaction：复杂序列的原子撤消/重做块标记。

3.🏗️ 场景操纵和战略意图

execute_strategic_intent：运行“编译食谱”（例如。， BLOCKOUT_HUMANOID, THREE_POINT_LIGHTING).
add_primitive：产生立方体、球体或猴子。
transform_object：精确的位置、旋转和比例调整。
select_objects：管理选择集(ALL, NONE，或按名称）。
manage_collection：将对象组织到集合中。

4.🎨 技术艺术、节点和表面处理

manage_material：创建和指定材质。
manage_nodes：构建 着色器图 和 几何体节点 树（添加和链接）。
manage_modifier：配置 SUBSURF, ARRAY, BOOLEAN等，带有硬件安全帽。
trigger_bake：自动纹理烘焙（上限为2048px）。
process_mesh：阴影平滑/平坦、细分和物体连接。

5.🏃 动画、物理和机械逻辑

set_animation_keyframe：在时间线上插入变换的关键帧。
apply_physics：设置刚体、布料或碰撞模拟。
manage_constraints：索具工具，如 TRACK_TO, FOLLOW_PATH，以及 COPY_LOCATION.
create_procedural_curve：从坐标列表中生成3D贝塞尔样条曲线。
manage_vertex_groups：设置角色装配和重量绘制组。

6.🎬 制作、视觉和音频

setup_lighting：带安全能量帽的点、太阳、斑点和区域灯（10k）。
manage_camera：动态相机创建和活动视图控制。
set_world_background：设置全局环境颜色。
set_viewport_shading：在线框、实体、材质和渲染之间切换。
take_viewport_screenshot：代理的高速视觉反馈。
setup_spatial_audio：放置具有安全音频路径验证的3D扬声器对象。

7.🔗 管道和基础设施

import_export_asset：FBX、OBJ、STL和GLB文件的安全数据流。
link_external_library：专业的多文件资产链接。
create_3d_annotation：用于人工智能与人类交流的3D标记。
secure_write_file：AST验证了Python/C#文件写入。

📚 文档与治理

为了维护一个安全和确定的环境，该项目遵循严格的操作原则。有关设置、安全和哲学指导，请参阅以下文档：

🐣 对于初学者

完整的初学者手册：设置Blender、Python和AI桥的分步指南。
招聘经理：为技术招聘人员提供工程审计和系统设计概述。

🛠️ 适用于工程师和电力用户

技术安装指南深入了解架构、AST审计和主线程调度。
技术架构：有关拆分线程消费者模型和上下文覆盖的详细信息。
坐标系和标准化：振动计和轴平移公式。
测试与验证指南：单元、集成和安全测试程序。
人工智能工程约束：“人工智能宪法”----不可谈判的安全和结构规则。
Blender AI程序工作流程：身份和状态管理的强制性程序步骤。
Blender AI程序流程：Blender中AI操作的绝对执行顺序。
Vibe生命周期规程：生命周期和IO完整性的最终安全附录。
ISA规范：指令集架构（操作码和意图绑定）。
Blender内核工具清单：所有低级工具和功能的详尽列表。

🛡️ 安全和故障协议

安全策略：漏洞报告和基线安全任务。
安全与架构深度学习：“铁盒子”安全模型解释。
三重锁不变性模型：绝对决定论的三层验证系统。
代理隔离架构：多代理沙盒，防止上下文中毒。
防冻和恢复指南：预防和恢复Blender挂起和崩溃。

📜 理论与法律

治理和覆盖策略：“第四秩序”（人类在循环中）的规则。
非目标与原则：防止“人工智能精神病”的故意限制
人工智能背景与哲学：对抗性提示和“过度自信陷阱”的哲学指南
完整功能清单：所有功能能力的权威列表。
贡献指南：代码质量标准和“零信任”理念。
隐私政策：本地优先，零遥测承诺。

______________________________________________________________________

🛡️ 铁盒安全

桥梁通过三个不同的层硬化：

AST审计所有传入的Python代码都会被解析和扫描，以查找被禁止的调用（例如。， os.system, subprocess).
资产扫描：在链接之前，二进制资产会贪婪地扫描嵌入式脚本。
操作系统沙盒：可选的内核级隔离。

操作系统级安全层

您可以在运行之前通过设置环境变量来启用额外的保护 start_bridge.sh:

图层	变量	描述
Bublewrap	`USE_BWRAP=true`	使用Linux命名空间隔离文件系统。
消防监狱	`USE_FIREJAIL=true`	应用受限的安全配置文件和网络过滤
AppArmor	`USE_APPARMOR=true`	内核级强制访问控制（MAC）。

使用示例：

USE_BWRAP=true ./start_bridge.sh

*注意：AppArmor需要通过以下方式加载配置文件 sudo apparmor_parser -r security/blender_vibe_bridge.apparmor.*

______________________________________________________________________

🐣 初学者指南（入门）

下载：使用Blender 3.6 LTS或更新版本。
安装:

- 拉上拉链 blender_addon/vibe_bridge 目录。 - 安装 .zip 通过Blender的 编辑>首选项>附加组件>安装. - 启用 BlenderVibeBridge.

本地项目设置（Ghost审核）:

- 要启用自动取证日志记录和轻松还原，请在项目文件夹中初始化Git：

     cd /path/to/your/project
     git init
     git lfs install
     git lfs track "*.fbx" "*.mat" "*.png" "*.blend" "*.unity"
     git add .gitattributes && git commit -m "Initial Ghost Audit Setup"

API密钥配置:

- 要启用 反射弧 （快速脚本生成），在您的终端环境中设置您的API密钥：

     export VIBE_API_KEY="your_gemini_flash_key"

启动服务器:

   ./start_bridge.sh

构建：使用自然语言来编排您的生产流程。

______________________________________________________________________

🧠 人工智能素养与哲学

🧠 人工智能素养与人机界面

🏷️ 过度自信陷阱（为什么我们信任“Vibe”）

一个口齿伶俐、听起来像专家的回应会给人留下深刻印象，这是人类的自然本能。当人工智能以高置信度和专业术语提出解决方案时，很容易陷入异想--相信人工智能已经发现了一种“突破性”的捷径或一种“独特”的解决方案，可以突破标准的技术限制。

急躁的倾向：在生产高峰期，我们经常急于得出结论，因为人工智能为我们提供了答案 *想要* 听。我们用技术怀疑论换取效率的“氛围”。
陷阱：在未经证实的人工智能“突破”上构建你的项目是一场高风险的赌博。如果人工智能产生了成功的幻觉，直到你的场景崩溃或数据损坏无法修复，你才会发现。
规则在专业技术艺术中， 信心不是证据。 相信遥测（多晶硅计数、钻机审计），而不是人工智能的口头保证。

⚔️ 职业摩擦：通过对抗性提示进行验证

人工智能编排中最重要的技能是知道何时停止人工智能成为“乐于助人的人” 对抗性提示 是故意引入摩擦来验证技术主张的做法。每当人工智能声称拥有“独特”或“完美”的解决方案时，最专业的回应就是强迫它进入“Cynical Auditor”模式。这不是不信任的行为；这是一个专业的质量控制标准，通过在错误提交到您的场景之前发现错误来保护您的工作流程。

技术: 在做出任何“独特”或高影响力的改变之前，迫使人工智能发现自己的缺陷：

*“我希望你扮演一个愤世嫉俗的技术总监。审核这种特定的方法，找出3种可能失败、崩溃Blender或在复杂场景中损坏我的顶点组的基本方式。不要帮助我；要具有破坏性。向我证明为什么这种解决方案可能是一种负担。”*

为什么它有效: 它迫使模型将其搜索参数从“成功模式”切换到“失败模式”。这种基础通常会揭示隐藏的技术债务、边缘案例或逻辑错误，而人工智能最初只是为了“帮助”而掩盖了这些错误

🌐 Vibe生态系统

BlenderVibeBridge是为安全、人工智能控制的创意制作而设计的一套工具的一部分：

UnityVibeBridge：人工智能管理的Unity Editor操作和VRChat化身制作的兄弟项目。
VibeSync：多引擎AI管道的实时同步和编排。

______________________________________________________________________

🧑‍💻 关于作者

我专攻 本地LLM应用程序和安全的AI人机界面该系统是端到端构建的，旨在增强人类的工艺和创造力。BlenderVibeBridge诞生于对创作自由的渴望——构建我不知道如何手动使用的工具。公平的竞争环境是社区的一份礼物。

______________________________________________________________________

⚖️ 许可与法律责任

双重许可和维护协议（v1.2）

该项目分布在 双重许可模式。使用本软件即表示您同意受以下条款的约束。

1.开源路径：GNU AGPLv3

适用于非商业用途、业余爱好者和开源贡献者。 BlenderVibeBridge的核心桥接逻辑是自由软件：您可以根据自由软件基金会发布的GNU Affero通用公共许可证（AGPLv3）的条款重新分发和/或修改它。

对企业至关重要： AGPLv3要求，如果您运行此软件的修改版本并允许其他人通过网络与之交互，您必须将您的整个源代码公开。如果你不能或不愿分享你的源代码，你不得使用此许可证必须走下面的商业道路。

2.商业路径：“按劳计酬”模式

适用于产生收入的实体、商业工作室或希望将其修改保密的实体。根据GNU AGPLv3第7节，商业使用需要满足一以下内容：

维护贡献：记录并核实对项目的“重大维护贡献”。
许可费：支付规定的商业许可费。
酌情豁免：作者自行决定授予的书面弃权书。

3.贡献者许可协议（CLA）和来源

通过向本项目提交贡献（拉取请求、代码片段、错误修复或文档），您授予作者永久、全球性、非排他性、免费、免版税、不可撤销的版权许可，以使用、复制、准备衍生作品、公开展示和 分许可 您在软件的开源和商业版本中的贡献。

追踪豁免：此授权不要求作者跟踪、通知或寻求贡献者的进一步批准以供将来使用。您声明，您在法律上有权授予此许可，并且您的贡献不侵犯任何第三方权利。

______________________________________________________________________

⚠️ 责任限制、赔偿与人工智能免责声明

无担保：本软件按“原样”提供。作者不对人工智能解释操作的非确定性负责。
人工智能非决定论：作者对LLM到Blender翻译导致的“幻觉漂移”、意外资产删除、项目损坏或“氛围丧失”不承担责任。
作战人员任务：在人类用户执行“完成”检查之前，所有人工智能建议的突变都被视为“建议”。用户对他们允许人工智能执行的任何代码或变体承担全部法律和技术责任。
赔偿：您同意赔偿、保护并使作者免受因您使用软件、违反本许可证或使用本软件产生的任何资产而引起的任何和所有索赔、责任、损害和费用（包括律师费）。
第三方IP和EULA合规性:

- 非附属机构BlenderVibeBridge是一个独立的项目 不隶属于、不支持或赞助 Blender基金会或任何其他引擎提供商。 - 用户责任：用户全权负责确保其使用符合Blender的最终用户许可协议（EULA）和服务条款以及所使用的任何资产。

责任限制：在法律允许的最大范围内，在任何情况下，作者均不对任何直接、间接、附带或后果性损害（包括数据、利润或创意流的损失）承担责任。

由Vibe Bridge团队创建。

Blender Vibe Bridge

快速接入

详细介绍