LanMountainDesktop/.trae/testing/fused-desktop-manual-test-checklist.md

融合桌面功能手动测试清单

测试日期: 2026-06-08
测试人员: ___________
构建版本: ___________

---

测试环境准备

• 启用融合桌面功能（设置 -> 应用设置 -> EnableFusedDesktop = true）
• 重启应用以加载融合桌面组件
• 确认任务栏托盘图标可见

---

测试组 1: 编辑模式控制 ⭐⭐⭐

测试 1.1: 打开组件库进入编辑模式

步骤:

1. 右键点击托盘图标
2. 选择"添加小组件"（或对应的菜单项）
3. 观察融合桌面组件库窗口是否打开

预期结果:

• 组件库窗口成功打开
• 已存在的桌面组件窗口的光标变为"移动"光标（十字箭头）
• 桌面组件显示蓝色边框高亮
• 桌面组件显示8个调整尺寸手柄（四角+四边）
• 桌面组件内部UI变为不可交互（IsHitTestVisible = false）

日志验证:

• 搜索日志: "Entered edit mode via library window open"

---

测试 1.2: 关闭组件库退出编辑模式

步骤:

1. 点击组件库窗口的关闭按钮（X）或按 ESC 键
2. 观察桌面组件状态

预期结果:

• 组件库窗口关闭
• 桌面组件的光标恢复正常
• 蓝色边框高亮消失
• 调整尺寸手柄消失
• 桌面组件内部UI恢复可交互

日志验证:

• 搜索日志: "Exited edit mode via library window close"

---

测试组 2: 组件添加与居中放置 ⭐⭐⭐

测试 2.1: 从组件库添加组件

步骤:

1. 打开组件库
2. 选择一个分类（如"时钟"）
3. 观察预览区显示的组件
4. 点击"添加小组件"按钮

预期结果:

• 组件成功添加到桌面
• 组件居中显示在当前屏幕的工作区
• 组件吸附到网格
• 组件库窗口保持打开（根据规格要求）
• 新组件立即显示蓝色边框和调整手柄（因为仍在编辑模式）

日志验证:

• 搜索日志: "Added component '...' with placement '...' at grid"

---

测试 2.2: 连续添加多个组件

步骤:

1. 在组件库保持打开的状态下
2. 连续添加3-5个不同的组件

预期结果:

• 每个组件都成功添加
• 后添加的组件不会覆盖先前的组件位置
• 所有组件都显示编辑模式视觉反馈

---

测试组 3: 组件拖拽移动 ⭐⭐⭐

测试 3.1: 在编辑模式下拖拽组件

步骤:

1. 打开组件库（进入编辑模式）
2. 左键按住桌面组件
3. 拖拽到不同位置
4. 释放鼠标

预期结果:

• 组件跟随鼠标移动
• 释放后组件吸附到最近的网格单元
• 组件不会超出屏幕工作区边界
• GridColumn 和 GridRow 正确更新

日志验证:

• 搜索日志: "Edit mode set to true"

---

测试 3.2: 拖拽到屏幕底部

步骤:

1. 拖拽组件到屏幕最底部
2. 释放鼠标

预期结果:

• 组件成功吸附到底部网格行
• 组件不会被任务栏遮挡
• 组件完全可见（不超出工作区）

---

测试 3.3: 拖拽到屏幕右侧

步骤:

1. 拖拽组件到屏幕最右侧
2. 释放鼠标

预期结果:

• 组件成功吸附到最右侧网格列
• 组件完全可见（不超出工作区）

---

测试组 4: 组件尺寸调整 ⭐⭐⭐⭐⭐

测试 4.1: 使用右下角手柄调整尺寸

步骤:

1. 进入编辑模式
2. 左键按住组件右下角的调整手柄
3. 向外拖拽增大尺寸
4. 释放鼠标

预期结果:

• 组件尺寸实时变化
• 释放后吸附到网格（宽度和高度都是 CellSize 的整数倍）
• GridWidthCells 和 GridHeightCells 正确更新
• 组件内容正确渲染新尺寸

日志验证:

• 搜索日志: "Resize started. Handle=BottomRight"
• 搜索日志: "Resize completed"

---

测试 4.2: 使用左上角手柄调整尺寸

步骤:

1. 拖拽左上角手柄
2. 向内缩小组件

预期结果:

