diff --git a/AGENTS.md b/AGENTS.md index 5347439..3d8e19f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -39,6 +39,9 @@ - 英文技术术语优先改成易懂的中文,例如 `Checkpoint` 用“保存记录”、`Storyboard` 用“分镜”、`Prompt` 用“画面描述”或“提示词”、`Thinking` 用“深度思考”。不要把内部字段名、错误码、任务标识直接作为主要说明。 - 接口返回的系统提示也需要在展示层转换为可读中文;错误详情只提取有助于操作的业务原因,不把调试对象、堆栈或整段原始数据直接输出给用户。原始错误和错误码保留在数据层,不改动业务判断依据。 - 只调整展示文案,不翻译或改写请求字段、枚举值、接口地址、用户创作的剧本与提示词正文、文件名、自定义名称或模型品牌。分类等内部值使用中文选项展示,提交仍保留真实取值。 +- 用短句直说结果和下一步。同一个意思只写一次;标题和按钮已说明用途时,删掉重复说明。提示一行能说清就不写成段落,必需的限制和费用信息要保留。 +- 导航只显示名称。禁用原因放到可通过悬停和键盘聚焦查看的提示里,菜单行高保持一致。 +- 问题提示放在能直接处理它的页面。素材图库不常驻展示下游镜头的生产警告和列表;从镜头主动定位素材时,只保留定位所需的信息与返回入口。普通浏览不发仅供该定位使用的全项目检查请求。 - 费用、覆盖、删除、适用范围与待审核限制必须保留并说清楚,不能为了简化文字改变功能含义。无法确认的能力不要用容易误解的描述代替。 - 必要的原始技术数据放在默认收起的“高级详情”或导出结果中,日常操作先展示中文摘要。同一弹窗的操作统一放入公共 `footer`,避免正文操作与默认关闭按钮重复。 @@ -56,17 +59,18 @@ - 页面外边距、模块间距优先复用 `--app-content-padding`、`--app-content-gap`;表单与抽屉内部复用对应公共组件的间距,不在各页面随意添加不同数值。 - 同级模块使用一致的标题、说明、字段间距和上下留白。需要说明时采用“模块标题 + 一句简短说明”,例如画布设置、图片配置、视频配置、动作与物理规则;优先复用 `WorkspaceSectionHeading`。 +- 页面、弹窗和抽屉中的同级模块共用左右边界。普通分区直接对齐;需要突出一组内容时,优先用已有的中性背景包住整组内容。背景外沿与相邻模块对齐,组内使用统一内边距,避免透明容器单独缩进。 - 新建剧本等长表单默认每个字段单独占一行并铺满内容宽度;不因改成全屏就自动把原来的字段挤成两列。 - 图片、视频等已有明确分组的并列模块可以保留协调的分栏,窄屏改为单列;同一行的标签、控件及操作必须分别对齐,不能因说明或校验消息出现而上下错位。 - 行内按钮按输入控件本身的基线对齐,不能按包含标签的整块区域垂直居中。动态例外行中的移除按钮与输入框底部对齐,使用 `Trash2` 等现有图标,不再显示“移除”文字,并提供可访问名称。 -- 项目生成配置等普通表单分区不铺大块背景色,使用标题、说明和统一间距组织;错误、成功等有明确状态含义的提示区域才使用对应柔和底色。 +- 项目生成配置等普通表单分区不铺大块背景色,使用标题、说明和统一间距组织;常规错误沿用中性底色,只有明确的严重错误或通过检查的成功状态才使用对应状态底色。 ### 按钮、图标与状态颜色 - 绿色背景、白色文字用于保存、提交、开始生成等主要执行操作;关闭、取消和普通辅助操作使用中性样式。 -- 错误、校验未通过、需要修复的区域使用柔和浅红背景,深色主题使用对应柔和深红底面。禁止使用上下两条绿色横线表示错误或待修复状态,也不能借用绿色选中态来标记错误。 -- 普通镜头定位仅使用中性提示,不能因点击“定位镜头”就标红;只有从当前明确问题定位时才使用错误底色,正文刷新后清除旧定位标记。 -- 错误入口按钮的文字、图标和焦点提示与红色底面保持一致;默认、悬停、按下、聚焦各状态都不能被主题主色覆盖成绿色。保留清晰的键盘焦点提示。 +- 普通请求失败、表单校验、审核未通过和可修复问题默认使用中性底面,配合短文字、图标或细线提示。红色底面只用于明确需要立即关注的严重错误,例如任务中断且可能重复计费。保留深浅主题对应的柔和状态色。 +- 普通镜头定位使用中性提示。从明确问题定位时,可加细线标记;正文刷新后清除旧标记。 +- 错误入口按钮使用中性底面,文字、图标和焦点保留错误语义。默认、悬停、按下和聚焦时保持清晰的键盘焦点与状态反馈。 - 只有执行完成且结果明确通过校验时,成功任务区域才使用柔和浅绿背景。执行结束但校验失败、质量待审或结果未确认时,不能显示成绿色成功状态,也不能用满格绿色进度条暗示业务成功。 - 卡片内的定位、复查、修订和历史入口使用带图标、独立中性底面的按钮,不添加边框,不能与说明文字混在一起;复用 `workspace-action-button` / `workspace-action-group`,不把辅助操作改成绿色主按钮。 - 工具栏中相邻按钮保持一致的高度、内边距、图标大小和间距。问题入口使用图标加文字;分镜结构校验失败时文案为“分镜校验未通过”,其他问题按真实类型命名。 @@ -102,6 +106,9 @@ - 涉及页面或交互的改动,必须在已有本地 Chrome 标签页使用 `localhost` 验证后才算完成,不能只根据代码、构建或 DOM 测试声称布局通过。 - 验证本次改动涉及的桌面、移动端、长内容滚动、固定底栏及必要的加载、错误、成功状态;检查普通、悬停和键盘聚焦时的颜色、对齐与可访问名称。 +- 页面模块之间复用公共间距;按钮、标题和辅助说明须有清晰留白。已有相邻页面使用骨架屏时,同类入口也应在项目加载和正文加载阶段预留相同结构。 +- 骨架与图片占位默认静态显示,避免闪动。图库按真实卡片结构分别预留图片、文字和操作位置。 +- 图片卡片在请求图片前就预留画面区域,优先用已有宽高,缺少宽高时使用稳定比例。检查慢速、加载失败和无图时卡片都不会塌陷。 - 界面验收不得为了制造状态而触发真实付费生成、覆盖正式结果或提交用户数据;使用现有状态、只读操作和合适的自动化测试验证。 - 测试与检查按改动范围执行;纯文档变更无需启动页面或重复完整构建。报告时区分自动化检查与真实浏览器验证,并明确未完成项,不把尝试操作当作验收通过。 diff --git a/src/App.vue b/src/App.vue index 9800e90..0665a5a 100644 --- a/src/App.vue +++ b/src/App.vue @@ -9,6 +9,7 @@ import { NLayout, NLayoutHeader, NMenu, + NTooltip, NScrollbar, zhCN, dateZhCN, @@ -120,6 +121,9 @@ function createMenuIcon(icon: typeof FolderOpen) { return () => h('span', { class: 'admin-menu-icon' }, [h(icon, { size: NAV_ICON_SIZE })]) } +/** 禁用原因由同一个提示响应鼠标和键盘,菜单不额外占行。 */ +const blockedMenuHint = ref(null) + /** 菜单链接使用 RouterLink,保留新标签打开和浏览器导航行为。 */ const menuOptions = computed(() => { return [ @@ -147,16 +151,33 @@ const menuOptions = computed(() => { label: () => disabled ? h( - 'span', + NTooltip, { - class: 'admin-menu-label admin-menu-label-blocked', - title: reason, - 'aria-label': `${label},${reason}`, - 'aria-disabled': 'true' + placement: 'right', + trigger: 'manual', + show: blockedMenuHint.value === target }, - sectionAccess - ? [h('span', label), h('small', { class: 'admin-menu-reason' }, reason)] - : label + { + trigger: () => + h( + 'span', + { + class: 'admin-menu-label', + tabindex: 0, + onMouseenter: () => (blockedMenuHint.value = target), + onMouseleave: () => (blockedMenuHint.value = null), + onFocus: () => (blockedMenuHint.value = target), + onBlur: () => (blockedMenuHint.value = null), + onKeydown: (event: KeyboardEvent) => { + if (event.key === 'Escape') blockedMenuHint.value = null + }, + 'aria-label': `${label},${reason}`, + 'aria-disabled': 'true' + }, + label + ), + default: () => reason + } ) : h(RouterLink, { to: target }, () => h('span', { class: 'admin-menu-label' }, label) @@ -275,7 +296,7 @@ const menuOptions = computed(() => {
- +
服务地址
@@ -373,20 +394,6 @@ const menuOptions = computed(() => { color 0.18s ease, opacity 0.18s ease; } -/* 保留菜单行高,在禁用项名称下展示当前步骤的简短原因。 */ -.admin-menu-label-blocked { - display: block; - line-height: 16px; - min-width: 0; -} -.admin-menu-reason { - display: block; - font-size: 10px; - line-height: 14px; - overflow: hidden; - text-overflow: ellipsis; - white-space: nowrap; -} .admin-brand { @apply flex shrink-0 items-center gap-3 h-[74px] overflow-hidden py-0 px-5 text-ink whitespace-nowrap; min-width: var(--admin-sider-expanded); diff --git a/src/components/ui/ContextNotice.vue b/src/components/ui/ContextNotice.vue index 4b8fedd..42bbf9d 100644 --- a/src/components/ui/ContextNotice.vue +++ b/src/components/ui/ContextNotice.vue @@ -12,15 +12,20 @@ withDefaults( title?: string /** 重要注意事项复用项目主题底面、图标与醒目标题,普通说明保持原有紧凑样式。 */ emphasized?: boolean + /** 仅在明确的严重错误中使用警示底色。 */ + critical?: boolean }>(), - { type: 'info', showIcon: true, emphasized: false } + { type: 'info', showIcon: true, emphasized: false, critical: false } ) 删除素材 - 删除后图片文件也会移除。正在用于视觉风格的素材需要先取消引用,才能删除。 + 删除会移除图片文件。风格参考图需先取消引用。
取消 diff --git a/src/features/project-assets/ProjectAssetsPage.vue b/src/features/project-assets/ProjectAssetsPage.vue index c5fba4d..b329312 100644 --- a/src/features/project-assets/ProjectAssetsPage.vue +++ b/src/features/project-assets/ProjectAssetsPage.vue @@ -291,7 +291,7 @@ watch(projectId, () => { 删除 - 删除后图片文件也会移除。正在用于视觉风格的素材需要先取消引用,才能删除。 + 删除会移除图片文件。风格参考图需先取消引用。
@@ -310,12 +310,7 @@ watch(projectId, () => {

- + { - + = { overall: '综合', character: '人物', scene: '场景', + 'scene-layout': '场景布局', prop: '道具', reference: '参考素材', 'visual-style': '视觉风格', @@ -17,7 +18,7 @@ const labels: Record = { * @returns 分类展示名称 */ export function assetCategoryLabel(value: string): string { - return labels[value] ?? value + return Object.hasOwn(labels, value) ? labels[value]! : value } /** diff --git a/src/features/projects/ProjectLayout.vue b/src/features/projects/ProjectLayout.vue index 3c54f60..fb7d2ca 100644 --- a/src/features/projects/ProjectLayout.vue +++ b/src/features/projects/ProjectLayout.vue @@ -7,7 +7,7 @@ import { useRoute, useRouter } from 'vue-router' import { Settings2 } from '@lucide/vue' import { NScrollbar, NButton, NPageHeader, NSpin, NEllipsis, NSkeleton } from 'naive-ui' import { EmptyState, WorkspaceRefreshButton } from '../../components/ui' -import { projectContextKey, useProjectData } from './context' +import { projectContextKey, useProjectData, type CheckpointWorkflow } from './context' import { getOperation, operationErrorText } from '../workflows/operations' import { projectAccessKey, projectSectionFromPath, type ProjectAccess, type ProjectSectionAccess } from './access' import { useProjectStageAccess } from './useProjectStageAccess' @@ -22,12 +22,13 @@ import type { ProjectSettingsTab } from '../generation-config/context' import CreateDramaSkeleton from '../create-drama/CreateDramaSkeleton.vue' import BreakdownSkeleton from '../breakdown/BreakdownSkeleton.vue' import VisualStyleSkeleton from '../visual-style/VisualStyleSkeleton.vue' +import ProjectWorkspaceSkeleton from './components/ProjectWorkspaceSkeleton.vue' import SubjectIdentitySkeleton from '../subject-identity/SubjectIdentitySkeleton.vue' /** 项目标题只保留名称;下游工作区在剧本完成前不挂载,直接链接也无法越过限制。 */ const route = useRoute() const router = useRouter() -const id = computed(() => String(route.params.projectId)) +const id = computed(() => String(route.params.projectId ?? '')) const context = useProjectData(id) provide(projectContextKey, context) /** 项目全局配置保存后更新已挂载生成表单。 */ @@ -68,10 +69,43 @@ watch(id, () => { generationRevision.value = 0 }) const operation = computed(() => getOperation(id.value)) +/** + * 跨页面观察真实终态并刷新对应数据,不因读取历史终态重复刷新。 + * @param observer 已挂载的后台观察器 + * @param workflow 需要刷新的正文所属工作流 + */ +function refreshOnTerminal(observer: ReturnType, workflow: CheckpointWorkflow | null) { + watch( + () => observer.query.data.value, + (record, previous) => { + if ( + !record || + record.projectId !== id.value || + previous?.id !== record.id || + !['pending', 'running'].includes(previous.status) || + !['completed', 'failed'].includes(record.status) + ) + return + void context.refreshWorkflow(workflow, record.projectId, record.id + ':' + record.status) + if (workflow === 'create-drama' && currentSection.value !== 'create-drama') { + void context.refreshProject() + void context.refreshStageReadiness() + } else if ( + workflow === 'breakdown' && + currentSection.value !== 'breakdown' && + currentSection.value !== 'storyboard' + ) { + void context.refreshStageReadiness() + } + } + ) +} + /** 从服务端发现创作任务,刷新或换浏览器后也能继续观察故事规划等节点。 */ const createDramaExecution = useWorkflowExecution(id, 'create-drama', { discover: true }) +refreshOnTerminal(createDramaExecution, 'create-drama') /** 项目内跨页面继续观察首帧后台任务,维持活动锁并在真实终态后释放。 */ -useWorkflowExecution(id, 'keyframe-quality') +refreshOnTerminal(useWorkflowExecution(id, 'keyframe-quality'), null) /** 派生设计从服务端发现新任务;其它既有入口继续观察已知任务,保持项目活动锁。 */ for (const workflowName of [ 'storyboard-direction', @@ -80,12 +114,16 @@ for (const workflowName of [ 'keyframe-generation', 'video-quality' ]) { - useWorkflowExecution(id, workflowName, { - discover: ['storyboard-direction', 'storyboard-visual-state'].includes(workflowName) - }) + refreshOnTerminal( + useWorkflowExecution(id, workflowName, { + discover: ['storyboard-direction', 'storyboard-visual-state'].includes(workflowName) + }), + null + ) } /** 即使直接刷新到生产页,也按真实重生成任务恢复旧剧情快照的失效标记。 */ const breakdownExecution = useWorkflowExecution(id, 'breakdown', { discover: true }) +refreshOnTerminal(breakdownExecution, 'breakdown') /** 只有后端确认有效的新分镜才废弃旧正文,不推测未完成或失败任务。 */ watchEffect(() => { const record = breakdownExecution.query.data.value @@ -105,12 +143,6 @@ watchEffect(() => { ) invalidateEpisodeSource(record.projectId, number) }) -watchEffect(() => { - const status = createDramaExecution.query.data.value?.status - if ((status === 'completed' || status === 'failed') && context.project.value?.status === 'generating') { - void context.refresh() - } -}) const stageAccess = useProjectStageAccess(id, context.stageReadiness) const complete = stageAccess.scriptReady /** 当前路由所属的制作步骤;项目素材不是制作步骤。 */ @@ -127,7 +159,14 @@ const currentAccess = computed(() => { }) const isCreation = computed(() => currentSection.value === 'create-drama') /** 各工作区共用首次读取判定;切换项目显示占位,刷新已有项目保留内容。 */ -const isProjectInitialLoading = computed(() => context.loading.value && context.project.value?.id !== id.value) +const isProjectInitialLoading = computed( + () => + (context.projectQuery.loading.value && !context.project.value) || + (!isCreation.value && + !isProjectAssets.value && + context.readinessQuery.loading.value && + !context.stageReadiness.value) +) type OperationGuide = { title: string description: string @@ -295,7 +334,9 @@ onScopeDispose(() => { :key="id" :project-id="id" :disabled="!!context.error.value" + :can-open-storyboard="stageAccess.sections.value.storyboard.enabled" @changed="context.refresh()" + @open-storyboard="router.push(`/projects/${id}/storyboard`)" /> {
{ + +
diff --git a/src/features/projects/api.ts b/src/features/projects/api.ts index 7a902cb..a0823e8 100644 --- a/src/features/projects/api.ts +++ b/src/features/projects/api.ts @@ -1,5 +1,5 @@ import { request, optionalResource } from '../../lib/http' -import type { Checkpoint } from '../workflows/types' +import type { Checkpoint, CheckpointSummary } from '../workflows/types' import type { WorkflowExecutionStart } from '../workflows/execution.types' import type { CreateProjectInput, @@ -71,8 +71,57 @@ export const projectsApi = { request<{ id: string; deleted: boolean }>(`/projects/${encodeURIComponent(id)}`, { method: 'DELETE' }), state: (id: string, signal?: AbortSignal) => optionalResource(request(`/projects/${encodeURIComponent(id)}/state`, { signal })), - checkpoints: (id: string, signal?: AbortSignal) => - request(`/projects/${encodeURIComponent(id)}/checkpoints`, { signal }), + /** + * 读取每个工作流最新的执行状态,供导航与操作门禁使用。 + * @param id 当前项目 + * @param signal 请求取消信号 + * @returns 最新保存记录摘要 + */ + async checkpointSummaries(id: string, signal?: AbortSignal) { + const rows = await request( + `/projects/${encodeURIComponent(id)}/checkpoints?view=summary`, + { signal } + ) + if ( + !Array.isArray(rows) || + rows.some( + row => + !row?.workflowName || + !row.checkpointId || + !row.createdAt || + !row.updatedAt || + !row.state || + typeof row.state !== 'object' || + Array.isArray(row.state) || + Object.keys(row.state).some(key => key !== 'workflowExecution') || + (row.state.workflowExecution !== undefined && + typeof row.state.workflowExecution?.status !== 'string') + ) || + new Set(rows.map(row => row.workflowName)).size !== rows.length + ) + throw new Error('任务摘要无法核对,请刷新后再试。') + return rows + }, + /** + * 读取完整记录,页面按实际需要指定工作流。 + * @param id 当前项目 + * @param signal 请求取消信号 + * @param workflowName 完整记录所属的工作流 + * @returns 保留历史顺序及来源信息的完整记录 + */ + async checkpoints(id: string, signal?: AbortSignal, workflowName?: string) { + const rows = await request( + `/projects/${encodeURIComponent(id)}/checkpoints` + + (workflowName === undefined ? '' : `?${new URLSearchParams({ workflowName })}`), + { signal } + ) + if ( + !Array.isArray(rows) || + (workflowName !== undefined && rows.some(row => row?.workflowName !== workflowName)) + ) + throw new Error('工作流记录无法核对,请刷新后再试。') + return rows + }, /** * 用户确认后恢复创作;改写明确携带服务端要求的确认标记。 * @param id 当前项目编号 diff --git a/src/features/projects/components/CreateProjectDialog.vue b/src/features/projects/components/CreateProjectDialog.vue index e1fde7f..b0f74e9 100644 --- a/src/features/projects/components/CreateProjectDialog.vue +++ b/src/features/projects/components/CreateProjectDialog.vue @@ -134,13 +134,7 @@ const rules = computed(() => ({