PS3D CAD Studio

PS3D CAD Studioは、独立したオリジナルのローカルファースト・ブラウザCAD研究プロジェクトです。現在のリポジトリは、動作する0.2公開リリース候補です。Sketch、Part、Assembly、Surface、Drawing、Electrical、Vehicle、Automateの各ワークスペースにまたがる単一のセマンティックプロジェクトに加え、Learning Center、セキュアなアカウントポータル、認証付きリモートMCPトランスポートを備えています。

PartModeや他のCADコードベースからコピーされたものではありません。このプロジェクトには独自の要件、アーキテクチャ、ソース、インターフェース、例、テスト、来歴記録、MITライセンスがあります。独立した開発は著作権リスクを低減しますが、法的見解や特許、商標、フリーダム・トゥ・オペレートのクリアランスではありません。

正規の公開ソース: sagar25-Code-it/ps3d-cad-studio。

ローカルで動作するもの

公開アカウントポータルは、検証済みメールでのサインアップ、サインイン、サインアウト、パスワード回復、タブスコープのセッション、ユーザーごとに最大5つの一意の期限付きMCPパーソナルトークンをサポートしています。OAuth 2.1は、互換性のあるAIホストの推奨接続パスです。生のパーソナルトークンは一度だけ表示され、ペッパー付きHMACダイジェストとしてのみ永続化されます。Learning Centerには、初心者から上級練習までの12の検証主導モジュールが含まれ、同じレビュー済みソースコンテンツから15ページのPDFマニュアルを生成します。

シェルはまた、オリジナルのカラーホイールワークスペースシステム、機能的なFile/Edit/Create/View/Inspect/Automate/Helpメニューバー、プロジェクト所有のインラインSVGシンボルを備えたコンテキスト依存のトップコマンドリボン、明示的な機能レベルを備えたキーボードナビゲーション可能でワークスペースフィルタリングされた119コマンドのオリジナルCADカタログ、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にあります。31ロールを組み合わせたPS Code Hubペルソナ名簿、6つの拡張PS3Dスペシャリストロール、真実の資格情報境界、タスクルーティングモデル、レビューループは、docs/PS_CODE_HUB_AI_TEAM.mdにあります。決定論的ワークスペースヘルスマトリックス、実際の関連性マップ、再構築レビュー順序、修復キュー、スコアリングルール、リリース境界は、docs/product/DESIGN_HEALTH_AND_REBUILD.mdにあります。

センターボアパートパスのみがqualifiedとマークされています。他のすべての機能的なワークベンチ機能はpreviewとマークされています。正確なB-rep/NURBS、一般的なブール演算および拘束ソルバー、永続的なフェイスネーミング、トリミング/シーイング、STEP/IGES/DWG/DXFの正確な変換、ネイティブのプロプライエタリCAD、生産図面PDF認証、共有クラウドCADドキュメントコラボレーション、自動電気サイジング、保護協調、アークフラッシュ/コンプライアンス分析、メーカー精度の自動電気パッケージ、導体/ハーネスサイジング、認定車両マルチボディ/タイヤ/FEA/熱/衝突シミュレーション、ホモロゲーション、ライブブラウザMCP制御は利用できません。リモート認証MCPはステートレスなPreviewトランスポートです。明示的な境界付き値を受け入れ、JSONまたは新しいプロジェクトコピーを返します。開いているCADタブを引き継ぐことはありません。正確な契約と除外事項については、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は、型付きパッケージスイート、実際のMCP stdioクライアント/サーバー交換、依存関係の整合性確認、両方のソース同一性ゲートを実行します。pnpm buildはさらに、ブラウザグラフからNode専用MCP SDK、Manifold候補、WASM、動的評価を拒否し、静的ホストセキュリティポリシーとバンドルされた通知を検証します。含まれているGitHubワークフローは、クリーンなホストランナーで型チェック、エビデンス、ビルド、CodeQL、依存関係レビューゲートを繰り返します。

MCPホストを接続する

デプロイされたインスタンスの場合、/accessに表示されるHTTPSエンドポイントを使用します:

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

自動OAuth 2.1ディスカバリを優先してください。ホストがカスタムHTTPヘッダーをサポートしているがOAuthをサポートしていない場合は、/accessでスコープ付きの期限付きps3d_mcp_...パーソナルトークンを1つ作成してください。Webパスワードを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>"
    }
  }
}

サーバーは、ローカルstdio上で、モダンなMCP 2026-07-28 ディスカバリと2025年世代のレガシー初期化をサポートします。ps3d_guide から始め、ps3d_find_commands を使用して、平易な言葉での目標を、実行せずに制約付きレシピにマッピングします。10個のツールは、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処理、1MBのリクエスト上限、およびIDごとのレート制限を追加し、プロジェクトペイロードを保存しません。

Python 3.11+ では、sdk/python 配下のプロジェクト所有の標準ライブラリクライアントを使用できます。呼び出し元は、コマンド、作業ディレクトリ、インメモリのプロジェクト/操作、レシート、および確認を明示的に提供します。クライアントは shell=False を使用し、ネットワークコードを含まず、自動的なファイルまたはシークレットの検出を行わず、docs/PYTHON_LINKING.md に文書化されています。その実際のプロセス交換は、個人用またはIT承認済みの開発/CI環境に委ねられます。

アーキテクチャ、エビデンス、スクリーンショット

セマンティックプロジェクトとリビジョン履歴が正本です。ワーカー/カーネル、テッセレーション済みプレビュー、SVG、Three.jsの状態は、使い捨て可能な派生アーティファクトです。アーキテクチャは、docs/architecture/PHASE_1_WORKBENCH_ARCHITECTURE.md に文書化され、決定事項は docs/adr にあります。

レビュー済みのトップリボン、フィーチャー履歴、3Dエクスチェンジセンター、インポートされた参照、PDFワークフロー、レイヤード車両エンジニアリングレイアウト、およびデザインヘルスセンターを含むブラウザレビュースクリーンショットは、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、THIRD_PARTY_NOTICES.md、INDEPENDENT_DEVELOPMENT.md、および provenance/SOURCE_POLICY.md を参照してください。