| | |
|---|
| | | # PRD：Pro 主题体验倒计时 |
|---|
| | | |
|---|
| | | 日期：2026-06-27 |
|---|
| | | 状态：已按 8.1.6 落地并进入 QA 回归 |
|---|
| | | 状态：8.1.7 已确认方案，进入实现与 QA 回归 |
|---|
| | | 目标分支：`codex/appgrid-usage-tips` |
|---|
| | | 目标范围：免费版 + Pro 主题体验 |
|---|
| | | 最低系统：macOS 14.0 |
|---|
| | |
|---|
| | | - 倒计时文案不写死 5 分钟，从 `ProThemePreviewState.endsAt` 推导真实剩余时间。 |
|---|
| | | - 29 个语言文件新增 `pro.theme.status.previewCountdown`，统一保留 `%time%` 占位符。 |
|---|
| | | |
|---|
| | | ## 0.1 8.1.7 实验增补：暗色炫彩 / 亮色炫彩可调背景 |
|---|
| | | |
|---|
| | | 本增补是 8.1.7 的新实验需求。它建立在 8.1.6 的 Pro 主题体验倒计时之上，不改变倒计时、购买、恢复购买、旧付费用户自动获得 Pro、免费预览不写入真实设置等既有口径。 |
|---|
| | | |
|---|
| | | ### 0.1.1 产品目标 |
|---|
| | | |
|---|
| | | - 把现有“深蓝”主题升级为更现代的暗色液体渐变视觉，显示名称改为“暗色炫彩”。 |
|---|
| | | - 把现有“炫彩”主题显示名称改为“亮色炫彩”，保留当前明亮、年轻、彩色的初始视觉方向。 |
|---|
| | | - “暗色炫彩”和“亮色炫彩”都纳入 Pro 主题范围，继续复用现有 Pro 预览倒计时和解锁逻辑。 |
|---|
| | | - 两个炫彩主题被选中时，在主题网格下方显示整行调色滑轨。用户拖动滑轨时，只改变 App Grid 背景的液体渐变色彩状态，不改变容器玻璃、图标、标签、拖拽、备注、布局、Pro 状态或购买逻辑。 |
|---|
| | | |
|---|
| | | ### 0.1.2 命名与兼容 |
|---|
| | | |
|---|
| | | - UI 显示名变更： |
|---|
| | | - `深蓝` -> `暗色炫彩` |
|---|
| | | - `炫彩` -> `亮色炫彩` |
|---|
| | | - 如现有代码已有稳定主题内部 ID，应优先保留内部 ID，只改显示名和视觉 token，避免破坏用户已保存主题、QA 脚本、旧偏好值和回滚路径。 |
|---|
| | | - 多语言必须同步新增或更新 29 个语言的主题显示名。译文应短、自然、可放进主题卡片；长语言允许最多两行，但不得挤掉 Pro 标识和选中状态。 |
|---|
| | | |
|---|
| | | ### 0.1.3 调色滑轨 |
|---|
| | | |
|---|
| | | - 滑轨只在选中 `暗色炫彩` 或 `亮色炫彩` 时显示。 |
|---|
| | | - 滑轨位置：主题卡片网格下方的 full-width 附加控制区，不嵌入单个主题卡片，不改变两列卡片高度。 |
|---|
| | | - 滑轨区域建议高度控制在 44-56pt，底部保留至少 24pt 安全空白，不贴近设置窗口底部圆角。 |
|---|
| | | - `暗色炫彩` 的滑轨只能在暗色可读范围内变化：无论拖到哪里，整体仍是深色背景，容器标题、标签、按钮和图标都保持足够对比。 |
|---|
| | | - `亮色炫彩` 的滑轨只能在亮色可读范围内变化：无论拖到哪里，整体仍是明亮、干净、年轻的背景，不退化成暗黑主题。 |
|---|
| | | - 免费用户体验这两个 Pro 主题时，滑轨调整只影响本次临时预览；未解锁 Pro 前不得把滑轨值写入真实持久化设置。 |
|---|
| | | - Pro 用户或旧付费自动 Pro 用户调整滑轨后，滑轨值可以作为真实主题配置持久化。 |
|---|
| | | |
|---|
| | | ### 0.1.4 视觉方向 |
|---|
| | | |
|---|
| | | - `暗色炫彩`：深色基底 + 多色液体流动感。它不是纯深蓝，也不是单一紫蓝渐变；应有高级、冷静、现代的色彩层次。 |
|---|
| | | - `暗色炫彩` 默认初始视觉采用方案 1「极夜孔雀」：深青黑底，孔雀蓝与冷翠绿液体光带。滑轨初始位置应对应这套初始状态。 |
|---|
| | | - `亮色炫彩`：明亮基底 + 多色液体流动感。它服务年轻、轻快、漂亮的审美，不应变成暗黑或低饱和灰脏效果。 |
|---|
| | | - 单个容器继续保持统一玻璃面板，不在每个容器内部各自做强烈渐变；渐变主要属于整个 App Grid 背景。 |
|---|
| | | - hover、选中、Pro 标识和滑轨 thumb 的颜色必须跟随主题适配，但不能牺牲可读性。 |
|---|
| | | |
|---|
| | | ### 0.1.5 设置页布局调整 |
|---|
| | | |
|---|
| | | - 内容区顶部不再重复显示“主题”标题和“选择应用网格的背景主题。”短说明；Tab 已经表达当前位置，主题卡片和 Pro 状态行应整体上移，减少不必要的纵向滚动。 |
|---|
| | | - 主题页内容整体上移，为底部滑轨留出空间。 |
|---|
| | | - 主题说明文案保持简短，避免在 29 种语言下挤压主题卡片和滑轨。 |
|---|
| | | - 主题卡片网格中，`暗色炫彩` 和 `亮色炫彩` 固定放在最下方最后一排：左侧为 `暗色炫彩`，右侧为 `亮色炫彩`。这两个可调主题在视觉上形成对称分组，下方整行滑轨自然归属于这一组。 |
|---|
| | | - Pro 标识、主题名、选中勾三者不能互相挤压；长语言下优先保护主题名和选中状态。 |
|---|
| | | |
|---|
| | | ### 0.1.6 不做范围 |
|---|
| | | |
|---|
| | | - 不改变 App Grid 的布局算法。 |
|---|
| | | - 不改变容器玻璃的独立深浅开关。 |
|---|
| | | - 不改变 Pro 购买流程、价格、恢复购买或旧用户权益。 |
|---|
| | | - 不改变 8.1.6 已落地的倒计时机制。 |
|---|
| | | - 方案确认前不直接落 App 代码；产品已选择方案 1「极夜孔雀」作为默认起点后，本阶段进入实现与 QA。 |
|---|
| | | |
|---|
| | | ### 0.1.6a 同批小需求：新用户默认图标大小 |
|---|
| | | |
|---|
| | | - 初次安装、没有已有 `iconSize` 偏好的新用户，默认图标大小改为 `56`。 |
|---|
| | | - 已有用户如果已经保存过图标大小，不做迁移、不覆盖、不重置。 |
|---|
| | | - 该需求与 8.1.7 同批实现和回归，避免为小需求单独走一轮发布级 QA。 |
|---|
| | | |
|---|
| | | ### 0.1.7 验收标准 |
|---|
| | | |
|---|
| | | - `PTC-16`：主题页中 `深蓝` 已显示为 `暗色炫彩`，`炫彩` 已显示为 `亮色炫彩`，29 种语言都不存在旧显示名遗漏。 |
|---|
| | | - `PTC-17`：`暗色炫彩` 和 `亮色炫彩` 都按 Pro 主题处理，免费用户仍走 8.1.6 的预览倒计时。 |
|---|
| | | - `PTC-18`：只有选中两个炫彩主题时才显示调色滑轨；其它主题不显示且不占位。 |
|---|
| | | - `PTC-18a`：主题网格最后一排固定为左 `暗色炫彩`、右 `亮色炫彩`，其它主题不会插入这两个卡片之间。 |
|---|
| | | - `PTC-19`：`暗色炫彩` 滑轨任何位置都保持暗色风格和足够文字对比。 |
|---|
| | | - `PTC-20`：`亮色炫彩` 滑轨任何位置都保持亮色风格和足够文字对比。 |
|---|
| | | - `PTC-21`：免费预览期间调色不写入真实主题设置；预览结束或切回免费主题后不残留脏数据。 |
|---|
| | | - `PTC-22`：Pro 用户调色后可持久化，重启 App 后仍保持所选主题和滑轨状态。 |
|---|
| | | - `PTC-23`：macOS 14 下主题页布局不裁切、不出现底部贴边、不因长语言挤压滑轨。 |
|---|
| | | - `PTC-24`：已有保存为旧 `深蓝` / `炫彩` 的用户偏好仍能映射到新显示名和新视觉，不出现空主题或回退默认。 |
|---|
| | | - `PTC-25`：新安装默认 `iconSize=56`；已有 `iconSize` 的用户不被覆盖。 |
|---|
| | | - `PTC-26`：`亮色炫彩` 的默认滑轨位置为最左端；新用户、首次切到该主题、未保存过调色偏好的用户都从最左端初始视觉开始。 |
|---|
| | | |
|---|
| | | ## 1. 摘要 |
|---|
| | | |
|---|
| | | 为 Pro 主题的免费体验状态增加可见倒计时。 |
|---|
