Kazama-Suichiku/Houdini-Agent

解决的问题

Houdini Agent 是为自动化和优化 SideFX Houdini 中复杂的程序化 3D 工作流而设计的 AI 助手。它通过一个能够直接操作软件环境的自主代理，消除了构建节点网络、编写 VEX/Python 代码以及获取 3D 资产的手动工作量。

工作原理

该项目作为一个独立的桌面应用程序运行，通过轻量级桥接连接到正在运行的 Houdini 会话。它使用由 OpenAI 的 Function Calling 协议驱动的自主代理循环，使 AI 能够规划任务、执行工具并根据结果进行迭代。

关键机制包括：

• 代理模式：提供“代理模式”用于完整场景修改，“询问模式”用于只读分析，以及“计划模式”用于在执行前创建带有 DAG 流程图的结构化执行计划。
• 工具集成：代理可访问超过 50 个工具，用于节点操作（创建、连接和修改节点）、几何分析（通过预优化的 Python 脚本“技能”系统）以及系统级执行（Python 和 Shell）。
• 3D 生成：集成 Meshy AI API，从文本或图像生成带纹理的 3D 模型，并自动将其作为带有 PBR 材质的 GLB 资产导入 Houdini。
• 记忆与上下文：采用受大脑启发的三层记忆系统（情景记忆、语义记忆和程序记忆），使代理能够从过往交互中学习，同时用户定义的上下文规则提供持久性指令。

适用人群

希望加速程序化生成工作流、自动化重复性节点设置，或直接将生成式 AI 3D 资产集成到场景中的技术艺术家、3D 通才和 Houdini 用户。

主要亮点

• 自主循环：支持多轮工具调用和复杂任务分解为可追踪的子任务。
• Meshy AI 集成：提供从文本/图像到 3D 的完整流程，支持重新纹理和重拓扑，并配有交互式概念画廊，支持人机协同选择。
• 深度集成：可读取节点网络、执行 VEX wrangles，并通过聊天中的可点击路径导航至特定节点。
• 高级 UI：采用现代 QML/Qt Quick「Mono Editorial」界面，具备实时令牌分析、流式代码预览和云资产库功能。
• 可扩展性：支持社区扩展的插件系统，以及通过 OpenRouter 或自定义端点接入多种 AI 提供商（DeepSeek、OpenAI、Claude 等）。