Files

5.9 KiB
Raw Permalink Blame History

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;VdePluginRegistration 96B 不变;
  • 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
        → 真实文件导入/导出(字节/几何断言)
        → 卸载后无残留

10. 链接