使用说明
参数化
人工智能辅助CAD进行功能参数化设计。
ParamAItric是一个CAD工具，用于根据结构化尺寸和要求创建功能部件。
它使用受约束的MCP工具、分阶段的工作流程和几何验证，而不是开放式的CAD自动化。当前的后端是Autodesk Fusion 360，具有本地模型和开发中的其他CAD后端支持。
目标不是完全自主的CAD。目标是从结构化意图到可编辑Fusion几何体的可靠路径，用于有用的机械工作，特别是实用和维护零件：支架、板、盖、适配器、手柄和其他易于建模但昂贵或采购缓慢的小型替换零件。
ParamAItric旨在帮助操作员、技术人员和业余爱好者生成功能性的替换零件和支架，但目前的设置仍然是开发人员风格。如今，它需要一个本地仓库克隆、Python环境设置、Fusion插件安装和MCP客户端配置。 新用户应该从 安装指南，它将逐步完成设置和构建第一部分。
它包括什么
- Fusion插件桥（环回HTTP加Fusion主线程执行）
- 用于输入验证、工作流编排和验证的MCP服务器
- 车身、表面和边缘几何形状的只读检查工具
- 局部回归测试和实时烟雾追踪
- 桌面主机的打包MCP stdio入口点（Claude desktop、Cursor等）
当前产品形状
今天，ParamAItric最好理解为：
- 本地Fusion 360插件
- 从repo克隆启动的本地MCP服务器
- 一个经过验证的可靠小型机械零件工作流库
这使得当前的体验适合构建者、测试人员和早期采用者。它尚未打包为一键式消费者安装。
项目方向
项目方向是保持CAD核心的狭窄和可靠，同时使非开发人员的安装和日常使用更加简单。
近期产品方向：
- 保持MCP工具作为稳定的后端契约
- 在这些工具之上添加提示式入口点，以简化主机用户体验
- 将ParamAItric打包为Claude Desktop扩展或类似的一键式MCP安装
- 减少或消除用户手动管理Python环境的需要
- 使Fusion加载项设置和首次运行健康检查更容易理解
目标用户流应该更像：
- 单击一下即可在Claude Desktop中安装ParamAItric
- 启用Fusion加载项
- 用通俗易懂的语言请求角色
- 查看并导出结果
当前能力（广泛）
已验证的工作流系列目前包括：
- 扁平实用零件（垫片、板、孔、槽、凹槽）
- 支架系列（普通、安装孔、圆角、倒角）
- 外壳和盖子路径（开箱、配套盖子、带壳外壳）
- 圆柱形和旋转驱动的实用部件（实心/空心圆柱体、套筒手柄式部件）
运营模式
每个工作流程都遵循相同的可靠性合同：
- 在CAD操作之前验证模式
- 按顺序执行明确的阶段
- 在里程碑处验证几何图形
- 使用结构化故障上下文在验证失败时停止
- 从已验证的实体导出STL
操作模式
工作模式
默认值。确定性零件创建，其中可预测性比广度更重要。
- 小工具表面
- 强验证
- 显式阶段排序
- 里程碑之间的验证检查点
- 明显的失败，保留了部分进展
公用设施操作模式
围绕现有设计进行自动化，而不是创建几何图形。低风险运营风格。
- 低风险操作
- 明确报告发生了什么变化
- 更强大的文件和路径控制
创意模式
可靠岩心足够强后的后期探索性建模。可用于评估和边缘测试，但不是主要的价值主张。
设计理念
- 分阶段工作流优于一次性请求
- CAD操作前的验证很重要
- 每个主要步骤后的验证都很重要
- 人体校正回路是一种正常的操作模型
- 更复杂的工作流应该从经过验证的较小工作流路径构建
- 保持工作流表面的狭窄和明确
- 比起广泛的自然语言命令，更喜欢键入操作
- 当工作流失败时，保留干净的部分结果
- 仅在前一个切片稳定后才进行扩展
- 让真实部件驱动下一个工作流程缺口
- 让用户控制危险或破坏性的行为
入门
ParamAItric目前作为本地Fusion 360插件以及从仓库克隆启动的本地MCP服务器运行。安装大约需要15分钟，而且你只需要做一次。
安装.md 是单一设置指南。 它涵盖了先决条件，即一个命令引导(scripts/setup.ps1 / scripts/setup.sh)，手动逐步安装，连接您的AI客户端，用简单的语言制作第一部分，并打印出来。
简而言之，流程：
- 克隆仓库并创建Python虚拟环境。
- 安装并运行Fusion 360插件。
- 将您的MCP客户端（Claude Desktop、Cursor等）指向本地服务器。
- 用简单的语言请求一个零件，然后查看并导出。
看 安装.md 对于确切的命令。
规范文档
- docs/README.md：当前经典与存档历史文档的简短指南。
- 安装.md：适用于所有技能水平的全面设置指南。
- 建筑.md：系统边界、执行模型和安全约束
- HOST_INTEGRATION.md：预期的MCP主机集成模型和传输方向
- 最佳实践.md：生活工作流程和提示合同
- docs/VERIFICATION_POLICY.md：采用验证信任层和运行时与审计策略
- docs/CSG_CHECKLIST.md：用于规划和审查的简短确定性工作流程检查表
- docs/FREEFORM_PLAYBOOK.md：引导式自由操作模型、验证规则和推广标准
- docs/FREEFORM_CHECKLIST.md：简短的自由形式课程指导清单
- ROADMAP.md：单一的规范路线图——迭代、阶段和旧计划的去向
- docs/Lemonade集成规范.pdf：推动当前方向的本地LLM（Lemonade+Pi）集成规范
- 文档/设置/：每次迭代设置指南（今天使用claude融合；柠檬水融合、strix远程、strix本地计划）
- 被取代的规划文件保存在 文档/档案/规划/
- docs/dev-log.md：执行证据、验证结果和持久的理由变更
内部工作说明：
- 内部/自由结构.md：自由形式的会议合同和架构说明
- 内部/测试recipes.md：用于验证会话的临时结构化和自由形式的配方语料库
