一、本周任务把产品骨架打磨成可被直接演示、可被新用户理解的优秀形态在真实注册—登录—第一次使用的路径上仍暴露出两类「骨架已搭好、体验尚未收口」的问题新用户目录初始化不符合产品语义注册后自动出现默认目录甚至因多处并发初始化出现重复目录与「用户从零自建知识库」的预期冲突空状态下也缺少明确引导。功能 discoverability 不足之前为了信息密度大量操作收敛为图标按钮左侧导航、目录操作、编辑器 AI 能力、对话栏控件等缺少统一的功能说明机制新用户或答辩观众需要「试错」才能理解各入口用途。此外在引入悬浮提示组件后左侧导航出现 排版回归四个图标纵向挤在一起说明「加能力」与「保布局」需要同步处理。因此这次我的主线是修正新用户目录空状态与初始化逻辑消除自动建目录与并发重复创建新增统一的悬浮功能提示HintTip覆盖主工作区关键操作并修复左侧导航排版使第四周的三段式布局在「首次使用」和「功能说明」两个维度上真正可演示、可交付。这一步属于 「体验收口层」它不改变第四周确立的主链路架构但决定系统是否像「成熟产品」而非「联调通过的 Demo」。二、为什么本次必须做「上手体验 可发现性」如果只停留在第四周的功能堆叠会出现三个现实问题第一演示叙事断裂。答辩或验收时注册完账号就出现「我的知识库」等系统代建目录观众会质疑这是用户数据还是系统预置空状态没有「新建目录」引导则无法自然演示「从 0 到 1 搭建知识库」的完整故事。第二图标化布局的学习成本被低估。第四周把笔记选择合并进知识库栏、AI 固定右栏、顶栏收敛为图标——信息架构更紧凑但 没有配套的说明层。在缺少 Tooltip / 引导的情况下「导入页 vs 笔记页 vs AI 栏 vs 个人中心」的边界对非开发者不友好。第三联调后的边界问题会在「真实环境」才暴露。例如ensureSeed()在MainLayout、AiChatPanel等多处并发调用在本地 Mock 或单页调试时不易复现接入真实后端、新用户空库时才会出现重复建目录。这说明 第四周主链路联调完成后必须再跑一轮「新账号全路径」验证而不是只测老账号存量数据。本周工作不是重复第四周的 API 对接而是 在已联调骨架上补齐 onboarding、提示与布局细节——属于产品交付前的必要一层。三、本周实现 1新用户目录空状态与初始化逻辑修正问题定位前端ensureSeed()曾在目录树为空时自动POST /api/notebook创建「我的知识库」该逻辑在布局挂载、AI 面板挂载等多处 几乎同时触发产生竞态导致新用户偶发 两个相同目录后端注册接口本身 不创建 任何 notebook问题完全出在前端初始化策略。改动要点项说明取消自动建目录ensureSeed()退化为仅refreshTree()不再替用户创建默认目录空状态引导无目录时在树区域展示「新建目录」虚线提示 按钮由用户主动创建创建后自动选中手动创建目录后自动选中并刷新笔记列表缩短「建目录 → 建笔记」路径移除冗余初始化删除AiChatPanel、ImportView等处多余的ensureSeed()避免再次触发异常行为笔记区文案联动无目录时提示「请先新建目录」有目录未选中时提示「请先选择目录」价值第三、四周的流式导入与 CRUD 写入的对象从此在 用户明确创建的目录 下发生注册演示路径变为注册 → 空库 → 新建目录 → 新建笔记 → 编辑 / 导入 / AI 对话与「个人知识库产品」心智一致也避免答辩时被追问「目录哪来的」。四、本周实现 2统一悬浮功能提示HintTip 组件设计思路第四周界面已高度图标化本周不回到「满屏文字按钮」而是增加 轻量、一致的 hover 说明层新增可复用组件HintTip.vue基于 Arcoa-tooltip封装对 禁用按钮 同样包裹如未选目录时的编辑/删除提示「请先选择目录」避免「点了没反应却不知道原因」文案覆盖 做什么必要时点出 前置条件如 LLM 未配置时 AI 排版不可用。覆盖范围区域提示能力示例左侧导航笔记 / 视频导入 / AI 对话 / 个人中心知识库栏新建 / 重命名 / 删除目录新建笔记搜索与过滤顶栏全局搜索保存状态与 AI 状态标签编辑器HomeView本篇标签、导入笔记、AI 排版、生成习题、停止生成AI 对话栏LLM 状态、新对话、发送 / 停止、打开召回笔记个人中心改密、标签 CRUD、退出、打开 AI视频导入页导入到当前笔记 / 新笔记价值在不破坏第四周三段式紧凑布局的前提下把 「这是什么」 的问题交给 hover 即时回答对答辩场景尤其友好——观众鼠标移上去即可理解无需口头逐项解释。五、本周实现 3左侧导航排版修复HintTip 引入后的布局回归问题HintTip在图标外增加了一层span/ Tooltip 容器后原先写在.icon-item上的margin-bottom不再作用于图标之间的间距导致四个导航图标纵向挤在一起。处理.nav-icons改为flex-direction: columngap: 30px统一控制间距图标点击热区固定为 40×40补充 hover / active 反馈通过:deep(.arco-tooltip)保证 tooltip 包裹层参与 flex 布局。价值说明 组件化封装要考虑布局上下文——可复用的HintTip不能假设子元素原有的 margin 仍然生效。本次修复也为后续在导航栏继续加 Badge、红点等留出了稳定结构。六、本周阶段性成果总结这周我完成的核心成果可概括为三点上手路径产品化取消新用户自动建目录空状态引导 手动创建闭环消除并发重复目录注册演示叙事从「系统给目录」变为「用户建知识库」。界面可发现性统一通过HintTip覆盖主工作区关键操作禁用态也有说明第四周的图标化布局终于具备「自解释」能力。布局细节收口修复左侧导航间距回归保证三段式主工作区在窄栏导航处仍保持可用性与观感。
智汇笔记项目第五周：新用户上手体验与界面可发现性优化
一、本周任务把产品骨架打磨成可被直接演示、可被新用户理解的优秀形态在真实注册—登录—第一次使用的路径上仍暴露出两类「骨架已搭好、体验尚未收口」的问题新用户目录初始化不符合产品语义注册后自动出现默认目录甚至因多处并发初始化出现重复目录与「用户从零自建知识库」的预期冲突空状态下也缺少明确引导。功能 discoverability 不足之前为了信息密度大量操作收敛为图标按钮左侧导航、目录操作、编辑器 AI 能力、对话栏控件等缺少统一的功能说明机制新用户或答辩观众需要「试错」才能理解各入口用途。此外在引入悬浮提示组件后左侧导航出现 排版回归四个图标纵向挤在一起说明「加能力」与「保布局」需要同步处理。因此这次我的主线是修正新用户目录空状态与初始化逻辑消除自动建目录与并发重复创建新增统一的悬浮功能提示HintTip覆盖主工作区关键操作并修复左侧导航排版使第四周的三段式布局在「首次使用」和「功能说明」两个维度上真正可演示、可交付。这一步属于 「体验收口层」它不改变第四周确立的主链路架构但决定系统是否像「成熟产品」而非「联调通过的 Demo」。二、为什么本次必须做「上手体验 可发现性」如果只停留在第四周的功能堆叠会出现三个现实问题第一演示叙事断裂。答辩或验收时注册完账号就出现「我的知识库」等系统代建目录观众会质疑这是用户数据还是系统预置空状态没有「新建目录」引导则无法自然演示「从 0 到 1 搭建知识库」的完整故事。第二图标化布局的学习成本被低估。第四周把笔记选择合并进知识库栏、AI 固定右栏、顶栏收敛为图标——信息架构更紧凑但 没有配套的说明层。在缺少 Tooltip / 引导的情况下「导入页 vs 笔记页 vs AI 栏 vs 个人中心」的边界对非开发者不友好。第三联调后的边界问题会在「真实环境」才暴露。例如ensureSeed()在MainLayout、AiChatPanel等多处并发调用在本地 Mock 或单页调试时不易复现接入真实后端、新用户空库时才会出现重复建目录。这说明 第四周主链路联调完成后必须再跑一轮「新账号全路径」验证而不是只测老账号存量数据。本周工作不是重复第四周的 API 对接而是 在已联调骨架上补齐 onboarding、提示与布局细节——属于产品交付前的必要一层。三、本周实现 1新用户目录空状态与初始化逻辑修正问题定位前端ensureSeed()曾在目录树为空时自动POST /api/notebook创建「我的知识库」该逻辑在布局挂载、AI 面板挂载等多处 几乎同时触发产生竞态导致新用户偶发 两个相同目录后端注册接口本身 不创建 任何 notebook问题完全出在前端初始化策略。改动要点项说明取消自动建目录ensureSeed()退化为仅refreshTree()不再替用户创建默认目录空状态引导无目录时在树区域展示「新建目录」虚线提示 按钮由用户主动创建创建后自动选中手动创建目录后自动选中并刷新笔记列表缩短「建目录 → 建笔记」路径移除冗余初始化删除AiChatPanel、ImportView等处多余的ensureSeed()避免再次触发异常行为笔记区文案联动无目录时提示「请先新建目录」有目录未选中时提示「请先选择目录」价值第三、四周的流式导入与 CRUD 写入的对象从此在 用户明确创建的目录 下发生注册演示路径变为注册 → 空库 → 新建目录 → 新建笔记 → 编辑 / 导入 / AI 对话与「个人知识库产品」心智一致也避免答辩时被追问「目录哪来的」。四、本周实现 2统一悬浮功能提示HintTip 组件设计思路第四周界面已高度图标化本周不回到「满屏文字按钮」而是增加 轻量、一致的 hover 说明层新增可复用组件HintTip.vue基于 Arcoa-tooltip封装对 禁用按钮 同样包裹如未选目录时的编辑/删除提示「请先选择目录」避免「点了没反应却不知道原因」文案覆盖 做什么必要时点出 前置条件如 LLM 未配置时 AI 排版不可用。覆盖范围区域提示能力示例左侧导航笔记 / 视频导入 / AI 对话 / 个人中心知识库栏新建 / 重命名 / 删除目录新建笔记搜索与过滤顶栏全局搜索保存状态与 AI 状态标签编辑器HomeView本篇标签、导入笔记、AI 排版、生成习题、停止生成AI 对话栏LLM 状态、新对话、发送 / 停止、打开召回笔记个人中心改密、标签 CRUD、退出、打开 AI视频导入页导入到当前笔记 / 新笔记价值在不破坏第四周三段式紧凑布局的前提下把 「这是什么」 的问题交给 hover 即时回答对答辩场景尤其友好——观众鼠标移上去即可理解无需口头逐项解释。五、本周实现 3左侧导航排版修复HintTip 引入后的布局回归问题HintTip在图标外增加了一层span/ Tooltip 容器后原先写在.icon-item上的margin-bottom不再作用于图标之间的间距导致四个导航图标纵向挤在一起。处理.nav-icons改为flex-direction: columngap: 30px统一控制间距图标点击热区固定为 40×40补充 hover / active 反馈通过:deep(.arco-tooltip)保证 tooltip 包裹层参与 flex 布局。价值说明 组件化封装要考虑布局上下文——可复用的HintTip不能假设子元素原有的 margin 仍然生效。本次修复也为后续在导航栏继续加 Badge、红点等留出了稳定结构。六、本周阶段性成果总结这周我完成的核心成果可概括为三点上手路径产品化取消新用户自动建目录空状态引导 手动创建闭环消除并发重复目录注册演示叙事从「系统给目录」变为「用户建知识库」。界面可发现性统一通过HintTip覆盖主工作区关键操作禁用态也有说明第四周的图标化布局终于具备「自解释」能力。布局细节收口修复左侧导航间距回归保证三段式主工作区在窄栏导航处仍保持可用性与观感。
