PS3D CAD Studio

PS3D CAD Studio — это независимый, оригинальный, локально-ориентированный браузерный исследовательский проект САПР. Текущий репозиторий — рабочий кандидат публичного релиза 0.2: один семантический проект, охватывающий рабочие пространства Sketch, Part, Assembly, Surface, Drawing, Electrical, Vehicle и Automate, а также учебный центр, защищённый портал учётной записи и аутентифицированный удалённый транспорт MCP.

Проект не скопирован из PartMode или другой кодовой базы САПР. У проекта есть собственные требования, архитектура, исходный код, интерфейс, примеры, тесты, запись о происхождении и лицензия MIT. Независимая разработка снижает риск нарушения авторских прав, но не является юридическим заключением или разрешением по патентам, товарным знакам или свободе действий.

Канонический публичный исходный код: sagar25-Code-it/ps3d-cad-studio.

Что работает локально

Публичный портал учётной записи поддерживает регистрацию с подтверждённой электронной почтой, вход, выход, восстановление пароля, сеансы с ограничением по вкладкам и до пяти уникальных истекающих персональных токенов MCP на пользователя. OAuth 2.1 — предпочтительный путь подключения для совместимых AI-хостов. Необработанные персональные токены показываются один раз и сохраняются только в виде хешей HMAC с перцем. Учебный центр содержит 12 модулей с проверкой знаний — от начального до продвинутого уровня практики — и генерирует 15-страничное PDF-руководство из того же проверенного исходного контента.

Оболочка также предоставляет оригинальную систему рабочих пространств с цветовым кругом, функциональную строку меню File/Edit/Create/View/Inspect/Automate/Help, контекстно-зависимую верхнюю командную ленту с принадлежащими проекту встроенными SVG-символами, навигируемый с клавиатуры и фильтруемый по рабочим пространствам оригинальный каталог команд САПР из 119 команд с явными уровнями возможностей, постоянный браузер моделей с Origin/Sketches/Feature History/Bodies/хронологией ревизий, сохранение выбора между рабочими пространствами, аудит ревизий, сохранение/загрузку в локальную IndexedDB браузера, широкий проектный JSON, собственный JSON ревизий и двоичный STL квалифицированной детали, безопасный SVG чертежа, правдивые значки возможностей и видимую диагностику. Исследованный базовый уровень взаимодействия и матрица реализации находятся в docs/product/CAD_INTERACTION_ESSENTIALS.md. Палитра, правила командных символов, меню и адаптивности записаны в docs/product/UI_COLOR_AND_COMMAND_SYSTEM.md. Точная матрица форматов обмена, правила единиц, границы PDF и модель безопасности — в docs/product/3D_EXCHANGE_AND_PDF.md. Границы автоматического вида, размеров, общих допусков, баз и GD&T-рецензирования — в docs/product/AUTOMATIC_DRAWING_AND_TOLERANCE.md. Номинальные шаблоны контейнеров, границы неквалифицированной компоновки BESS, модель данных электрики, шаблоны цепей, ERC и инженерные исключения — в docs/product/CONTAINER_BESS_AND_ELECTRICAL.md. Общий каталог электрических панелей, модель трассировки ECAD↔MCAD, границы путей проводников, поведение устаревших связей и контракт подтверждения MCP — в docs/product/ELECTROMECHANICAL_REALIZATION.md. Шаблоны транспортных средств, соглашения SI, видимые уравнения, модель опоры трёхколёсных, границы MCP, исключения квалификации и индекс исследовательских источников — в docs/product/VEHICLE_ENGINEERING.md. Объединённый список ролей PS Code Hub из 31 роли, шесть расширенных специализированных ролей PS3D, правдивая граница учётных данных, модель маршрутизации задач и цикл рецензирования — в docs/PS_CODE_HUB_AI_TEAM.md. Детерминированная матрица здоровья рабочих пространств, реальная карта ассоциативности, порядок проверки перестроения, очередь ремонта, правила оценки и границы выпуска — в docs/product/DESIGN_HEALTH_AND_REBUILD.md.

Только путь детали с центральным отверстием помечен как qualified. Все остальные функциональные возможности рабочих мест помечены как preview. Точные B-rep/NURBS, общие решатели логических операций и ограничений, постоянное именование граней, подрезка/сшивание, точное преобразование STEP/IGES/DWG/DXF, собственные проприетарные форматы САПР, сертификация производственных PDF-чертежей, совместная облачная работа над CAD-документами, автоматический расчёт электрики, координация защиты, анализ дуговой вспышки/соответствия, точные автоматические электрические пакеты от производителя, расчёт сечения проводников/жгутов, квалифицированное моделирование транспортных средств multibody/шин/FEA/тепловое/краш, гомологация и управление MCP в живом браузере недоступны. Удалённый аутентифицированный MCP — это транспорт Preview без сохранения состояния: он принимает явные ограниченные значения и возвращает JSON или новую копию проекта; он не перехватывает открытую вкладку САПР. См. docs/product/PRD_PHASE_1_WORKBENCH_PREVIEW.md для точного контракта и исключений.

Related MCP server: Battenmark

Запуск и проверка

Предварительные требования: Node.js 24 или новее и pnpm 11.9.0. Каждая версия пакета точна, а сверка блокировки с инвентаризацией — это выполняемый этап тестирования/сборки.

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

