From c4b43b97251aa9ad68004baaffadd2b5359c66d4 Mon Sep 17 00:00:00 2001 From: GJ Date: Sat, 17 Oct 2026 22:09:28 +0800 Subject: [PATCH] =?UTF-8?q?feat(short-drama-agent-front):=20=E5=AE=8C?= =?UTF-8?q?=E5=96=84=E8=B4=A8=E9=87=8F=E8=A7=84=E5=88=99=E7=A1=AE=E8=AE=A4?= =?UTF-8?q?=E4=B8=8E=E4=B8=AD=E6=96=87=E4=BA=A4=E4=BA=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 11 + src/App.vue | 2 +- src/components/ui/AppDialog.vue | 1 + src/components/ui/FieldLabel.vue | 7 +- src/components/ui/IssueHint.vue | 3 +- src/components/ui/RawDataDetails.vue | 16 ++ src/components/ui/WorkspaceTools.vue | 5 + src/components/ui/useActionMessage.ts | 2 + src/features/breakdown/BreakdownPage.vue | 134 +++++++-- src/features/breakdown/action-exceptions.ts | 66 +++++ .../components/ActionExceptionRepair.vue | 223 +++++++++++++++ .../components/BreakdownCandidatePanel.vue | 2 +- .../components/BreakdownIssuesDialog.vue | 18 +- .../breakdown/components/CandidateRepairs.vue | 2 +- .../components/StoryboardQualityRepair.vue | 4 +- src/features/breakdown/repair.ts | 2 +- .../breakdown/useBreakdownStartPolicy.ts | 246 +++++++++++++++++ .../components/GenerationModelControls.vue | 12 +- .../components/GenerationOptionFields.vue | 27 +- .../components/QualityPolicyExceptions.vue | 26 ++ .../components/QualityPolicySettings.vue | 229 +++++++-------- src/features/production/ProductionPage.vue | 4 +- .../components/AdvancedProduction.vue | 3 +- .../components/EpisodeAssemblyPanel.vue | 2 +- .../production/components/KeyframeDialog.vue | 7 +- .../components/KeyframeValidationHistory.vue | 5 +- .../components/ModelCapabilities.vue | 9 +- .../components/ProductionReceipt.vue | 3 +- .../components/ProviderInputInspector.vue | 3 +- .../production/components/QualityDialog.vue | 9 +- .../production/components/QualityResult.vue | 12 +- .../components/ShotProductionAssets.vue | 2 +- .../components/VideoQualityDiagnostics.vue | 3 +- .../production/production-messages.ts | 3 +- .../production/useAdvancedProduction.ts | 2 +- src/features/production/useQuality.ts | 6 +- .../project-assets/AssetLibraryPage.vue | 66 +++-- .../project-assets/ProjectAssetsPage.vue | 58 ++-- src/features/project-assets/categories.ts | 23 ++ .../components/AssetCategorySelect.vue | 22 ++ src/features/projects/ProjectLayout.vue | 4 +- src/features/projects/ProjectsPage.vue | 2 +- .../components/DeleteProjectDialog.vue | 5 +- .../projects/quality-policy-confirmation.ts | 93 +++++++ .../projects/useProjectStageAccess.ts | 13 +- src/features/storyboard/StoryboardPage.vue | 11 +- .../components/GenerationReceipt.vue | 13 +- .../components/MotionRevisionEditor.vue | 5 +- .../storyboard/components/ShotTools.vue | 30 +- .../components/SubjectCoverageAudit.vue | 7 +- .../subject-identity/SubjectIdentityPage.vue | 16 +- .../components/CastingCandidateDialog.vue | 4 +- .../components/IdentityImageDialog.vue | 26 +- .../components/StableAnchorQualityDialog.vue | 2 +- .../subject-images/SubjectImagesPage.vue | 11 +- .../components/FormPromptBatch.vue | 3 +- .../components/FormPromptDialog.vue | 6 +- .../components/GenerateImageDialog.vue | 10 +- .../components/ImageGalleryDialog.vue | 9 +- .../visual-style/components/StyleEditor.vue | 37 ++- src/features/workflows/HistoryPanel.vue | 2 +- .../workflows/WorkflowDiagnosticsDialog.vue | 25 +- .../workflows/WorkflowExecutionPanel.vue | 5 +- src/features/workflows/execution.ts | 13 +- src/features/workflows/operations.ts | 18 +- src/lib/assets.ts | 2 +- src/lib/form-rules.ts | 4 +- src/lib/format.ts | 24 +- src/lib/http.ts | 21 +- src/lib/user-facing-text.ts | 66 +++++ tests/components/ui/ActionMenu.test.ts | 22 +- tests/components/ui/form.test.ts | 14 +- .../features/breakdown/BreakdownPage.test.ts | 99 ++++++- .../breakdown/action-exceptions.test.ts | 158 +++++++++++ tests/features/breakdown/start-policy.test.ts | 261 ++++++++++++++++++ .../generation-config/options.test.ts | 2 +- tests/features/production/quality.test.ts | 2 +- tests/features/project-assets/library.test.ts | 22 +- .../features/projects/quality-policy.test.ts | 102 ++++--- .../subject-images/asset-impact.test.ts | 2 +- tests/features/workflows/execution.test.ts | 4 +- tests/features/workflows/pages.test.ts | 30 +- tests/fixtures/breakdown-candidate.ts | 22 ++ tests/lib/http.test.ts | 2 +- tests/lib/user-facing-text.test.ts | 30 ++ 85 files changed, 2059 insertions(+), 480 deletions(-) create mode 100644 src/components/ui/RawDataDetails.vue create mode 100644 src/features/breakdown/action-exceptions.ts create mode 100644 src/features/breakdown/components/ActionExceptionRepair.vue create mode 100644 src/features/breakdown/useBreakdownStartPolicy.ts create mode 100644 src/features/generation-config/components/QualityPolicyExceptions.vue create mode 100644 src/features/project-assets/categories.ts create mode 100644 src/features/project-assets/components/AssetCategorySelect.vue create mode 100644 src/features/projects/quality-policy-confirmation.ts create mode 100644 src/lib/user-facing-text.ts create mode 100644 tests/features/breakdown/action-exceptions.test.ts create mode 100644 tests/features/breakdown/start-policy.test.ts create mode 100644 tests/lib/user-facing-text.test.ts diff --git a/AGENTS.md b/AGENTS.md index 0776ae2..28fdc4b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -33,6 +33,15 @@ - 维持项目现有简洁、扁平的视觉风格。用标题、简短说明、留白和对齐区分普通功能区域,避免无意义的底色、边框和装饰线。 - 页面文案保持精简,说明应帮助用户理解当前操作;不把大量错误、技术细节和重复提示堆在设置页面。 +### 面向普通用户的文案 + +- 默认使用者不了解软件开发。页面、弹窗、按钮、说明、校验、空状态和错误提示不得直接描述“前端做什么”“后端做什么”,应说明当前结果、影响和下一步操作。 +- 英文技术术语优先改成易懂的中文,例如 `Checkpoint` 用“保存记录”、`Storyboard` 用“分镜”、`Prompt` 用“画面描述”或“提示词”、`Thinking` 用“深度思考”。不要把内部字段名、错误码、任务标识直接作为主要说明。 +- 接口返回的系统提示也需要在展示层转换为可读中文;错误详情只提取有助于操作的业务原因,不把调试对象、堆栈或整段原始数据直接输出给用户。原始错误和错误码保留在数据层,不改动业务判断依据。 +- 只调整展示文案,不翻译或改写请求字段、枚举值、接口地址、用户创作的剧本与提示词正文、文件名、自定义名称或模型品牌。分类等内部值使用中文选项展示,提交仍保留真实取值。 +- 费用、覆盖、删除、适用范围与待审核限制必须保留并说清楚,不能为了简化文字改变功能含义。无法确认的能力不要用容易误解的描述代替。 +- 必要的原始技术数据放在默认收起的“高级详情”或导出结果中,日常操作先展示中文摘要。同一弹窗的操作统一放入公共 `footer`,避免正文操作与默认关闭按钮重复。 + ### 全屏抽屉与关闭入口 - 新建剧本、项目全局配置、拆解设置、拆解问题等已确认使用全屏的界面统一复用 `AppDrawer`。后续同类复杂表单、设置和问题处理界面默认沿用全屏抽屉;简短确认或轻量提示仍可使用 `AppDialog`。 @@ -65,6 +74,8 @@ ### 设置、问题处理与任务进度 - 拆解设置与问题处理分开:设置界面负责模块选择、分组预览、启动拆解、候选确认与提交;问题界面负责错误查看、分镜定位、人工修订、读取修复清单及阶段恢复。 +- 首次拆解前只确认表现方式、动作许可和自定义规则,不显示精确动作例外的空白编辑行。已有例外可只读核对,隐藏输入不能清空已有规则或在保存时覆盖后来新增的例外。 +- 新增精确动作例外统一放在拆解后的问题修订中,从当前版本的真实冲突证据自动带入角色、部位或物品及动作,用户填写允许原因。证据缺失时不能猜测或用其他镜头代替;按后端实际范围说明影响,保存例外不能直接标记质量通过。 - 不在拆解设置中重复堆放详细错误列表和修复说明;问题按剧集、节拍、镜头分组并去重,保留后端原始问题及可定位位置。 - 从问题界面定位正文时,先关闭抽屉,等离场和焦点约束释放后再定位,不能同时叠加两个主界面。 - 后端从其他入口启动或重新执行任务时,前端也应发现任务并显示真实运行阶段、进度、作用范围及更新时间;重新进入页面后能够恢复观察,不能只依赖前端本次点击形成的加载状态。 diff --git a/src/App.vue b/src/App.vue index 1aa9870..f4136ec 100644 --- a/src/App.vue +++ b/src/App.vue @@ -273,7 +273,7 @@ const menuOptions = computed(() => {
-
API 地址
+
服务地址
{{ apiBase }}
diff --git a/src/components/ui/AppDialog.vue b/src/components/ui/AppDialog.vue index a8dce48..4c320d9 100644 --- a/src/components/ui/AppDialog.vue +++ b/src/components/ui/AppDialog.vue @@ -161,6 +161,7 @@ onBeforeUnmount(() => { .app-dialog .dialog-footer { @apply flex justify-end gap-2; + width: 100%; align-items: center; padding-top: 0; } diff --git a/src/components/ui/FieldLabel.vue b/src/components/ui/FieldLabel.vue index eb2f319..8bc0978 100644 --- a/src/components/ui/FieldLabel.vue +++ b/src/components/ui/FieldLabel.vue @@ -3,6 +3,7 @@ import { ref } from 'vue' import { NPopover } from 'naive-ui' import type { PopoverProps } from 'naive-ui' import { CircleHelp } from '@lucide/vue' +import { userFacingText } from '../../lib/user-facing-text' /** 字段标签与按需打开的说明,适用于项目配置和各类生成表单。 */ withDefaults( @@ -23,14 +24,14 @@ const open = ref(false) diff --git a/src/components/ui/useActionMessage.ts b/src/components/ui/useActionMessage.ts index 6a4ad47..f599e0d 100644 --- a/src/components/ui/useActionMessage.ts +++ b/src/components/ui/useActionMessage.ts @@ -1,5 +1,6 @@ import { hasInjectionContext, inject, type InjectionKey } from 'vue' import type { MessageApi } from 'naive-ui' +import { userFacingText } from '../../lib/user-facing-text' /** 页面操作结果共用的 Naive Message 实例。 */ export const actionMessageKey: InjectionKey = Symbol('action-message') @@ -18,6 +19,7 @@ export function showActionFeedback( type: 'success' | 'error' | 'warning' | 'info' ) { if (!message || !content.trim()) return + content = userFacingText(content) const history = recentMessages.get(message) ?? new Map() const now = Date.now() const key = `${type}:${content}` diff --git a/src/features/breakdown/BreakdownPage.vue b/src/features/breakdown/BreakdownPage.vue index 7e63562..1f4ea81 100644 --- a/src/features/breakdown/BreakdownPage.vue +++ b/src/features/breakdown/BreakdownPage.vue @@ -7,8 +7,9 @@ import WorkspaceExportButton from '../../components/ui/WorkspaceExportButton.vue import { NScrollbar, NButton, NCheckbox, NCollapse, NCollapseItem, NInputNumber, NTab, NTable, NTabs } from 'naive-ui' import { computed, h, nextTick, onScopeDispose, ref, watch } from 'vue' import { useActionMessage } from '../../components/ui/useActionMessage' -import { CircleAlert, Layers, LoaderCircle, Settings2 } from '@lucide/vue' -import { EmptyState, StatusBadge, WorkspaceTools } from '../../components/ui' +import { CircleAlert, Layers, LoaderCircle, Settings2, ShieldCheck } from '@lucide/vue' +import { AppDialog, EmptyState, StatusBadge, WorkspaceTools } from '../../components/ui' +import QualityPolicySettings from '../generation-config/components/QualityPolicySettings.vue' import { useProjectContext } from '../projects/context' import { breakdownApi } from './api' import type { BreakdownAction, BreakdownInput, BreakdownModule, BreakdownPreview, ShotValidation } from './types' @@ -24,7 +25,9 @@ import BreakdownCandidatePanel from './components/BreakdownCandidatePanel.vue' import StoryboardQualityRepair from './components/StoryboardQualityRepair.vue' import BreakdownIssuesDialog from './components/BreakdownIssuesDialog.vue' import CandidateRepairs from './components/CandidateRepairs.vue' +import ActionExceptionRepair from './components/ActionExceptionRepair.vue' import { useBreakdownQuality } from './useBreakdownQuality' +import { useBreakdownStartPolicy } from './useBreakdownStartPolicy' import type { DiagnosisLocation } from './diagnosis' import { errorMessage } from '../../lib/http' import { downloadText } from '../../lib/format' @@ -41,6 +44,8 @@ const tab = ref('character') const toolsOpen = ref(false) /** 问题查看、人工修订和阶段恢复共用独立窗口。 */ const issuesOpen = ref(false) +/** 动作例外真实写入期间锁定问题抽屉的关闭,普通查询不锁定。 */ +const exceptionSaving = ref(false) /** 从设置切换时等待关闭动画结束,避免两层弹窗同时显示。 */ const pendingIssues = ref(false) /** 问题入口统一使用红色文字、图标和柔和底色,交互时保持错误语义。 */ @@ -343,6 +348,42 @@ const canStart = computed( !error.value && (!records.value.length || taskStopped.value) ) +/** 质量确认始终绑定本次真实预览输入,修改设置后立即撤销未完成启动。 */ +const startScope = computed(() => JSON.stringify(input.value)) +/** 首次及规则变化时确认,已确认的相同内容不重复弹出规则表单。 */ +const startPolicy = useBreakdownStartPolicy(projectId, startScope, canStart) +/** 复用全局质量表单的完整校验和独立草稿。 */ +const qualityForm = ref | null>(null) +/** 仅由用户明确勾选形成规则确认,不能把默认配置当作已确认。 */ +const rulesAcknowledged = ref(false) +/** 每次真实模型启动仍需核对后台任务是否停止。 */ +const startAcknowledged = ref(false) +/** 规则、目标或步骤变化后重新确认,不沿用旧勾选。 */ +watch([startPolicy.reviewOpen, startPolicy.editorKey, startScope], () => { rulesAcknowledged.value = false }) +watch(startPolicy.startOpen, () => { startAcknowledged.value = false }) +/** 关闭整个设置时中断只读确认,不能在关闭后打开迟到的弹窗。 */ +watch(toolsOpen, shown => { if (!shown) startPolicy.cancel() }, { flush: 'sync' }) + +/** 校验用户编辑的规则,成功后进入普通启动确认;此步骤不运行模型。 */ +async function confirmStartRules() { + if (!rulesAcknowledged.value) return + const draft = qualityForm.value?.validatedDraft() + if (draft) await startPolicy.confirmRules(draft) +} + +/** 最终确认费用与任务范围后重新读取规则,再消费本次启动许可。 */ +async function confirmStart() { + if (records.value.length > 0 && !startAcknowledged.value) return + if (await startPolicy.verifyStart()) await run('start') +} + +/** + * 普通启动弹窗只读核对期间仍允许用户取消。 + * @param shown 弹窗目标显隐状态 + */ +function updateStartOpen(shown: boolean) { + if (!shown) startPolicy.cancel() +} let previewController: AbortController | undefined let previewVersion = 0 @@ -395,7 +436,7 @@ async function loadPreview() { async function run(action: BreakdownAction) { if (project.value?.status !== 'completed' || operation.value.pending || error.value) return if (breakdownBusy.value || backgroundExecution.discovering.value || backgroundExecution.discoveryError.value) return - if (action === 'start' && !canStart.value) return + if (action === 'start' && (!canStart.value || !startPolicy.consumePermit())) return const labels: Record = { start: '正在拆解剧本', retry: '正在重试失败抽取', @@ -477,12 +518,29 @@ const rules = { :pending="operation.pending" :pending-label="operation.label" v-model:open="toolsOpen" - title="拆解设置" + :title="startPolicy.reviewOpen.value ? '拆解前确认质量规则' : '拆解设置'" label="拆解设置" + :busy="startPolicy.saving.value" fullscreen @closed="finishOpeningIssues" > -
+ +
+

请核对动作与物理规则,修改将在继续时保存。当前浏览器会记住确认,规则未变时不再重复提醒。

+ + + 我已核对本次拆解使用的质量规则 + + +
+ +

/ {{ preview.estimatedTaskCount }} 个抽取任务

- + type="primary" + :disabled="!canStart || startPolicy.busy.value" + @click="startPolicy.prepare" + >{{ candidateOnly ? '生成拆解候选' : '开始拆解' }}
@@ -607,6 +659,7 @@ const rules = {
+

剧本仍在生成,暂不允许启动拆解,避免读取到不完整的剧集。

@@ -618,6 +671,7 @@ const rules = {

- + + + + + + 我已确认后台任务停止,当前没有同项目的生成或拆解任务在运行。 + + +