Unity Vibe Bridge

🌌 UnityVibeBridge

Unity Editor扩展，通过受保护的控制内核约束意图执行，实现安全、确定性的人工智能辅助场景创建和编辑。

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

Unity编辑器精通“一键”技术总监

*用于确定性、撤消安全Unity编辑器操作的生产级AI控制界面。*

UnityVibeBridge 是一个专业级的智能界面，可以将Unity编辑器转换为 受控创建内核它允许AI代理与Unity的核心引擎进行安全、确定和艺术的交互，将自然语言意图转化为专业的生产操作。

______________________________________________________________________

🏛️ 项目架构（文本描述）

UnityVibeBridge作为 分割平面内核:

1. 意图平面（MCP服务器）：一个基于Python的服务器，从AI代理接收高级命令。它通过以下方式审核这些命令 SecurityGate 并把他们排成一列 vibe_queue/inbox.
2. 执行平面（Unity编辑器）：Unity中轮询队列的C#内核。它使用a 强化异步内核 (UniTask)用于非阻塞操作和 零反射IPC (MemoryPack)用于安全、高速的数据传输。
3. 审计平面（预写日志）：每笔交易都记录到 logs/vibe_audit.jsonl 并用Git安全快照括起来进行取证验证。

\[！重要\] 动态路径分辨率：为了保持跨不同开发环境的可移植性，所有脚本都必须使用动态路径解析（例如。， os.path.abspath(os.path.dirname(__file__))).严格禁止使用硬编码的主目录路径。

______________________________________________________________________

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

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

它是一个 人工智能辅助系统设计的参考实现 在高保真、有状态的环境中。它允许大型语言模型（LLM）在Unity中安全运行，而不会冒项目损坏、无限导入循环或执行失控的风险。

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

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

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

______________________________________________________________________

🧠 这个项目展示了什么（技术审计）

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

• 控制平面与执行平面分离：LLM生成 *意图* （机械意图），从不执行原始代码。
• 对抗性安全：通过本地绑定、会话令牌身份验证和 递归AST审计 Python有效载荷。
• 三阶不变性：实施“三重锁定”系统：

1. 机械的：硬引擎保护（编译过程中无突变）。 1. 上下文的：强制将WAL哈希值和单调滴答声输入到每个响应中。 1. 语义：每次提交都需要强制性的“工作量证明”（理由+状态哈希）。

• 单代理控制：统一编排，代理通过过滤的、与引擎无关的IPC管理引擎内核，确保单点真实性和原子状态转换。
• 事务状态突变：每个操作都包含在撤消安全的原子块中。 一个AI请求=一个撤销步骤。
• 绩效预算：实施 5ms主线时间预算 并遵守 Unity防冻指南 以确保Unity编辑器即使在人工智能高度自动化的情况下也能保持60+FPS。
• 取证审计跟踪（Git日志记录）：每个突变都被记录到一个加密链中 预写日志（WAL）。对于本地设置，我们建议配置Git以跟踪 logs/ 目录作为次要的不可变分类账（请参阅设置）。
• 真相和解循环：工具如 get_telemetry_errors 迫使代理在闭环反馈中根据意图验证现实。

______________________________________________________________________

⚡ 你能在5分钟内做什么

1. 安装：拖动 unity-package/ 将文件夹放入Unity项目的 Assets/.
2. 初始化：等待编译。内核在端口上自动启动 8085.
3. 连接：使用以下命令将您的AI代理（Claude Desktop、Goose等）指向网桥 scripts/python mcp-server/server.py.
4. 创建问AI： *在原点生成一个红色立方体，并将其命名为“TestCube”*
5. 审计问AI： *“对我选择的对象运行网格审计，并告诉我多边形计数。”*

______________________________________________________________________

需求:

• 统一：2019.4 LTS或更新版本。
• 操作系统：Windows、Linux或macOS。
• 团结依赖：强化异步内核需要UniTask、MemoryPack和编辑器协程。

🚀 快速入门（详细安装）

1. 安装Unity软件包:

从Unity项目根目录运行自动化脚本：

   python /path/to/UnityVibeBridge/scripts/setup_unity_deps.py

这将通过Git URL将UniTask和MemoryPack添加到您的项目中。

1. 安装VibeBridge：复制 unity-package/ 目录到项目的 Assets/ 文件夹。
2. 初始化：等待Unity编译。内核在端口上自动启动 8085.
3. 握手：将您的MCP兼容AI代理（例如Goose、Claude Desktop）指向网桥。
4. 监视器：打开 http://localhost:22005 观看直播 系统脉冲 和 连锁审计追踪.

______________________________________________________________________

🔰 入门指南

Unity中的AI开发新手？从这里开始了解哲学、安全机制以及如何避免“人工智能精神病”等常见陷阱。

👉 阅读初学者综合指南

______________________________________________________________________

🛠️ 常见AI意图（示例）

AI通过以下方式与Unity交互 机械工具以下是代理在连接后可以自主执行的典型请求：

______________________________________________________________________

🛡️ 可验证的安全保障

与标准脚本桥不同，UnityVibeBridge将AI视为 不受信任的操作员.

