7.9.0 QA 测试用例集：容器内 App 手动排序
1. 测试目标
验证用户可以在同一容器内拖动 App 改变显示顺序，并确保顺序在刷新、重启、语言切换、导入导出、恢复、SmartStart 等路径中保持一致，同时不破坏现有跨容器拖动改标签行为。
2. 测试范围
- 数据模型兼容性。
- 同容器拖动排序。
- 旧拖拽行为回归。
- 多显示模式和标签位置。
- 导入导出、恢复、重置、SmartStart。
- macOS 14 兼容性。
3. 测试环境
- macOS 14 Apple Silicon 真机。
- 当前开发机最新 macOS。
- 干净用户数据一份。
- 旧版
tags.json fixture 一份。
- 含多标签 App、未分类 App、Apple 内置 App、已卸载 path 的测试数据一份。
4. 自动化用例
| ID |
优先级 |
类型 |
用例 |
期望结果 |
| DATA-001 |
P0 |
自动 |
旧 tags.json 无 containerAppOrder 字段时解码 |
加载成功，默认顺序与旧版本一致 |
| DATA-002 |
P0 |
自动 |
新 tags.json 含 containerAppOrder 字段时解码 |
加载成功，顺序字段保留 |
| DATA-003 |
P0 |
自动 |
导出后再导入含顺序的分类与布局 |
导入后每个容器顺序一致 |
| DATA-004 |
P0 |
自动 |
CategorySchemeFingerprint 包含顺序字段 |
只改变顺序也能触发上一方案快照 |
| DATA-005 |
P0 |
自动 |
恢复上一方案 |
标签、App 归属、容器内顺序都恢复 |
| DATA-006 |
P0 |
自动 |
重置为未分类 |
清空旧普通标签归属，并按既定策略清理旧容器顺序 |
| DATA-007 |
P0 |
自动 |
SmartStart replace |
新方案顺序可预测，不复用旧容器顺序 |
| DATA-008 |
P1 |
自动 |
tag rename/delete/relocalize |
顺序 key 正确迁移或清理 |
| DATA-009 |
P1 |
自动 |
卸载 App path 出现在顺序字段 |
不显示空位，不崩溃，必要时懒清理 |
| DATA-010 |
P1 |
自动 |
新 App 不在顺序字段内 |
已排序 App 保持，新增 App 追加并按默认名称排序 |
5. 手工功能用例
| ID |
优先级 |
用例 |
步骤 |
期望结果 |
| UI-001 |
P0 |
同容器拖动到最前 |
在某容器中把第 3 个 App 拖到第 1 个位置 |
App 顺序立即改变，不启动 App |
| UI-002 |
P0 |
同容器拖动到中间 |
把最后一个 App 拖到中间位置 |
插入位置正确，顺序保存 |
| UI-003 |
P0 |
跨行/跨列拖动 |
在网格容器中跨行拖动 App |
目标位置正确，无错位 |
| UI-004 |
P0 |
拖回原位 |
长按拖动后放回原位置 |
不写入无意义变更，不闪烁 |
| UI-005 |
P0 |
松手未移动 |
长按 App 后直接松手 |
不启动 App，不改变顺序 |
| UI-006 |
P0 |
多标签 App 独立顺序 |
App 同时在 A/B 容器，重排 A |
A 顺序改变，B 顺序不变 |
| UI-007 |
P0 |
重开 App Grid |
排序后关闭再打开 App Grid |
顺序保持 |
| UI-008 |
P0 |
重启 App |
排序后退出并重启 TagLauncher |
顺序保持 |
| UI-009 |
P1 |
语言切换 |
排序后切换中英文/日文 |
顺序保持，显示名变化不影响位置 |
| UI-010 |
P1 |
新安装 App |
排序后新增一个 App 并刷新 |
旧顺序保持，新 App 按默认规则追加 |
6. 旧拖拽行为回归
| ID |
优先级 |
用例 |
步骤 |
期望结果 |
| DRAG-001 |
P0 |
跨容器移动标签 |
从 A 容器拖 App 到 B 容器 |
App 获得/移动到 B 标签，旧逻辑保持 |
| DRAG-002 |
P0 |
Option 复制标签 |
按住 Option 从 A 拖到 B |
App 同时保留 A/B 标签 |
| DRAG-003 |
P0 |
拖到空白移除来源标签 |
从容器拖到空白区域 |
继续出现现有确认逻辑 |
| DRAG-004 |
P0 |
拖到未分类 |
拖到未分类目标 |
继续走未分类确认与记忆逻辑 |
| DRAG-005 |
P0 |
拖到 Apple 内置组 |
拖到 Mac 自带 / Apple 内置组 |
继续被保护，不改变标签 |
| DRAG-006 |
P1 |
标签栏拖拽排序 |
拖动顶部/侧边标签排序 |
不受 App 排序拖拽影响 |
7. 显示模式矩阵
| ID |
优先级 |
displayMode |
验收 |
| MODE-001 |
P0 |
flat |
顺序读取一致；是否允许拖动按产品最终边界验收 |
| MODE-002 |
P0 |
container |
可同容器排序 |
| MODE-003 |
P0 |
coloredContainer |
可同容器排序，颜色填充不遮挡插入提示 |
| MODE-004 |
P0 |
gridContainer |
可同容器排序，跨行插入正确 |
| MODE-005 |
P0 |
coloredGridContainer |
可同容器排序，跨行插入正确 |
8. 标签位置矩阵
| ID |
优先级 |
标签位置 |
验收 |
| NAV-001 |
P1 |
左侧 |
App 排序和标签导航互不冲突 |
| NAV-002 |
P1 |
右侧 |
App 排序和标签导航互不冲突 |
| NAV-003 |
P1 |
顶部 |
App 排序和标签导航互不冲突 |
9. 尺寸与显示矩阵
| ID |
优先级 |
条件 |
验收 |
| VIEW-001 |
P1 |
hide app names 开 |
拖动排序时不因名称隐藏误触发气泡 |
| VIEW-002 |
P1 |
hide app names 关 |
名称不遮挡插入提示 |
| VIEW-003 |
P1 |
icon size 40 |
小图标可拖动，命中正确 |
| VIEW-004 |
P1 |
icon size 64 |
默认尺寸可拖动 |
| VIEW-005 |
P1 |
icon size 80 |
大图标可拖动，布局不重叠 |
10. 异常与取消
| ID |
优先级 |
用例 |
期望结果 |
| EDGE-001 |
P0 |
拖出窗口后松手 |
状态清理干净，不残留拖拽影子 |
| EDGE-002 |
P1 |
拖动中按 Esc |
取消拖动，顺序不变 |
| EDGE-003 |
P1 |
拖动中滚动 |
不出现错位插入；若暂不支持滚动拖拽，边界表现明确 |
| EDGE-004 |
P1 |
拖动中切换 Space/窗口 |
不崩溃，不残留 hover/bubble 状态 |
| EDGE-005 |
P1 |
拖动中打开 Quick Search/Settings |
拖动状态清理，窗口行为正常 |
11. 现有 QA 脚本
实现完成后至少运行；本轮 7.9.0 (20260611.2212) 已按下列脚本回归：
cd /Users/ar/Projects/Taglauncher/src
bash Scripts/app_ordering_data_qa.sh
bash Scripts/macos14_availability_typecheck_qa.sh
bash Scripts/macos14_build_metadata_qa.sh
bash Scripts/quick_search_app_name_qa.sh
bash Scripts/quick_search_system_app_qa.sh
bash Scripts/smartstart_catalog_resource_qa.sh
bash Scripts/window_logic_qa.sh
自动化覆盖说明：
Scripts/app_ordering_data_qa.sh 覆盖排序字段兼容、JSON roundtrip、分类方案 fingerprint、导入导出、备份恢复、SmartStart 清理、ContentView wiring、AppGrid 同容器 payload 和 AppDragCoordinator 解析。Scripts/window_logic_qa.sh 覆盖 Dock 重开、Quick Search、Settings、文件面板、全屏/Split View、隐藏 Dock 场景下的窗口行为回归。- macOS 14 专项脚本覆盖
arm64-apple-macosx14.0 typecheck 和构建 metadata。
12. 发布阻断条件
- 顺序在刷新、重启、语言切换、导入导出、恢复上一方案任一路径丢失。
- 同容器排序破坏跨容器移动、Option 复制、拖空白移除、Apple 内置保护。
- 旧数据无法加载或升级后默认顺序改变。
- macOS 14 typecheck/build metadata/window logic 任一失败。
- 手工发现拖拽残影、误启动 App、窗口关闭、UI 重叠或插入位置不可理解。