Vite выводит локальный URL браузера. pnpm test запускает типизированный набор пакетов, реальный обмен stdio-клиент/сервер MCP, сверку зависимостей и оба проверочных барьера идентичности исходного кода. pnpm build дополнительно отклоняет Node-only MCP SDK, кандидата Manifold, WASM и динамическое вычисление из графа браузера и проверяет политику безопасности статического хостинга и прилагаемые уведомления. Включённые рабочие процессы GitHub повторяют проверки типов, доказательств, сборки, CodeQL и рецензирования зависимостей в чистых размещённых раннерах.

Подключение MCP-хоста

Для развёрнутого экземпляра используйте конечную точку HTTPS, показанную на /access:

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

Предпочитайте автоматическое обнаружение OAuth 2.1. Если хост поддерживает пользовательские HTTP-заголовки, но не OAuth, создайте один ограниченный истекающий персональный токен ps3d_mcp_... на /access; никогда не помещайте веб-пароль в конфигурацию MCP. Полное руководство по удалённой конфигурации, областям, ошибкам и безопасным командам находится в docs/MCP_CONNECTION_GUIDE.md.

Локальный stdio-сервер остаётся доступным для одобренных локальных хостов. Он не имеет состояния и использует ту же семантику ограниченных инструментов:

Он не читает ни файлов проекта, ни секретов окружения, ни профиля браузера, ни учётных данных операционной системы, ни сетевых ресурсов. Каждый вызов предоставляет свой полный ограниченный проект и получает результат.

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

Соберите один раз, затем настройте хост на прямой запуск Node. Это сохраняет stdout зарезервированным для MCP JSON с разделителями строк, а не для вывода сборки менеджера пакетов. Пример адаптера хоста после клонирования, установки и сборки:

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

Сервер поддерживает современное обнаружение MCP 2026-07-28 и унаследованную инициализацию эпохи 2025 года через локальный stdio. Начните с ps3d_guide; используйте ps3d_find_commands, чтобы сопоставить цель на простом языке с ограниченным рецептом без её выполнения. Десять инструментов: 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 и ps3d_apply_preview.

Предпросмотр «схема-в-3D» разрешает только принадлежащий проекту общий каталог и возвращает точную операцию плюс чек; он не применяет результат и не управляет живой сессией браузера. Apply принимает только совпадающий SHA-256 чек предпросмотра плюс confirmed: true, возвращает новый проект и не записывает внешнее состояние. Флаг подтверждения — это утверждение хоста, а не криптографическое доказательство проверки человеком, а чек — это контрольная сумма целостности, а не подпись. Внешние вызовы не управляют открытым проектом браузера: хост предоставляет полное значение проекта, затем пользователь просматривает и открывает или импортирует возвращённую копию. Полный контракт соединения, пространства имён команд и безопасности указан в docs/AI_COLLABORATION.md. Удалённый транспорт Vercel добавляет HTTPS-аутентификацию, фильтрацию области, строгую обработку Origin, ограничение запроса в 1 МБ и лимиты частоты на каждую учётную запись без хранения полезных нагрузок проекта.

Python 3.11+ может использовать клиент стандартной библиотеки, принадлежащий проекту, в sdk/python. Вызывающий код явно предоставляет команду, рабочую директорию, проект/операцию в памяти, чек и подтверждение. Клиент использует shell=False, не содержит сетевого кода, не выполняет автоматического обнаружения файлов или секретов и описан в docs/PYTHON_LINKING.md. Его реальный обмен процессами откладывается на персональную или одобренную IT-отделом среду разработки/CI.

Архитектура, доказательства и скриншоты

Семантический проект и история ревизий являются авторитетными. Состояние worker/kernel, мозаичного предпросмотра, SVG и Three.js — это одноразовые производные артефакты. Архитектура описана в docs/architecture/PHASE_1_WORKBENCH_ARCHITECTURE.md, а решения — в docs/adr.

Скриншоты проверки в браузере, включая проверенную верхнюю ленту, историю функций, 3D Exchange Center, импортированную ссылку, PDF-процесс, многослойные макеты автомобильной инженерии и Design Health Center, находятся в docs/screenshots. Локальные доказательства квалификации записаны в docs/PHASE_1_LOCAL_EVIDENCE.md. Зависимости и вспомогательные материалы по умолчанию запрещены и записаны в provenance; никакой ключ, токен, файл .env, приватный путь, пользовательские данные или скопированный CAD-ресурс не должны находиться в репозитории.

Статус развёртывания

vercel.json определяет усиленное развёртывание Vite и Web-стандартные функции API. Supabase владеет идентификацией; миграция хранит только хэши токенов и агрегированные счётчики частоты. Точная настройка бесплатного тарифа, границы среды, живая проверка и контроль инцидентов описаны в docs/PUBLIC_DEPLOYMENT.md, а блокирующий обзор релиза — в docs/RELEASE_CHECKLIST.md. Бесплатные тарифы провайдеров имеют квоты и не являются обещанием безлимитного или вечно бесплатного сервиса.

Лицензия

Оригинальные материалы проекта лицензируются под MIT License. Сторонние компоненты сохраняют свои собственные лицензии и уведомления. См. LICENSE, THIRD_PARTY_NOTICES.md, INDEPENDENT_DEVELOPMENT.md и provenance/SOURCE_POLICY.md.