Onboarding 不是导览：它应让用户更快完成第一次价值交付

注册完成不是价值，配置完全部偏好也不是。对不同产品，第一次价值可能是完成一次任务、看到一条可信结果、邀请第一个协作者。

围绕这个时刻反推最少步骤，所有不影响首次成功的信息都可以延后。

一屏同时要求上传、授权、填资料、选模板，很容易让用户退出。将不可逆或高成本操作放在理解收益之后，并明确是否可跳过。

进度提示应该是真实节奏：告诉用户还差什么，而不是制造虚假的仪式感。

成功状态不是终点。它应该解释刚刚发生的结果，并给出一个最自然的继续动作。

对 AI 产品，尤其要展示结果依据与可编辑入口，避免用户把一次自动生成当作无法控制的黑箱。

Onboarding 的步骤不应由数据库字段数量决定。把动作按认知阻力、隐私风险、配置成本和等待时间排序，先完成低阻力且能快速产生反馈的部分。

能从已有数据推断的内容不要询问，能在第一次价值之后补充的内容不要前置。创建账号、邀请团队、连接数据、付费和授权外部系统是不同级别的承诺，不能假装只是五个等价的 Step。

每一步说明为什么需要、预计多久、是否可以稍后完成。用户知道成本和退出方式后，反而更愿意继续。

用户完成 Onboarding 后不应掉进一个空 Dashboard。空态要承接刚才的输入，生成第一份可编辑对象、示例数据或明确任务，让用户马上看到配置如何产生结果。

示例内容必须可区分于真实内容，并允许一键清除。它的作用是解释结构和操作，不是用漂亮假数据制造产品已经有价值的错觉。

对 AI 产品，第一次价值最好是可校正的草稿而不是漫长生成。用户通过一次修改、一次批准或一次工具调用理解产品协作方式，比看完整功能导览更有效。

Onboarding completion 只能说明用户走完了页面，不能说明获得价值。定义 activation event：第一次成功导入、第一次邀请协作、第一次发布、第一次 Agent run 完成，围绕它分析时间与流失。

记录每一步停留、返回、跳过、错误和求助，但不要为了提高完成率删除必要的安全说明。好的优化是减少无意义输入与等待，不是掩盖授权和付费成本。

对不同入口建立 cohort。带着明确任务进入的用户和从模板浏览进入的用户，需要不同的默认值与引导；强行统一流程会让平均数据看似正常，却同时伤害两类人。