Files
short-drama-agent-front/docs/audits/storyboard-ui-information-hierarchy-2026-11-18.md
T

14 KiB
Raw Blame History

分镜页面信息层级优化交接

范围与边界

  • 在前端根目录 dev 完成,起点为 b15a6011ce28dd58156ac3c5c06e84c8796fe39c。保留同轮此前未提交的图片卡片改动。
  • 本次只调整展示与按需展开,不修改后端、接口字段、收费参数、质量结论、来源校验及正式采用条件。
  • 普通用户首屏先看到当前结果、主要输入和操作。流程介绍放信息图标,完整创作正文和业务历史按需展开。
  • 普通详情不再直接输出整段响应、任务编号、SHA 或指纹。需要核对的历史改为明确的中文字段。原始对象仍用于请求、来源和并发保护;已有显式导出保留。
  • 费用、未知请求、来源变化、覆盖、保存与正式采用的区别仍在操作处展示。信息背景只用于分组,不暗示质量通过。
  • 未执行真实图片、文本、Vision 或视频模型,未向正式项目保存草案、采用、批准或核清费用。本轮完整改动已获用户明确提交及推送授权,交付目标为 origin/dev。

已有问题与本次结果

  1. 图片列表原有最大宽度导致大屏右侧空白,长错误和模型名令卡片高度不齐。现在网格使用可用全宽,按缩略图列宽自动排布、统一等高;少量图片保留列位,不无限放大。手机单列。
  2. 卡片依次显示图片、标签、图片名称、日期、操作。标签最小高度从 44px 收紧到单行 22px;名称前不再预留未使用的第二行。模型、尺寸、画幅问题、失败原因与来源说明放 info 浮层。
  3. 没有独立名称的历史图片,使用镜头名及按创建时间生成的展示编号;不写回资产,不因主图切换而重编号。
  4. 分镜摄影规划与开拍事实使用两块中性主题底面。构图机位、天气环境、主体和连续依据按需展开,完整原文保持可查看。
  5. 摄影、联合草案、动作修订、首帧、质量和连续性相关弹窗收起流程介绍及高级参数;保存、预检和采用仍是独立操作。
  6. 原来整段输出的摄影历史、动作版本、人工来源观察、布局约束、生成方案和许可记录改为中文业务记录。历史摄影保留修改前后构图、机位、审核人和时间;联合模式也可查看。
  7. 普通有效图片授权不再误显示“原请求和费用仍未知”。只有实际阻断、可选许可、已选许可或读取问题时才显示有限许可区域;实际费用阻断保持可见。
  8. 原候选校验、Workflow、来源复核去掉内部请求与执行编号、原始 JSON;执行状态、业务问题、独立质量结论、恢复与历史入口保留。
  9. 布局完整约束改为要求、来源、画面要求、构图要求和验收依据;不再展示版本哈希。保存仍原样发送正式确认参数及期望版本。

文件职责

新增:

  • src/components/ui/RecordDetails.vue:只接收显式选择的中文业务字段,不序列化接口对象;支持已在折叠区中的直接显示。
  • tests/components/ui/progressive-info.test.ts:公共标题说明、动态费用状态、创作原文和长提示词按需展开。
  • tests/features/production/keyframe-dialog-density.test.ts:普通有效授权与真实阻断分别显示,不自动生成。

修改:

  • AGENTS.md:补充本次用户确认的信息层级与普通用户详情规范。
  • AppDialog.vue、AppDrawer.vue、WorkspaceSectionHeading.vue、FieldLabel.vue:复用说明入口;动态说明插槽直接显示,创作内容可原样展示。
  • admin.css:全宽等高候选网格、参考缩略图网格、开拍事实主题背景。
  • production/model.ts、KeyframeCard.vue、ShotProductionAssets.vue:稳定图片展示名、紧凑标签、info 详情、对齐操作和候选/记录标题。
  • StoryboardPage.vue、ShotDesign.vue、ShotTools.vue:分镜标题说明、摄影/状态分组和可读生成内容。
  • ShotDerivedReview.vue、JointDraftReviewPanel.vue、JointDraftFields.vue、DirectionStageReview.vue、derived-review.ts:摄影审核、联合表单、完整差异和可读历史;原模式、保存、预览、采用保留。
  • MotionRevisionEditor.vue:版本和失败候选摘要、历史按需展开,指定历史任务编号收起;保存、Vision、采用仍分别控制。
  • ImageGenerationPreview.vue、KeyframeDialog.vue、QualityDialog.vue、ValidationPreviewPanel.vue:预览层级、长提示词、按需许可、费用背景和中文参考职责。
  • ContinuityReviewDrawer.vue、ContinuityJointReview.vue、ContinuityStateEditor.vue、SceneTransitionEvidence.vue:连续性业务摘要、有限高度图片、中文正式依据、规划与视频末态区别。
  • SourceReviewDrawer.vue、LayoutSupplementPanel.vue:原图来源记录、逐项人工观察、布局完整约束与来源影响,去除普通响应对象展示。
  • KeyframeValidationHistory.vue、KeyframeValidationSteps.vue、KeyframeExecutionStatus.vue、QualityResult.vue、WorkflowExecutionPanel.vue:历史质量、执行与费用保持分离,去掉普通诊断数据 dump。
  • src/testing/naive.ts 和相关 UI 测试:通过用户主动展开读取详情;按中文业务结果验证,不依赖内部编号显示。
  • tests/browser/v02-continuity.ts:隔离页额外允许已拦截的免费布局输入预览,批准、签收、保存、执行和恢复仍返回拒绝;没有真实请求回退。

