### P2-5c 圆角盒残余 seam 96→0
- 根因:平面单环耳切剔除共线中间点,与共享采样 3 段边界不一致;新增 restore_ring_boundary_points 把共享边界点逐点补回;
- 26 面圆角盒 open 96→0(Plane/Cylinder/Sphere 全 0),tris 6396,box 类保持 0;平面面与曲面相邻时 10 tris/面(纯平面 box 仍 2),
测试断言按新语义更新;
### P3-4 外部服务 OS 级沙箱
- vde-service.json limits(max_memory_mb/max_cpu_seconds/max_processes/kill_on_close);Windows Job Object(挂起创建→Assign→Resume、
KILL_ON_JOB_CLOSE、内存/CPU/进程数限制事件)+ POSIX setsid/rlimit;结果 limit_exceeded/limit_kind;
- test_plugin_external_service 18/18(内存/CPU/进程数超限、kill_on_close 回收、旧行为、非法清单);docs 更新;
### P3-5 插件 DLL 工件哈希 + 密钥轮换/吊销
- manifest artifacts[{path,sha256}]/key_id;SHA-256 自实现 + 路径白名单;Policy require_artifact_hashes/trusted_keys/revoked_key_ids;
新错误码;evaluate 扩展 + manager hook 已接线;tool verify --hash/--key-id;test_plugin_security 42/42;docs plugin-security §4.5/§4.6;
### P3-6 C++ 跨 DLL ABI 边界定稿(opt-in 实验)
- VDE_BUILD_CPP_SHARED(默认 OFF)12 内核模块 SHARED + consumer smoke(CPP_SHARED_CONSUMER_PASS faces=6 volume=6000);
- 决策:保持 C++ 静态 + 纯 C ABI + 插件默认;跨 DLL 单例/STL/RTTI/导出规模风险,实验仅 opt-in;architecture §7.8/design §13;
### P3-7 MSVC/Linux 跨平台验证收口
- .github/workflows/ci.yml 新增 windows-msvc job(YAML 校验通过);vde_platform UTF-8 宽 API/error/自守卫修复;
- 可移植性审计 12 类;docs/guides/cross-platform-validation.md;本机无 MSVC/WSL/docker,实机由 CI 反馈;
### VDE-1249 / 工程
- 反馈单更新:圆角盒 open 960→96→0,1.0.68 预算 Normal≈6396,宿主复测指引改 1.0.68;
- 版本 1.0.68;全量构建 0 error(340 targets);全量 ctest 7472 注册、7377/7377 PASS(0 failed,25 skipped,560.68s)。
5.1 KiB
5.1 KiB
P3-6 C++ 跨 DLL ABI 实验记录(VDE_BUILD_CPP_SHARED)
状态:实验(opt-in,默认 OFF);不属于默认发布/CI 门禁。 分支 main,HEAD
ee13a3ed(1.0.67);构建目录build-fb-cppshared/build-fb-cppshared-off。 文档结论:docs/guides/architecture.md§7.8、docs/design/microkernel-plugin-architecture.md§13。
1. 目的与开关
验证“内核 C++ 模块构建为 SHARED、消费者只链接 DLL 导入库”的可行性与边界:
cmake -S . -B build-fb-cppshared -G Ninja -DCMAKE_BUILD_TYPE=Release ^
-DVDE_BUILD_CPP_SHARED=ON -DFETCHCONTENT_FULLY_DISCONNECTED=ON ...
cmake --build build-fb-cppshared --target vde_cpp_shared_consumer -j 12
- ON 时内核模块(foundation/plugin/core/compute/curves/mesh/spatial/boolean/
collision/sdf/brep + platform)以 SHARED 构建;Windows 由 CMake
WINDOWS_EXPORT_ALL_SYMBOLS自动生成 .def 全导出;DLL 与可执行统一输出<build>/bin。 - 非内核/官方模块(io/cae/render/drafting/pdm/mechanism/ui/cam 等)仍 STATIC,链接共享内核。
2. 实测结果(Windows 11 / MinGW GCC 16.1 UCRT / Release / 本机)
构建:configure + kernel SHARED 构建 0 error;生成 12 个内核 DLL,合计 15,828,919 B:
| DLL | 大小 (B) | 导出 defined symbols |
|---|---|---|
| libvde_platform.dll | 111,987 | — |
| libvde_foundation.dll | 168,171 | 464 |
| libvde_core.dll | 542,524 | 946 |
| libvde_compute.dll | 120,642 | — |
| libvde_curves.dll | 2,612,282 | 1,004 |
| libvde_spatial.dll | 246,620 | — |
| libvde_collision.dll | 117,447 | — |
| libvde_mesh.dll | 1,235,369 | 863 |
| libvde_boolean.dll | 156,488 | — |
| libvde_sdf.dll | 253,421 | — |
| libvde_brep.dll | 9,501,727 | 3,121 |
| libvde_plugin.dll | 762,241 | 971 |
| 合计 | 15,828,919 | — |
最小消费者 experiments/cpp_shared_consumer(只链接内核 DLL 导入库):
CPP_SHARED_CONSUMER_PASS faces=6 volume=6000.000000 triangles=12
CTest VDE_CppSharedConsumerSmoke 1/1 PASS。
共享内核下既有测试抽查(混合“共享内核 + 静态官方模块”,DLL 在 exe 同目录):
- test_display_mesh 13/13 PASS、test_vde1239_display_quality 13/13 PASS、 test_capi_split 10/10 PASS;
- test_plugin_manager 23/24:唯一失败为
sample_plugin_available()(实验构建目录未构建 sample_vbox 插件产物,环境缺失,非跨 DLL ABI 失败); ctest -R 'VDE_CppSharedConsumerSmoke|Display'15/15 PASS。
默认 OFF 回归(build-fb-cppshared-off):configure/build exit 0;
内核仍为 27 个静态库(libvde_brep.a 13,837,174 B),bin 下 0 个内核 DLL;
test_display_mesh 13/13 PASS。默认 static/hybrid 构建行为不变。
3. 跨 DLL 边界约束(实验结论,必须遵守)
- 单例/静态注册表:每个 DLL 各有一份静态数据;日志 sink、缓存、注册表、tolerance、 thread-local 等必须收敛到同一组 DLL。消费者不得再静态链入内核,否则出现双实例 (句柄/缓存不一致)。本实验用“同一内核闭包全部 SHARED”避免该问题。
- STL/分配器跨边界:禁止在一个 DLL 分配 STL 容器/对象而在另一个 DLL 释放 (CRT 不同 → 堆损坏)。当前头文件 API 大量按值/STL 传递,跨 DLL 使用必须 同编译器 + 同 CRT + 同标志(MinGW UCRT 与 MSVC 不互通)。生产级需 pimpl/纯 C 包装/显式 allocator+free 接口。
- RTTI/异常:type_info 去重与异常跨 DLL 传播依赖同 ABI/CRT;跨编译器(MinGW↔MSVC) 禁止。
- 导出规模/链接成本:全导出使 DLL 体积与符号表显著增大(brep ~9.5MB / 3,121 符号), 且泄漏全部内部 C++ 符号(实验可接受,发布不可接受)。
- 部署/加载顺序:所有内核 DLL 必须与可执行同目录(或 PATH);版本需成套 (1.0.x DLL 混 1.0.y 导入库有 ABI 风险)。
- 插件 ABI 独立:官方/第三方插件仍走纯 C ABI(不链接这些 C++ DLL);C++ DLL 实验与插件 ABI 互不影响。
4. 决策(P3-6 定稿)
- 机制可行(配置/构建/最小 smoke/部分既有测试通过),但导出体系、STL/分配器/ 异常边界、单例治理与跨编译器矩阵的成本/风险远超收益;
- 保持默认决策:C++ 消费者静态链接内核;动态边界只提供纯 C ABI(
libvde_capi) 与插件; VDE_BUILD_CPP_SHARED仅保留为 experimental opt-in(默认 OFF,不进发布/CI 门禁);- 未来若需跨 DLL C++,优先 pimpl/纯 C 包装或进程外服务,而非全导出符号。
5. 复现
# 实验
cmake -S . -B build-fb-cppshared -G Ninja -DCMAKE_BUILD_TYPE=Release -DVDE_BUILD_CPP_SHARED=ON ...
cmake --build build-fb-cppshared --target vde_cpp_shared_consumer -j 12
build-fb-cppshared/bin/vde_cpp_shared_consumer.exe # CPP_SHARED_CONSUMER_PASS ...
# 默认 OFF 回归
cmake -S . -B build-fb-cppshared-off -G Ninja -DCMAKE_BUILD_TYPE=Release ...
cmake --build build-fb-cppshared-off --target test_display_mesh -j 12