5.9 KiB
5.9 KiB
VDE 插件生态分层(1.0.107)
历史基线说明:本文的 ABI 1.9 / 19 官方插件仍适用,但版本快照为 1.0.107;当前 1.0.175 的架构与能力入口见 current-architecture-1.0.177.md。
状态:ABI 1.9 · VDE 官方覆盖 8 个 kind / 19 个插件 · GCS/CAE solver 为外部 provider
目标:让多个团队在不修改内核的前提下,独立开发、测试、分发、升级插件。
1. 边界
Kernel 几何/基础算法 + 插件 ABI/安全边界(11 模块)
Integration 格式 IO、CAE/CFD 前处理(vde::io / vde_cae)
Official 官方模块与官方 dogfood 插件(17 应用模块 + 19 插件)
Third-party 外部团队插件/进程外服务
Host 宿主应用(CAD/CAE/CAM/PDM/PLM)
插件只依赖纯 C ABI 头 include/vde/plugin/vde_plugin_api.h,不链接内核 C++ 库。
求解器归属原则:VDE 不提供生产级 GCS/CAE 求解器;VDCS 与外部 CAE 工程按 ABI 提供插件,
VDE 仅保留接口、契约测试与 sample mock。
2. 生态分层
| 层 | 内容 | 变更节奏 |
|---|---|---|
| ABI | vde_plugin_api.h、host 服务表、capabilities、注册结构 | 慢,只尾追加 |
| SDK | 头、模板、CMake package、scaffold、CI 模板 | 版本化 |
| Runtime | PluginManager、加载/卸载、失败隔离、能力注册表 | 中 |
| Distribution | 索引、Ed25519 签名、安装/升级/卸载、吊销 | 中 |
| Content | 官方/第三方插件(format/geom/cam/mesher/optimizer/io_batch/ui/binding 等) | 快 |
3. PluginKind 与当前提供方(ABI 1.9)
| kind | 值 | VDE 官方 | 当前提供方 |
|---|---|---|---|
| format | 1 | ✅ | 12 个官方格式插件 |
| geom_op | 2 | ✅ | geom_analyze(mass_properties/bbox/volume/area/centroid) |
| cae_solver | 3 | ❌ | 外部 CAE 工程(ABI 1.2;VDE 仅 sample_cae mock) |
| cam_strategy | 4 | ✅ | cam_gcode(raster/contour/多程/刀补) |
| gcs_solver | 5 | ❌ | VDCS 工程(ABI 1.3;VDE 仅 sample_gcs mock) |
| binding | 6 | ✅ | binding_meta(python/csharp/typescript,ABI 1.9 options) |
| ui | 7 | ✅ | ui_theme(dark/light/high_contrast/custom) |
| mesher | 8 | ✅ | mesher_voxel(hex8/tet4) |
| optimizer | 9 | ✅ | optimizer_nelder_mead(NM/CD) |
| io_batch | 10 | ✅ | io_batch_mesh(STL/OBJ/PLY/OFF,流式) |
官方插件矩阵要求 8 个 kind;cae_solver/gcs_solver 用
--allow-missing-kind 标记为外部 provider。
4. 官方插件清单(plugins/official,19 manifests)
| 类别 | 插件 | 关键能力 |
|---|---|---|
| format(12) | stl/obj/ply/off/amf/3mf/gltf/vrml/collada/step/iges/dxf | 读/写;STEP/IGES/DXF 含写;PLY binary、OFF、COLLADA polylist 等 |
| geom_op | geom_analyze | 质量特性(体积/面积/质心/惯性张量)、bbox |
| cam_strategy | cam_gcode | Fanuc/Grbl;raster/contour、direction、passes、tool_radius |
| binding | binding_meta | 3 语言元数据;ABI 1.9 options 选择语言,旧 1.8 环境变量回退 |
| ui | ui_theme | 4 主题 + custom hex 校验 |
| mesher | mesher_voxel | hex8/tet4;Y 列扫描 + BVH 回退,输出哈希等价,5–9× |
| optimizer | optimizer_nelder_mead | quadratic/sphere/rosenbrock/beale;NM/坐标下降 |
| io_batch | io_batch_mesh | stl/obj/ply/off 互转;PLY binary;options.stream=auto/always/never |
5. ABI 兼容与扩展
- 当前
VDE_PLUGIN_ABI_MAJOR=1、MINOR=9;VdePluginRegistration96B 不变; - 1.9 尾扩展:
VdeBindingPlugin.get_manifest_json_ex(host,options,result),struct 48→56B; 旧 1.8 插件(48B)无 ex 回调时宿主自动回退; - ABI 矩阵覆盖 1.0–1.9;旧插件无需重编译;
- 新扩展点必须尾追加字段,禁止改变既有字段偏移/大小;
- 插件不得链接内核静态库、不得跨 CRT 分配内存、不得静默返回空几何或伪造精确 B-Rep。
6. 分发与安全
- 索引 schema、artifact SHA-256、Ed25519 签名、
--install/--uninstall/--upgrade原子替换与回滚; - 索引级
key_id吊销强制;CRL 文件/URL、过期/签名校验; - 进程外服务(
vde-service协议)用于重型/不可信/非 C ABI 组件; - 容器隔离(docker/podman)已有 fake runtime 测试;真实环境 e2e 挂起。
7. 性能与质量证据(1.0.107)
| 项 | 结果 |
|---|---|
| 插件族 CTest | 293/293 PASS |
| Mesher | 大 box 输出哈希与优化前一致;本地 50³ ~445→53ms(5–9×) |
| IO_BATCH | 200k 三角流式转换;stream/legacy 字节一致;PLY token 多记录 |
| 格式写 | STEP/IGES/DXF write_file 流式;大模型 file=memory 字节一致;纯格式化基准已记录 |
| 独立验证 | 报告 105:PASS 44/45(3 项非阻塞已整改) |
8. 多团队责任矩阵
| 团队 | 可独立交付 | 依赖 |
|---|---|---|
| Kernel team | ABI 1.x(当前 1.9)、host 服务、兼容矩阵 | 无 |
| SDK/Release | vde-plugin-sdk、模板、scaffold、CI | ABI |
| Format team | format:* 插件 | SDK + 真实语料 |
| CAE team(外部) | cae:* 插件/服务 | SDK + 求解器 |
| CAM team | cam:* 插件 | SDK + 后处理 |
| GCS team(VDCS) | gcs:* 插件 | SDK + 约束模型 |
| Optimizer/IO batch | optimizer/io_batch 插件 | SDK + 数值/格式 |
| Security/ops | 索引、签名、吊销、审计 | Distribution |
9. 验收口径
外部目录 → find_package(vde-plugin-sdk) → 构建插件
→ vde_plugin_tool --check PASS
→ 宿主 PluginManager 加载/query/init
→ 真实文件导入/导出(字节/几何断言)
→ 卸载后无残留