LUCKEELUC-1375 · WS7 · 需求评审稿 ← 返回工作台

A5 · 新手引导改版 PRD v0.1

待评审FOR REVIEW
▶ 打开可交互原型A2 · 目标运营计划 PRDA5 · 新手引导改版 PRD
目录
  1. 0. 要解决的问题（会议诊断 + 现状量化）
  2. 1. 改版目标
  3. 2. 改版设计（按会后五条逐条）
  4. 3. 改版后新手旅程（目标态）
  5. 4. 范围裁剪
  6. 5. 验收标准与评估集
  7. 6. 依赖与风险
  8. 7. 8/12 评审需拍板

0. 要解决的问题（会议诊断 + 现状量化）

会议原话：「引导流程过深，用户容易困在示例中出不来，存在 Bug（连接 IM 后跳转回来概览消失）」。代码走查证实并量化：

现状新手旅程（3 大段 11+ 屏，理论最短 ~35s，典型 4–8 分钟，产品自述 badge 还写着「约 2 分钟」）：

注册(单页5字段,legacy云端,无角色收集) → 不自动登录 → /login 手动登录
 → 强制跳 /onboarding/first-value（5页轮播,5.2s自动切换,26s/圈,唯一逃生口=「连接自有数据」）
 → demo chat 三阶段（~19s动画+2次点击,典型1.5–3分钟,中途无退出）
 → 3 步真实 setup（连数据→建workspace→绑IM,分钟级）
 → 完成后才见真实产品

「困在示例」的五个机制点（全部有代码定位，详见上下文包）：

  1. 登录强制门：引导未完成一律送进示例，shouldShowIntro 把任何路由访问弹回引导页；
  2. demo 中途无退出：「设置自己的工作区」出口全部 gated 在 3/3 完成之后；
  3. shell isolation：demo 路由上侧边栏 workspace 列表清空、禁止新建 workspace、ProductTour 隐藏；
  4. resume 拉回：每次登录把 in_progress 用户拉回 lastPath（core 段=demo chat；setup 段=IM 设置页）；
  5. 阶段顺序锁：乱序命令被拒。

IM 跳转 bug 双重机理：(a) setup 断点 lastPath 被写成 /workspace/:id/im?first_value_setup=1，Slack OAuth 回来后被 resume 到 IM tab 而非概览——PR #974 修的就是这个（改指 /workspace/:id/overall，已 approved，2 个 CI check 失败待修，未合并）；(b) 引导/预览状态只存 localStorage（#967 建好的后端持久化被 #983 暂停），应用标识/用户目录变化即被重判为新用户、首页跌回 hero 态——这是更深的一层，8/15 不解、记为风险。

1. 改版目标

新用户登录后 1 分钟内站在真实产品的 Overview 上、明确知道下一步是连接账号；示例从「强制通道」变为「可选展品」；老板与运营各自更快到达自己的 Aha Moment（由 A2 快速目标卡供给）。

2. 改版设计（按会后五条逐条）

2.1 上来给 Overview（落点定义）

2.2 只引导连接账号（引导卡替代引导流）

dashboard 态顶部叠加一张「连接账号引导卡」（不是整页接管）：

元素内容
主张「连接你的店铺，X 分钟后在这里看到真实经营数据」
主 CTA连接数据源（→ 现有 AmazonDataConnectionDialog / /data-sources，三渠道）
次级链「看示例工作区」（→ /ads 商品管理，高亮 demo 卡；示例本体是一个真实工作区，不是独立整页）｜「稍后再说」（收起，可从空 KPI 区再唤起）
分流态文案按注册分流答案微调（见 2.4）

连接完成 → 引导卡进入第二态「创建商品工作区」（→ 现有四步创建向导）→ 建完落 workspace overall → A2 快速目标卡接管（Aha Moment）。IM 绑定从必经步骤降级为 workspace 内可选提示（原 3 步 setup 的第 3 步不再阻塞「完成」）。

数据等待期（建 workspace 后 overall 空态最长 ~2.4 分钟轮询窗口）：引导卡第三态显示同步进度文案（「正在同步近 30 天广告数据…」），衔接 A2 快速目标卡的骨架态。

