# 7.9.0 产品 PRD：容器内 App 手动排序 ## 1. 背景 TagLauncher 当前支持按标签/容器展示 App，也支持拖动 App 改变标签归属。但在同一个容器内，App 的显示顺序主要来自扫描后的默认名称排序，用户无法把高频 App 固定到自己习惯的位置。 对重度用户来说，容器不仅是分类，也是工作流入口。用户希望像整理桌面图标一样，在每个容器中把 App 摆成自己的顺序，并且这个顺序能随“分类与布局”一起保存、导入、恢复。 ## 2. 目标 - 用户可以在同一个容器/分组内拖动 App，改变该容器内显示顺序。 - 自定义顺序在刷新、重启、语言切换、导入导出、恢复上一方案、SmartStart 回滚后保持一致。 - 不破坏现有跨容器拖动改标签、Option 复制、拖到空白移除标签、Apple 内置组保护等既有行为。 - 将该需求作为 `7.9.0` 大版本需求管理。 ## 3. 用户价值 - 高频 App 可以放到容器最前面，减少寻找成本。 - 每个标签/容器可以形成独立工作流顺序。 - 多标签 App 在不同容器里可以有不同位置，符合不同使用语境。 - 导出“分类与布局”时真正包含布局顺序，便于迁移和恢复。 ## 4. 适用用户 - 安装 App 数量较多、依赖 TagLauncher 做日常启动入口的用户。 - 已经维护多个标签/容器，并希望在容器内进一步精细整理的用户。 - 需要在多台 Mac 或重装后恢复分类与布局的用户。 ## 5. 范围 ### 5.1 版本 7.9.0 必做 - 同一容器内拖动 App 改变顺序。 - 每个容器独立保存顺序。 - 多标签 App 在不同容器中的顺序互不影响。 - 新 App 或未记录 App 在自定义顺序之后按默认规则显示。 - 删除/卸载 App 后不显示空位、不崩溃。 - 顺序纳入分类与布局数据，可导出、导入、恢复。 - 旧用户数据无顺序字段时保持原有默认排序。 ### 5.2 版本 7.9.0 不做 - 不做跨容器插入位置排序。 - 不改变跨容器拖动的标签归属语义。 - 不改变 Quick Search 结果排序。 - 不提供“按名称重新排序”“重置单个容器顺序”等高级管理入口。 - 不做跨机器 bundle id/name fallback 的完整稳定匹配；第一版以 path 为 App 顺序身份。 ## 6. 核心交互 ### 6.1 同容器排序 用户在 App Grid 普通展示态中，长按并拖动某个 App 到同一容器中的另一个位置。 期望： - 拖动过程中显示清晰的插入位置提示。 - 松手后该 App 移动到目标位置。 - 不改变该 App 的标签归属。 - 不触发 App 启动。 ### 6.2 跨容器拖动 用户把 App 拖到其他容器/标签。 期望： - 沿用现有移动/复制标签逻辑。 - 按住 Option 时继续执行复制标签语义。 - 不把跨容器拖动解释为排序。 ### 6.3 拖到空白区域 用户把 App 拖到容器外空白区域。 期望： - 继续沿用现有移除来源标签或归为未分类确认逻辑。 - 不因为新增排序功能改变提醒、确认或“不再提醒”逻辑。 ### 6.4 特殊容器 - “未分类”容器：第一版允许读取排序；是否开放拖动排序按实现风险在开发阶段确认。 - “Mac 自带 / Apple 内置”容器：保持现有保护逻辑，不允许通过拖动改变系统标签归属；排序是否开放需单独评估，默认不作为第一优先级。 ## 7. 数据行为 - 自定义顺序属于“分类与布局方案”。 - 导出分类与布局时必须包含顺序。 - 导入分类与布局时必须恢复顺序。 - 恢复上一方案时必须恢复顺序。 - SmartStart 应用新方案前的备份必须包含顺序。 - “重置为未分类”应清理旧容器顺序，避免旧布局在未来意外复活。 ## 8. 兼容性要求 - macOS 14 起可用。 - 旧 `tags.json` 无新增字段时可正常读取。 - 旧版本 App 读取新 JSON 时不应破坏已知字段；新版本 App 重新读取后仍应尽量保留顺序。 - 语言切换不影响顺序，因为顺序 key 不能依赖本地化显示名。 ## 9. 验收标准 - 用户可在同容器内完成拖动排序。 - 排序结果立即显示。 - 关闭并重新打开 App Grid 后顺序保持。 - 重启 App 后顺序保持。 - 切换语言后顺序保持。 - 导出再导入后顺序保持。 - 恢复上一方案后顺序恢复。 - 跨容器拖动、Option 复制、拖到空白、Apple 内置保护保持现有行为。 - 旧数据用户升级后默认顺序不变。 ## 10. 发布要求 - 版本号从 `7.9.0` 开始。 - `CHANGELOG.md` 必须记录数据模型、交互范围和兼容性说明。 - 发布前必须有 QA 报告，覆盖数据层、UI 手工拖拽、macOS 14、导入导出、恢复、SmartStart 回归。 ## 11. 未决问题 - “未分类”容器是否开放拖动排序。 - “Mac 自带 / Apple 内置”容器是否开放仅显示顺序排序。 - 是否需要在后续版本提供“重置当前容器顺序”入口。 - 是否需要在后续版本支持跨机器导入时基于 bundle id/name 匹配顺序。