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

117 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 分镜页面信息层级优化交接
## 范围与边界
- 在前端根目录 `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已核对两类弹层和两种视口,相关检查通过。