Compare commits
1
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
8a72979a3c |
@@ -0,0 +1,74 @@
|
||||
# VDCS-021:R2 — 实体级 mate 一期落地(承接 `feedback/VDCS-019-mates`)
|
||||
|
||||
**Status**: Open
|
||||
**来源**: ViewDesign 宿主 R2 立项(`docs/dev/requirements/R2-R3-project-scope-and-split-20261106.md`)
|
||||
**优先级**: P0 — 决定装配配合能否从应用侧回退实现切到内核求解
|
||||
**日期**: 2026-11-06
|
||||
**版本/commit**: VDCS 子模块 `1e14871`
|
||||
|
||||
## 现象
|
||||
|
||||
VDCS 已具备 3D 求解所需的全部底层件:
|
||||
|
||||
- `RigidBody` 实体(`include/vdcs/model/entity.h:1043`)与 `AddRigidBody`(`include/vdcs/model/model.h:161`);
|
||||
- 23 类 3D 几何约束(`include/vdcs/model/constraint3d.h`,含 Coincident3D / Distance3D / Angle3D /
|
||||
Concentric3D / Parallel3D / Perpendicular3D / RigidFixed3D 等),解析雅可比在实体参数空间推导;
|
||||
- 稀疏 LM / Newton / 增量 / 分解求解器与 DOF 分析、过约束诊断(`include/vdcs/core/`)。
|
||||
|
||||
但**实体级 mate 这一层尚未实现**:全仓检索 `MateEntity` / `add_mate_entity` / `mate_residuals`
|
||||
无匹配。宿主因此只能保留应用侧 `EntityMateSolver`(Dual6 解析雅可比 + LM + 投影重试),
|
||||
无法使用内核的稀疏与增量能力。
|
||||
|
||||
本单承接此前分支 `feedback/VDCS-019-mates`(因主分支 `VDCS-019` 编号已被测试基建占用而未能入 main),
|
||||
请按主分支现状重新编号落地。
|
||||
|
||||
## 期望行为(一期)
|
||||
|
||||
1. 新增实体级 mate API(C++ 与 C API 同步):
|
||||
|
||||
```c
|
||||
int vdcs_add_mate_entity(...); /* MateEntity: component_uid, kind, point[3], dir[3],
|
||||
radius, half_angle, reversed */
|
||||
int vdcs_add_mate(...); /* 引用两个 mate entity + 类型 + value */
|
||||
int vdcs_update_mate(...);
|
||||
int vdcs_remove_mate(...);
|
||||
int vdcs_mate_residuals(...); /* 逐配合残差 */
|
||||
int vdcs_mate_conflicts(...); /* 失败/冗余配合 uid */
|
||||
int vdcs_drag(...); /* 拖动增量 */
|
||||
```
|
||||
|
||||
2. 一期配合类型(与宿主 `MateType` 的交集,7 类):
|
||||
`Coincident / Distance / Angle / Concentric / Parallel / Perpendicular / Lock`。
|
||||
其余 10 类(Tangent、Gear、RackPinion、CamFollower、Width、Symmetric、Screw、Universal、
|
||||
Sphere/Cone/Point 组合)明确列为二期,不在本单验收。
|
||||
3. 位姿约定与宿主一致:`worldPoint = pos + rot * localPoint`,增量 `[dt(3), dtheta(3)]`,
|
||||
`fixed` 时 DOF 为 0;实体几何(点/方向/半径/半角)由宿主从 VDE B-Rep 求值后传入。
|
||||
4. 求解失败必须可解释:返回失败的 mate uid 列表、剩余 DOF 与冗余配合,不返回假成功。
|
||||
5. `drag` 增量与全量 `solve` 结果收敛到同一解(同一初值/同一约束下最终残差一致)。
|
||||
|
||||
## 验收
|
||||
|
||||
1. 2 零件 3 配合:`solve` 残差 ≤ 1e-6,耗时 ≤ 10 ms(数值雅可比)/ ≤ 1 ms(解析);
|
||||
2. 50 配合 / 200 刚体:耗时不超过宿主现有基线(5 ms)的 2 倍,且收敛;
|
||||
3. 过约束场景:返回冗余配合集合与剩余 DOF,与宿主 `MateSolveAnalysis` 口径一致;
|
||||
4. 拖拽增量:单次 ≤ 5 ms;1000 步随机拖动后位姿漂移在约定容差内;
|
||||
5. C ABI 基线检查通过(`vdcs_abi_check`),序列化往返位姿一致。
|
||||
|
||||
## 影响
|
||||
|
||||
- 若不提供:宿主继续维护应用侧求解器,无法获得稀疏/增量能力,大装配性能上限受限;
|
||||
- 若口径不一致:宿主需要维护两套残差/诊断语义,UI 红标与失败原因会分裂。
|
||||
|
||||
## 请求
|
||||
|
||||
1. 确认一期 7 类配合的范围与上述 API 形态;若命名/分层与现有 `constraint3d` 冲突,请给出替代方案;
|
||||
2. 明确 `drag` 的切坐标重基准语义(是否与 `RigidBody::AbsorbDelta` 一致);
|
||||
3. 明确冗余/冲突诊断的返回结构,便于宿主直接映射 UI;
|
||||
4. 补验收中列出的测试。
|
||||
|
||||
## 关联
|
||||
|
||||
- 前置分支:`feedback/VDCS-019-mates`(原 VDCS-018 内容)
|
||||
- 宿主立项与分工:`docs/dev/requirements/R2-R3-project-scope-and-split-20261106.md`
|
||||
- 宿主回退实现:`src/vd_assembly/include/vd/assembly/entity_mate_solver.h`
|
||||
- 宿主配合类型:`src/vd_assembly/include/vd/assembly/mate_types.h`
|
||||
Reference in New Issue
Block a user