diff --git a/AGENTS.md b/AGENTS.md index 7e382c8..ba00b32 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -43,14 +43,22 @@ - 导航只显示名称。禁用原因放到可通过悬停和键盘聚焦查看的提示里,菜单行高保持一致。 - 问题提示放在能直接处理它的页面。素材图库不常驻展示下游镜头的生产警告和列表;从镜头主动定位素材时,只保留定位所需的信息与返回入口。普通浏览不发仅供该定位使用的全项目检查请求。 - 费用、覆盖、删除、适用范围与待审核限制必须保留并说清楚,不能为了简化文字改变功能含义。无法确认的能力不要用容易误解的描述代替。 -- 必要的原始技术数据放在默认收起的“高级详情”或导出结果中,日常操作先展示中文摘要。同一弹窗的操作统一放入公共 `footer`,避免正文操作与默认关闭按钮重复。 +- 日常操作先展示中文业务摘要;排查用的原始技术数据保留在数据层、专用排查入口或显式导出中,不能仅以“高级详情”为名把整段接口响应搬进普通弹窗。同一弹窗的操作统一放入公共 `footer`,避免正文操作与默认关闭按钮重复。 +- 所有页面、弹窗和抽屉首屏优先显示当前结果、待处理事项、主要输入和操作;流程解释与历史长说明放到 info、二级详情或默认收起的区域。普通详情也只展示明确需要的中文业务字段,不展示无助于决策的接口对象、整段 JSON、内部字段、任务编号或指纹;不能因为接口返回某个字段就把它加入界面。费用、来源冲突、覆盖和正式采用限制仍须在操作处清楚显示。 +- 重要内容较多时复用主题中的中性背景分组,区分当前事实、规划和操作风险;背景不能暗示尚未取得的审核通过。 ### 全屏抽屉与关闭入口 - 新建剧本、项目全局配置、拆解设置、拆解问题等已确认使用全屏的界面统一复用 `AppDrawer`。后续同类复杂表单、设置和问题处理界面默认沿用全屏抽屉;简短确认或轻量提示仍可使用 `AppDialog`。 - 全屏必须同时覆盖容器与正文:内容使用可用的完整宽度,不能只把外壳放大而保留原弹窗的固定宽度或居中最大宽度。 - 标题区和底部操作区固定,只有正文独立滚动。长内容不能把关闭或提交按钮挤出视口,也不能产生页面与抽屉重复滚动。 +- PC和移动端弹窗、抽屉的头部与底部均不使用border分隔正文;footer不使用box-shadow,header默认也不显示阴影,仅当正文向下滚动、顶部有内容被遮挡时显示更淡的主题阴影,回到顶部即隐藏。监听实际正文滚动容器,重新打开时清除旧状态;保持固定区域的背景和堆叠顺序,阴影不能遮挡正文或交互入口。 +- 手机端公共弹窗与全屏抽屉统一复用底部浮动面板,顶部横条支持按住向下拖动关闭,仅手柄区域接收关闭手势,正文正常滚动。轻触、短拖及取消手势保持展开;保留关闭按钮和键盘入口,提交期间包括拖动在内的关闭方式均须锁定,切换布局或重新打开时清除旧手势状态。 +- 底部浮动面板沿用项目直角样式,顶部不增加border-radius;只有正文滚动后的header使用淡阴影,footer保持无阴影、无分隔边框。 +- 移动端弹窗和抽屉的footer按钮需占满内容宽度:单个按钮铺满整行,多个按钮等宽分配并铺满每一行,中间仅保留统一的小间隙;长标签宽度不足时允许按钮换行。复用公共底栏样式,保留按钮文字及提交锁;PC端保持原底栏布局。 +- PC和移动端公共弹层footer按钮高度统一为组件原始 `--n-height` 的1.2倍,字号保持原样;复用公共CSS,不在业务页面再次叠加放大。 - 抽屉标题、说明、正文和底栏左右边界统一。复用公共抽屉的桌面、移动端内边距;正文 `padding-top` 保持为 `0`,不要额外叠加顶部空白。 +- PC和移动端弹窗、抽屉的header标题最多显示一行,超出可用宽度以省略号显示;复用 `app-panel-title`,完整标题保留在原文、可访问名称及title提示中。标题可收缩,状态图标、说明入口和关闭按钮保持可见;副标题与正文继续按各自规则展示。 - 所有弹窗和抽屉底部至少保留一个可见的“关闭”或“取消”按钮,不能只有右上角叉号。底部操作使用公共组件的 `footer` 插槽,避免正文末尾再放一套底栏或重复关闭按钮。 - 关闭、取消统一为灰色底面和中性文字的普通按钮,不使用绿色主按钮;右上角关闭图标的尺寸、底色与交互反馈也统一复用公共样式。 - 提交期间按真实业务状态防止重复操作及意外关闭;普通只读加载不能无故阻止用户关闭。关闭、切换或定位后,不回填已失效的异步结果。 @@ -58,6 +66,8 @@ ### 布局、说明与间距 - 页面外边距、模块间距优先复用 `--app-content-padding`、`--app-content-gap`;表单与抽屉内部复用对应公共组件的间距,不在各页面随意添加不同数值。 +- 区分功能组间距与组内间距:未使用交替底面的独立功能组可复用 `workspace-section-stack-spacious`(两倍模块间距),组内复用普通模块间距;字段之间使用 `workspace-form-stack` 的16px,标签到控件为8px。同类区域只能使用同一套间距,不叠加默认 margin、padding 和 gap,也不把每个按钮都当成独立大分区。 +- 同级折叠列表复用 `workspace-collapse`,收起时统一44px行高;首项、后续项及相邻折叠组不能因组件默认样式出现忽大忽小的空白。展开正文统一内边距,仍保留完整内容和输入状态。 - **表单字段间距为强制要求**:页面、弹窗、抽屉中的标签不能紧贴输入框、下拉框或选择组;自定义字段默认使用 `--app-field-label-gap`(8px),相邻字段默认使用 `--app-field-gap`(16px)。紧凑布局和移动端也不得取消这些必要间距,除非用户明确要求调整。 - 自定义的“标签 + 控件”优先复用 `src/styles/admin.css` 中的 `workspace-form-field`,使用真实的纵向 Flex/Grid `gap`;成熟表单继续复用 `AppForm` / `NFormItem` 的公共排版。禁止仅给行内 `span` 套 `space-y-*` 或垂直 margin 后,就认定标签间距已经生效。 - 修改表单布局时必须核对同模块的全部同类字段,保证同排标签、控件分别对齐;图片与表单并排时,图片标题和字段标签必须复用同一纵向间距值,图片与首排控件的上沿必须对齐;在本地 Chrome 检查桌面、窄屏及必要的加载/校验状态,确认实际留白生效后才算完成。 @@ -68,6 +78,28 @@ - 行内按钮按输入控件本身的基线对齐,不能按包含标签的整块区域垂直居中。动态例外行中的移除按钮与输入框底部对齐,使用 `Trash2` 等现有图标,不再显示“移除”文字,并提供可访问名称。 - 项目生成配置等普通表单分区不铺大块背景色,使用标题、说明和统一间距组织;常规错误沿用中性底色,只有明确的严重错误或通过检查的成功状态才使用对应状态底色。 +### 长文本与多功能块布局(默认模板) + +- **适用范围**:后续新增或优化页面、弹窗、抽屉时,遇到多段长文本与状态、历史、编辑、预览或确认操作混排,默认沿用当前摄影草案审核的布局;适用于全项目同类界面,不限于分镜或摄影功能。简单提示、短表单及单一剧本正文继续使用适合其内容的简洁布局。 +- **先按功能分组**:将概况、正式内容与历史、编辑、差异、预览和确认等实际存在的功能分别组织成块。首屏突出主要信息与操作,历史和次要说明按需展开;相关按钮、状态和说明归入对应功能块。 +- **统一序标标题**:独立功能块使用“罗马数字 I、II、III… + 标题”,复用 `WorkspaceSectionHeading` 的 `marker`。按可见块依次编号,条件区域隐藏时不跳号;字段、普通说明及嵌套详情不重复编号。序标仅表示阅读顺序,执行进度、质量与费用状态仍分别表达。 +- **统一交替底色**:外层复用 `workspace-section-stack workspace-numbered-sections`,每块复用 `workspace-numbered-section`。两种中性底色均须与页面或弹窗背景区分,同时保持输入控件清晰可辨。功能块连续排列,块间不留额外 gap、margin 或装饰线,以底色表达边界。 +- **同级严格对齐**:所有功能块使用相同内边距,序标、标题和同类正文各自共用左边线。标题与正文放在同一个功能块内,不因某块另套卡片而单独缩进。桌面块内边距20px,手机复用 `--app-content-padding`;正文避免再嵌套一层同色背景和重复内边距。 +- **块内保持阅读间距**:去掉的是功能块之间的额外空白。组内说明与操作沿用公共模块间距;字段复用 `workspace-form-stack` 的16px,标签到控件保留8px。折叠列表复用 `workspace-collapse`,统一44px收起行高及展开正文间距。普通辅助按钮保持就地宽度,避免拉伸为整条灰色区域。 +- **控制长文行宽与高度**:关联的长文编辑字段可在宽屏分栏、窄屏单列,标签和控件上沿对齐;列内字段间距不受另一列内容高度影响。复用 `workspace-prose-input` 的字号和行距、有界自动高度及必要的内部滚动,完整原文保持可查看、可编辑,不裁剪或改写创作内容。 +- **复用与验收**:优先参考 `ShotDerivedReview.vue`、`JointDraftReviewPanel.vue` 及公共样式增量实现。保留原有历史、来源、费用和确认条件;在本地 Chrome 核对桌面、手机、长内容、折叠展开、序号变化、标题对齐、交替底色、内容滚动和固定底栏后交付。 + +### 图片列表与详情浮层 + +- 图片列表使用可用内容宽度,复用公共网格;不能因固定最大宽度在大屏右侧留下整片可利用的空白。图片以紧凑缩略图展示,少量图片不无限拉伸成巨图;窄屏按可用宽度调整列数。 +- 同一图片列表的卡片高度一致,操作区对齐。长名称、模型名、历史错误和说明不能撑高某一项;完整信息仍可通过详情查看,不能为了等高截掉必要内容。 +- 图片卡片的信息顺序统一为“图片 → 状态标签 → 图片名称 → 日期时间 → 操作”。名称必须可识别,不能只显示日期;无独立名称时可使用镜头名称和稳定展示序号,不覆盖用户名称或写回资产。 +- 标签放在名称上方,标签、名称和操作之间保持紧凑且一致的间距;不要为未出现的第二行标签预留空白。卡片等高依靠网格与操作区对齐,不依靠给短内容增加大块空白。 +- 列表先展示主要状态与名称;尺寸、型号、完整历史、可修复错误和技术说明放在 info 或二级详情。影响当前执行的费用风险、来源冲突和采用限制仍在对应操作处显示,不能全部藏进图标。 +- 弹窗、抽屉和滚动区域中的提示及详情浮层必须避开容器裁切:优先复用公共组件,Naive UI `NPopover` 明确使用 `:to="true"` 挂到页面浮层,并启用边缘自动翻转;不能只提高 `z-index` 掩盖父容器的 `overflow` 问题。 +- 浮层宽度不得超出当前视口,计入内边距并保留屏幕边距。长模型名、连续字符和长说明必须换行;长详情限制高度并允许内部滚动,不能横向裁切正文或遮住必要操作。 +- 同一按钮的详情打开后,停用重复的悬浮操作说明,避免提示覆盖详情标题或正文;保留按钮的可访问名称与键盘操作。信息浮层不能触发生成、保存、审核或采用。 + ### 按钮、图标与状态颜色 - 绿色背景、白色文字用于保存、提交、开始生成等主要执行操作;关闭、取消和普通辅助操作使用中性样式。 @@ -86,6 +118,7 @@ ### 设置、问题处理与任务进度 - 拆解设置与问题处理分开:设置界面负责模块选择、分组预览、启动拆解、候选确认与提交;问题界面负责错误查看、分镜定位、人工修订、读取修复清单及阶段恢复。 +- 普通目录浏览不增加无必要的勾选框;多选只在用户主动进入的批量操作中提供。进入页面或刷新时不自动弹出生成配置,不自动提交生成;配置由明确的操作入口打开。 - 质量规则确认以服务端 revision、fingerprint、confirmed 和独立 confirm 接口为准,不能用 LocalStorage 或格式版本 policy.version 代替。规则保存携带 expectedRevision,拆解启动携带本次已确认修订;候选提交预检查必须包含 qualityPolicyMatches。 - 首次拆解前只确认表现方式、动作许可和自定义规则,不显示精确动作例外的空白编辑行。已有例外可只读核对,隐藏输入不能清空已有规则或在保存时覆盖后来新增的例外。 - 新增精确动作例外统一放在拆解后的问题修订中,从当前版本的真实冲突证据自动带入角色、部位或物品及动作,用户填写允许原因。证据缺失时不能猜测或用其他镜头代替;按后端实际范围说明影响,保存例外不能直接标记质量通过。 @@ -112,6 +145,7 @@ - 页面模块之间复用公共间距;按钮、标题和辅助说明须有清晰留白。已有相邻页面使用骨架屏时,同类入口也应在项目加载和正文加载阶段预留相同结构。 - 骨架与图片占位默认静态显示,避免闪动。图库按真实卡片结构分别预留图片、文字和操作位置。 - 图片卡片在请求图片前就预留画面区域,优先用已有宽高,缺少宽高时使用稳定比例。检查慢速、加载失败和无图时卡片都不会塌陷。 +- 图片列表及浮层验收需覆盖最左、最右和底部卡片、少量与多行图片、长名称和模型名、长错误、桌面与手机窄屏;确认详情不会被弹窗或滚动容器裁切,边缘避让、换行、滚动和提示互斥实际生效。 - 界面验收不得为了制造状态而触发真实付费生成、覆盖正式结果或提交用户数据;使用现有状态、只读操作和合适的自动化测试验证。 - 测试与检查按改动范围执行;纯文档变更无需启动页面或重复完整构建。报告时区分自动化检查与真实浏览器验证,并明确未完成项,不把尝试操作当作验收通过。 diff --git a/docs/audits/storyboard-ui-information-hierarchy-2026-11-18.md b/docs/audits/storyboard-ui-information-hierarchy-2026-11-18.md new file mode 100644 index 0000000..3678105 --- /dev/null +++ b/docs/audits/storyboard-ui-information-hierarchy-2026-11-18.md @@ -0,0 +1,116 @@ +# 分镜页面信息层级优化交接 + +## 范围与边界 + +- 在前端根目录 `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已核对两类弹层和两种视口,相关检查通过。 diff --git a/src/components/ui/AppDialog.vue b/src/components/ui/AppDialog.vue index 4757256..67614c2 100644 --- a/src/components/ui/AppDialog.vue +++ b/src/components/ui/AppDialog.vue @@ -2,6 +2,10 @@ import { NButton, NModal, NScrollbar, useThemeVars } from 'naive-ui' import { CircleAlert, CircleCheck, CircleX } from '@lucide/vue' import { onBeforeUnmount, onMounted, ref, watch } from 'vue' +import FieldLabel from './FieldLabel.vue' +import MobilePanelHandle from './MobilePanelHandle.vue' +import { useMobileViewport } from '../../composables/useMobileViewport' +import { usePanelScrollState } from '../../composables/usePanelScrollState' /** 公共弹窗的标题、说明、操作状态和宽度。 */ withDefaults( @@ -10,6 +14,8 @@ withDefaults( title: string /** 可选的简短标题补充,尽量一句话;完整说明与操作影响应放入默认正文插槽。 */ description?: string + /** 操作流程说明放入信息图标,业务状态说明插槽仍直接显示。 */ + descriptionAsInfo?: boolean /** 展示语义状态;默认保持中性,警告、成功和错误仅在标题旁显示对应图标。 */ status?: 'default' | 'warning' | 'success' | 'error' /** 提交期间锁定关闭操作。 */ @@ -27,6 +33,10 @@ const themeVars = useThemeVars() const emit = defineEmits<{ closed: [] }>() /** 弹窗显隐状态,关闭行为由 Naive 管理。 */ const open = defineModel('open', { default: false }) +/** 手机端使用底部面板,桌面继续采用原居中弹窗。 */ +const mobile = useMobileViewport() +/** 正文离开顶部时才显示标题区阴影,底栏始终保持平面。 */ +const { bodyScrolled, onBodyScroll } = usePanelScrollState(open) /** 正文容器隔离子元素外边距,保留完整的自然内容高度。 */ const bodyContent = ref(null) /** 正文最大可用高度;未挂载时不限制自然高度。 */ @@ -46,7 +56,7 @@ function updateBodyHeight() { maxBodyHeight.value = Math.max( 0, (window.visualViewport?.height ?? window.innerHeight) - - 32 - + (mobile.value ? 12 : 32) - (header?.offsetHeight ?? 0) - (footer?.offsetHeight ?? 0) - (contentStyle ? parseFloat(contentStyle.paddingTop) + parseFloat(contentStyle.paddingBottom) : 0) - @@ -95,17 +105,22 @@ onBeforeUnmount(() => { :closable="!busy" :mask-closable="!busy" :close-on-esc="!busy" - :style="{ width: `${width ?? (wide ? 1040 : 600)}px` }" + :style="{ width: mobile ? '100vw' : `${width ?? (wide ? 1040 : 600)}px` }" class="app-dialog" - :class="{ 'app-dialog-title-only': !description && !$slots.description }" + :class="{ + 'app-dialog-title-only': !description && !$slots.description, + 'app-mobile-panel': mobile, + 'has-body-scroll': bodyScrolled + }" role="dialog" :aria-label="title" @after-leave="emit('closed')" >