PS3D CAD Studio

PS3D CAD Studio es un proyecto de investigación de CAD en navegador independiente, original y local-first. El repositorio actual es un candidato de versión pública 0.2 en funcionamiento: un proyecto semántico en los espacios de trabajo Sketch, Part, Assembly, Surface, Drawing, Electrical, Vehicle y Automate, además de un Centro de Aprendizaje, un portal de cuentas seguro y transporte MCP remoto autenticado.

No está copiado de PartMode ni de otro código base de CAD. El proyecto tiene sus propios requisitos, arquitectura, código fuente, interfaz, ejemplos, pruebas, registro de procedencia y licencia MIT. El desarrollo independiente reduce el riesgo de derechos de autor, pero no es una opinión legal ni una autorización de patente, marca comercial o libertad de operación.

Fuente pública canónica: sagar25-Code-it/ps3d-cad-studio.

Qué funciona localmente

El portal de cuentas público admite registro con correo verificado, inicio de sesión, cierre de sesión, recuperación de contraseña, sesiones con alcance de pestaña y hasta cinco tokens personales MCP únicos y con caducidad por usuario. OAuth 2.1 es la ruta de conexión preferida para hosts de IA compatibles. Los tokens personales sin procesar se muestran una vez y se persisten solo como resúmenes HMAC con pimienta. El Centro de Aprendizaje contiene 12 módulos guiados por verificación desde principiante hasta práctica avanzada y genera un manual PDF de 15 páginas a partir del mismo contenido fuente revisado.

El shell también proporciona un sistema de espacio de trabajo de rueda de colores original, una barra de menú funcional Archivo/Editar/Crear/Ver/Inspeccionar/Automatizar/Ayuda, una cinta de comandos superior sensible al contexto con símbolos SVG en línea propiedad del proyecto, un catálogo de comandos CAD original de 119 comandos navegable por teclado y filtrado por espacio de trabajo con niveles de capacidad explícitos, un explorador de modelos persistente con línea de tiempo de Origen/Bocetos/Historial de características/Cuerpos/revisión, selección que preserva el espacio de trabajo, auditoría de revisión, guardar/cargar IndexedDB local del navegador, JSON de proyecto amplio, JSON de revisión nativo y STL binario de la pieza cualificada, SVG de dibujo seguro, insignias de capacidad veraces y diagnósticos visibles.

La línea base de interacción investigada y la matriz de implementación están en docs/product/CAD_INTERACTION_ESSENTIALS.md. La paleta, el símbolo de comando, el menú y las reglas responsivas se registran en docs/product/UI_COLOR_AND_COMMAND_SYSTEM.md. La matriz exacta de formatos de intercambio, las reglas de unidades, el límite de PDF y el modelo de seguridad están en docs/product/3D_EXCHANGE_AND_PDF.md. El límite de revisión automática de vistas, dimensiones, tolerancias generales, datos y GD&T está en docs/product/AUTOMATIC_DRAWING_AND_TOLERANCE.md. Las plantillas nominales de contenedores, el límite de arreglo BESS no certificado, el modelo de datos eléctricos, las plantillas de circuitos, el ERC y las exclusiones de ingeniería están en docs/product/CONTAINER_BESS_AND_ELECTRICAL.md. El catálogo genérico de paneles eléctricos, el modelo de trazado ECAD↔MCAD, el límite de ruta de conductores, el comportamiento de enlaces obsoletos y el contrato de confirmación MCP están en docs/product/ELECTROMECHANICAL_REALIZATION.md. Las plantillas de vehículos, las convenciones SI, las ecuaciones visibles, el modelo de soporte de tres ruedas, el límite MCP, las exclusiones de cualificación y el índice de fuentes de investigación están en docs/product/VEHICLE_ENGINEERING.md. La lista combinada de 31 roles de persona de PS Code Hub, seis roles especialistas extendidos de PS3D, el límite de credenciales veraces, el modelo de enrutamiento de tareas y el bucle de revisión están en docs/PS_CODE_HUB_AI_TEAM.md. La matriz determinista de salud del espacio de trabajo, el mapa de asociatividad real, el orden de revisión de reconstrucción, la cola de reparación, las reglas de puntuación y el límite de liberación están en docs/product/DESIGN_HEALTH_AND_REBUILD.md.

