# 分镜页面信息层级优化交接 ## 范围与边界 - 在前端根目录 `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已核对两类弹层和两种视口,相关检查通过。