diff --git a/.scratch/rework-ux-adjust-20261014/spec.md b/.scratch/rework-ux-adjust-20261014/spec.md index 662692aa..85781cdd 100644 --- a/.scratch/rework-ux-adjust-20261014/spec.md +++ b/.scratch/rework-ux-adjust-20261014/spec.md @@ -80,7 +80,7 @@ Base: 线上 7b299abe(retro-dict-20261014 发布版) - **D2 无效动作=特殊标注动作,必须可见**:轨道与所有审查界面始终可见,特殊样式(虚线+浅灰+无效标识);轨道块上不提供直接改判(恢复有效走编辑器,维持现状)。零宽/极小宽产物不得静默不可见。 - **D3 「无效动作消失」缺陷修复**:静态分析已排除「渲染过滤器」嫌疑(无排除过滤器、冲突流三道断言保证残段不蒸发);头号嫌疑=冲突产物零宽动作渲染宽度为 0。实现:冲突解析增加零宽产物守卫(显式并入相邻或拒绝报错,绝不静默);贴边静默跟随在冲突列表加折叠提示行(「N 个贴边无效动作自动跟随」)。顺序:先本地复刻栈复现(G 键/编辑器开关/冲突三选判无效/未标注区间标无效 四路径 × 冲突流全走查),复现不了再向用户要线上条目 id 取证。 - **D4 整体作用域全流程停用(ADR 0009)**:创建侧——所有审查界面移除整体作用域入口(作用域循环、单选组),服务端草稿 PUT 拒绝新增整体作用域问题(存量随草稿原样保留不阻断);展示侧——存量整体意见全界面隐藏(标注返工横幅/软提醒、质检双板与意见面板、验收意见源、统计面板、预打包镜像行);数据不迁移、不删除;统计口径改为 切片/动作/时间点 计对象数、覆盖时长只计切片与动作区间,整体不再计入,历史按新口径重算并注明口径切换;正式打回扁平化不再生成新的「整体任务:」行(历史原文保留)。 -- **D5 意见目标切换交互(2026-10-14 晚修订,取代早前「在既有意见间移动」方案)**:Ctrl+↑/↓ 切换**写意见的目标**——当前切片 → 当前动作 → 当前时间点(三档,由播放头位置确定「当前」是哪片哪动作;到头停住);意见区常驻显示所选目标(目标标签+该目标已有意见/草稿);按 **F 直接开始给当前选中目标写意见**(光标进输入框),**Ctrl+Enter 提交**;F 原有的作用域选择弹层**删除**;「编辑当前画面意见」按钮与「全任务 N 处意见」展开器维持已删除状态。时间点沿用现有锚点冻结机制(发起时播放位置);G 跳时间点、J/K 返修复审跳意见、1/2 判定键不变;既有意见列表的键盘遍历能力移除(看历史=列表点击/G)。校验/提交逻辑本身不变。 +- **D5 意见目标切换交互(2026-10-14 晚修订,取代早前「在既有意见间移动」方案)**:Ctrl+↑/↓ 切换**写意见的目标**——当前切片 → 当前动作 → 当前时间点(三档,由播放头位置确定「当前」是哪片哪动作;到头停住);意见区常驻显示所选目标(目标标签+该目标已有意见/草稿);按 **F 直接开始给当前选中目标写意见**(光标进输入框),**Ctrl+Enter 提交**;F 原有的作用域选择弹层**删除**;「编辑当前画面意见」按钮与「全任务 N 处意见」展开器维持已删除状态。时间点沿用现有锚点冻结机制(发起时播放位置);G 跳时间点、J/K 返修复审跳意见、1/2 判定键不变;既有意见列表的键盘遍历能力移除(看历史=列表点击/G)。校验/提交逻辑本身不变。(2026-10-15 快修增补)每次意见成功提交后,当前目标自动回位到当前动作档(动作档不可用时回退切片档)——时间点档每次重进按当下播放头重新冻锚,连续添加不再撞重复锚定。 - **D9 审核与返工面模式头同步调整(新增,2026-10-14 晚)**:审核(质检复检)面与审核返工(标注员返修)面的**普通/专注两种模式头**随 D5 新交互同步更新——快捷键帮助行文案改为新语义(Ctrl+↑/↓=切换意见目标、F=直接填写、Ctrl+Enter=提交),移除指向已删弹层/按钮的死入口与过时提示;四个面(审核-普通/专注、返工-普通/专注)口径一致。 - **D10 时间点意见卡与动作归属(新增,2026-10-14 深夜,工单 08;细化 D5 的时间点档呈现)**:「本轮审核意见」卡片清单扩为**三张**——当前切片意见/当前动作意见/**当前时间点意见**,三张卡同一视觉规格(同一 role/选中态样式):Ctrl+↑/↓ 切到时间点档时该卡与另两卡一样**高亮变色**(aria-selected 同款);点卡片进入该目标编辑。时间点卡内容=**归属当前动作**的时间点意见条目(按 atSeconds 升序,条目点击沿用 selectProblem 定位锚定);原「全任务时间点平铺列表」删除——其他动作的时间点意见随播放头/跳转到达该动作时在其卡内可见。写意见的目标锚点语义不变(切入档位时刻冻结,D5);当前动作无时间点意见时卡内显示「无」(档位仍可切、F 仍可在当前画面写时间点意见)。(2026-10-14 三审增补)动作间隙锚定的时间点意见随**最近动作**归属(等距归后继);播放头处于间隙时,时间点卡内容窗口=最近动作,保证间隙条目可见且 J/K 焦点有落点。 - **D6 J/K 与 E 面板联动解锁**:J/K 落切片问题→自动打开/切换 E 面板目标;落动作/时间点问题→收起 E 面板、右上编辑界面打开(现状);E 面板开着不再拦截 J/K(该场景移除「已锁定」toast);未应用 pendingSlices 全程驻留(重开还在,Esc 显式整体回滚);冲突列表打开期间(动过开始/结束时间待决断)J/K 锁定直至决断完成;鼠标路径(拖边界/删片/悬停+)面板打开期间维持锁定。 diff --git a/src/hooks/useReviewDraft.ts b/src/hooks/useReviewDraft.ts index c6deec25..b9469698 100644 --- a/src/hooks/useReviewDraft.ts +++ b/src/hooks/useReviewDraft.ts @@ -24,6 +24,7 @@ import { defaultReviewScope, nearestReviewPositionAction, nextReviewTargetScope, + postSubmitReviewTarget, reviewPositionAction, reviewTargetPosition, } from "../lib/review-navigation.js"; @@ -186,6 +187,18 @@ export function useReviewDraft(itemId: string, userId: string, enabled: boolean, editor: { ...queued.editor, baseGroup: stored, baseline: stored[0]?.text || "", legacy: false }, }); if (!p.background && !m.editor) focusWorkbench(); + // 2026-10-15 快修(D5 增补):手动提交成功(草稿入列、输入收起)后目标回位 + // 当前动作档(动作档不可用回退切片档)——时间点档每次重进按当下播放头重新 + // 冻锚,连续添加不再撞重复锚定。自动落盘/后台写入不清输入;失败/校验拒绝走 + // blocked/catch 到不了 settle;清除确认(p.clear)不属于添加意见——均不切档。 + if (!p.clear && !p.background && !p.autosave) { + const reset = postSubmitReviewTarget(p.editor.scope, m.position); + if (reset) { + m.selected = reset; + // 回位档只可能是动作/切片(无锚点语义),清锚保证时间点档每次重进重新冻锚。 + m.targetAnchor = null; + } + } m.message = p.clear ? "已清除意见" : p.autosave ? "意见已自动保存" : "已保存"; notify(); }; diff --git a/src/lib/review-navigation.js b/src/lib/review-navigation.js index 3f4c8c92..20eebcfb 100644 --- a/src/lib/review-navigation.js +++ b/src/lib/review-navigation.js @@ -46,6 +46,27 @@ export function nextReviewTargetScope(current, position, direction) { return null; } +/** + * 提交后目标回位(2026-10-15 快修 / D5 增补):任何一次意见成功提交后,当前 + * 目标自动回位「当前动作」档——动作意见提交后本就在动作档(无操作,仍返回 + * action 便于钉子);切片/时间点提交后跳回动作档,此后 Ctrl+↑=切片、Ctrl+↓= + * 时间点(既有循环次序本来如此),时间点档每次重进按当下播放头重新冻锚, + * 连续添加不再撞重复锚定。动作档不可用(播放头在动作间隙)回退切片档 + * (切片档无锚点、不会再冲突);连切片也不可用(画面未就绪)返回 null + * (保持现状不切档)。可用性复用 reviewTargetOptions(opinionTarget 同一契约)。 + * + * @param {string | null | undefined} currentScope + * @param {{ sliceId?: string | null, actionId?: string | null, time?: number } | null | undefined} position + * @returns {"slice" | "action" | null} + */ +export function postSubmitReviewTarget(currentScope, position) { + if (currentScope === "action") return "action"; + const options = reviewTargetOptions(position); + if (options.includes("action")) return "action"; + if (options.includes("slice")) return "slice"; + return null; +} + /** * 目标档位解析用画面:时间点档用切入该档时刻冻结的播放头画面(沿用 viewAnchor * 冻结机制,票 07),切片/动作档跟随实时播放头(含播放头的切片/动作)。 diff --git a/tests/frontend/review-target-interaction.test.mjs b/tests/frontend/review-target-interaction.test.mjs index 82c4b90e..c1230b30 100644 --- a/tests/frontend/review-target-interaction.test.mjs +++ b/tests/frontend/review-target-interaction.test.mjs @@ -10,7 +10,8 @@ import { opinionScopes, opinionTarget } from "../../src/lib/review-opinions.ts"; // Ctrl/⌘+Enter 提交。接缝:src/lib/review-navigation.js 纯函数(node --test 直接加载); // 键位映射 review-shortcuts.js;TS 模块按仓库先例以源码守卫钉住(见文末)。 -const { reviewTargetOptions, reviewTargetScopes, nextReviewTargetScope, reviewTargetPosition } = reviewNavigation; +const { reviewTargetOptions, reviewTargetScopes, nextReviewTargetScope, reviewTargetPosition, postSubmitReviewTarget } = + reviewNavigation; test("target options: playhead resolves the three tiers (slice / action / timestamp)", () => { const pos = (extra = {}) => ({ time: 4, sliceId: "s1", actionId: null, ...extra }); @@ -116,7 +117,7 @@ test("source guard: hook wires the target model (switch, freeze anchor, F direct // review-r3 三审增补:间隙兜底 nearestReviewPositionAction(卡内容窗口,不改目标可用性)。 assert.match( hook, - /import \{\s*defaultReviewScope,\s*nearestReviewPositionAction,\s*nextReviewTargetScope,\s*reviewPositionAction,\s*reviewTargetPosition,\s*\} from "\.\.\/lib\/review-navigation\.js";/, + /import \{\s*defaultReviewScope,\s*nearestReviewPositionAction,\s*nextReviewTargetScope,\s*postSubmitReviewTarget,\s*reviewPositionAction,\s*reviewTargetPosition,\s*\} from "\.\.\/lib\/review-navigation\.js";/, ); // Ctrl+↑/↓ = 目标档位切换(复用纯函数),到头停住;切入时间点档冻结画面。 assert.match(hook, /switchTarget: \(direction: -1 \| 1\) =>/); @@ -173,3 +174,39 @@ test("source guard: workbench and acceptance dispatch target switching to the pa const viewing = read("../../src/components/review-viewing.ts"); assert.match(viewing, /onReviewTargetSwitch\?: \(direction: -1 \| 1\) => void;/); }); + +test("post-submit reset: successful submit returns the target to the action tier (2026-10-15 quickfix)", () => { + const withAction = { time: 4, sliceId: "s1", actionId: "a1" }; + const gap = { time: 4, sliceId: "s1", actionId: null }; + // 动作意见提交后本就在动作档(无操作,仍返回 action 便于钉子;不看点位可用性)。 + assert.equal(postSubmitReviewTarget("action", withAction), "action"); + assert.equal(postSubmitReviewTarget("action", gap), "action"); + // 切片/时间点提交且动作档可用(播放头在动作内)→ 回位动作档。 + assert.equal(postSubmitReviewTarget("slice", withAction), "action"); + assert.equal(postSubmitReviewTarget("timestamp", withAction), "action"); + // 动作档不可用(播放头在动作间隙)→ 回退切片档(切片档无锚点、不会再冲突)。 + assert.equal(postSubmitReviewTarget("slice", gap), "slice"); + assert.equal(postSubmitReviewTarget("timestamp", gap), "slice"); + // 连切片也不可用(画面未就绪)→ null(保持现状不切档)。 + assert.equal(postSubmitReviewTarget("slice", null), null); + assert.equal(postSubmitReviewTarget("timestamp", { time: 4, sliceId: "", actionId: "a1" }), null); + assert.equal(postSubmitReviewTarget(null, null), null); +}); + +test("source guard: hook resets the target only on the manual-save success path (2026-10-15 quickfix)", () => { + const hook = read("../../src/hooks/useReviewDraft.ts"); + // 回位挂在 settle(成功确认点):手动提交(非清除/后台/自动落盘)才切档, + // 离开时间点档时清锚,保证时间点档每次重进按当下播放头重新冻锚。 + const settleStart = hook.indexOf("const settle ="); + const settleEnd = hook.indexOf("const flushRef"); + assert.ok(settleStart >= 0 && settleEnd > settleStart, "settle 成功确认点应可定位"); + const settleBody = hook.slice(settleStart, settleEnd); + assert.match(settleBody, /if \(!p\.clear && !p\.background && !p\.autosave\) \{/, "仅手动提交成功才回位"); + assert.match(settleBody, /const reset = postSubmitReviewTarget\(p\.editor\.scope, m\.position\);/); + assert.match(settleBody, /m\.selected = reset;/); + // 回位档只可能是动作/切片:清锚保证时间点档每次重进按当下播放头重新冻锚。 + assert.match(settleBody, /m\.targetAnchor = null;/); + // 失败/校验拒绝/入队路径不得切档:回位调用只允许出现在 settle 体内。 + const outside = hook.slice(0, settleStart) + hook.slice(settleEnd); + assert.doesNotMatch(outside, /postSubmitReviewTarget\(p\.editor\.scope/, "失败路径与 enqueue/save 不得切档"); +}); diff --git a/tests/frontend/scope-cycle-inline-editor.test.mjs b/tests/frontend/scope-cycle-inline-editor.test.mjs index 52bd1dbc..9618284e 100644 --- a/tests/frontend/scope-cycle-inline-editor.test.mjs +++ b/tests/frontend/scope-cycle-inline-editor.test.mjs @@ -32,7 +32,7 @@ test("source guard: hook wires the target model and resident editor", () => { const source = read("../../src/hooks/useReviewDraft.ts"); assert.match( source, - /import \{\s*defaultReviewScope,\s*nearestReviewPositionAction,\s*nextReviewTargetScope,\s*reviewPositionAction,\s*reviewTargetPosition,\s*\} from "\.\.\/lib\/review-navigation\.js";/, + /import \{\s*defaultReviewScope,\s*nearestReviewPositionAction,\s*nextReviewTargetScope,\s*postSubmitReviewTarget,\s*reviewPositionAction,\s*reviewTargetPosition,\s*\} from "\.\.\/lib\/review-navigation\.js";/, ); // 目标档解析用画面:时间点档=切入时刻冻结锚点,其余=实时播放头。 assert.match(source, /reviewTargetPosition\(scope, m\.position, m\.targetAnchor\)/);