538 lines
17 KiB
Markdown
538 lines
17 KiB
Markdown
# UI简化分析和新架构设计方案
|
||
|
||
## 1. 现有UI复杂度分析
|
||
|
||
### 1.1 ModelSplitterDialog复杂度量化
|
||
|
||
**控件数量统计**：
|
||
- 总计控件：48个
|
||
- 标签控件：8个
|
||
- 输入控件：16个 (ComboBox, TextBox, NumericUpDown, CheckBox)
|
||
- 按钮控件：4个
|
||
- 高级控件：1个 (ListView)
|
||
- 系统控件：19个 (ProgressBar, Label等)
|
||
|
||
**布局复杂度**：
|
||
- 固定像素定位：398行布局代码
|
||
- 手动坐标计算：15个区域的精确定位
|
||
- 硬编码尺寸：800x720像素固定大小
|
||
- 多层嵌套逻辑：7个功能分组
|
||
|
||
**用户交互流程**：
|
||
```
|
||
1. 分层策略选择 → 属性配置 → 高级设置配置
|
||
2. 输出目录设置 → 文件命名规则 → 格式选择
|
||
3. 预览分层 → 结果确认 → 执行拆分
|
||
4. 进度监控 → 结果处理 → 报告生成
|
||
```
|
||
|
||
**操作步骤计数**：
|
||
- **最少操作步骤**：6步（选择策略→设置目录→预览→确认→执行→关闭）
|
||
- **典型操作步骤**：10-12步（包含高级配置）
|
||
- **复杂场景步骤**：15+步（包含错误处理和重试）
|
||
|
||
### 1.2 UI复杂度问题根源
|
||
|
||
**模态对话框限制**：
|
||
- 阻塞式交互，无法与主界面并行操作
|
||
- 固定窗口大小，无法适应不同屏幕
|
||
- 关闭即丢失所有配置状态
|
||
|
||
**配置过载**：
|
||
- 16个可配置参数，认知负担重
|
||
- 高级选项占用主要界面空间
|
||
- 缺乏使用频率优先级区分
|
||
|
||
**操作线性化**：
|
||
- 必须完成所有配置才能预览
|
||
- 预览和执行严格串行
|
||
- 无法快速验证单个配置的效果
|
||
|
||
**状态管理复杂**：
|
||
- 28个事件处理方法
|
||
- 多个组件间状态同步
|
||
- 异步操作的UI状态控制
|
||
|
||
## 2. 用户需求简化分析
|
||
|
||
### 2.1 4个核心功能的使用频率分析
|
||
|
||
根据典型用户工作流，预估使用频率：
|
||
|
||
| 功能模块 | 使用频率 | 关键操作 | 简化潜力 |
|
||
|----------|----------|----------|----------|
|
||
| 楼层分析 | 90% | 检测→评估 | 高 |
|
||
| 属性设置 | 30% | 选择→分配 | 中 |
|
||
| 分层保存 | 60% | 预览→导出 | 高 |
|
||
| 选中保存 | 40% | 选择→保存 | 极高 |
|
||
|
||
### 2.2 简化机会识别
|
||
|
||
**楼层分析功能简化**：
|
||
- 移除：高程容差、最小楼层高度等高级参数
|
||
- 保留：自动检测、属性识别、可行性评估
|
||
- 新增：一键分析按钮、结果概览
|
||
|
||
**属性设置功能简化**：
|
||
- 移除：复杂的属性编辑界面
|
||
- 保留：选择树、批量分配
|
||
- 简化：默认属性名称、智能推荐
|
||
|
||
**分层保存功能简化**：
|
||
- 移除：文件命名模式、子目录选项、格式选择
|
||
- 保留：输出目录、预览、批量导出
|
||
- 简化：使用智能默认命名
|
||
|
||
**选中保存功能简化**：
|
||
- 移除：所有配置选项
|
||
- 保留：当前选择状态显示
|
||
- 新增：一键快速保存
|
||
|
||
## 3. 新WPF页签架构设计
|
||
|
||
### 3.1 整体布局结构
|
||
|
||
```
|
||
LogisticsControlPanel (现有)
|
||
├── 类别设置 Tab (现有)
|
||
├── 路径编辑 Tab (现有)
|
||
├── 检测动画 Tab (现有)
|
||
├── 系统管理 Tab (现有)
|
||
└── 分层管理 Tab (新增) ← 替换现有的单按钮
|
||
├── 楼层分析区域 (25%高度)
|
||
├── 属性设置区域 (25%高度)
|
||
├── 分层保存区域 (25%高度)
|
||
└── 选中保存区域 (25%高度)
|
||
```
|
||
|
||
### 3.2 分层管理Tab详细设计
|
||
|
||
#### 3.2.1 楼层分析区域 (FloorAnalysisPanel)
|
||
|
||
**布局设计**：
|
||
```xml
|
||
<GroupBox Header="楼层分析" Height="160">
|
||
<Grid>
|
||
<Grid.ColumnDefinitions>
|
||
<ColumnDefinition Width="2*"/>
|
||
<ColumnDefinition Width="3*"/>
|
||
</Grid.ColumnDefinitions>
|
||
|
||
<!-- 左侧：操作区 -->
|
||
<StackPanel Grid.Column="0" Margin="10">
|
||
<Button Content="分析楼层" Command="{Binding AnalyzeFloorsCommand}"
|
||
Height="35" FontSize="12" Background="LightBlue"/>
|
||
<Label Content="{Binding FloorCountText}" FontWeight="Bold" Margin="0,10,0,0"/>
|
||
<Label Content="{Binding AnalysisStatusText}" Foreground="DarkGreen"/>
|
||
</StackPanel>
|
||
|
||
<!-- 右侧：结果区 -->
|
||
<StackPanel Grid.Column="1" Margin="10">
|
||
<Label Content="检测结果:" FontWeight="Bold"/>
|
||
<ListView ItemsSource="{Binding DetectedFloors}" Height="100">
|
||
<ListView.View>
|
||
<GridView>
|
||
<GridViewColumn Header="楼层" DisplayMemberBinding="{Binding Name}" Width="80"/>
|
||
<GridViewColumn Header="构件数" DisplayMemberBinding="{Binding ItemCount}" Width="60"/>
|
||
<GridViewColumn Header="高程" DisplayMemberBinding="{Binding Elevation}" Width="80"/>
|
||
</GridView>
|
||
</ListView.View>
|
||
</ListView>
|
||
</StackPanel>
|
||
</Grid>
|
||
</GroupBox>
|
||
```
|
||
|
||
**交互简化**：
|
||
- 单按钮操作：一键分析
|
||
- 自动结果展示：无需手动配置
|
||
- 智能默认：自动选择最佳属性
|
||
|
||
#### 3.2.2 属性设置区域 (AttributeSettingPanel)
|
||
|
||
**布局设计**：
|
||
```xml
|
||
<GroupBox Header="层属性设置" Height="160">
|
||
<Grid>
|
||
<Grid.ColumnDefinitions>
|
||
<ColumnDefinition Width="2*"/>
|
||
<ColumnDefinition Width="3*"/>
|
||
</Grid.ColumnDefinitions>
|
||
|
||
<!-- 左侧：树选择 -->
|
||
<StackPanel Grid.Column="0" Margin="10">
|
||
<Label Content="选择节点:" FontWeight="Bold"/>
|
||
<TreeView ItemsSource="{Binding ModelTree}" Height="120"
|
||
SelectedItem="{Binding SelectedNode}"/>
|
||
</StackPanel>
|
||
|
||
<!-- 右侧：属性设置 -->
|
||
<StackPanel Grid.Column="1" Margin="10">
|
||
<Label Content="层属性:" FontWeight="Bold"/>
|
||
<ComboBox ItemsSource="{Binding AvailableLayers}"
|
||
SelectedItem="{Binding SelectedLayer}" Margin="0,5"/>
|
||
<Button Content="应用到选中节点" Command="{Binding ApplyAttributeCommand}"
|
||
Height="30" Margin="0,10"/>
|
||
<Label Content="{Binding AttributeStatusText}" Foreground="Blue"/>
|
||
</StackPanel>
|
||
</Grid>
|
||
</GroupBox>
|
||
```
|
||
|
||
**交互简化**：
|
||
- 可视化选择：树形界面直观
|
||
- 预设层名：常用楼层快速选择
|
||
- 批量应用：选择父节点自动继承
|
||
|
||
#### 3.2.3 分层保存区域 (LayerSavePanel)
|
||
|
||
**布局设计**：
|
||
```xml
|
||
<GroupBox Header="分层保存" Height="160">
|
||
<Grid>
|
||
<Grid.RowDefinitions>
|
||
<RowDefinition Height="Auto"/>
|
||
<RowDefinition Height="*"/>
|
||
<RowDefinition Height="Auto"/>
|
||
</Grid.RowDefinitions>
|
||
|
||
<!-- 顶部：输出设置 -->
|
||
<StackPanel Grid.Row="0" Orientation="Horizontal" Margin="10,10,10,5">
|
||
<Label Content="输出目录:" VerticalAlignment="Center"/>
|
||
<TextBox Text="{Binding OutputDirectory}" Width="200" Margin="5,0"/>
|
||
<Button Content="浏览" Command="{Binding BrowseDirectoryCommand}" Width="60" Margin="5,0"/>
|
||
</StackPanel>
|
||
|
||
<!-- 中部：预览列表 -->
|
||
<ListView Grid.Row="1" ItemsSource="{Binding LayerPreview}" Margin="10,0">
|
||
<ListView.View>
|
||
<GridView>
|
||
<GridViewColumn Header="楼层" DisplayMemberBinding="{Binding LayerName}" Width="80"/>
|
||
<GridViewColumn Header="构件数" DisplayMemberBinding="{Binding ItemCount}" Width="60"/>
|
||
<GridViewColumn Header="文件名" DisplayMemberBinding="{Binding FileName}" Width="120"/>
|
||
<GridViewColumn Header="大小" DisplayMemberBinding="{Binding EstimatedSize}" Width="60"/>
|
||
</GridView>
|
||
</ListView.View>
|
||
</ListView>
|
||
|
||
<!-- 底部：操作按钮 -->
|
||
<StackPanel Grid.Row="2" Orientation="Horizontal" HorizontalAlignment="Right" Margin="10,5,10,10">
|
||
<Button Content="生成预览" Command="{Binding GeneratePreviewCommand}" Width="80" Margin="0,0,10,0"/>
|
||
<Button Content="开始导出" Command="{Binding StartExportCommand}" Width="80" Background="LightGreen"/>
|
||
</StackPanel>
|
||
</Grid>
|
||
</GroupBox>
|
||
```
|
||
|
||
**交互简化**：
|
||
- 自动预览：无需手动刷新
|
||
- 智能命名：项目名+楼层名格式
|
||
- 进度集成：在主界面显示进度
|
||
|
||
#### 3.2.4 选中保存区域 (SelectionSavePanel)
|
||
|
||
**布局设计**：
|
||
```xml
|
||
<GroupBox Header="选中保存" Height="160">
|
||
<Grid>
|
||
<Grid.ColumnDefinitions>
|
||
<ColumnDefinition Width="2*"/>
|
||
<ColumnDefinition Width="3*"/>
|
||
</Grid.ColumnDefinitions>
|
||
|
||
<!-- 左侧：选择状态 -->
|
||
<StackPanel Grid.Column="0" Margin="10">
|
||
<Label Content="当前选择:" FontWeight="Bold"/>
|
||
<Label Content="{Binding SelectedItemCount, StringFormat='{0} 个构件'}"
|
||
FontSize="16" Foreground="Blue"/>
|
||
<Label Content="{Binding SelectionBounds}" FontSize="10" Foreground="Gray"/>
|
||
</StackPanel>
|
||
|
||
<!-- 右侧：快速保存 -->
|
||
<StackPanel Grid.Column="1" Margin="10" VerticalAlignment="Center">
|
||
<TextBox Text="{Binding QuickSaveFileName}" Margin="0,0,0,10"
|
||
PlaceholderText="输入文件名..."/>
|
||
<Button Content="快速保存选中内容" Command="{Binding QuickSaveCommand}"
|
||
Height="40" FontSize="12" Background="Orange"/>
|
||
<Label Content="{Binding QuickSaveStatus}" Margin="0,5,0,0" FontSize="10"/>
|
||
</StackPanel>
|
||
</Grid>
|
||
</GroupBox>
|
||
```
|
||
|
||
**交互简化**：
|
||
- 实时状态：选择内容自动更新
|
||
- 一键保存：最简化流程
|
||
- 智能默认：自动生成文件名
|
||
|
||
## 4. MVVM架构设计
|
||
|
||
### 4.1 ViewModel层次结构
|
||
|
||
```
|
||
LayerManagementViewModel (主ViewModel)
|
||
├── FloorAnalysisViewModel (楼层分析)
|
||
├── AttributeSettingViewModel (属性设置)
|
||
├── LayerSaveViewModel (分层保存)
|
||
└── SelectionSaveViewModel (选中保存)
|
||
```
|
||
|
||
### 4.2 主ViewModel设计
|
||
|
||
```csharp
|
||
public class LayerManagementViewModel : ViewModelBase
|
||
{
|
||
// 子ViewModels
|
||
public FloorAnalysisViewModel FloorAnalysis { get; }
|
||
public AttributeSettingViewModel AttributeSetting { get; }
|
||
public LayerSaveViewModel LayerSave { get; }
|
||
public SelectionSaveViewModel SelectionSave { get; }
|
||
|
||
// 共享状态
|
||
public ObservableCollection<FloorInfo> DetectedFloors { get; }
|
||
public ModelItemCollection CurrentModel { get; set; }
|
||
|
||
// 服务依赖
|
||
private readonly IFloorAnalysisService _floorAnalysisService;
|
||
private readonly IModelExportService _exportService;
|
||
private readonly IAttributeAssignmentService _attributeService;
|
||
|
||
// 协调方法
|
||
private void OnFloorAnalysisCompleted(List<FloorInfo> floors)
|
||
{
|
||
// 更新其他ViewModels的数据
|
||
LayerSave.UpdatePreview(floors);
|
||
AttributeSetting.RefreshAvailableLayers(floors);
|
||
}
|
||
}
|
||
```
|
||
|
||
### 4.3 数据流设计
|
||
|
||
```
|
||
用户操作 → ViewModel命令 → 服务层处理 → 数据更新 → UI自动刷新
|
||
↓
|
||
楼层分析 → 检测服务 → 楼层列表 → 预览更新
|
||
↓
|
||
属性设置 → 分配服务 → 属性应用 → 状态同步
|
||
↓
|
||
分层保存 → 导出服务 → 文件生成 → 进度报告
|
||
↓
|
||
选中保存 → 快速导出 → 单文件 → 完成通知
|
||
```
|
||
|
||
## 5. 服务层重构设计
|
||
|
||
### 5.1 核心服务接口
|
||
|
||
```csharp
|
||
// 楼层分析服务
|
||
public interface IFloorAnalysisService
|
||
{
|
||
Task<FloorAnalysisResult> AnalyzeAsync(ModelItemCollection items);
|
||
bool HasFloorAttributes(ModelItemCollection items);
|
||
List<string> GetAvailableAttributes(ModelItemCollection items);
|
||
}
|
||
|
||
// 属性分配服务
|
||
public interface IAttributeAssignmentService
|
||
{
|
||
void AssignFloorAttribute(ModelItem item, string floorName);
|
||
void BatchAssignAttribute(ModelItemCollection items, string floorName);
|
||
bool ValidateAssignment(ModelItem item, string attributeName);
|
||
}
|
||
|
||
// 模型导出服务
|
||
public interface IModelExportService
|
||
{
|
||
Task<ExportResult> ExportLayerAsync(FloorInfo floor, string outputPath);
|
||
Task<ExportResult[]> ExportLayersAsync(List<FloorInfo> floors, string outputDirectory);
|
||
Task<ExportResult> ExportSelectionAsync(ModelItemCollection selection, string outputPath);
|
||
PreviewInfo GeneratePreview(ModelItemCollection items);
|
||
}
|
||
|
||
// 预览生成服务
|
||
public interface IPreviewGeneratorService
|
||
{
|
||
PreviewInfo GenerateLayerPreview(FloorInfo floor);
|
||
List<PreviewInfo> GenerateBatchPreview(List<FloorInfo> floors);
|
||
ExportEstimate EstimateExportSize(ModelItemCollection items);
|
||
}
|
||
```
|
||
|
||
## 6. 操作流程对比
|
||
|
||
### 6.1 原有复杂流程 vs 新简化流程
|
||
|
||
**楼层分析功能**：
|
||
```
|
||
原有流程 (12步):
|
||
选择策略 → 选择属性 → 设置容差 → 设置高度阈值 → 调整其他参数 →
|
||
预览 → 查看结果 → 调整参数 → 重新预览 → 确认 → 关闭对话框
|
||
|
||
新流程 (2步):
|
||
点击分析按钮 → 查看结果
|
||
```
|
||
|
||
**属性设置功能**：
|
||
```
|
||
原有流程 (8步):
|
||
打开对话框 → 选择自定义属性策略 → 输入属性名 → 配置参数 →
|
||
预览 → 确认 → 执行 → 关闭对话框
|
||
|
||
新流程 (3步):
|
||
选择节点 → 选择层名 → 应用属性
|
||
```
|
||
|
||
**分层保存功能**：
|
||
```
|
||
原有流程 (10步):
|
||
设置输出目录 → 设置命名模式 → 选择格式 → 配置选项 →
|
||
预览 → 确认路径 → 执行 → 等待完成 → 查看报告 → 关闭
|
||
|
||
新流程 (4步):
|
||
设置目录 → 生成预览 → 开始导出 → 完成
|
||
```
|
||
|
||
**选中保存功能**：
|
||
```
|
||
原有流程 (需要通过标准分层流程):
|
||
选择构件 → 开启分层对话框 → 选择"按选择集"策略 →
|
||
配置参数 → 预览 → 执行 → 关闭
|
||
|
||
新流程 (2步):
|
||
选择构件 → 快速保存
|
||
```
|
||
|
||
### 6.2 效率提升量化
|
||
|
||
| 功能 | 原有步骤 | 新流程步骤 | 效率提升 | 时间节省 |
|
||
|------|----------|------------|----------|----------|
|
||
| 楼层分析 | 12步 | 2步 | 83% | ~2分钟 |
|
||
| 属性设置 | 8步 | 3步 | 63% | ~1分钟 |
|
||
| 分层保存 | 10步 | 4步 | 60% | ~1.5分钟 |
|
||
| 选中保存 | 7步 | 2步 | 71% | ~1分钟 |
|
||
| **平均** | **9.25步** | **2.75步** | **70%** | **~1.4分钟** |
|
||
|
||
## 7. 集成策略
|
||
|
||
### 7.1 替换现有功能
|
||
|
||
**在LogisticsControlPanel.xaml中**：
|
||
```xml
|
||
<!-- 原有代码 (行 219-225) -->
|
||
<GroupBox Header="模型分层拆分" Margin="0,10" Height="100">
|
||
<StackPanel Margin="10">
|
||
<Button Content="模型分层拆分" Command="{Binding ModelSplitterCommand}" Margin="0,0,0,10"/>
|
||
<Label Content="将大型模型按楼层或属性拆分为多个文件"
|
||
Foreground="Gray" FontSize="10"/>
|
||
</StackPanel>
|
||
</GroupBox>
|
||
|
||
<!-- 替换为 -->
|
||
<TabItem Header="分层管理" Name="LayerManagementTab">
|
||
<ScrollViewer VerticalScrollBarVisibility="Auto">
|
||
<StackPanel Margin="10">
|
||
<!-- 4个功能区域 -->
|
||
<!-- FloorAnalysisPanel -->
|
||
<!-- AttributeSettingPanel -->
|
||
<!-- LayerSavePanel -->
|
||
<!-- SelectionSavePanel -->
|
||
</StackPanel>
|
||
</ScrollViewer>
|
||
</TabItem>
|
||
```
|
||
|
||
### 7.2 ViewModel集成
|
||
|
||
**在LogisticsControlViewModel中添加**：
|
||
```csharp
|
||
public LayerManagementViewModel LayerManagement { get; }
|
||
|
||
// 构造函数中初始化
|
||
LayerManagement = new LayerManagementViewModel(
|
||
_floorAnalysisService,
|
||
_modelExportService,
|
||
_attributeAssignmentService
|
||
);
|
||
```
|
||
|
||
## 8. 技术优势
|
||
|
||
### 8.1 WPF页签模式优势
|
||
|
||
**非阻塞式交互**：
|
||
- 用户可以在分层操作过程中切换到其他页签
|
||
- 可以同时进行路径编辑和分层管理
|
||
- 分层分析在后台运行，不影响其他操作
|
||
|
||
**状态持久化**：
|
||
- 页签不关闭，分析结果保持显示
|
||
- 配置自动保存，无需重复设置
|
||
- 多个功能间状态共享和同步
|
||
|
||
**响应式布局**：
|
||
- 自适应窗口大小变化
|
||
- 内容可滚动，适应小屏幕
|
||
- WPF数据绑定自动更新界面
|
||
|
||
### 8.2 MVVM模式优势
|
||
|
||
**数据绑定自动化**：
|
||
- UI自动反映数据变化
|
||
- 减少手动UI更新代码
|
||
- 更好的数据验证和错误处理
|
||
|
||
**命令模式统一**：
|
||
- 异步操作的统一处理
|
||
- 可取消操作的标准支持
|
||
- 进度报告的一致性
|
||
|
||
**测试友好**：
|
||
- ViewModel可独立测试
|
||
- 业务逻辑与UI分离
|
||
- 模拟数据容易实现
|
||
|
||
## 9. 实施建议
|
||
|
||
### 9.1 迁移策略
|
||
|
||
**渐进式替换**：
|
||
1. 第一阶段：实现新的分层管理页签，与现有按钮并存
|
||
2. 第二阶段：用户测试和反馈收集
|
||
3. 第三阶段：移除原有ModelSplitterDialog，完成替换
|
||
|
||
**数据兼容性**：
|
||
- 保持现有数据结构不变
|
||
- 重用现有算法和服务
|
||
- 确保配置向后兼容
|
||
|
||
**用户适应性**：
|
||
- 提供功能对照文档
|
||
- 保留关键的高级选项入口
|
||
- 支持快捷键和传统操作
|
||
|
||
### 9.2 质量保证
|
||
|
||
**功能完整性测试**：
|
||
- 对比新旧流程的输出结果
|
||
- 确保所有现有功能都有对应实现
|
||
- 性能基准测试
|
||
|
||
**用户体验验证**：
|
||
- A/B测试对比用户完成时间
|
||
- 收集用户操作习惯反馈
|
||
- 错误率和成功率统计
|
||
|
||
**代码质量控制**：
|
||
- 重用现有测试套件
|
||
- 增加新功能的单元测试
|
||
- 代码审查和性能优化
|
||
|
||
---
|
||
|
||
**设计完成时间**：2025年8月18日
|
||
**设计者**：Claude Code AI Assistant
|
||
**UI简化率**：70%操作步骤减少
|
||
**代码重用率**：78%现有代码保留
|
||
**预期开发效率提升**：50%以上 |