2.3 示例改可选，且回到「一个真实工作区」（拆除强制门）

2.4 注册分流：老板 vs 运营（不同 Aha Moment）

2.5 IM 跳转 bug

2.6 #9 操作手册融入产品（P1，随线迭代）

挂点用现有 ProductTour（6 步 spotlight）+ 组件级提示 i（tooltip → docs 站对应页）；不卡 8/15，8 月内随迭代补。docs 站（4175）当前 app 内无入口，P1 一并加「帮助」入口。

3. 改版后新手旅程（目标态）

注册 → 登录（首次）
 → 分流单题（10s，可跳过）
 → 落 “/” 经营概览 dashboard 态（真实产品首屏，KPI 零态「—」）
    + 连接账号引导卡（主 CTA 连数据源｜次级:看示例/稍后）
 → 连接数据源（真实 OAuth，不计入引导时长）
 → 引导卡二态：创建商品工作区（现有四步向导）
 → 落 workspace overall：同步进度提示（~2 分钟）
 → A2 快速目标建议卡 = Aha Moment（老板:预算-效果行 / 运营:+专家模式入口）
 → 首次采纳 → 激活完成（L2）

强制引导时长 = 分流 1 题 + 引导卡阅读 ≈ 20–30 秒（≤1 分钟达标；示例、OAuth、数据同步均为可选或系统耗时，不计入）。

4. 范围裁剪

8/15 P0

  1. 登录后落点翻转：新用户 → / dashboard 态；有 workspace → workspace overall（含 #974 合并）
  2. 连接账号引导卡（三态：连接 → 建 workspace → 同步中）
  3. 注册分流单题插屏 + 持久化最小方案 + 引导卡文案分化
  4. 示例改可选并回归真实工作区：拆强制门/自动启动/resume 拉回；轮播页退役；入口三处收敛为指路；引导脚本改为对话内选项卡片
  5. experienceVersion 不 bump 的兼容验证（已完成/已跳过用户零感知）

8/31 P1：demo lazy seed；/ads demo 卡降级细化；老板/运营深度分化；#9 手册提示 i + 帮助入口；团队规模次题；LUC-1353 持久化恢复接入；同步等待期体验打磨。

明确不做：改 legacy 注册表单；D6 三模式自适应；IM 绑定作为必经步骤；Hero 营销态作为登录后默认（留给 WS9 评估）。

5. 验收标准与评估集

6. 依赖与风险

#事项说明
R1PR #974 两个 CI check 失败未合并8/12 前定归因与合并计划（yuanmanxue）；A5 落点翻转以它为基座
R2引导状态 localStorage 单点（#983 暂停后端接入）换机/清缓存重判新用户；分流答案若只走 localStorage 会丢——persona 列方案可规避核心资产丢失
R3S1 客户端自主更新 8/15 前若不具备首批用户拿不到后续热修，A5 上线质量要求提高；与甘特 S1 项联动
R4A2 快速目标卡是 Aha 供给方A2 滑期则引导终点退化为「目标未设 banner」，A5 自身仍成立但 Aha 减弱
R5en 文案key 全集完备但个别粗糙（"Send"/"Code"），首批海外用户前全量润色一遍（引导卡/分流题新文案中英同产）
R6分流插屏与「≤1 分钟」的张力单题+可跳过；若 linxx 用户输入要求多题，改为渐进式（后续在产品内补问）

7. 8/12 评审需拍板

  1. 落点确认：零 workspace 新用户落全局 dashboard 态 + 引导卡（本稿方案），还是保留 hero 态改造？（本稿理由：hero 是营销页不是 Overview，与会后口径「上来给 Overview」不符）
  2. 分流持久化：user_preferences.persona 列（建议）vs 仅 localStorage+progress JSON（最快）。
  3. Hero 态去向：删除 vs 移交 WS9 作 Web 漏斗前端素材。
  4. /ads 画廊 demo 卡：降序保留（本稿）vs 移除进 Settings。
  5. 分流题文案与选项（需 linxx 用户输入确认，8/11–8/12 窗口）。
  6. IM 绑定降级为可选后，飞书/Slack 绑定引导挂到哪（workspace 内提示 vs 通知设置页）——与 A4 Slack 评估线对齐。