• 组件从左上角调整尺寸
• 组件位置同步移动（保持右下角固定）
• 释放后正确吸附到网格
• 不会小于组件的 MinWidthCells 和 MinHeightCells

---

测试 4.3: 使用边缘手柄调整单一维度

步骤:

1. 拖拽右侧中间手柄（只调整宽度）
2. 拖拽底部中间手柄（只调整高度）

预期结果:

• 只有对应维度的尺寸变化
• 另一维度保持不变
• 吸附逻辑正确

---

测试 4.4: 最小尺寸约束

步骤:

1. 尝试将组件缩小到极小尺寸
2. 持续向内拖拽

预期结果:

• 组件停止在最小尺寸（50px 或 MinWidthCells/MinHeightCells）
• 无法继续缩小

---

测试组 5: 网格吸附一致性 ⭐⭐⭐

测试 5.1: 添加大尺寸组件

步骤:

1. 添加一个 4x4 或更大的组件

预期结果:

• 组件正确居中
• 跨越多个网格单元
• 边界对齐网格线

---

测试 5.2: 拖拽大组件到边缘

步骤:

1. 拖拽大组件到屏幕边缘
2. 释放

预期结果:

• 组件吸附时不会超出屏幕
• 如果无法完全显示，自动调整到边界内最近的合法位置

---

测试组 6: 多屏幕场景 ⭐⭐

测试 6.1: 跨屏幕拖拽（如果有多显示器）

步骤:

1. 将组件拖拽到第二个显示器
2. 释放

预期结果:

• 组件吸附到第二个显示器的网格
• 使用第二个显示器的工作区计算网格

---

测试组 7: 组件删除 ⭐⭐

测试 7.1: 非编辑模式下右键删除

步骤:

1. 关闭组件库（退出编辑模式）
2. 右键点击桌面组件
3. 选择"移除组件"

预期结果:

• 右键菜单显示
• 点击"移除组件"后窗口关闭
• 组件从布局配置中移除

---

测试组 8: 持久化与重载 ⭐⭐⭐

测试 8.1: 重启后保持布局

步骤:

1. 添加多个组件，调整位置和尺寸
2. 关闭应用
3. 重新启动应用

预期结果:

• 所有组件在相同位置重新加载
• 尺寸保持不变
• 网格坐标保持一致

---

测试组 9: 预览布局计算 ⭐⭐

测试 9.1: 组件库预览保持比例

步骤:

1. 打开组件库
2. 切换不同分类，观察不同尺寸的组件预览

预期结果:

• 横向组件（4x2）显示为宽大于高
• 纵向组件（2x4）显示为高大于宽
• 正方形组件（3x3）宽高相等
• 预览尺寸适应窗口大小

---

测试 9.2: 调整组件库窗口尺寸

步骤:

1. 拖拽组件库窗口边框调整尺寸
2. 观察预览区组件

预期结果:

• 预览组件尺寸自动调整
• 保持组件原始宽高比
• 不超出预览区边界

---

测试组 10: 边界情况 ⭐⭐

测试 10.1: 空布局启动

步骤:

1. 清空布局配置文件
2. 启动应用

预期结果:

• 应用正常启动
• 桌面无组件显示
• 可正常打开组件库添加组件

---

测试 10.2: 编辑模式中拖拽组件库窗口

步骤:

1. 打开组件库
2. 拖拽组件库窗口到不同位置
3. 尝试拖拽桌面组件

预期结果:

• 组件库窗口可正常拖拽
• 桌面组件仍可拖拽
• 两者互不干扰

---

回归测试 ⭐

回归 1: 组件内部交互（非编辑模式）

步骤:

1. 退出编辑模式
2. 与桌面组件交互（点击按钮、输入文字等）

预期结果:

• 组件内部UI完全可交互
• 所有功能正常工作

---

回归 2: 底部窗口层级

步骤:

1. 打开其他应用窗口
2. 最小化/移动窗口

预期结果:

• 桌面组件始终保持在最底层（BottomMost）
• 其他窗口不会被组件遮挡

---

性能测试 ⭐

性能 1: 大量组件

步骤:

1. 添加 10-20 个组件到桌面

预期结果:

• 拖拽仍然流畅
• 编辑模式切换无延迟
• CPU 和内存占用在合理范围

---

测试总结

通过的测试: _____ / 总计
失败的测试: _____
阻塞问题: _____

关键问题列表: 1. 2. 3.

改进建议: 1. 2. 3.

---

测试完成时间: ___________
签名: ___________