1. 顶层套房：我们包括a security_tests/pentest_suite.py 它测试了48种已知的攻击媒介。
2. 法医分类账：每个突变都记录到 不可变的、加密链接的审计日志 (vibe_audit.jsonl).
3. 人类死亡开关：内核包括一个机械 system/veto 立即锁定创建边界的工具。

______________________________________________________________________

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

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

• inspect_object：强制代理验证其对组件和状态的假设。
• get_telemetry_errors：将最后50个控制台日志流式传输到代理进行“真相循环”验证。
• list_available_tools：动态发现已安装的有效载荷和功能。
• 停滞会话警卫：如果Unity重新启动，则自动使信念无效（通过 sessionNonce 跟踪）。

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

• transaction_begin/commit：原子撤消组管理。
• system/veto：所有创建图元的物理停止按钮。
• 内核防护：在编译或播放模式下阻止突变。
• 时间预算：每帧5ms执行窗口的内核级强制。

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

• get_hierarchy：场景映射的实例ID和名称的递归转储。
• system/search：用于大规模场景的高性能正则表达式和基于层的发现。
• rename_object / reparent_object：精确的转换和身份调整。
• clone_object / delete_object：支持撤消的GameObjects管理生命周期。
• select_object：具有焦点感知的“隐形取景”，尊重用户的活动视口。

4.🎨 技术艺术、保险与优化

• object/set-value：公共字段和属性的安全、基于反射的突变。
• vram_footprint：按纹理对GPU内存使用情况的数值分析。
• texture_crush：使用硬件安全帽批量缩小纹理（最大8k）。
• swap_to_quest_shaders：自动将材质转换为移动安全着色器。
• opt/fork：使用孤立的材料克隆创建非破坏性优化变体。

5.🔗 管道和基础设施

• world/spawn：从项目数据库中安全实例化预制件。
• asset/rename / move：在不破坏GUID链接的情况下进行安全的文件系统操作。
• export/validate：检查缩放健全性、非零旋转和缺少脚本。
• view/screenshot：通过端口8085进行高速视觉反馈。

______________________________________________________________________

🛡️ 铁盒安全

桥梁通过四个不同的层进行硬化：

1. AST审计：所有传入的工具调用都由审核 scripts/security_gate.py 禁止的图案。
2. 令牌身份验证：端口8085需要 X-Vibe-Token 匹配当前会话。
3. 铁盒协议：每个突变都被包裹在原子中 Undo 组。 一个AI请求=一个撤销步骤。
4. 保安：如果发生以下情况，该桥将在物理上禁用突变 vibe_status.json 不是“准备好了”。

______________________________________________________________________

📘 用户指南和理念

• 完整功能清单：所有功能能力和路线图的权威列表。
• 技术安装与工程：深入了解内核架构、安全性和高级设置。
• AI哲学与安全学习如何管理人工智能行为并预防“人工智能精神病”

______________________________________________________________________

🌐 VibeBridge生态系统

UnityVibeBridge是为无缝人工智能辅助创建而设计的三位一体工具的一部分：

• BlenderVibeBridge：高保真3D建模和装配的配套内核。
• VibeSync：在Unity和Blender之间同步状态的编排层。

______________________________________________________________________

🤝 社区&软化“铁盒子”

虽然我们的“铁盒子”安全模型是严格的，但它旨在 赋能 创作者，不要限制他们。护栏的存在是为了让你可以自由地进行实验，而不必担心破坏你的作品。

项目新手？ 不要被技术强度吓倒。我们欢迎所有技能水平的贡献者。如果你有一个新的有效载荷或更好的数据可视化方法的想法，那就加入吧！我们的 新手指南 和 贡献指南 有没有帮助您安全地浏览内核。

______________________________________________________________________

🏛️ 项目原则与架构

• 招聘经理：深入的工程审计和系统设计分解。
• 愿景与哲学：深入了解架构目标和问题空间。
• 技术架构：控制平面与执行平面的高级概述。
• 最终不变蓝图：分布式证明系统和数据流的权威地图。
• 三重锁不变性：关于防止幻觉的第1-3层安全模型的详细信息。
• 认识完整性：三阶不变量防止系统性自我欺骗和漂移。
• Unity防冻指南：防止编辑器和运行时挂起的规范引用。
• 非目标与原则：项目的故意限制和哲学护栏。
• 安全威胁接受：责任边界和剩余风险的正式定义。
• 工程约束条件：管理所有代码生成的严格技术规则。
• 故障模式和恢复：系统故障和恢复协议的分类。
• 贡献：扩展内核或添加新有效载荷的指南。

______________________________________________________________________

⚖️ 许可与法律责任

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

版权所有（C）2026 B-A-M-N（“作者”）

该项目分布在 双重许可模式。使用本软件即表示您同意受 许可证 文件。

1. 开源路径：GNU AGPLv3：业余爱好者和非商业研究免费。
2. 商业路径：“按劳计酬”：针对创收实体。需要 重大维护贡献 或一个 许可费.

完整隐私政策 | 安全授权

______________________________________________________________________

由Vibe Bridge团队创建。