2026-06-27 Pro主题倒计时PRD
用户目标
将“免费用户体验 Pro 主题时显示剩余时间”的讨论结论落成 1 份正式 PRD,供研发和 QA 后续落地。
已完成事项
- 使用 PRD 写作规范整理需求,只描述用户可感知行为、交互状态、文案口径和验收标准。
- 核对当前代码事实:Pro 主题预览当前为 5 分钟,不是 15 分钟;倒计时应跟真实配置时长走,不能写死固定时长文案。
- 新增 PRD 文档:
src/Docs/Requirements/2026-06-27-pro-theme-preview-countdown-prd.md。
- 用户指出 PRD 正文不应使用英文后,已重新读取
/Users/ar/.codex/AGENTS.md 和项目根目录 AGENTS.md,并将 PRD 正文改为简体中文。
- 按经验教训规则新增记录:
Docs/KM2.项目管理-非业务直接相关/项目经理-经验与教训.md。
关键决策
- 需求定位:Pro 主题预览的状态可解释性增强,不是新增复杂控件。
- 展示位置:沿用 Theme 页顶部 Pro 状态行和当前预览主题卡的 accessory 区域。
- 展示形式:推荐
体验中 · 剩余 04:59,主题卡可用 04:59 或 体验中 04:59。
- 交互边界:不改变预览时长、不改变购买流程、不改变免费主题列表、不改变主题持久化规则。
- 过期处理:不弹阻塞 modal;预览结束后恢复真实可用主题,并可使用轻量反馈。
文件变更
- 新增:
src/Docs/Requirements/2026-06-27-pro-theme-preview-countdown-prd.md
- 新增:
.codex-sessionhistory/2026-06-27-Pro主题倒计时PRD.md
- 新增:
Docs/KM2.项目管理-非业务直接相关/项目经理-经验与教训.md
- 未修改 App 源码。
- 未修改
src/TODO.md;本轮用户明确要求产出 1 份需求文档,任务登记可在后续研发执行阶段由 PM/研发台账处理。
未决问题
- 是否保持当前生产预览时长 5 分钟,还是另起产品决策调整为其他时长。
- 预览结束反馈使用状态行变化即可,还是复用现有轻量 toast。
- 主题卡 accessory 最终文案采用纯时间
04:59,还是 体验中 04:59。
后续建议
- 研发落地时应补充 QA:免费用户预览、切换 Pro 主题、切换免费主题、倒计时结束、设置页关闭重开、购买/恢复成功、Pro/legacy Pro 不显示倒计时、多语言和 macOS 14。
- QA 可使用现有缩短预览时长的 QA override 加速验证倒计时过期链路。