无删除文件,无依赖变更。

自动化验证

  • 全量 Vitest:124 套、949 项通过。
  • 之后补充中文来源/布局记录及历史保留检查,按受影响范围复验:摄影联合与动作修订 4 套 24 项通过;来源、连续性和质量等 6 套 90 项通过;新增展示断言所在 2 套 19 项通过。以上计数有重叠,不累加为全量数。
  • 最后源码的 TypeScript 与 Vite build 通过。变量重命名消除作用域遮蔽警告后复验相关 Lint。
  • 修改范围 Oxfmt、Oxlint、Vue ESLint 通过;git diff --check 通过。

本地 Chrome 验收

使用已有 localhost Chrome 标签页及原生辅助功能/截图/键鼠,没有使用 Playwright。

  • 正式分镜只读:摄影与开拍状态背景分组、视觉重点 info、构图/主体/连续依据折叠;刷新没有自动打开生成配置。
  • 图片卡片此前已验证桌面多列、移动单列、紧凑标签与名称、info 长内容和等高;本次保留这些布局及原质量/主图门禁。
  • v8-10.html 隔离页:首帧流程说明进入 info、真实费用阻断仍显示;免费预览后长提示词默认收起且可展开;未点击生成。
  • 同一隔离页:动作失败候选只读加载,指定历史任务收起;保存/采用/Vision 未触发。390×844 验证正文滚动、固定底栏和表单边界。
  • review-billing.html:联合模式初始草案、全部差异、主体与衔接折叠、说明浮层;390×844 无横向溢出,固定保存/采用底栏可见。
  • b04-review.html:来源复核免费预检,中文正式动作、原图记录、逐图未知观察;桌面和390×844均可浏览,底栏固定。隔离页拒绝全部写请求。
  • v02-continuity.html:免费布局输入预览,展开中文完整约束,保存影响和独立确认仍清楚;未确认正式布局。
  • 最后关闭设备模拟与开发工具,恢复正式分镜只读页面。

仍保留的专用能力

本次没有全局删除原始数据组件。独立账单审计里的原件与签署材料、显式导出、以及高级人工物理交互编辑仍按原契约保留;这些不作为普通分镜首屏的默认内容。后续新增界面继续遵守当前 AGENTS 的信息层级规范。

图片详情浮层裁切补充

  • 本地 Chrome 复现:候选管理最右列的详情挂在弹窗内部,超过弹窗正文边界的文字被裁掉。
  • KeyframeCard.vue 的详情、主图切换确认,以及公共 WorkspaceActionTooltip.vue 明确挂载至页面浮层,启用边缘自动翻转;长说明限制宽度并换行。
  • 详情打开时停用同一按钮的悬浮说明,避免“查看首帧详情”提示叠在正文上。
  • Chrome 只读验证桌面最右列详情完整显示;390×844 下摄影抽屉内同类详情保持在屏幕范围内,模型长名完整可读。恢复桌面并关闭开发工具。
  • 相关 Vitest 3 套29项、TypeScript、两文件 Oxlint/ESLint/格式检查通过,未触发生成、审核或采用。

摄影编辑间距与长文阅读补充

  • 原不一致来自独立折叠组的模块 gap 与 Naive UI 后续项默认 margin、header padding 叠加。新增公共 workspace-collapse 统一44px折叠行、首项与后续项留白、展开正文间距;已用于摄影审核、联合草案与设计状态的同类区域。
  • 独立功能组使用现有两倍模块间距,来源读取与保存状态归为一组;完整草案单独用中性主题底面组织。表单字段统一16px,标签到控件仍为8px。
  • 共用 DirectionCameraFields 增量支持摄影意图插槽,宽屏构图在左,机位与意图在右;列内保持固定字段间距,窄屏恢复单列。长文输入统一字号、行距和有界自动高度,未修改原文或提交结构。
  • 已同步写入 AGENTS,后续同类界面按公共样式复用。
  • 相关 Vitest 4套33项、TypeScript、修改组件 Oxlint/ESLint、格式及差异检查通过。Chrome 使用正式项目只读核对桌面分栏、等距折叠、390×844单列、长文内部滚动、正文滚动与固定底栏;未保存、预检采用或执行收费操作。

