32 lines
1.2 KiB
Markdown
32 lines
1.2 KiB
Markdown
|
# Decisions
|
|||
|
|
|
|||
|
|
记录架构决策和重要选择。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## [2026-01-27] 实施决策
|
|||
|
|
|
|||
|
|
### 执行方式
|
|||
|
|
- **Task 1-3**: Orchestrator 直接实现（代码简单，遵循既有模式）
|
|||
|
|
- **原因**: 子代理调用失败（JSON Parse error），且任务为标准代码添加，无复杂逻辑
|
|||
|
|
|
|||
|
|
### 代码模式复用
|
|||
|
|
- Engine 方法封装：复用测量功能模式（`src/components/engine/index.ts:217-401`）
|
|||
|
|
- Manager 代理：复用测量方法代理模式（`src/managers/engine-manager.ts:126-163`）
|
|||
|
|
- DialogManager 回调：复用 MeasureDialogManager 模式
|
|||
|
|
|
|||
|
|
### 生命周期设计
|
|||
|
|
- **打开弹窗**: `onDialogCreated()` 中自动激活 X 轴
|
|||
|
|
- **切换轴向**: `onAxisChange` 回调中调用 `activateSectionAxis()`
|
|||
|
|
- **关闭弹窗**: `onBeforeDestroy()` 中调用 `deactivateSectionAxis()`
|
|||
|
|
- **关键点**: 使用 `clipping.disActive()` 停用所有剖切，而非单个 plane 的 `disActive()`
|
|||
|
|
|
|||
|
|
### 幂等性保证
|
|||
|
|
- 重复激活同一轴向时，`activateSectionAxis()` 静默返回
|
|||
|
|
- 避免不必要的引擎 API 调用
|
|||
|
|
|
|||
|
|
### 注释策略
|
|||
|
|
- 公共 API 方法：保留 JSDoc（IntelliSense 需要）
|
|||
|
|
- 业务逻辑限制：保留注释（"第三方引擎无 API"）
|
|||
|
|
- 生命周期步骤：保留注释（理解执行时机）
|