仅列未完成事项。已完成记录见 2026-11-12 归档、2026-10-29 归档、2026-09-29 归档。
-
修复 HONOR YAL-AL00(Android 10)视频剪辑保存失败。真机对照定位到 FFmpeg 8.0 为 MP4 全局头部预探测时发送 EOS 并 flush MediaCodec 编码器,导致后续提交帧失败或只产出一帧。Android 跳过预探测,由 MP4 封装器从实际码流提取 H.264 配置,并单独校验视频轨时长。原真机集成用例修复前失败,修复后音频/视频、有/无字幕四种场景全部通过,视频保留 H.264 并验证应用播放器出画;剪辑相关单元和组件测试 56 项通过。见 排障记录。完成时间: 2026-11-19
-
评价提醒埋点:真正向系统发起原生评分请求时上报
rating_prompt_requested(已加入 PostHog 白名单),参数check_in_days(上次提醒之后的打卡天数)与is_repeat(0 / 1)。埋点放在冷却落盘与二次条件检查之后、requestReview之前,条件不满足或冷却回滚的请求不上报;RatingPromptCoordinator注入AnalyticsService。新增 3 个埋点用例(首次 / 冷却后再次 / 条件未满足)并在冷却回滚用例中断言不上报;白名单测试同步。复审修复:main_shell_rating_prompt_test的_RecordingCoordinator未传入新增的analytics参数导致编译失败,已补测试替身。回归范围(router、评价提醒、analytics、四类学习页与收藏复习页测试)共 445 项全部通过;改动文件dart format无变更,flutter analyze无 error / warning(仅沿用的prefer_initializing_formalsinfo)。完成时间: 2026-11-18 -
底部导航与侧边栏「资源库」图标改用
assets/icon/library.svg(替换 Materiallibrary_music,选中态仍为navActiveColor);「学习」图标改用assets/icon/book-open.svg(替换 Materialschool);「收藏」改用assets/icon/bookmark.svg、「我的」改用assets/icon/account-round.svg(激活态与未激活态同形,仅靠颜色区分,VIP 角标保留);同步更新main_shell_navigation_rail_test的图标查找方式。格式、分析与相关测试通过。完成时间: 2026-11-18 -
波形流式生成:FFmpeg 解码期间每 300ms 跟随增长中的 PCM 文件增量计算峰值(
WaveformPeaksBuilder,computeWaveformPeaksFromPcmFile复用同一实现),通过onPartial把已完成像素的快照推给剪辑页与字幕编辑页,边生成边显示;快照的length恒为整段像素数,readyLength之后不绘制。只有完整波形写入缓存,解码失败或取消仍走原失败 / 取消路径。日志行由decode=…ms total=…ms简化为total=…ms(解码与峰值已交织,不再单独计时)。单测 3 项(分段喂入与整文件一致、快照只含完整像素、未完成不能编码);macOS 集成测试 6 种格式与取消 / 静音检测全部通过,新增 30 分钟音频流式用例(解码期间收到未完成快照,前缀与最终结果逐像素一致)。iOS / Android / Windows 真机待验证:边解码边读取 PCM 文件在 Windows 上的文件共享行为未验证。完成时间: 2026-11-18 -
随心听视频偶发黑屏:
MediaKitBackend跨媒体复用同一 mpv 实例,上一段会话隐藏视频轨(setVisualTrackVisible(false))后 vid 保持关闭;新会话load把界面显示状态重置为可见,却没有同步开启 mpv 视频轨,VideoFrameGate收不到 video-size / vo-configured,画面一直隐藏。修复:加载新媒体前按visualTrackVisible同步视频轨。新增 1 个 provider 回归用例(隐藏视频轨后退出,再加载新媒体时视频轨恢复)。- 后续复现:暂停打开随心听仍黑屏,点播放才出画面。日志显示
vo-configured yes后纹理尺寸一直停在上一媒体尺寸,直到播放才被 mpv 出帧更新(TextureGL: resize与播放同时出现)。修复:VideoFrameGate.needsFrameRedraw,VO 已配置且纹理未追上时,暂停中 seek 到打开时的起始位置触发一次重绘(每次打开只请求一次,不用播放器当前位置,避免断点丢失)。新增门控单元用例。待真机验证:日志应出现event=paused_redraw_requested,随后current_media_visible trigger=texture-size。完成时间: 2026-11-18
- 后续复现:暂停打开随心听仍黑屏,点播放才出画面。日志显示
-
随心听收藏句译文卡在加载中:译文流正常结束但没有任何非空译文(空终帧或无帧即结束)时,
sentenceTranslationProvider静默结束,骨架屏永久转圈。改为抛出SentenceTranslationEmptyException进入失败态,点击可重新请求,并记录「译文流结束但无内容」日志。新增 2 个 widget 回归用例(流无内容、终帧译文为空)。根因中「为何服务端返回空流」尚未从日志确认,待复现时看该日志行。完成时间: 2026-11-18 -
随心听自动聚焦仅在播放时生效:暂停时用户手动滚动松手后,2 秒恢复计时器不再把字幕列表拉回当前句(原因:恢复逻辑未判断播放状态)。
ParagraphSentenceListCard新增isPlaying(默认 true,段落盲听不受影响),随心听传入state.isPlaying;暂停时仅解除手动滚动挂起,开始播放时立即(无动画)定位到当前句,手动滚动中不抢位置;点句子、进度条 seek、路由返回等显式定位在暂停时保持有效。新增 5 个播放门控回归用例(暂停滚动不回弹、播放中滚动恢复跟随、暂停点句定位、暂停后开始播放即时定位、两帧内完成定位)。相关测试 145 项通过。完成时间: 2026-11-18 -
iOS 视频(mkv 等)字幕编辑「(-11828) 无法打开」:字幕编辑器的声音从 just_audio(AVPlayer 不能解封装 mkv/avi)切到编辑器独占的 media_kit 播放器
SubtitleEditorAudioPlayer(与剪辑页同一模式,不接入全局引擎),画面链路不变;撤回上一轮的 ffmpeg 抽音轨临时方案。顺带修复 mpv 原生终点丢弃 0.2s 输出缓冲导致句尾被截约 200ms(编辑器播放器缓冲设为 50ms)。波形改用剪辑页的MediaTrimWaveformLoader(视频先抽代理音轨),修复 mkv 波形「ExtAudioOpenURL error 1954115647」生成失败。字幕读取抽为共享loadTranscriptSentences,pauseOtherPlaybackProvider由剪辑页与字幕编辑共用。新增 macOS 集成测试(mkv / avi 真实播放,按日志核对起播位置与实际播放时长)与播放器单测,字幕编辑相关单测全部迁移到 fake media_kit backend。iOS 真机验证待做。完成时间: 2026-11-18 -
字幕编辑波形:单词块与它下方的词区间合并为同一个目标。轻点当前句的词区间改为试听该词(播放头不动),不再定位播放头;长按(鼠标为按住拖动)顶部单词块也能抓住该词整体拖动。相邻句的词区间轻点仍定位播放头(顶部只显示当前句的单词块)。新增 3 个 widget 回归用例(触摸 / 鼠标轻点词区间试听、长按单词块拖词),修复前均失败;集成测试改在时间轴行轻点定位。鼠标右键在波形任意位置拖动只平移(不抓词、边界或播放头),右键轻点不试听、不定位,新增 1 个回归用例(修复前失败)。完成时间: 2026-11-18
-
波形生成去掉 just_waveform:改为 FFmpeg 解码第一条音轨为 24kHz 单声道 PCM,后台 isolate 计算每像素 min/max(80px/s),自有缓存格式(旧 just_waveform 缓存读取时直接删除重建)。音频、mkv/avi 等视频走同一路径,不再依赖系统解码器,也不再编码 AAC 代理音轨;导入时静音检测复用同一计算,修复 mkv/avi 静音检测失效。删除
WaveformSamples(just_waveform 16 位错位补丁)。新增峰值计算单测与 macOS 集成测试(5 种格式按信号逐像素校验、缓存、取消、静音检测)。iOS / Android 真机待验证:首次打开波形日志应出现[MediaWaveform] 波形生成完成 … decode=…ms total=…ms。完成时间: 2026-11-18 -
TTS 配置目标去重:控制器记录已应用的有效目标(引擎 + 发音参数),目标未变的重配置(无关设置变化、模型就绪状态变化)直接跳过,不再清空在途预热批次或通知页面重新提交。目标真正变化时仍整体重配。测试覆盖:无关设置变化、未选用模型就绪变化、被选用模型就绪变化均不改变目标;引擎切换仍清空批次。清理:有效引擎与模型就绪无关,移除就绪监听中的无效重配置与
effectiveTtsEngine的无用参数(规则保持不变,改由tts_controller_gating_test单独覆盖)。完成时间: 2026-11-17 -
收藏词汇预热生命周期:复习页单词发音窗口为当前卡与后续 2 张;AI 查词只订阅当前卡(正面即开始,不再预取后续卡),加载成功后预热其例句,翻面不取消;切到下一张或离开复习页(含系统返回手势)立即取消当前卡的例句 TTS 与 AI 查询。退出后的会话收尾不再发起预热。收藏列表离开(含全屏页覆盖)取消,返回后重新预热。完成时间: 2026-11-17
-
TTS 文本预热按所有者隔离取消:
prewarmTextsIncremental/prewarmWord/cancelTextsPrewarm改为带owner,各页面(收藏词汇列表、收藏词汇复习、词典面板、词典详情)只取消自己的预热,不再互相作废(修复复习窗口预热在进入页面时被收藏列表取消、词典开关后丢失的问题)。去重记录按所有者保存并在配置切换时清空,被取消的文本不会被误记为已提交。协调器的后台取消按所有者代际与队列过滤,配置切换仍整体取消。完成时间: 2026-11-17 -
收藏词汇复习发音预热:单词发音与「自动显示 AI 查词」解耦,当前卡与后续 2 张在进入窗口时预热(CDN 优先,缺失走 TTS);AI 查词加载成功后预热其中的标题与例句,不再在翻面时才开始。离开复习页统一取消后台预热(
prewarmWord在 CDN 查询期间被取消时不再提交 TTS)。收藏列表保持按可见 tile 预热。相关测试favorite_vocabulary_review_screen_test与收藏预热测试通过。完成时间: 2026-11-17 -
图标统一(按审核结果
icon-review-result.csv):「同意」的 19 组 Material / FontAwesome / Cupertino 图标替换为assets/icon中的 SVG(删除、撤销/重做、编辑、固定、刷新、分享、下载、添加、搜索、字幕、锁定、链接、标签、统计、视频、账号、用户组、完成);「待定」项保持原样。相关组件与页面测试 pass,测试改按svgIcon()资源名查找。完成时间: 2026-11-17 -
句子 AI 对话入口不再依赖页面异步现算的句子编号:
SentenceChatTarget可携带来源句区间,打开对话时在当前字幕里定位编号与上下文(收藏复习、收藏词汇复习、查词详情、收藏来源句选词问 AI、句子讲解页字幕加载前);查词页收藏记录读出前不显示入口。完成时间: 2026-11-17 -
收藏句子复习背面:讲解视图新增
isSentenceIndexPending,当前句编号算出前自动与手动翻译共用的上下文入口等待编号就绪、预热暂停(解析、意群照常),每句只发一次带上下文的翻译请求;后续卡片编号算出后才加入预热;复习页不再整块隐藏讲解区。完成时间: 2026-11-17 -
音频列表与学习计划页将管理字幕、编辑字幕合并为“字幕”,使用 closed-captions.svg,打开原管理字幕弹窗。完成时间: 2026-11-17
-
管理字幕弹窗标题栏将编辑图标改为“图标 + 编辑字幕”文字按钮,保留删除入口。完成时间: 2026-11-17
-
管理字幕弹窗删除按钮改用与编辑入口一致的中性色。完成时间: 2026-11-17
-
音频列表菜单改为 MenuAnchor + SubmenuButton 二级结构:导出、更多操作分组,删除在底部独立分组,保留社区与播客操作限制。组件测试 64 项通过。完成时间: 2026-11-17
-
音频二级菜单复用原弹出菜单主题,恢复背景、18px 圆角、描边、阴影及 15px 字体与 44px 行高;补充主菜单与子菜单主题一致性断言,64 项测试通过。完成时间: 2026-11-17
-
学习计划页将音频/视频与 PDF 导出合并为“导出”子菜单;与音频列表复用菜单样式,保留字幕及重置入口和原可见性条件。相关组件测试 146 项通过。完成时间: 2026-11-17
-
分栏拖动修正:剪辑页与字幕编辑页拖动中的左栏宽度按当前窗口范围限制,拖动期间缩放窗口不再挤压右栏;剪辑页算不出有效比例时保留原偏好而不是恢复默认。两页的分栏比例偏好抽为共用的
SideBySideSplitFractionNotifier(各自独立存储键),左右栏宽度范围复用PracticeMediaExtentRange.sideBySideColumns;字幕页setMediaFraction更名为setFraction。分隔条在拖动中被移出树(窗口缩放切换布局)时帧后补发拖动结束,三处使用方按结果保存且不残留拖动宽度。剪辑页集成测试补注入内存 SharedPreferences(原提交后整套用例无法打开页面)。测试:分隔条组件回归、剪辑页 7 项与字幕编辑页 4 项 macOS 集成测试(含拖动中缩放窗口回归)、相关单元 / 组件测试 277 项通过。完成时间: 2026-11-18
- 下载队列真机 spike:iOS / Android / macOS 验证卡住超时(默认 60s)后的
waitingToRetry与续传、Range 头、离线挂起、并发 2、cancel 后.part清理;结果不符合预期时再评估 Dart 侧看门狗。另需验证:同资源多入口并发只产生一条插件任务、杀进程重启后遗留任务被清理。 - 实测 WebView 移动内容模式:macOS 完整重启 App 后确认有道等词典是否显示移动布局;仍为桌面版时再收集页面 User-Agent 与 viewport 宽度。
- 修复 macOS 网页词典首帧黑闪:继续隔离原生 WebView 创建与 Flutter 合成时序,不修改插件源码。
- Android 离线 ASR 结束录音闪退:获取真机
logcat与 tombstone,定位并修复 Silero VAD native 崩溃。 - 段落复述页面复用统一录音识别模块。
- 意群操作栏切换收藏时其他按钮闪烁,继续定位根因。
- 在发布包手动验证数据采集:核对 onboarding、页面访问、权限快照、生命周期事件及应用版本信息。
已完成功能的待真机确认项,逐条细节见归档。
-
学习页卡片与折叠区:展开状态保持、条目全宽与末尾间距、浅色描边、深色进度条配色、方形图标与封面、角标与长标题排版、推荐卡元信息行、首页整卡点击区域。
-
搜索结果与合集列表:搜索框样式、标题字号与行数、命中描述行、标签 chip 信息量、滚动回来时封面是否立即出现、合集详情图标与进度条、下载状态与进度环、社区合集弱网下失败后重试、字幕图标、导入入口图标。
-
播放器与速度控件:胶囊选择器浮层边界与滑动手感、320pt 窄屏单行显示、底栏按钮位置与间距、播放主按钮图标大小、macOS 底栏布局与 toast 位置。
-
学习内容字号与解析样式:解析圆点与首行对齐(100% / 150%)、AI 解析字号层级、原文字重与行距、85% / 100% / 150% 同比缩放、字幕文字粗细 31 档(50%~200%,100% 对应 w400)在 iOS / macOS 系统字体上是否可见(依赖 wght 可变轴,静态字体仅靠最近枚举字重)、两台设备间字号与粗细能否双向同步。
-
导入与网盘:iOS / Android 导入
.opus、.ogg、.webm、.avi的播放、时长、字幕配对与转录;Android 端 ffmpeg-kit / libmpv 构建未做二进制核验;真实百度账号下超过 1000 个文件的目录,以及超过 100 个文件的完整列表。 -
服务地区切换后登录态验收(全球区登录 → 切中国区 → 重启 → 切回全球区重启,账号应始终一致;登出后两端均为未登录)。同时确认升级后保留的是升级时所在端点的会话。Web 端暂不支持迁移,升级后需重新登录。
-
其他:今日目标庆祝动画的全屏过渡与深浅色、iOS 静音键与学习音频共存、收藏句译文显示与未订阅额度提示、看译文的流式显示与预热命中、连续切句时后续卡片预热(日志与是否重复请求)、收藏词汇 AI 面板位置、手动查词页图标与进度条细条观感、播客搜索失败日志的
statusCode(待下次失败复现)。 -
收藏入口打开视频来源句(收藏列表句子行、收藏词汇 / 短语的来源句、收藏词汇复习、查词详情来源句卡片):讲解页显示该句起点画面;播放、切句、字幕、全屏正常;返回收藏页后音频不再播放,系统媒体卡片状态正常;视频加载失败时提示且不进入讲解页;音频材料的讲解入口无回归。
-
视频句子讲解页自适应分栏(复用学习任务页
PracticeMediaSplitLayout):手机竖屏上下、宽屏 / 横屏左右;分隔条拖动与双击还原、比例与学习任务页共用;窗口缩放跨断点时视频与词典面板不重建;全屏进出正常。 -
视频会话与画面统一后回归:随心听、盲听、复述、收藏入口进入讲解页,显示 / 隐藏画面、CC、字幕遮罩、全屏按钮行为与之前一致(讲解页改用
PracticeMediaPresentationSession+PracticeMediaVisualSurface)。
-
编辑字幕不再清空学习进度与收藏:一条收藏(句子 / 词汇 / 意群)就是「音频 + 收藏时那句话的时间区间」,不再存句子编号——删除三张收藏表的
sentence_index列及收藏句{audio_item_id, sentence_index}唯一约束(schema v71,重建表并补回索引;v70 为未发布开发版,按from < 71统一重建)。当前是第几句按区间中点在当前字幕里现算(services/source_sentence_anchor.dart:多句同时包含中点取重叠最长;来源句被删或无有效时间返回 null,不按编号 / 文字去找其他句子);需要前后句作 AI 上下文的收藏复习、收藏词汇复习、查词页与来源句卡片用sourceSentenceIndexProvider现算(收藏复习页算出编号后才构建讲解视图,避免重复请求翻译)。收藏与取消收藏对称:按调用方句子自身的时间定位到当前字幕,只处理这一句上的收藏(合并后一句可能挂多条,一起取消),不再「同文本一起取消」;重新收藏复用回收站里落在这一句上的原记录(保留复习进度);收藏列表、收藏复习按收藏本身 / 记忆主体取消。收藏的文字与区间之后不随字幕编辑改动。字幕替换(编辑保存、社区字幕更新)后TranscriptChangeSync只做学习断点换算:阶段与复习时间不变,盲听 / 精听 / 复述断点按时间换算(拆分落前半句、合并落合并句、被删落下一句),难句跟读 / 补练断点(难句列表内位置)清除;社区更新的换字幕与换算在同一事务。编辑器保存时同步成功即推进基线,后续步骤失败可重试且不重复换算。讲解页入口只带时间区间、自行定位,入口句不在当前字幕时不提供收藏切换;来源句播放只播收藏区间,无效时 TTS。去掉保存前的确认弹窗及文案。日志[TranscriptSync]、event=breakpoints-remapped。单元测试 100 个相关文件 1904 项通过(定位规则、DAO、真实数据库同步与收藏生命周期、v69→v71 迁移含回收站与同步状态保留、社区更新保留与回滚、保存失败重试、收藏复习现算编号等);macOS 集成测试「保存字幕:收藏句、收藏词与学习进度按时间保留」(拆分 / 改字 / 合并 / 删除后 ⌘S 直接保存,读库核对收藏不改、按区间定位、FSRS 调度、断点换算,并用旧句子取消收藏)及字幕编辑集成测试 4 个场景通过(界面焦点 / 分隔条双击两处断言偶发失败,重跑通过)。完成时间: 2026-11-17- 未处理:「删除字幕」(管理字幕面板)仍清空收藏与进度;早期没有有效时间区间的收藏无法定位(仍在收藏列表中,可播放 TTS),不做按文字修复。
-
字幕编辑器:波形顶部点词只试听、播放头不动(新增播放模式
wordAudition:不启动播放头计时器、不采纳位置流,视频画面停在播放头所在帧;播完显式停止底层播放器——此前只试听时没有播放头计时器,_stopActivePlayback误判为无播放只清片段,导致播完后从头继续播放);字幕列表点词仍移动播放头帮助定位。控制器单元测试与 macOS 集成测试subtitle_editor_ui_test.dart4 个场景通过。完成时间: 2026-11-17 -
字幕编辑器:删除句子后不再弹出带「撤销」的提示条(已有撤销 / 重做按钮与快捷键),同时删掉只为它服务的
editRevision与sentenceDeleted文案。波形上可整体拖动单词:鼠标悬停在词区间(非边界)显示抓取手形,按住拖动整体平移该词(移动不足 3px 松手仍为轻点定位播放头),拖动中为「抓取中」光标;触摸长按词区间后拖动(有触感反馈),未长按的拖动仍是平移波形。控制器moveWord:词长不变;与相邻词首尾相接时共享边界一起移动(相邻词不短于最小词长),有间隙时相邻词为硬边界;句首 / 句末词带动句子起止,不越过相邻句;一次拖动撤销一步。单元 / 组件测试(test/features/subtitle_editor147 项)与 macOS 集成测试subtitle_editor_ui_test.dart4 个场景通过。完成时间: 2026-11-17 -
修复编辑字幕后收藏列表与随心听 / 讲解页显示的收藏句不一致(拆分收藏句后列表仍显示整句,随心听和讲解页显示后半句):字幕替换(编辑保存、社区字幕更新)时
TranscriptChangeSync把收藏句、收藏词汇 / 意群(含回收站)的来源句文字与区间改写为新字幕中对应的那一句,记忆主体与复习进度不变,来源句已删除的保持原样;改写只依据收藏自身区间,可重复执行。收藏句按区间中点定位;词汇 / 意群先在与区间重叠的句子里找含该词的句子(不区分大小写、词首边界,词元可命中变形),找不到再按中点(resolveVocabularySourceSentenceIndex)。合并后同一句上的多条收藏都保留。去掉收藏导出中「定位句文本须等于收藏文本才取译文」的冗余判断。日志[TranscriptSync] relinked=bookmarks:N,words:N,senseGroups:N。相关单元测试 284 项通过;macOS 集成测试「保存字幕:收藏句、收藏词改写为新字幕中的句子」通过。已存在的不一致数据在该材料下次保存字幕时自动修正。完成时间: 2026-11-17 -
删除本地合集去掉「同时删除音频文件」复选框,固定删除只属于该合集的音频(含文件与学习记录),同时在其他合集中的音频保留。确认弹窗提示「合集内的材料及其学习记录将一并删除,同时在其他合集中的材料不受影响」,空合集不显示该提示。macOS 集成测试
integration_test/collection_delete_test.dart(真实数据库、文件与关键状态截图)通过。完成时间: 2026-11-17 -
本地合集自定义封面:创建合集时可选封面(不设则保留首字占位),合集菜单「重命名」改为「编辑」,可同时改名与更换 / 移除封面。创建与编辑共用居中对话框
showLocalCollectionDialog(上方大封面点按即添加 / 更换,有封面时显示「移除封面」,下方名称输入;宽度随屏幕自适应、宽屏封顶 420,封面 88~128 随宽度缩放),创建入口的类型面板只负责选择类型。选图后经共享的 1:1 裁剪页(头像裁剪抽为SquareImageCropScreen,图片处理抽为services/square_image_processor.dart)编码为 512 JPEG,存collection_covers/,库表collections.local_cover_path存相对路径(schema v69);先写新文件再写库,写库失败删新文件,成功后删旧文件,删除合集同时删封面。封面显示在「我的合集」列表,并与社区 / 播客一致用作合集内素材图标(合集详情、学习页任务卡,已订阅合集优先)。备份按库中路径导出 / 恢复封面,旧备份缺列兼容。仅存本机,不同步。日志[CollectionCover]。macOS 集成测试integration_test/collection_cover_test.dart(真实裁剪页、文件与数据库、关键状态截图)通过。完成时间: 2026-11-17- 未完成的验证:iOS / Android 真机相册选图与裁剪手感、深色模式下表单与占位观感。
-
字幕编辑页 UI 与布局优化(参考剪辑页视觉语言,不复刻其交互,编辑功能不变):标题栏加材料名,保存按钮无改动置灰 / 有改动主色;波形改为圆角卡片,缩放与速度移到波形上方工具条(± 按钮 + 滑杆 + 倍速胶囊,非 1x 主色提示);波形配色全部随明暗主题,起止保留绿 / 红语义并分三级(当前句起止 > 句内词边界 > 相邻句),相邻边界合并为双色把手,句子文字不再被边界线压住,播放头改中性色带顶帽;波形改用
WaveformSamples修复 16 位错位导致的扁平波形(troubleshooting 7.54);句子行去分隔线,选中句为主色描边卡片,圆形播放按钮 + 编号,单词 chip 圆角底色;单栏最大宽 960 居中,各区左右对齐。视频材料新增显示 / 隐藏画面(默认隐藏,共享VideoToggleIcon):画面由独立 media_kit 后端关闭音轨后跟随试听播放 / 暂停 / 定位,声音仍走原音频链路;宽窗口(沿用PracticeMediaSplitGeometry断点)左侧画面 + 工具条 + 波形、右侧句子列表,窄窗口上下排布。新增MediaPlayerBackend.setAudioTrackEnabled。macOS 集成测试integration_test/subtitle_editor_ui_test.dart(真人语音示例 + 带时间码视频,手机竖 / 横屏、平板、桌面,明暗主题,16 张截图)通过。完成时间: 2026-11-17- 波形柱宽统一为 1.5px(间距 3px),字幕编辑器与剪辑时间轴一致。完成时间: 2026-11-17
- 左右分栏可拖动调整:复用学习任务页分隔条(抽为共享
MediaSplitDivider,拖动 / 双击恢复 / 悬停光标一致),比例单独保存(subtitle_editor_side_by_side_media_fraction,不与学习任务共用);默认宽度不再固定 42%,改为让画面按视频比例填满左栏高度(右栏自动适配时至少 420、拖动最小 360,竖屏视频自动让宽给列表)。波形固定 120 高,不随窗口加高(加高后比例失调,已撤回),画面受宽度限制时多余空间留在底部。规则见SubtitleEditorSplitGeometry,单元测试 6 项,集成测试覆盖自动填满、拖动保存、双击恢复与高窗口。完成时间: 2026-11-17 - 波形支持双指 / 滚轮平移(此前只处理了缩放):触控板双指滑动按主方向平移、捏合缩放;鼠标滚轮平移、Ctrl / ⌘ + 滚轮缩放(与剪辑页一致),未放大时不接管滚轮;触屏双指同向移动时平移;播放中仍由跟随播放头接管。所有平移统一走
_panBy。Widget 测试 6 项。完成时间: 2026-11-17
-
字幕编辑支持撤销 / 重做、插词、整句改字与补句:标题栏「撤销 / 重做」按钮(桌面 ⌘Z / ⇧⌘Z / Ctrl+Y),所有编辑(拖边界一次算一步、改词、插删词、整句改字、插入 / 删除 / 合并 / 拆分句子)都可撤销,撤销后选中并居中被改的句子;有无改动改为与打开或上次保存时的内容比较,撤销回原样后保存按钮置灰;删除提示条的撤销走同一份历史(之后又有编辑则不生效);历史只在本次编辑有效。单词浮层改为「编辑 / 前插 / 后插 / 断句 / 删除」,浮层贴边时收回屏内。选中句右下角「编辑文字」(桌面回车)整句改字,按最长公共子序列对齐,未改动的词保留原时间,新词在前后保留词之间按字数分时间。补句:句子菜单「在上方 / 下方插入句子」(空隙不足 300ms 置灰),或暂停时把播放头点进句间空隙,波形标出区间并显示「添加句子」;新句确认文字后才写入,留空或 Esc 放弃。句子菜单新增「合并上一句」。桌面快捷键:⌘S 保存、↑↓ 切句、回车改字、Esc 取消输入;输入文字时不响应(字幕调整不需要空格播放,已去掉)。修复:页面持有快捷键焦点后输入框 autofocus 不生效,改为显式请求焦点。规则在
SubtitleEditEngine(matchTokens/retimeTokens/slotAfter/slotBefore/slotAt)。新增单元 / widget 测试 29 项(替换原 restoreSentences 测试),macOS 集成测试新增编辑场景(手机 / 桌面、明暗主题,16 张截图)。完成时间: 2026-11-17- 补充验证编辑与保存结果:随机编辑一致性测试(示例材料,5 个固定种子 × 150 步插删改词、整句改字、拆合删句、补句、拖边界、撤销重做,每步检查词与文字逐词一致、词时间不重叠且首尾贴句界、句子按时间排序不重叠;全部撤销逐毫秒回到原样且为未修改,再重做回到最终结果);集成测试保存后读库核对 SRT、词级时间、句数 / 词数与编辑结果逐项一致,并重新打开编辑页核对内容。期间发现并修复:插词按字数分出的短于 20ms 的词,拖动其边界时为补足最小词长会越过相邻词造成重叠,改为相邻边界为硬约束、最小词长只阻止再变短。完成时间: 2026-11-17
- 播放头常驻并可拖动,与高亮单词、视频画面同步:播放头参照剪辑页改为白色圆头竖条 + 投影(波形区底色改为与剪辑时间线一致的浅灰),暂停时也显示;按住拖动连续定位(在顶部句子文字行,或附近没有边界时可抓),播放中拖动先停止播放,下端停在边界把手上方不遮挡。新增
highlightedWordIndex:句子列表高亮、波形上淡色标出的单词都取播放头所在词(点词播放后以点的词为准,避免播完停在词尾被算成下一个词),播放整句时逐词跟随。视频画面播放中允许偏差由 300ms 收紧到 150ms,暂停时 40ms(约一帧)。词边界线加粗(当前句起止 2.5px、句内 2px、相邻句 1.5px),首尾相接的红绿双色线每半边不细于单色线。修复单词浮层贴边平移偶发未生效(测量失败不重试,浮层停在透明态):改为每次重建后复核位置、失败下一帧重试。集成测试新增拖动播放头后、播放中、停止后核对画面与播放头偏差(停稳 ≤50ms、播放中 ≤250ms)及高亮词包含播放头;全量集成测试连续 3 轮通过。完成时间: 2026-11-17 - 修复输入框(新句 / 整句 / 插词)不能输入空格:页面快捷键用
CallbackShortcuts绑定了空格,按键匹配即标为已处理,macOS 上不再交给输入框。改为注册FocusManager.addEarlyKeyEventHandler(先于焦点树执行,已处理的按键不再触发方向键移焦点 / 回车激活获焦按钮;HardwareKeyboard处理器拦不住焦点树,曾导致方向键把焦点移到倍速按钮、回车弹出倍速菜单),仅在本页为当前页且焦点不在输入框时处理,去掉焦点锚点与「抢回焦点」逻辑(它与新打开的输入框争焦点,偶发输入框拿不到焦点);按用户意见去掉空格播放快捷键。另修:播放转暂停时画面在暂停生效前多走几十毫秒,改为暂停后一律定位到播放头所在帧;单词浮层贴边平移改按词 chip 位置计算(跟随层位置在合成阶段才更新,帧后读取可能过时)。回归测试:输入框内按空格不被页面处理(在修复前代码上验证会失败)。完成时间: 2026-11-17 - 波形精确编辑交互:播放头改为 1.5px 橙色细线 + 顶部倒五边形手柄(拖动时放大加粗),线身与句子起止边界线身等长;拖动优先级按纵向分区——顶部手柄只抓播放头、线身与边界重叠时让给边界、底部把手只抓边界,手柄压在单词块上时轻点仍算点词、拖动超过阈值才拖播放头。句子按序号蓝 / 紫 / 青三色轮换(
SubtitleSentenceColors,避开起止绿 / 红与播放头橙),波形、区间底色、文字与句子列表同色(列表每行主色换成该句颜色:编号胶囊、选中卡片描边、播放按钮、高亮单词、编辑入口)。选中句的顶部整句文字改为逐词单词块(放不下且过窄时只留色块),轻点试听该词,试听单词时波形不跟随滚动(播放头出视口才居中)。Widget 测试新增 6 项;macOS 集成测试「波形:播放头手柄、句子主题色与逐词单词块」(手机 / 桌面、明暗主题,15 张截图)通过。完成时间: 2026-11-17 - 未完成的验证:iOS / Android 真机软键盘下整句输入框与新句输入行不被遮挡、插词输入框在软键盘「完成」后提交。
- 未完成的验证:iOS / Android 真机上画面播放器与音频播放器并存时的音频会话表现、画面跟随延迟。
-
跨平台媒体剪辑:已下载材料多片段剪辑,字幕只读整句切分,独立 ID / SHA256、整批原子保存,只保存到本地合集。实现与验证见
docs/media-trim.md。完成时间: 2026-11-16- 宽屏左右分栏支持拖动调整并双击恢复:默认右侧片段面板 400px,拖动后以比例跨窗口记忆,最小左栏 480px / 右栏 360px;复用
MediaSplitDivider,新增布局与偏好测试及集成覆盖。相关单元测试和静态分析通过。macOS 集成测试启动受 Flutter SDK cache 写权限阻断。完成时间: 2026-11-17 - 重构与交互重设计:编排移到 Exporter、Controller 改为 Riverpod Notifier、类型化失败 + l10n;自研时间轴(波形、全部片段、拖动把手、缩放平移)、片段列表就地编辑、字幕「起 / 止」、自动分段、桌面快捷键、可取消的保存进度;重复内容复用已有材料;修复 just_waveform 16 位波形错位。30 项单元 / Widget 测试与 macOS 7 项原生集成测试通过。完成时间: 2026-11-16
- 交互对齐系统相册视频裁剪:选中片段后播放头只在片段内移动,点按片段外取消选中(桌面 Esc);播放头可拖动;拖动把手时隐藏播放头、松手停在该端;一端不再越过另一端导致整段跳走;片段试听从手动定位处继续;视频画面可收起;「放大到当前片段」按钮;微调长按连续;修复只有一个片段时点选不滚动到片段。完成时间: 2026-11-16
- 精简控件:视频画面默认收起(
video-2.svg,收起加斜线,音频不显示);去掉标题栏快捷键图标、片段「设为播放位置」按钮和字幕行「起 / 止」按钮,字幕改为点句定位后「新片段」;时间轴下方显示「片段 N · 起 – 止」并点按放大到该片段。完成时间: 2026-11-16 - 自动分段只列出比材料短的段长(不超过 1 分钟时说明并禁用);保存弹窗对播客 / 共享合集来源提示只能保存到本地合集。完成时间: 2026-11-16
- 视觉刷新:时间轴改为圆角裁剪框 + 实心把手、中性色圆形抓手播放头、圆头波形竖条、居中序号;片段卡片圆角 16、标题精简为「片段 N」、起止编辑并排胶囊;头部按钮统一字号;字幕行圆角。明暗主题、150% 字号截图已检查。完成时间: 2026-11-16
- 把手移到片段外侧(播放头在起止点贴把手内沿)、白色投影播放头;「新片段」改为从播放头往后在空白处建段(默认 2 分钟、最短 10 秒,找不到空白提示),修复连续点击无效;片段按序号 6 色循环配色,时间轴 / 列表 / 字幕色条一致;放大后平移松手惯性滑动;修复首帧缩放按钮不可用。完成时间: 2026-11-16
- 页面左右边距固定 16,不再在 600px 宽度处从 16 跳到 24。完成时间: 2026-11-16
- 波形采样列固定到内容坐标,横向平移时同一时间位置的柱高保持稳定;新增采样区间回归测试。完成时间: 2026-11-17
- 修复视口宽度变化时放大后的时间轴每次右移一个留白宽度(锚点取点与恢复点不一致)。完成时间: 2026-11-16
- 修复布局切换(宽 / 窄 / 矮窗口、展开收起画面)时时间轴缩放被重置:时间轴挂 GlobalKey 搬家不重建。完成时间: 2026-11-16
- 片段列表标题改为保存时的名称(默认名过长只省略原名、保留序号),时间轴下方标签改为「起 – 止 · 时长」,删除「片段 N」文案。完成时间: 2026-11-16
- 拖动把手靠近其它片段边界时磁吸对齐 + 轻震 + 同色对齐线;「新片段」空白不足提示改为顶部 toast(
showAppToast);集成测试快捷键先恢复 resumed,修复窗口失去前台时偶发失败(troubleshooting 7.56)。完成时间: 2026-11-16 - 修复有字幕时连续「新片段」在播放头位于末段内时产生重叠片段(troubleshooting 7.58);新增覆盖任意播放头位置的不重叠回归测试。完成时间: 2026-11-16
- 图标线宽统一为约 1.67px(线条图标 20px;
split.svg/arrow-range.svg改为描边路径;8 倍渲染实测 1.75px 量化值一致)。完成时间: 2026-11-16 - Android 真机与 iOS 模拟器重跑
integration_test/media_trim_integration_test.dart(重构后尚未在两端执行)。 - 字幕编辑器波形改用
WaveformSamples,修复同样的 16 位错位问题(troubleshooting 7.54)。
- 宽屏左右分栏支持拖动调整并双击恢复:默认右侧片段面板 400px,拖动后以比例跨窗口记忆,最小左栏 480px / 右栏 360px;复用
-
收藏复习宽屏布局:句子 / 词汇复习页整页(进度条、卡面、评分栏、状态栏)限宽 720 居中,与原有正面限宽一致,翻面不跳版;共享评分栏
FlashcardRatingActionBar按钮高度上限 80(窄屏仍按宽高比,手机观感不变),修复宽屏下评分按钮随宽度拉成大块空卡片、挤掉 AI 查词内容的问题。完成时间: 2026-11-16- 未完成的验证:macOS 宽窗口 / iPad 横屏确认两个复习页的居中观感与词典面板位置。
-
评分按钮分色:
FlashcardRatingActionBar按评分使用浅底 + 同色细边框 + 深色文字(听不懂暖橙、听懂了蓝、轻松听懂绿,四档模式「困难」为土金;不用红色,避免「答错」暗示影响如实自评),深色模式单独配色;按下时同色叠加加深并缩放 0.98,表情缩小、文字加粗为视觉焦点;禁用时整体半透明。完成时间: 2026-11-16- 未完成的验证:真机确认深色模式配色与按压反馈手感。
-
收藏复习正面视觉重做:句子 / 词汇复习正面抽成共享组件
ReviewFrontLayout+ReviewPlaybackPrompt(lib/widgets/review/review_front_layout.dart),删除两页重复的_CenteredPrompt。去掉上下两块大色块:内容直接居中在页面底色上(整块可点按重播),底部 52 高「查看答案」主按钮,与背面评分栏同位、翻面前后版式连贯;播放按钮用primaryContainer色调圆形、播放中填实为primary、失败用errorContainer;状态文字降为次要色;单词放大加粗,单词隐藏时释义升为主内容层级。删除不再使用的bookmarkReviewRevealHint/favoriteVocabularyReviewRevealHint文案。完成时间: 2026-11-16- 未完成的验证:真机确认浅 / 深色观感、长释义与 150% 字号下的排版。
-
收藏句复习显示来源视频画面:来源是视频且「收藏句子复习 → 显示视频画面」开启(默认开,随句子复习设置同步)时,正反面都显示画面,复用学习任务的自适应分栏(竖屏上下、宽屏左右,比例共用);翻面画面不重建。视频卡由媒体引擎播放这一句、画面随声音移动,背面逐词高亮与意群播放跟随媒体引擎;同一视频的下一张卡只定位不重载;加载失败退回音频播放。画面不提供字幕与全屏;遮罩照常可开关(由用户负责,避免无内嵌字幕的视频被关不掉的遮罩挡住),开关与拖动 / 缩放写库;隐藏画面本次复习内跨卡保留。设置关闭时完全走原音频路径。编排在
BookmarkReview(复用并扩展FavoriteSentenceVideoSession),MediaVisualSurface新增MediaVisualControls(默认行为不变)。日志[FavoriteSentenceReview] video.*/play path=。macOS 集成测试integration_test/bookmark_review_video_test.dart(ffmpeg 生成真实视频、真实 media_kit、关键状态截图)通过。完成时间: 2026-11-16- 未完成的验证:iOS / Android 真机(竖屏视频比例、触屏拖动遮罩、后台切换)。
- 同日审查修复:
videoSession校验会话加载的是当前卡片材料,切到其它材料时不再暴露旧画面;视频同步异常只退回音频,不中断切卡与自动播放。回归测试见test/providers/learning_session/bookmark_review_test.dart的「视频材料」组。完成时间: 2026-11-16 - 既有问题(未改动):
BookmarkReview的onDispose调用真实AudioEngine.stop()会在容器销毁期间修改其它 provider,触发 Riverpod 断言;生产中该 provider keepAlive,仅容器销毁 / invalidate 时出现。
-
学习内容字号(只调正文,不缩放整个 UI;颜色设置待产品决定)。
- 云端偏好同步接入字幕文字字号与粗细:本地键
subtitle_font_size_percent/subtitle_font_weight_percent,云端字段appearance.subtitleFontSizePercent/appearance.subtitleFontWeightPercent(后端按域名校验、域内字段自由,无需改后端);云端缺失或非法时保留本地值。完成时间: 2026-11-12
- 云端偏好同步接入字幕文字字号与粗细:本地键
-
收藏词汇复习设置新增「正面显示释义」(默认关闭,仅对单词有效,先取基础在线词典(本地缓存 → API),未查到时只读 AI 查词缓存,经偏好同步跨平台)。完成时间: 2026-11-13
- 未完成的验证:真机确认正面释义的加载/占位观感,以及两台设备切换后同步生效。
-
收藏导出 PDF:收藏页右上角「导出」弹窗选择句子 / 词汇(可同时导出),句子按来源材料分组并附本地译文,词汇按字母序并附本地释义(AI 查词首义项与首例句,单词回落基础词典首行释义)与来源句。全部只读本地缓存,不发起任何 API 请求。PDF 底层(字体、版式外壳、保存 / 分享、预览)与学习材料导出共用(
services/pdf_export/common/、widgets/pdf/);导出数据与格式解耦,新增格式只需加FavoritesExportFormat枚举值并补渲染分支。完成时间: 2026-11-14- 未完成的验证:真机确认收藏 PDF 的中文字体、分页与长词条观感,以及下载 / 分享流程(iOS / Android / macOS)。
-
视频字幕遮罩:视频画面右上角新增遮罩按钮,开启后在画面底部显示半透明磨砂遮罩,用于遮住视频内烧录的原字幕;单指拖动移动、双指捏合等比缩放、拖动四边中点手柄单独调整对应边;点按遮罩进入编辑态(收起播放控件、显示手柄 2 秒),与点按画面显示控件互不重叠。位置按去黑边后的实际画面归一化,窗口缩放 / 全屏切换后仍对准字幕;开关与位置按视频保存在本地数据库表
video_subtitle_masks(schema v68),只在用户操作遮罩后才写入,没有记录即为关闭 + 底部居中默认位置;删除视频时级联清除,不跨端同步。随心听、学习任务与句子讲解页共用MediaVisualSurface单一实现。完成时间: 2026-11-15- 拖动发卡已修复(手势判定阈值,见 troubleshooting 7.46)。已在 Android 真机(竖屏烧录字幕视频)验证开关、拖动、手柄缩放、全屏前后位置保持;未完成的验证:iOS / macOS 的磨砂效果与双指缩放手感、横屏视频全屏。
- 手柄自动弹出已修复(见 troubleshooting 7.49):边框与手柄只在开关打开、点按 / 拖动后保持 2 秒、鼠标悬浮时显示;打开视频与窗口跨越布局断点导致的重建不再弹出。日志标签
[VideoSubtitleMask]记录挂载与激发态变化及原因。完成时间: 2026-11-15。未完成的验证:真机确认桌面端悬浮显示,以及触屏下不出现悬浮残留。
-
修复音频列表项「…」菜单两个问题(macOS):菜单展开时整卡变灰、关闭后部分卡片残留灰底(菜单焦点经浮层冒泡到卡片 InkWell,菜单项随浮层销毁时 Flutter 丢失失焦通知,见 troubleshooting 7.59);菜单展开时点击外部穿透触发列表项。菜单移出 InkWell 子树并设
consumeOutsideTap,学习计划页「更多」菜单同步。完成时间: 2026-11-18 -
修复打开视频时先闪现上一个视频画面:media_kit 跨视频复用同一块原生纹理,新视频出帧前纹理仍是上一视频的最后一帧。
VideoFrameGate在本次 open 后 mpvvo-configured=yes且纹理尺寸等于新视频尺寸时才绘制纹理,此前露出黑色画布;video-params实测比原生出帧早 100~400ms,不能作为信号。日志[VideoFrame]记录每次打开的代次、正在加载的视频与纹理中实际画着的视频。完成时间: 2026-11-15- 已在 macOS 验证横竖屏视频互切 4 次均无旧画面;未完成的验证:两个同分辨率视频互切(纹理不重建,仅靠
vo-configured)、iOS / Android。
- 已在 macOS 验证横竖屏视频互切 4 次均无旧画面;未完成的验证:两个同分辨率视频互切(纹理不重建,仅靠
-
逐句精听视频自适应分栏(试点):按实际可用空间自动切换上下 / 左右布局(宽 ≥ 720 且宽高比 ≥ 1.2 时视频在左),分隔条可拖动调整视频高度 / 宽度,双击恢复默认;两种方向各自按比例记住尺寸(本地键
practice_media_split_stacked_fraction/practice_media_split_side_by_side_fraction,所有学习任务共用)。画面容器按视频比例贴合,左右布局下词典面板只覆盖右侧内容;跨越断点时视频、句子分页与词典面板状态保留。阈值集中在PracticeMediaSplitGeometry,布局组件PracticeMediaSplitLayout可直接复用。日志标签[PracticeMediaLayout]。完成时间: 2026-11-15- 加载态跟随分栏(修复宽屏视频加载时仍为上下结构):加载占位改由
ManagedMediaVisualSurface.builder按启动状态画在视频槽内(MediaStartupCanvas),内容区加载期间淡化且不可交互;音频任务仍用全页遮罩。见 troubleshooting 7.50。完成时间: 2026-11-15 - 未完成的验证:真机 / 桌面端确认宽屏进入视频精听时加载态已是左右结构、拖窄窗口后切换上下、失败重试可用,音频任务加载仍为全页遮罩。
- 已在 macOS 拖动窗口验证 400×800 / 600×900 / 820×1000 / 1180×820 / 1200×800 的布局切换、拖动、双击恢复与热重启后尺寸保持;已在 iPad Air 11 模拟器(iOS 26)验证竖屏上下布局、横屏左右布局、两个方向触屏拖动与旋转后各自恢复记住的尺寸。
- 修复竖屏把视频拉高后盲听区溢出(BOTTOM OVERFLOWED):
PracticeNormalModeView在可用高度 < 300 时切换紧凑排布(倒计时并入偷看入口行、正文可滚动、压缩留白),上下布局学习区最小高度按实测硬下限约 282 加两行字幕空间设为 340;回归测试「视频拉到最大时学习区不溢出(盲听 / 讲解)」守护。已在 macOS 用竖屏视频验证拉到最高、偷看字幕、倒计时出现均无溢出。完成时间: 2026-11-15。未完成:iPad 真机拖动手感。
- 加载态跟随分栏(修复宽屏视频加载时仍为上下结构):加载占位改由
-
视频自适应分栏推广到全部学习任务:全文盲听、难句跟读、段落复述、难句复习接入
PracticeMediaSplitLayout(盲听与复述经共享骨架ParagraphPracticeScaffold一处接入)。加载占位与内容区淡化收进分栏组件(startupStatus),各任务页重复的_wrapMediaStartup统一为PracticeMediaStartupHost。跟读录音区在视频拉到最大时实测不溢出,学习区最小高度 340 无需按任务区分。完成时间: 2026-11-15- macOS 交互测试
integration_test/practice_media_split_test.dart(5 个任务 × 4 个用例全部通过):5 种窗口尺寸的布局方向与不重叠 / 不溢出、鼠标拖动分隔条记住比例与双击恢复、上下布局拖到底学习区完整、宽屏加载占位位于左侧视频槽。运行期间测试窗口须保持前台(troubleshooting 7.51)。 - 未完成的验证:真实视频文件(竖屏视频宽高比)下的手感、iPad / Android 真机。
- 复查 macOS 实机日志后补充:
[PracticeMediaLayout]记录分栏方向切换(含尺寸)与视频轨显示 / 隐藏,便于把视频纹理重建、遮罩重挂载对应到用户操作;拖到上下限后再次拖动比例不变时不再重复写入偏好。完成时间: 2026-11-15
- macOS 交互测试
-
随心听视频自适应分栏:随心听视频页改用
PracticeMediaSplitLayout与统一断点(替换原先「宽高比 > 1 即双栏、3:2 固定比例」的自写布局),字幕与控制面板作为整体内容区,宽屏时在右栏、视频独占左列全高;分隔条可拖动、双击恢复,视频尺寸与学习任务共用同一份偏好。加载改走PracticeMediaStartupHost,视频加载占位画在视频槽内(7.50),音频仍为全页遮罩、布局不变。词典面板宿主用 GlobalKey 在全屏 / 上下 / 左右间保留;控制面板按内容区实际宽度(< 600)决定紧凑排布。[PracticeMediaLayout]分栏方向日志补充该方向恢复的比例。完成时间: 2026-11-15- 组件回归测试:左右布局位置关系、统一断点与隐藏视频轨、视频拉到最大不溢出、竖向视频按比例贴合、宽 / 窄屏加载占位位于视频槽且内容区不可交互、跨断点保留字幕列表 / 视频画面 / 词典面板状态。macOS 交互测试
integration_test/media_playback_split_test.dart(4 个用例通过);createTestAppWithAudio的 extraOverrides 改为可替换默认替身。 - 复查 macOS 实机日志后修复:加载 ready 时视频画面被重建(
[VideoSubtitleMask] 遮罩组件挂载出现两次)。原因是分栏组件加载期间在视频外包了一层叠放占位的 Stack,ready 去掉后元素树变化;改为视频自身再用一个 GlobalKey 保留(学习任务页同样受益),回归测试守护。完成时间: 2026-11-15 - 未完成的验证:真实竖屏视频手感、iPad / Android 真机。
- 组件回归测试:左右布局位置关系、统一断点与隐藏视频轨、视频拉到最大不溢出、竖向视频按比例贴合、宽 / 窄屏加载占位位于视频槽且内容区不可交互、跨断点保留字幕列表 / 视频画面 / 词典面板状态。macOS 交互测试
-
学习材料 PDF 读取 AI 词典缓存时仍使用旧类型
ai_dictionary,而当前写入类型为ai_dictionary_v2,导致学习材料 PDF 读不到 AI 查词结果;收藏导出已改用AiDictionarySource.readCachedEntry。需确认后统一修正。 -
查词归一化 Unicode 化,并迁移已有收藏 key(需产品与数据决策)。
-
计算并展示每个学习任务的预计/实际耗时。
-
学习 Tab 点击学习/复习后直接进入学习页面,跳过学习计划页。
-
学习 Tab 展示“今日完成任务”折叠区。
-
支持自定义背景和背景音。
-
增加播放完成音效、任务完成动画与音效。
-
埋点能力按中国大陆 / 全球环境拆分落地。
- 后端合入并部署
/api/v1/me/profile:线上当前返回 404,App 头像与昵称不可用(客户端入口已提供重试)。 - 账户页「用量与额度」:账户页入口进入子页,按功能展示本月已用百分比进度条(依赖后端
/api/v1/me/usage,打开页面时加载一次,不轮询)。完成时间: 2026-11-13 - 后端账号登录会话能力。
- 完成跨平台验证与发布准备。