PS3D CAD Studio

PS3D CAD Studio 是一个独立、原创、本地优先的浏览器 CAD 研究项目。当前仓库是一个可用的 0.2 公开发布候选版本：一个跨 Sketch、Part、Assembly、Surface、Drawing、Electrical、Vehicle 和 Automate 工作区的统一语义项目，外加一个学习中心、安全账户门户和经过身份验证的远程 MCP 传输。

它不是从 PartMode 或其他 CAD 代码库复制而来。该项目拥有自己的需求、架构、源代码、界面、示例、测试、来源记录和 MIT 许可证。独立开发降低了版权风险，但这不构成法律意见，也不构成专利、商标或自由实施权的许可。

公开的规范源代码：sagar25-Code-it/ps3d-cad-studio。

本地可用的功能

公共账户门户支持验证邮箱注册、登录、登出、密码恢复、标签页范围会话，以及每个用户最多五个唯一的过期 MCP 个人令牌。OAuth 2.1 是兼容 AI 主机的首选连接路径。原始个人令牌仅显示一次，并且仅以加盐 HMAC 摘要形式持久化。学习中心包含 12 个从初学者到高级实践的验证引导模块，并从相同的已审查源内容生成一份 15 页的 PDF 手册。

该外壳还提供原始色轮工作区系统、功能性的文件/编辑/创建/视图/检查/自动化/帮助菜单栏、带项目自有内联 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 人物名册、六个扩展的 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 是一种无状态预览传输：它接受明确的有界值并返回 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_... 个人令牌；切勿将 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>"
    }
  }
}

该服务器支持现代 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 MB 请求上限以及按身份限流，且不存储项目负载。

Python 3.11+ 可以使用项目自有的标准库客户端，位于 sdk/python 下。调用方显式提供命令、工作目录、内存中的项目/操作、收据和确认。该客户端使用 shell=False，不包含任何网络代码，不执行自动文件或密钥发现，相关文档见 docs/PYTHON_LINKING.md。其真实进程交换被推迟到个人或 IT 批准的开发/CI 环境中。

架构、证据与截图

语义项目和修订历史是权威来源。Worker/内核、曲面细分预览、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。