Solo la ruta de pieza con orificio centrado está marcada como qualified. Todas las demás capacidades funcionales del banco de trabajo están marcadas como preview. No están disponibles: B-rep/NURBS exactos, solucionadores generales de Booleanos y restricciones, nombres de caras persistentes, recorte/costura, conversión exacta STEP/IGES/DWG/DXF, CAD propietario nativo, certificación de dibujos PDF de producción, colaboración compartida en la nube de documentos CAD, dimensionamiento eléctrico automático, coordinación de protecciones, análisis de arco eléctrico/cumplimiento, paquetes eléctricos automáticos precisos del fabricante, dimensionamiento de conductores/arneses, simulación cualificada de vehículos multicuerpo/neumáticos/FEA/térmica/choque, homologación y control MCP en navegador en vivo. El MCP remoto autenticado es un transporte de Vista Previa sin estado: acepta valores acotados explícitos y devuelve JSON o una copia nueva del proyecto; no toma el control de la pestaña CAD abierta. Consulte docs/product/PRD_PHASE_1_WORKBENCH_PREVIEW.md para conocer el contrato exacto y las exclusiones.

Related MCP server: solidworks-mcp

Ejecutar y verificar

Los requisitos previos son Node.js 24 o superior y pnpm 11.9.0. Cada versión de paquete es exacta y la conciliación de bloqueo a inventario es una puerta de prueba/compilación ejecutada.

pnpm install --frozen-lockfile --ignore-scripts
pnpm peers check
pnpm typecheck
pnpm test
pnpm build
pnpm dev

Vite imprime la URL del navegador local. pnpm test ejecuta la suite de paquetes tipados, el intercambio real de cliente/servidor MCP stdio, la conciliación de dependencias y ambas puertas de identidad de origen. pnpm build además rechaza el SDK MCP solo para Node, el candidato Manifold, WASM y la evaluación dinámica del gráfico del navegador, y verifica la política de seguridad del host estático y los avisos incluidos. Los flujos de trabajo de GitHub incluidos repiten las puertas de verificación de tipos, evidencia, compilación, CodeQL y revisión de dependencias en ejecutores alojados limpios.

Conectar un host MCP

Para una instancia desplegada, use el endpoint HTTPS que se muestra en /access:

https://your-ps3d-domain.example/api/mcp

Prefiera el descubrimiento automático de OAuth 2.1. Si un host admite encabezados HTTP personalizados pero no OAuth, cree un token personal ps3d_mcp_... con alcance y caducidad en /access; nunca ponga la contraseña web en la configuración de MCP. La guía completa de configuración remota, alcance, errores y comandos seguros está en docs/MCP_CONNECTION_GUIDE.md.

El servidor stdio local sigue disponible para hosts locales aprobados. No tiene estado y usa la misma semántica de herramientas acotadas:

No lee ningún archivo de proyecto, secreto de entorno, perfil de navegador, credencial del sistema operativo ni recurso de red. Cada llamada proporciona su proyecto acotado completo y recibe un resultado.

pnpm mcp:build
node apps/mcp-server/dist/apps/mcp-server/src/server.js

Compile una vez y luego configure el host para lanzar Node directamente. Esto mantiene stdout reservado para JSON MCP enmarcado por nuevas líneas en lugar de la salida de compilación del administrador de paquetes. Ejemplo de adaptador de host después de clonar, instalar y compilar:

{
  "mcpServers": {
    "ps3d": {
      "command": "node",
      "args": ["apps/mcp-server/dist/apps/mcp-server/src/server.js"],
      "cwd": "<absolute-path-to-ps3d-repository>"
    }
  }
}

