Files
hm 6f44d48d29
Build & Test / build-and-test (push) Canceled after 0s
VDE Build & Test / build-and-test (push) Canceled after 0s
Build & Test / python-bindings (push) Canceled after 0s
feat: P2-5c 圆角盒 seam 归零 + P3-4/5/6/7 收口(1.0.68)
### 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)。
2026-10-28 20:49:27 +08:00

98 lines
5.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 导入库”的可行性与边界:
```powershell
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 边界约束(实验结论,必须遵守)
1. **单例/静态注册表**:每个 DLL 各有一份静态数据;日志 sink、缓存、注册表、tolerance、
thread-local 等必须收敛到同一组 DLL。消费者不得再静态链入内核,否则出现双实例
(句柄/缓存不一致)。本实验用“同一内核闭包全部 SHARED”避免该问题。
2. **STL/分配器跨边界**:禁止在一个 DLL 分配 STL 容器/对象而在另一个 DLL 释放
(CRT 不同 → 堆损坏)。当前头文件 API 大量按值/STL 传递,跨 DLL 使用必须
**同编译器 + 同 CRT + 同标志**(MinGW UCRT 与 MSVC 不互通)。生产级需 pimpl/纯 C
包装/显式 allocator+free 接口。
3. **RTTI/异常**:type_info 去重与异常跨 DLL 传播依赖同 ABI/CRT;跨编译器(MinGW↔MSVC)
禁止。
4. **导出规模/链接成本**:全导出使 DLL 体积与符号表显著增大(brep ~9.5MB / 3,121 符号),
且泄漏全部内部 C++ 符号(实验可接受,发布不可接受)。
5. **部署/加载顺序**:所有内核 DLL 必须与可执行同目录(或 PATH);版本需成套
(1.0.x DLL 混 1.0.y 导入库有 ABI 风险)。
6. **插件 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. 复现
```powershell
# 实验
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
```