历阶 Helix-α冲刺Day4

目录

一、站立式会议

参会成员：周蔚琳、刘嘉奕、柳钰舒、黄奕、郑聪凌、刘锐清、林彩华、汤文琪
会议照片：

二、项目燃尽图

燃尽图：

三、昨日至今进展总览

Day3 把大模型接到服务端、甘特按计划动态渲染。今天把 AI 从「只会起草」推进到「能记住你、能复习、能找资料」，同时补齐 FSRS 复习调度闭环和正文检索第一步。

• 用户长期记忆：汤文琪接入 Mem0，本机 pgvector 持久化（helix 库 mem0_memories 表，dim=1024），只在 helix 一个库内扩展，未另开 Qdrant/Milvus。对话和新建计划前，用当前这句话做向量检索，取 top5、截约 500 字拼进提示词；回答后再用一次短模型调用做门控，只在用户陈述稳定偏好、习惯、约束时才写入 Mem0，闲聊不写。未登录用浏览器 guest-xxx 作为 user_id，登录后切真实 id。聊天超过 10 轮时把旧对话 compact 压成一句。

• 向量模型：周蔚琳在百炼北京地域给原来那把 Key 开通 text-embedding-v3，用兼容接口试调返回 200、向量长度 1024，供记忆检索使用。对话继续用 qwen-flash，Key 不进 Git，写进 web/.env.local。

• FSRS 复习调度：郑聪凌接入独立 Python py-fsrs 服务，实现复习评分、下一次复习日计算和 FSRS 状态保存；复习重新做题流程把题目判分关联到 Good/Again；服务失败时进入「待计算」状态，到期复习任务排在今日列表第一条；前端不能直接改掌握状态和复习日期，复习接口加了幂等提交处理。

• 正文检索：柳钰舒完成正文检索 Day1——新增 web/src/server/analysis/（types.ts 契约类型 + retrieval.ts 检索模块），新建计划时模型只出检索词，服务端用 Tavily 把检索词换成真实链接，逐条做存活检查（HEAD 优先、405 回退 GET），再按 Content-Type / 后缀分类（url/pdf/word/ppt），替换 composeDraft 里的检索词占位接入 analyze 最小链路；新增 readers/ 正文读入骨架（trafilatura 2.3.1 + read_web.py + venv + README），单链接实测可读出正文。

• 前端体验：黄奕修复天梯弹层互斥（层级测试弹窗与抽屉叠开不可点击），甘特新增「撤回/复原初始排期」（撤销栈 + 排期快照）；周蔚琳按测试反馈修了层级测试弹窗——未点亮时不再在 useEffect 里同步改状态，已推到 dev。

• 测试：今天对 web 工程做了一轮功能测试（访客演示模式、Chrome、1440×900），发现 4 个问题：今日面板步骤详情弹窗漏传回调按钮无反应、甘特「今天之前」任务难改期且误拖不可撤销、双栏页面右栏吸顶、任务列表进度条标签重叠，详见第五部分。

• 约定保持不变：密钥不进 Git、每人写进 web/.env.local 后重启；开发阶段未登录时，完成、归档、删除、导入、通关和记忆都落在本机/guest 标识下，登录注册和共用数据库留到部署。

四、成员进展

AI 技术员工作情况

五、代码签入与测试结果记录

代码签入记录

以下为 2026-10-25 远程 dev 上的提交。

提交记录总览：今日 dev 上有 8 次提交。接入Mem0用户长期记忆，初步完成FSRS复习调度功能，修复层级测试、甘特图等问题，接入Tavily真实链接检索与存活检查，新增正文读入骨架。

提交记录截图：

工作项（Issue）

工作项列表：https://devcloud.cn-north-4.huaweicloud.com/projectman/scrum/08ad145e89cd43d89513e75bf09dd94e/workitem/backlog

工作项列表截图：

测试等其他工作结果

2026-10-26 对 web 工程做了一轮功能测试。测试环境：本地 npm run dev（localhost:3000），访客演示模式（未登录，前端回退 mock 数据），Chrome，视口 1440×900。本轮共发现 4 个问题，分别位于今日面板回调缺失、甘特改期与撤销、双栏吸顶、任务列表进度条排版。

问题一（中优先级，功能缺陷）：今日看板「步骤详情」弹窗内，除「标记已完成」和「打开资源」外，其余按钮全部无反应 —— 没有弹窗、没有 toast、没有跳转，控制台也不报错。根因不是某个按钮单独的问题：StepDetailModal 内部所有交互按钮都采用「回调存在才执行」的写法（如改期是 onClick={() => (onReschedule ? onReschedule(step) : undefined)}），而 TodayPanel.tsx 渲染该组件时只传入了 step、plan、onClose、onToggle 四个参数，漏传 onReschedule、onCopyPrompt、onPractice、onGoTest、onJumpTask 五个交互回调，回调缺失就静默不响应，所以既无报错也无视觉反馈。对照验证：同样的弹窗在历阶天梯页和任务详情页表现完全正常，因为这两处父组件把回调都传齐了，证明缺陷只出在今日面板这一处调用点。修复：在 TodayPanel.tsx 渲染 StepDetailModal 的位置参照 Ladder.tsx 补齐五个回调即可，无需改动组件本身；onCopyPrompt 照抄 Ladder 的 copyPrompt（组装学习提示词写入剪贴板并 toast「学习 Prompt 已复制」），onPractice 复用面板已有的 setReviewPractice 通道。修完按按钮清单逐个回归，重点确认弹窗内八个交互点全部有响应。