功能块罗马序标补充

  • 公共 WorkspaceSectionHeading 增加可选 marker,默认不改变已有标题;以中性底面的罗马序标加强功能区边界。
  • 联合修订面板按可见功能块依次编号:来源与草案状态、正式内容与历史、完整草案、字段差异、可选原文依据、画面与相邻镜头预览、审核与采用,以及可选采用后预览。条件区域隐藏时无跳号,嵌套字段和说明不重复编号。
  • 只调整阅读分组,不改变保存、预检、采用、来源保护及任何收费动作。规则已补入 AGENTS。
  • 根据后续反馈,编号功能块改用交替中性底面并去掉块间额外间距。每个同级功能区使用相同内边距,序标、标题保持一条左边线;草案及差异不再嵌套额外卡片缩进。块内表单仍保留必要间距。
  • 最终相关 Vitest 4套34项、TypeScript、Oxlint/ESLint和差异检查通过。Chrome 桌面与390×844已确认序标及同级标题对齐、交替底面连续展示、正文和固定底栏正常;只读验收,未生成或保存正式结果。

原摄影修订模式同步

  • ShotDerivedReview.vue 原模式也使用公共编号与斑马纹布局:正式分镜审核、正式摄影/图片/历史、可选差异及采用结果、已保存草案、可选视线范围和编辑、预览确认。按实际可见块连续编号,标题统一左对齐,块间无额外空白。
  • 将来源刷新、历史与原图片归为一个功能区;保留原摄影修订、主体视线、前镜场景沿用、导入、草案保存、免费预览和正式采用全部入口。预览按钮改为就地宽度,避免被拉伸成整条灰色区域。
  • Mock 摄影修订测试补充可见块连续编号与差异出现后的编号核对,原保存/采用/冲突保护继续通过。相关4套78项、TypeScript、Oxlint/ESLint、格式及差异检查通过。
  • 本地 Chrome 桌面及390×844只读验证正式历史与过期草案、预览禁用、内容滚动和固定底栏;未点击保存、生成、审核或采用。

手机底部面板与弹窗头尾

  • AppDialog.vue 和 AppDrawer.vue 在639px及以下统一使用直角底部面板。普通弹窗按内容自然高度,长表单及原全屏抽屉保留独立正文滚动和固定底栏。桌面继续使用原居中/全屏布局;没有新增Vant依赖或重复业务页面。
  • 新增 MobilePanelHandle.vue:仅顶部44px手柄区域捕获指针,支持跟随下拉、短拖回位、距离/速度关闭、上拉阻尼、系统取消和多触点保护。提交锁在拖动中或离场过程中生效时均取消关闭;关闭、重新打开和切换桌面布局清理旧手势。保留关闭按钮、键盘和读屏入口,尊重减少动效偏好。
  • 新增 useMobileViewport.ts 同步公共手机断点;新增 usePanelScrollState.ts 监听实际正文滚动。header默认无阴影,正文离开顶部后显示更淡的主题阴影,回顶和重新打开时清除;footer始终无阴影。PC和移动端头尾均不增加border,面板顶部不增加圆角。
  • admin.css 统一手机底栏:单按钮整行铺满,多个按钮等宽填满可用行宽,只保留统一间隙;长标签按实际内容换行。PC底栏排版保留。
  • 新增 tests/components/ui/mobile-panel.test.ts,覆盖轻触/短拖、明确下拉/甩动、兼容click误关闭防护、取消/丢失捕获、多触点、提交中和离场中加锁、公共组件键盘关闭、切回桌面、正文阴影和重新打开状态。
  • 新增 tests/browser/mobile-panels.html、mobile-panels.ts,仅内存模拟,所有fetch均拒绝。Chrome原生操作已验证440×956手机模拟视口中的两类面板、横条关闭与回位、提交锁、长正文滚动、单/多按钮底栏、直角及淡header阴影;同时核对PC原布局与无分隔线。没有使用Playwright或执行任何真实业务请求。
  • 前一次全量959项检查只有新增圆角违反既有扁平主题约束,已将面板及横条改为直角;相关主题、公共布局和手势回归56项通过。未放宽原主题检查规则。
  • 最终全量Vitest:125套961项通过;TypeScript、Vite build、修改范围Oxlint/ESLint、格式及差异检查通过。
  • 最新移动交互、头尾阴影和底栏要求已写入AGENTS。代码在前端根目录dev交付,实际提交号及远端状态以Git记录为准。
  • 公共header标题在PC及手机端统一单行省略,完整名称保留在原文、可访问名称和title提示中,关闭与说明入口保持可见;公共footer按钮高度按原组件尺寸统一增加20%。Chrome已核对两类弹层和两种视口,相关检查通过。