feat(tree,menu,docs): 对接目录树三类数据并中文化文档

This commit is contained in:
yuding
2026-01-28 17:19:36 +08:00
parent 3ab9d4b0ea
commit 0b8dcd36fa
32 changed files with 4060 additions and 3302 deletions

View File

@@ -102,12 +102,12 @@ interface MenuItemConfig {
- `.sisyphus/drafts/API_CALLCHAIN.md` - 重构调用链文档(从 Toolbar 专用扩展为全局文档)
### Definition of Done
- [ ] `bun run build` 构建成功
- [ ] 点击构件后,右键显示"构件详情"和"显示全部"
- [ ] 未选中构件时,右键只显示"显示全部"
- [ ] 点击"构件详情"弹出属性弹窗,展示底层 API 返回的数据
- [ ] 点击"显示全部"控制台输出提示
- [ ] 调用链文档已重构并更新
- [x] `bun run build` 构建成功
- [x] 点击构件后,右键显示"构件详情"和"显示全部"
- [x] 未选中构件时,右键只显示"显示全部"
- [x] 点击"构件详情"弹出属性弹窗,展示底层 API 返回的数据
- [x] 点击"显示全部"控制台输出提示
- [x] 调用链文档已重构并更新
### Must Have
- 监听底层 Click 事件获取选中构件
@@ -155,7 +155,7 @@ Task 6 (重构调用链文档)
## TODOs
- [ ] 1. Engine 组件 - 监听构件点击,记录选中状态
- [x] 1. Engine 组件 - 监听构件点击,记录选中状态
**What to do**:
`engine/src/components/engine/index.ts` 中:
@@ -211,11 +211,11 @@ Task 6 (重构调用链文档)
- `engine/src/components/engine/index.ts:108-131` - init() 方法位置
**Acceptance Criteria**:
- [ ] 新增 `selectedComponent` 私有属性
- [ ] 在 init() 中监听 click 事件
- [ ] 新增 `getSelectedComponent()` 方法
- [ ] 新增 `getComponentProperties()` 方法
- [ ] 点击构件时控制台输出选中信息
- [x] 新增 `selectedComponent` 私有属性
- [x] 在 init() 中监听 click 事件
- [x] 新增 `getSelectedComponent()` 方法
- [x] 新增 `getComponentProperties()` 方法
- [x] 点击构件时控制台输出选中信息
**Commit**: YES
- Message: `feat(engine): 监听构件点击事件并记录选中状态`
@@ -223,7 +223,7 @@ Task 6 (重构调用链文档)
---
- [ ] 2. EngineManager - 暴露方法并修改右键处理器
- [x] 2. EngineManager - 暴露方法并修改右键处理器
**What to do**:
在 `engine/src/managers/engine-manager.ts` 中:
@@ -289,11 +289,11 @@ Task 6 (重构调用链文档)
- `engine/src/components/menu/item.ts` - MenuItemConfig 定义
**Acceptance Criteria**:
- [ ] 新增 `getSelectedComponent()` 代理方法
- [ ] 新增 `getComponentProperties()` 代理方法
- [ ] 修改 registerHandler 动态返回菜单项
- [ ] 有选中时显示"构件详情"+"显示全部"
- [ ] 无选中时只显示"显示全部"
- [x] 新增 `getSelectedComponent()` 代理方法
- [x] 新增 `getComponentProperties()` 代理方法
- [x] 修改 registerHandler 动态返回菜单项
- [x] 有选中时显示"构件详情"+"显示全部"
- [x] 无选中时只显示"显示全部"
**Commit**: YES
- Message: `feat(engine-manager): 添加构件选中方法和动态右键菜单`
@@ -301,7 +301,7 @@ Task 6 (重构调用链文档)
---
- [ ] 3. 创建 ComponentDetailManager - 构件详情弹窗
- [x] 3. 创建 ComponentDetailManager - 构件详情弹窗
**What to do**:
创建 `engine/src/managers/component-detail-manager.ts`
@@ -443,11 +443,11 @@ Task 6 (重构调用链文档)
- `engine/src/components/description/index.ts` - Description 组件
**Acceptance Criteria**:
- [ ] 新建 `component-detail-manager.ts` 文件
- [ ] 实现 `show(modelUrl, componentId)` 方法
- [ ] 调用底层 API 获取属性数据
- [ ] 使用 Collapse + Description 展示属性
- [ ] 实现 `hide()` 和 `destroy()` 方法
- [x] 新建 `component-detail-manager.ts` 文件
- [x] 实现 `show(modelUrl, componentId)` 方法
- [x] 调用底层 API 获取属性数据
- [x] 使用 Collapse + Description 展示属性
- [x] 实现 `hide()` 和 `destroy()` 方法
**Commit**: YES
- Message: `feat: 新增构件详情弹窗管理器`
@@ -455,7 +455,7 @@ Task 6 (重构调用链文档)
---
- [ ] 4. BimEngine 和 Registry 注册管理器
- [x] 4. BimEngine 和 Registry 注册管理器
**What to do**:
@@ -491,9 +491,9 @@ Task 6 (重构调用链文档)
- `engine/src/core/manager-registry.ts` - Registry 结构
**Acceptance Criteria**:
- [ ] ManagerRegistry 添加 componentDetail 类型声明
- [ ] BimEngine 添加 componentDetail 属性
- [ ] BimEngine 添加 initComponentDetail() 方法
- [x] ManagerRegistry 添加 componentDetail 类型声明
- [x] BimEngine 添加 componentDetail 属性
- [x] BimEngine 添加 initComponentDetail() 方法
**Commit**: YES
- Message: `feat(bim-engine): 注册构件详情管理器`
@@ -501,7 +501,7 @@ Task 6 (重构调用链文档)
---
- [ ] 5. 国际化文本 + 构建验证
- [x] 5. 国际化文本 + 构建验证
**What to do**:
@@ -550,9 +550,9 @@ Task 6 (重构调用链文档)
- `engine/src/locales/en-US.ts` - 英文国际化
**Acceptance Criteria**:
- [ ] zh-CN 添加 menu.componentDetail, menu.showAll, panel.componentDetail.title
- [ ] en-US 添加对应英文文本
- [ ] `bun run build` 执行成功,无报错
- [x] zh-CN 添加 menu.componentDetail, menu.showAll, panel.componentDetail.title
- [x] en-US 添加对应英文文本
- [x] `bun run build` 执行成功,无报错
**Commit**: YES
- Message: `feat(i18n): 添加构件详情相关国际化文本`
@@ -560,7 +560,7 @@ Task 6 (重构调用链文档)
---
- [ ] 6. 重构调用链文档
- [x] 6. 重构调用链文档
**What to do**:
@@ -728,11 +728,11 @@ Task 6 (重构调用链文档)
- `engine/src/managers/engine-manager.ts` - 右键处理器注册
**Acceptance Criteria**:
- [ ] 文档重命名为 `API_CALLCHAIN.md`
- [ ] 文档标题改为"SDK API 调用链文档"
- [ ] 新增"右键菜单"章节,包含构件详情、显示全部、信息、首页
- [ ] 新增"构件交互"章节,包含选中/取消选中调用链
- [ ] 原 Toolbar 内容保持不变,作为第一章
- [x] 文档重命名为 `API_CALLCHAIN.md`
- [x] 文档标题改为"SDK API 调用链文档"
- [x] 新增"右键菜单"章节,包含构件详情、显示全部、信息、首页
- [x] 新增"构件交互"章节,包含选中/取消选中调用链
- [x] 原 Toolbar 内容保持不变,作为第一章
**Commit**: YES
- Message: `docs: 重构调用链文档,新增右键菜单和构件交互章节`
@@ -761,13 +761,13 @@ bun run build # Expected: BUILD SUCCESS
```
### Final Checklist
- [ ] 点击构件后,控制台输出选中信息
- [ ] 有选中构件时,右键显示"构件详情"+"显示全部"
- [ ] 无选中构件时,右键只显示"显示全部"
- [ ] 点击"构件详情"弹出属性弹窗
- [ ] 弹窗正确展示底层 API 返回的属性数据
- [ ] 点击"显示全部"控制台输出提示
- [ ] 构建成功
- [ ] 调用链文档已重构为全局文档
- [ ] 新增右键菜单章节
- [ ] 新增构件交互章节
- [x] 点击构件后,控制台输出选中信息
- [x] 有选中构件时,右键显示"构件详情"+"显示全部"
- [x] 无选中构件时,右键只显示"显示全部"
- [x] 点击"构件详情"弹出属性弹窗
- [x] 弹窗正确展示底层 API 返回的属性数据
- [x] 点击"显示全部"控制台输出提示
- [x] 构建成功
- [x] 调用链文档已重构为全局文档
- [x] 新增右键菜单章节
- [x] 新增构件交互章节