El servidor admite el descubrimiento moderno de MCP 2026-07-28 y la inicialización en modo heredado de la era 2025 a través de stdio local. Empiece con ps3d_guide; use ps3d_find_commands para mapear un objetivo en lenguaje natural a una receta acotada sin ejecutarla. Las diez herramientas son ps3d_guide, ps3d_find_commands, ps3d_capabilities, ps3d_inspect_project, ps3d_design_health, ps3d_analyze_vehicle, ps3d_electromechanical_catalog, ps3d_preview_electromechanical, ps3d_preview_operation y ps3d_apply_preview.

La vista previa de circuito a 3D usa únicamente el catálogo genérico propio del proyecto y devuelve una operación exacta incluido el recibo; no aplica el resultado ni controla una sesión de navegador en vivo. Apply acepta solo un recibo de vista previa SHA-256 coincidente además de confirmed: true, devuelve un proyecto nuevo y no escribe ningún estado externo. El indicador de confirmación corresponde una afirmación del host, no una prueba criptográfica de revisión humana, y el recibo es una suma de comprobación de integridad, no una firma. Las llamadas externas no controlan el proyecto de navegador abierto: un host proporciona un proyecto completo y, a continuación, el usuario lo revisa y abre o importa la copia devuelta. El contrato completo de conexión, espacio de nombres de comandos y seguridad está en docs/AI_COLLABORATION.md. El transporte remoto de Vercel añade autenticación HTTPS, filtrado de ámbito, gestión estricta de Origin, un tope de solicitudes de 1 MB y límites de tasa por identidad sin almacenar los datos del proyecto.

Python 3.11+ puede usar el cliente de biblioteca estándar propio del proyecto que se encuentra en sdk/python. El invocador proporciona explícitamente el comando, el directorio de trabajo, el proyecto/operación en memoria, el recibo y la confirmación. El cliente usa shell=False, no contiene código de red, no realiza ningún descubrimiento automático de archivos ni secretos, y está documentado en docs/PYTHON_LINKING.md. El intercambio de proceso real queda diferido a un entorno de desarrollo o CI personal o aprobado por TI.

Arquitectura, evidencia y capturas de pantalla

El proyecto semántico y el historial de revisiones son la autoridad. Los estados del worker/kernel, de la vista previa teselada, de SVG y Three.js son artefactos derivados desechables. La arquitectura está documentada en docs/architecture/PHASE_1_WORKBENCH_ARCHITECTURE.md y las decisiones se recogen en docs/adr.

Las capturas de revisión en navegador, incluidas la cinta superior revisada, el historial de funcionalidades, el 3D Exchange Center, el PDF flujo de trabajo, la referencia importada, los diseños de ingeniería de vehículos en capas y el Design Health Center, se encuentran en docs/screenshots. La evidencia de cualificación local queda registrada en docs/PHASE_1_LOCAL_EVIDENCE.md. Las dependencias y el material asistido se rechazan por defecto y se registran en provenance; ninguna clave, token, archivo .env, ruta privada, datos de usuario, dato del usuario ni activo CAD copiado debe estar en el repositorio.

Estado de despliegue

vercel.json define el despliegue protegido de Vite y las funciones de API estándar de la Web. Supabase proporciona la identidad; la migración solo almacena hashes de tokens y contadores de frecuencia agregados. La configuración exacta del nivel gratuito, los límites adicionales, la verificación en vivo y los controles de incidentes se incluyen en docs/PUBLIC_DEPLOYMENT.md, y la revisión de lanzamiento bloqueada está en docs/RELEASE_CHECKLIST.md. Los niveles gratuitos de los proveedores tienen cuotas y no son una promesa de servicio ilimitado o permanentemente gratis.

Licencia

El material original del proyecto está licenciado bajo la Licencia MIT. Los componentes de terceros conservan sus propias licencias y avisos. Consulta LICENSE, THIRD_PARTY_NOTICES.md, INDEPENDENT_DEVELOPMENT.md y provenance/SOURCE_POLICY.md.