问题二（中优先级，交互缺陷）：甘特图里「今天之前」的任务大多没有改期途径，且误拖后的改动无法撤销。这不是单一 bug，而是两道限制叠加出的设计盲区：其一，落点守卫（GanttTimeline.tsx 对 day < today 的列设置 dropEffect='none' 且不调用 preventDefault，光标显示禁止）防止把任务排进过去日期，本身合理；其二，拖拽只能发生在当前显示的 7 列之内、不支持跨周投放 —— 演示「今天」固定 10 月 15 日，本周视图右侧还有 10/15–10/18 四个合法落点，所以 10/13、10/14 的任务能后移；但更早一周切过去后 7 列全是过去日期，一个合法落点都找不到，自然无法改期。带锁条形（mastery=fuzzy 且有复习日）学习日设为 draggable=false 是预期设计（FSRS 复习日由服务端计算、只读），非缺陷。次生问题：误拖后 markStep 已真实修改排期数据，想拖回原日期又被同一个守卫拦截，界面上没有任何撤销入口，只能靠「历史与成就」页的「重置演示数据」整体还原。修复建议：给普通任务条增加不依赖拖拽的改期入口（点击任务条弹出日期选择器，选过去日期给确认提示而非直接禁止），或支持拖起任务后翻周投放、放宽守卫为「允许落到过去列但需二次确认」，并把改期撤销做成 toast 上的「撤销」按钮。此问题与问题一存在连锁：问题一修好后详情弹窗的「改期」会把用户指去甘特图，而甘特图对老任务又拖不动，改期闭环仍是断的，建议两处一起规划。

问题三（低优先级，CSS 交互缺陷）：页面出现两栏时（任务详情页步骤列表 + 右侧检查器，今日看板主列 + 右侧统计栏同理），向下滚动页面，最右边那栏始终吸顶不动，要等左边栏的内容全部滚完、页面触底后右栏才跟着下移，导致右栏超出一屏的部分（如「掌握状态」面板）被留在视口之外。根因是 CSS 粘性定位的使用方式：两个右栏都设置了 position: sticky; top: 96px，但没有限制 max-height、没有设置 overflow，吸顶后底部内容落在视口外，而页面滚动又完全由左栏内容主导。修复：给两个右栏容器补 max-height: calc(100vh - 96px) 与 overflow-y: auto，让右栏内容超一屏时在栏内部独立滚动，与左栏滚动进度解耦；内容不长时外观没有任何变化。若产品上希望右栏完全随文档流，也可直接去掉 sticky，但考虑到右栏承担「随时可见的检查器」职责，推荐前者。

问题四（低优先级，排版缺陷）：「我的任务」页切换到「列表」视图后，每张计划卡片的六段层级进度条下方，L1–L6 层级标签文字与下一行「完成 9/14 级・10 月 15 日 起・共 10 天・优先级 64」的统计文字叠在一起，难以阅读。根因：层级标签不是独立文字节点，而是进度条分段的绝对定位伪元素（.level-segment:after { position: absolute; top: 12px; }），绝对定位不占布局高度，进度条容器预留高度（分段 8px + margin-bottom 12px = 20px）不够，标签从分段顶部往下 12px 起、自身约 14px 高，底沿到达容器顶部以下约 26px，超出预留高度，于是与统计行叠在同一条基线。修复：把 .level-progress 的 margin: 24px 0 12px 调大为 margin: 24px 0 28px（或等效加 padding-bottom: 18px），给悬空标签留出空间，统计行自然下移不再重叠；改完需确认「卡片」视图与甘特图等其他用到该进度条的页面没有因此出现多余空隙。更彻底的做法是把标签从绝对定位伪元素改为正常文档流内的元素（分段下方套一行六列文字），可作为二期优化。

六、程序/模块最新运行效果

• FSRS 复习调度：接入 py-fsrs 后，复习评分、判分关联、下一次复习日计算与「待计算」处理均已生效；到期复习任务排在今日列表第一条，前端复习日期只读。

• Mem0 用户记忆：对话 / 新建计划前按当前这句话向量检索，取 top5 拼进提示词；只在用户陈述稳定偏好时写入，闲聊不入库；超 10 轮自动 compact。

• 正文检索：新建计划时模型只出检索词，服务端用 Tavily 换成真实链接并做存活检查与内容分类，analyze 产出 6 条真实链接资源（linkState=ok）。

• 甘特撤回/复原：甘特新增「撤回/复原初始排期」，撤销栈记录旧日期并复用 markStep 回写，登录/访客态自动同步。

• 天梯弹层互斥：层级测试弹窗与右侧抽屉不再叠开，开新弹窗前关旧弹层，关闭按钮与背景可正常点击。

七、下一步计划

记忆已能写入并带出，复习闭环与检索链路已初步完成，下一步将继续：1、正文读入 Day2（FastAPI /read + Next.js readers.ts 客户端 + 落库 body_ready/body_ref，PDF/Word/PPT 用 Docling 或兜底库）。2、补聊天记录 localStorage 持久化、登录后把 guest 记忆合并到真实 user id、清理 Mem0 把助手建议入库的噪声。3、对齐演示数据 id 与数据库主键格式，跟进复习日用户调度方案（等 py-fsrs 协议），并在数据库 + FSRS 服务完整环境下补完固定日期、服务异常与重复提交的联调验证。