# VDE 插件生态分层(1.0.107) > **历史基线说明**:本文的 ABI 1.9 / 19 官方插件仍适用,但版本快照为 1.0.107;当前 1.0.175 的架构与能力入口见 [current-architecture-1.0.177.md](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. 链接 - [当前工程现状总览(1.0.107)](../reference/106-VDE工程现状总览(1.0.107).md) - [插件开发指南](../guides/plugin-development.md) - [插件安全与分发](plugin-security.md) · [分发指南](../guides/plugin-distribution.md) - [微内核插件架构](microkernel-plugin-architecture.md) - [VDCS GCS 集成](vdcs-gcs-integration.md)