Repolode
sixtysevenlf

sixtysevenlf/dsh-blender-plugin

Un plugin de DSH que permite a un modelo de IA controlar una sesión de Blender en ejecución mediante un canal TCP directo, con 16 herramientas para capturar el viewport, editar escenas y trabajar en modo headless.

Estrellas
715
Forks
32
Issues abiertos
10
Último commit
ayer

¿Qué es?

DSH x Blender es un plugin para el entorno de agentes DSH (DeepSeek Harness) que conecta un modelo de IA directamente con Blender a través de un canal TCP local, sin necesidad de un servidor MCP. Un addon de Blender incluido escucha en 127.0.0.1:9876 y un backend de Node.js en 127.0.0.1:9877 retransmite los comandos, de modo que el modelo puede capturar el viewport 3D, ejecutar Python en el hilo principal de Blender, renderizar desde ángulos de cámara personalizados y realizar búsquedas iterativas de parámetros.

Además de la edición de escenas en vivo, el plugin incluye perfilado del rendimiento de renderizado con ajustes predefinidos, decimación segura de objetos, procesos `blender -b` en modo headless para renders pesados y geometría por lotes, transacciones con snapshot o reversión a nivel de objeto, una biblioteca reutilizable de presets y una capa de trabajos para tareas de larga duración. Una herramienta de plan agrupa comprobaciones de contratos, auditorías de mallas, puertas de ensamblaje y verificación de exportación en 28 familias y 186 operaciones.

El plugin requiere Blender 4.x o 5.x ejecutándose con su interfaz gráfica para el canal en vivo, Node.js 20 o superior y una instalación de DSH. Es compatible con WSL usando Blender de Windows, Windows, Linux nativo y macOS, y se publica bajo la licencia BSD-3-Clause.

Funciones clave

  • 01Captura el viewport 3D desde la vista del usuario o desde cualquier ángulo de cámara personalizado sin modificar la escena.
  • 02Ejecuta Python en el hilo principal de Blender mediante un kernel persistente para ediciones de varios pasos.
  • 03Ejecuta bucles iterativos de búsqueda de parámetros dentro de Blender con límites de iteraciones y de tiempo.
  • 04Perfila los ajustes de renderizado y aplica presets de datos persistentes y de eliminación de ruido, con soporte para revertirlos.
  • 05Deriva los renders pesados y la geometría por lotes a procesos de Blender en modo headless.
  • 06Ofrece transacciones de snapshot y a nivel de objeto para poder revertir cambios.

Casos de uso

  • Permitir que un agente de IA modele, ajuste y verifique objetos en una escena de Blender abierta.
  • Ejecutar barridos de parámetros que ajusten un modelo a una silueta de referencia.
  • Renderizado por lotes o procesamiento de geometría en Blender headless mientras la interfaz gráfica sigue libre.
  • Comprobar ensamblajes mecánicos en busca de holguras e interferencias antes de imprimirlos en 3D.

Inicio rápido

  1. 1

    Clona el repositorio y entra en el directorio

    cd dsh-blender-plugin
  2. 2

    Instálalo como bundle en un perfil de DSH (crea un enlace simbólico, añade el enlace al package.json del perfil y reinicia DSH)

  3. 3

    Inicia Blender, conecta el complemento DSH Blender Bridge incluido y comprueba la instalación con el endpoint doctor

    curl -sS http://127.0.0.1:9877/doctor

Antes de usarlo

  • Blender debe ejecutarse en modo GUI, ya que el canal en vivo no funciona en modo de segundo plano.
  • Se necesita un host de DeepSeek Harness (DSH) y Node.js 20 o posterior.
  • El complemento MCP upstream para Blender ya no tiene soporte; debes instalar el complemento incluido.

Temas

Preguntas frecuentes

¿Qué es dsh-blender-plugin?
Un plugin de DSH que permite a un modelo de IA controlar una sesión de Blender en ejecución mediante un canal TCP directo, con 16 herramientas para capturar el viewport, editar escenas y trabajar en modo headless. DSH x Blender es un plugin para el entorno de agentes DSH (DeepSeek Harness) que conecta un modelo de IA directamente con Blender a través de un canal TCP local, sin necesidad de un servidor MCP. Un addon de Blender incluido escucha en 127.0.0.1:9876 y un backend de Node.js en 127.0.0.1:9877 retransmite los comandos, de modo que el modelo puede capturar el viewport 3D, ejecutar Python en el hilo principal de Blender, renderizar desde ángulos de cámara personalizados y realizar búsquedas iterativas de parámetros.
¿dsh-blender-plugin es gratuito? ¿Qué licencia tiene?
dsh-blender-plugin es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿dsh-blender-plugin sigue mantenido?
Mantenimiento activo. El último commit de dsh-blender-plugin fue el 19 oct 2026.
¿Para qué puedo usar dsh-blender-plugin?
Permitir que un agente de IA modele, ajuste y verifique objetos en una escena de Blender abierta. Ejecutar barridos de parámetros que ajusten un modelo a una silueta de referencia. Renderizado por lotes o procesamiento de geometría en Blender headless mientras la interfaz gráfica sigue libre. Comprobar ensamblajes mecánicos en busca de holguras e interferencias antes de imprimirlos en 3D.
¿Cómo se instala dsh-blender-plugin?
Clona el repositorio y entra en el directorio: cd dsh-blender-plugin Instálalo como bundle en un perfil de DSH (crea un enlace simbólico, añade el enlace al package.json del perfil y reinicia DSH) Inicia Blender, conecta el complemento DSH Blender Bridge incluido y comprueba la instalación con el endpoint doctor: curl -sS http://127.0.0.1:9877/doctor
¿Dónde consigo dsh-blender-plugin?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/sixtysevenlf/dsh-blender-plugin

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados