Design-Express-Res/README.md

Design Express Res — CAD 设计标注检查与设计数据查询工具

基于 Core + Link 架构（类似 COMSOL LiveLink）：独立核心库与 CAD 完全解耦，Inventor / SolidWorks 各自通过 Link 适配层调用 Core 功能。

架构

┌────────────────────────────────────────────┐
│ DesignExpress.Core.dll (独立核心, 不依赖CAD) │
│  - KB 知识库 (GB/T 275/1800/1801/894/1095)  │
│  - CheckEngine 检查引擎 (P/A/D 三阶段)       │
│  - DesignQuery 设计数据查询 (键槽/卡簧槽已实装)│
│  - UI: MainForm/QueryForm/FitForm           │
│  - Report 报告 (Excel/CSV)                  │
│  - ICadHost 抽象接口 + DocSnapshot 快照      │
│  - ToolIcons 共享图标(仓鼠品牌+功能符号)      │
└────────────────────────────────────────────┘
      ▲              ▲
  InventorLink    SolidWorksLink
  (已交付)        (已交付)

• ICadHost 接口：GetActiveDocument / GetDocType / Capture / PickCylinderDiameterMM / SetStatusText
• DocSnapshot 快照：Link 层把 CAD 文档状态拍成纯数据，Core 只处理快照
• 新增 CAD 支持 = 实现一个 ICadHost + 该 CAD 的选项卡壳

功能

系统	内容
设计检查	零件(标注/公差配合GB/T 275/形位/粗糙度/螺纹/物料接触GMP/表面处理/强度指引)、装配(GMP材料/密封/清洁/静态干涉/外购件/电气西门子/动力)、工程图(图框/视图/尺寸公差/22项spec关键词检查)
设计数据查询	键槽(GB/T 1095)、卡簧槽(GB/T 894.1)已实装; O型密封圈(GB/T 3452.1)、轴承挡圈规划中

部署

Inventor

1. 复制 AddIn/deploy 文件夹到目标机器
2. 右键 install.ps1 → 使用 PowerShell 运行（无需管理员）
3. 重启 Inventor，功能区出现 [Design Express Res] 选项卡

SolidWorks

1. 复制 AddIn/deploy 文件夹
2. 运行 install_solidworks.ps1（用户级注册）
3. 首次需管理员执行两条 reg add（脚本末尾有提示）：
   • HKLM\SOFTWARE\SolidWorks\AddIns\{4A7E023E-...} 键（default=1, Title）
4. 启动 SolidWorks → 工具→插件 勾选 Design Express Res
5. 打开零件 → 出现选项卡 → 正常退出并重启一次（持久化选项卡定义）

文件清单

路径	说明
AddIn/deploy/DesignExpress.Core.dll	独立核心（成品）
AddIn/deploy/DesignExpress.InventorLink.dll	Inventor 适配层（成品）
AddIn/deploy/DesignExpress.SolidWorksLink.dll	SolidWorks 适配层（成品）
AddIn/deploy/install.ps1	Inventor 一键部署脚本
AddIn/deploy/install_solidworks.ps1	SolidWorks 部署脚本
AddIn/src/Core/*.cs	核心源码（ICadHost/Snapshots/KB/CheckEngine/DesignQuery/UI/ToolIcons）
AddIn/src/InventorLink/*.cs	Inventor 适配源码
AddIn/src/SolidWorksLink/*.cs	SolidWorks 适配源码

关键技术点

Inventor

• 按钮点击：ButtonDefinition.OnExecute 事件（不依赖 ExecuteCommand 路由）
• 加载规则：AddInLoadRules 二进制文件控制加载，install.ps1 自动修复（DWORD=0 允许加载）

SolidWorks

• 延迟创建：命令组/选项卡在文档激活事件（ActiveDocChangeNotify）中创建——SW 启动早期命令系统未就绪，ConnectToSW 时创建会静默失败
• EnableMethod 回调：命令必须提供启用方法（返回 1），否则 SW 禁用命令导致按钮不可见
• tab.Active = true：选项卡可见性 + 激活必须直接设置，否则不显示在选项卡栏
• 持久化：SW 正常退出时把选项卡定义写入注册表，重启后读取显示
• GetDocType 注意：不能 dynamic.GetType()（解析成 Object.GetType），必须编译时调用

通用

• 窗口：1/4 屏幕面积，TableLayoutPanel 百分比布局，无固定尺寸不遮罩
• 报告：Excel COM 动态调用，未装 Excel 回退 CSV
• 图标：ToolIcons 共享生成（功能符号集中式），SolidWorks 用 9 格 BMP 图标条；Inventor 因 AddButtonDefinition 对 IPictureDisp 兼容性问题暂用文字按钮（可后续手动补图标）

建议的 iProperties 自定义属性

属性名	取值示例	用途
物料接触	直接接触 / 间接接触 / 非接触	触发 GMP 专项检查
表面处理	镀镍+磨削 / 抛光 / 发黑	表面处理检查
材料	316L / 304 / PTFE	GMP 材料判定

编译

# Core (无 CAD 依赖)
csc /target:library /platform:x64 /codepage:65001 /out:DesignExpress.Core.dll ^
  /r:System.Windows.Forms.dll /r:System.Drawing.dll /r:Microsoft.CSharp.dll /r:System.Core.dll ^
  src\Core\*.cs

# Inventor Link
csc /target:library /platform:x64 /codepage:65001 /out:DesignExpress.InventorLink.dll ^
  /r:DesignExpress.Core.dll /r:"<Inventor>\Bin\Public Assemblies\Autodesk.Inventor.Interop.dll" ^
  /r:System.Windows.Forms.dll /r:System.Drawing.dll /r:Microsoft.CSharp.dll /r:System.Core.dll ^
  src\InventorLink\*.cs

# SolidWorks Link
csc /target:library /platform:x64 /codepage:65001 /out:DesignExpress.SolidWorksLink.dll ^
  /r:DesignExpress.Core.dll /r:"<SW>\SolidWorks.Interop.sldworks.dll" ^
  /r:"<SW>\SolidWorks.Interop.swpublished.dll" /r:"<SW>\SolidWorks.Interop.swconst.dll" ^
  /r:System.Windows.Forms.dll /r:System.Drawing.dll /r:Microsoft.CSharp.dll /r:System.Core.dll ^
  src\SolidWorksLink\*.cs

版本历史

• 1.3.0 (2026-08-21): SolidWorks Link 交付; 功能图标(集中式功能符号); 生产版代码清理
• 1.3.1 (2026-08-22): 清理调试代码与临时文件; Inventor 图标方案(IPictureDisp)因 API 兼容性暂缓, 保留文字按钮