Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
TypeScript agent-skillscodex-clideskop-appdubbingimage-generationlocalizationskillsttsvideo-editingvideo-generationvideo-transcriptionvideo-translation
feat(creator): add shared artifact version and provenance details
MijaelX9be74b36dcdb
diff --git a/apps/daemon/src/api/routes.creator.ts b/apps/daemon/src/api/routes.creator.tsindex ae8493fe..9636978b 100644--- a/apps/daemon/src/api/routes.creator.ts+++ b/apps/daemon/src/api/routes.creator.ts@@ -13,7 +13,6 @@ import type {CreatorStageRun,RuntimeErrorCode} from '@opencreator/protocol';-import { readCreatorResultSnapshots } from '@opencreator/protocol';import { createHash } from 'node:crypto';import { createReadStream } from 'node:fs';import { rm, stat } from 'node:fs/promises';@@ -583,13 +582,9 @@ export async function registerCreatorRoutes(return reply.code(404).send(apiError('creator_job_not_found', 'Creator job not found'));}const artifact = job.artifacts.find(candidate => candidate.id === artifactId);- const referencedBySnapshot = artifact === undefined ? false : readCreatorResultSnapshots(- job.state.resultSnapshots- ).some(snapshot => Object.values(snapshot.artifactRefs).flat().includes(artifact.id));if (artifact?.path === null|| artifact === undefined- || (artifact.status === 'stale' && !referencedBySnapshot)) {return reply.code(404).send(apiError('creator_artifact_not_found', 'Creator artifact not found'));}diff --git a/apps/daemon/src/creator/service.ts b/apps/daemon/src/creator/service.tsindex 6095f315..cef78332 100644--- a/apps/daemon/src/creator/service.ts+++ b/apps/daemon/src/creator/service.ts@@ -691,6 +691,17 @@ export function createCreatorService(input: {if (stickmanAction.handled) {// Template-specific mutations have already produced the authoritative state.+ } else if (request.action === 'select-result-version') {+ if (current.status === 'running' || current.stages.some(stage => (+ stage.status === 'queued' || stage.status === 'running'+ ))) {+ throw new CreatorServiceError('creator_job_has_active_run', 'Wait for the active stage before selecting a result version');+ }+ const version = readResultVersion(current, parsedInput.version, 'version', true)!;+ const snapshot = creatorResultSnapshotForVersion(current, version)!;+ // Selecting a result changes only the existing project selection, never its history or validity.+ nextState.resultVersion = version;+ affectedArtifactIds.push(...Object.values(snapshot.artifactRefs).flat());} else if (request.action === 'update-settings' || request.action === 'undo-action') {const patch = readNonEmptyRecord(parsedInput.patch, 'patch');nextState = { ...nextState, ...patch };@@ -1031,6 +1042,7 @@ function writeActivity(input: {objectId: typeof objectId === 'string' ? objectId : '',affectedArtifactIds: input.affectedArtifactIds};+ if (input.action === 'select-result-version') details.version = input.input.version!;if (input.action === 'run-stage' && typeof input.input.stageId === 'string') {details.stageId = input.input.stageId;}@@ -1244,6 +1256,7 @@ function dependentArtifacts(artifacts: CreatorArtifact[], sourceId: string): Cre}function summarizeAction(action: string, input: Record<string, CreatorJson>): string {+ if (action === 'select-result-version') return `选择项目结果 V${String(input.version)}`;if (action === 'edit-subtitle') return '更新字幕并保留下游旧版本';if (action === 'commit-version') return '保存项目版本设置';if (action === 'run-stage') return `启动阶段 ${String(input.stageId ?? '')}`.trim();diff --git a/apps/daemon/src/creator/templates/registry.ts b/apps/daemon/src/creator/templates/registry.tsindex 9227b7a3..d43ceec1 100644--- a/apps/daemon/src/creator/templates/registry.ts+++ b/apps/daemon/src/creator/templates/registry.ts@@ -1,4 +1,5 @@import { createVideoTranslationTemplate } from './video-translation.js';+import { z } from 'zod';import {createLegacyVideoDownloadTemplate,createVideoDownloadTemplate@@ -64,7 +65,14 @@ export function createCreatorTemplateRegistry(validateTemplate(template);const key = templateKey(template.id, template.version);if (byKey.has(key)) throw new Error(`Duplicate template: ${key}`);- byKey.set(key, template);+ byKey.set(key, {+ ...template,+ actions: [...template.actions, {+ id: 'select-result-version',+ inputSchema: z.object({ version: z.number().int().positive() }).strict(),+ allowedStages: template.stages.map(stage => stage.id)+ }]+ });}return {diff --git a/apps/daemon/test/integration/creator-artifact-versions.test.ts b/apps/daemon/test/integration/creator-artifact-versions.test.tsnew file mode 100644index 00000000..6b077bc0--- /dev/null+++ b/apps/daemon/test/integration/creator-artifact-versions.test.ts@@ -0,0 +1,74 @@+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { expect, it } from 'vitest';+import { buildServer } from '../../src/api/server.js';+import { openRuntimeDatabase } from '../../src/storage/database.js';+import { createCreatorRepository } from '../../src/creator/repository.js';+import { createCreatorService } from '../../src/creator/service.js';+import { createDefaultCreatorTemplateRegistry } from '../../src/creator/templates/registry.js';+import { appendCreatorResultSnapshot } from '../../src/creator/result-snapshots.js';++it('selects history through the Dispatcher, persists a revision once, and downloads stale history without rewriting it', async () => {+ const directory = mkdtempSync(join(tmpdir(), 'creator-artifact-versions-'));+ const databasePath = join(directory, 'app.sqlite');+ const db = openRuntimeDatabase(databasePath);+ const repository = createCreatorRepository(db);+ const service = createCreatorService({ repository, templates: createDefaultCreatorTemplateRegistry() });+ const job = service.createJob({ projectId: 'project', templateId: 'image-generation' });+ const sourcePath = join(directory, 'source.txt');+ writeFileSync(sourcePath, 'historical source');+ const source = repository.insertArtifact({ jobId: job.id, kind: 'source_text', path: sourcePath, status: 'stale', sourceArtifactIds: [], metadata: {} });+ for (const version of [1, 2]) {+ const path = join(directory, `result-${version}.txt`);+ writeFileSync(path, `result ${version}`);+ const artifact = repository.insertArtifact({ jobId: job.id, kind: 'generated_image', path, status: version === 1 ? 'stale' : 'completed', sourceArtifactIds: [source.id], metadata: { resultVersion: version } });+ const current = repository.getJob(job.id)!;+ repository.updateJob({ id: job.id, status: 'completed', revision: 0, state: {+ ...current.state,+ ...appendCreatorResultSnapshot({ job: current, version, changedArtifacts: [artifact], action: 'stage-succeeded', stageId: 'generate', description: `Generation ${version}`, artifactRefsPatch: { source_text: [] } })+ } });+ }+ const before = repository.getJob(job.id)!;+ const server = await buildServer({ db, token: 'secret', dataDir: directory, codexHome: join(directory, 'codex-home') });+ try {+ const payload = { action: 'select-result-version', expectedRevision: 0, idempotencyKey: 'select-v1', input: { version: 1 } };+ const post = (body: typeof payload) => server.inject({ method: 'POST', url: `/creator/jobs/${job.id}/actions`, headers: { authorization: 'Bearer secret' }, payload: body });+ const first = await post(payload);+ expect(first.statusCode).toBe(200);+ expect(first.json().job).toMatchObject({ revision: 1, state: { resultVersion: 1, latestResultVersion: 2 } });+ expect((await post(payload)).statusCode).toBe(200);+ expect(repository.getJob(job.id)!.revision).toBe(1);+ expect(repository.getJob(job.id)!.artifacts).toEqual(before.artifacts);+ expect(repository.getJob(job.id)!.state.resultSnapshots).toEqual(before.state.resultSnapshots);+ expect(repository.getJob(job.id)!.activities.filter(activity => activity.action === 'select-result-version')).toHaveLength(1);+ expect(repository.getJob(job.id)!.stages).toHaveLength(0);+ expect((await post({ ...payload, idempotencyKey: 'conflict', input: { version: 2 } })).statusCode).toBe(409);+ const invalid = await post({ ...payload, expectedRevision: 1, idempotencyKey: 'missing', input: { version: 999 } });+ expect(invalid.statusCode).toBeGreaterThanOrEqual(400);+ for (const artifact of before.artifacts) {+ const response = await server.inject({ method: 'GET', url: `/creator/jobs/${job.id}/artifacts/${artifact.id}/content`, headers: { authorization: 'Bearer secret' } });+ expect(response.statusCode).toBe(200);+ expect(response.body).toContain(artifact.id === source.id ? 'historical source' : 'result');+ }+ const unauthenticated = await server.inject({ method: 'GET', url: `/creator/jobs/${job.id}/artifacts/${source.id}/content` });+ expect(unauthenticated.statusCode).toBe(401);+ repository.createStageRun({ jobId: job.id, stageId: 'generate', executor: 'image', status: 'running' });+ const active = await post({ ...payload, expectedRevision: 1, idempotencyKey: 'active', input: { version: 2 } });+ expect(active.statusCode).toBeGreaterThanOrEqual(400);+ expect(repository.getJob(job.id)!.revision).toBe(1);+ } finally {+ await server.close();+ if (db.open) db.close();+ }+ const reopened = openRuntimeDatabase(databasePath);+ try {+ const restored = createCreatorRepository(reopened).getJob(job.id)!;+ expect(restored.state.resultVersion).toBe(1);+ expect(restored.artifacts).toEqual(before.artifacts);+ expect(restored.artifacts.find(artifact => artifact.metadata.resultVersion === 1)!.status).toBe('stale');+ } finally {+ reopened.close();+ rmSync(directory, { recursive: true, force: true });+ }+});diff --git a/apps/web/e2e/web-desktop-parity.spec.ts b/apps/web/e2e/web-desktop-parity.spec.tsindex 934c091b..81ef9e6a 100644--- a/apps/web/e2e/web-desktop-parity.spec.ts+++ b/apps/web/e2e/web-desktop-parity.spec.ts@@ -1,5 +1,69 @@import type { CreatorYtDlpStatusResponse } from '@opencreator/protocol';import { test, expect } from './fixtures/runtime.js';+import { dirname, join } from 'node:path';+import { writeFileSync } from 'node:fs';+import { openRuntimeDatabase } from '../../daemon/src/storage/database.js';+import { createCreatorRepository } from '../../daemon/src/creator/repository.js';+import { appendCreatorResultSnapshot } from '../../daemon/src/creator/result-snapshots.js';++test('Artifact 历史选择和来源在 Browser/Desktop Bridge 下保持一致并可刷新', async ({ browser, runtime }, testInfo) => {+ test.skip(testInfo.project.name !== 'chromium-desktop', '内部使用相同内容视口');+ const created = await runtime.api<{ job: { id: string } }>('POST', '/creator/jobs', {+ projectId: runtime.projectId, templateId: 'image-generation', state: { prompt: '版本来源验收', currentStep: 2, furthestStep: 2 }+ });+ const db = openRuntimeDatabase(join(dirname(runtime.projectDir), 'runtime', 'app.sqlite'));+ const repository = createCreatorRepository(db);+ for (const version of [1, 2]) {+ const path = join(runtime.projectDir, `history-${version}.png`);+ writeFileSync(path, Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQIHWP4z8DwHwAFgAI/ScLbtAAAAABJRU5ErkJggg==', 'base64'));+ const artifact = repository.insertArtifact({ jobId: created.job.id, kind: 'generated_image', path, status: version === 1 ? 'stale' : 'completed', sourceArtifactIds: [], metadata: { fileName: `history-${version}.png`, resultVersion: version } });+ const job = repository.getJob(created.job.id)!;+ repository.updateJob({ id: job.id, status: 'completed', revision: job.revision + 1, state: { ...job.state,+ ...appendCreatorResultSnapshot({ job, version, changedArtifacts: [artifact], action: 'stage-succeeded', stageId: 'generate', description: `生成 ${version}` })+ } });+ }+ const old = repository.getJob(created.job.id)!.artifacts.find(artifact => artifact.metadata.resultVersion === 1)!;+ db.close();+ const results = [];+ for (const platform of ['browser', 'desktop'] as const) {+ const current = await runtime.api<{ job: { revision: number } }>('GET', `/creator/jobs/${created.job.id}`);+ await runtime.api('POST', `/creator/jobs/${created.job.id}/actions`, { action: 'select-result-version', expectedRevision: current.job.revision, input: { version: 2 } });+ const context = await browser.newContext({ viewport: { width: 1440, height: 900 }, deviceScaleFactor: 1, reducedMotion: 'reduce' });+ const page = await context.newPage();+ if (platform === 'desktop') await installDesktopBridge(page);+ try {+ await runtime.openApp(page);+ await page.goto(`${runtime.origin}/#/workbench?tool=image-generation&jobId=${created.job.id}`);+ await page.getByText('产物版本与来源', { exact: true }).click();+ const details = page.getByRole('region', { name: '产物详情' });+ await details.getByLabel('浏览产物(不改变项目选择)').selectOption(old.id);+ await expect(details).toContainText('已过期,非当前有效结果');+ const requests: unknown[] = [];+ page.on('request', request => {+ if (request.method() === 'POST' && request.url().endsWith('/actions')) {+ const body = request.postDataJSON();+ if (body.action === 'select-result-version') requests.push({ action: body.action, input: body.input });+ }+ });+ await details.getByRole('button', { name: '采用项目版本' }).click();+ await expect(page.getByRole('button', { name: '项目 V1', exact: true })).toBeVisible();+ await page.reload();+ await expect(page.getByRole('button', { name: '项目 V1', exact: true })).toBeVisible();+ await page.getByText('产物版本与来源', { exact: true }).click();+ await expect(details).toContainText('已过期,非当前有效结果');+ const downloadWork = page.waitForEvent('download');+ await details.getByRole('button', { name: '下载 V1' }).click();+ expect((await downloadWork).suggestedFilename()).toBe('history-1.png');+ await details.getByRole('button', { name: '预览 V1' }).click();+ await expect(details.getByRole('img')).toBeVisible();+ await details.evaluate(element => { element.scrollTop = 0; });+ results.push({ text: normalizeParityText(await details.innerText()), box: await details.boundingBox(), requests });+ await page.screenshot({ path: testInfo.outputPath(`artifact-${platform}.png`) });+ } finally { await context.close(); }+ }+ expect(results[0]).toEqual(results[1]);+ expect(results[0]!.requests).toEqual([{ action: 'select-result-version', input: { version: 1 } }]);+});test('通用界面设置在 Browser/Desktop Bridge 下读取并写入相同 Runtime 配置', async ({browser,diff --git a/apps/web/src/features/dashboard/CoverGeneratorWorkspace.test.tsx b/apps/web/src/features/dashboard/CoverGeneratorWorkspace.test.tsxindex b37674bd..7d28cb56 100644--- a/apps/web/src/features/dashboard/CoverGeneratorWorkspace.test.tsx+++ b/apps/web/src/features/dashboard/CoverGeneratorWorkspace.test.tsx@@ -293,7 +293,7 @@ describe('CoverGeneratorWorkspace', () => {expect(screen.queryByRole('textbox', { name: '封面提示词' })).not.toBeInTheDocument();});- it('opens an existing project on its latest generated version', async () => {+ it('opens an existing project on its persisted result version', async () => {const fixture = createFixture();const createdAt = fixture.currentJob().createdAt;const versionOne = {@@ -324,10 +324,10 @@ describe('CoverGeneratorWorkspace', () => {renderWorkspace(fixture, initialJob);expect(await screen.findByRole('region', { name: '封面生成项目产出' })).toBeInTheDocument();- expect(screen.getByRole('button', { name: '项目 V2' })).toBeInTheDocument();+ expect(screen.getByRole('button', { name: '项目 V1' })).toBeInTheDocument();await waitFor(() => expect(fixture.openArtifact).toHaveBeenCalledWith(initialJob.id,- versionTwo.id+ versionOne.id));});diff --git a/apps/web/src/features/dashboard/CoverGeneratorWorkspace.tsx b/apps/web/src/features/dashboard/CoverGeneratorWorkspace.tsxindex 0bfe822d..5a39c40b 100644--- a/apps/web/src/features/dashboard/CoverGeneratorWorkspace.tsx+++ b/apps/web/src/features/dashboard/CoverGeneratorWorkspace.tsx@@ -92,7 +92,7 @@ export default function CoverGeneratorWorkspace(props: {const [resultTab, setResultTab] = useState<CoverResultTab>(() => (readResultTab(session?.state.resultTab)));- const [resultVersion, setResultVersion] = useState<number>();+ const resultVersion = session?.job.state.resultVersion;const [artifactUrls, setArtifactUrls] = useState<Record<string, string>>({});const [submitting, setSubmitting] = useState(false);const [taskControlPending, setTaskControlPending] = useState<@@ -173,7 +173,6 @@ export default function CoverGeneratorWorkspace(props: {useEffect(() => {if (latestResult !== undefined) {- setResultVersion(latestResult.value);setCurrentStep(2);setFurthestStep(2);setResultTab('options');@@ -464,14 +463,12 @@ export default function CoverGeneratorWorkspace(props: {}function selectVersion(version: number) {- setResultVersion(version);setResultTab('options');openStep(2);}function returnToResult() {if (selectedResult === undefined) return;- setResultVersion(selectedResult.value);setResultTab('options');openStep(2);}diff --git a/apps/web/src/features/dashboard/CreatorArtifactDetails.test.tsx b/apps/web/src/features/dashboard/CreatorArtifactDetails.test.tsxnew file mode 100644index 00000000..d77b7814--- /dev/null+++ b/apps/web/src/features/dashboard/CreatorArtifactDetails.test.tsx@@ -0,0 +1,110 @@+import { fireEvent, render, screen, waitFor, within } from '@testing-library/react';+import type { CreatorActionRequest, CreatorArtifact, CreatorJob, CreatorJson } from '@opencreator/protocol';+import { beforeEach, expect, it, vi } from 'vitest';+import { LanguageProvider } from '../../i18n/LanguageProvider.js';+import { CreatorSessionProvider } from './creator-session-store.js';+import CreatorArtifactDetails from './CreatorArtifactDetails.js';+import ImageGenerationWorkspace from './ImageGenerationWorkspace.js';+import CoverGeneratorWorkspace from './CoverGeneratorWorkspace.js';++beforeEach(() => {+ Object.defineProperty(URL, 'createObjectURL', { configurable: true, value: vi.fn(() => 'blob:artifact') });+ Object.defineProperty(URL, 'revokeObjectURL', { configurable: true, value: vi.fn() });+});++function fixture(templateId = 'video-translation', kind = 'target_subtitle') {+ const createdAt = '2026-09-15T01:00:00.000Z';+ const artifacts: CreatorArtifact[] = [1, 2].map(version => ({+ id: `artifact-${version}`, jobId: 'job', kind, version,+ status: version === 1 ? 'stale' : 'completed', path: `/results/result-${version}.${kind === 'target_subtitle' ? 'srt' : 'png'}`,+ scopeKey: null, inputFingerprint: null, sha256: null,+ sourceArtifactIds: version === 2 ? ['artifact-1', 'missing-source'] : [], metadata: {}, createdAt+ }));+ let job: CreatorJob = {+ id: 'job', projectId: 'project', templateId, templateVersion: 2, status: 'completed', revision: 0,+ state: { provider: 'openai', currentStep: 2, furthestStep: 2, resultVersion: 2, latestResultVersion: 2,+ resultSnapshots: artifacts.map((artifact, index) => ({ version: index + 1, createdAt, action: 'stage-succeeded', stageId: 'generate', description: `生成 ${index + 1}`, artifactRefs: { [kind]: [artifact.id] }, changedArtifactIds: [artifact.id], staleArtifactIds: [], state: {} })) as CreatorJson },+ agentThreadId: null, stages: [], artifacts, providerRequests: [], activities: [], createdAt, updatedAt: createdAt+ };+ const applyAction = vi.fn(async (_id: string, request: CreatorActionRequest) => {+ job = { ...job, revision: job.revision + 1, state: { ...job.state, ...(request.action === 'select-result-version' ? { resultVersion: request.input.version! } : request.input.patch as Record<string, CreatorJson>) } };+ return { job, receipt: { actor: 'user' as const, action: request.action, summary: '', affectedArtifacts: [], newRevision: job.revision, createdAt } };+ });+ const openArtifact = vi.fn(async (_jobId: string, id: string) => new Response(id === 'artifact-1' ? 'same\nold' : 'same\nnew'));+ const service = { applyAction, openArtifact, runAgentTurn: vi.fn() };+ return { get job() { return job; }, service, applyAction, openArtifact };+}++function mount(f: ReturnType<typeof fixture>, child = <CreatorArtifactDetails />) {+ return render(<LanguageProvider initialPreference="zh-CN"><CreatorSessionProvider initialJob={f.job} service={f.service}>{child}</CreatorSessionProvider></LanguageProvider>);+}++async function openDetails() {+ fireEvent.click(screen.getByText('产物版本与来源'));+ return screen.findByRole('region', { name: '产物详情' });+}++it('traces sources, highlights text changes, downloads history and keeps stale results explicit', async () => {+ const f = fixture();+ mount(f);+ const details = within(await openDetails());+ expect(details.getByText('来源记录缺失:missing-source')).toBeInTheDocument();+ fireEvent.change(details.getByLabelText('对比版本'), { target: { value: 'artifact-1' } });+ await waitFor(() => expect(details.getByLabelText('版本 1 文本')).toHaveTextContent('old'));+ expect(details.getByLabelText('版本 2 文本').querySelector('.is-changed')).toHaveTextContent('new');+ const click = vi.spyOn(HTMLAnchorElement.prototype, 'click').mockImplementation(() => undefined);+ fireEvent.click(details.getByRole('button', { name: '下载 V1' }));+ await waitFor(() => expect(click).toHaveBeenCalled());+ expect(f.openArtifact).toHaveBeenCalledWith('job', 'artifact-1');+ click.mockRestore();+ fireEvent.click(details.getByRole('button', { name: /result-1.srt · V1/ }));+ expect(details.getByText('已过期,非当前有效结果')).toBeInTheDocument();+ expect(details.getByText('已有记录将此结果标记为过期,未记录具体原因。')).toBeInTheDocument();+ expect(f.applyAction).not.toHaveBeenCalled();+});++it.each([+ ['image-generation', 'generated_image', ImageGenerationWorkspace],+ ['cover', 'cover_image', CoverGeneratorWorkspace]+] as const)('shares persisted version selection with the %s workspace and survives remount', async (templateId, kind, Workspace) => {+ const f = fixture(templateId, kind);+ const first = mount(f, <Workspace onBack={() => undefined} />);+ const details = within(await openDetails());+ fireEvent.change(details.getByLabelText('浏览产物(不改变项目选择)'), { target: { value: 'artifact-1' } });+ const adopt = details.getByRole('button', { name: '采用项目版本' });+ fireEvent.click(adopt);+ fireEvent.click(adopt);+ await waitFor(() => expect(f.job.state.resultVersion).toBe(1));+ expect(f.applyAction.mock.calls.filter(([, request]) => request.action === 'select-result-version')).toHaveLength(1);+ expect(screen.getByRole('button', { name: '项目 V1' })).toBeInTheDocument();+ expect(screen.getByText('包含过期结果')).toBeInTheDocument();+ expect(f.job.artifacts).toHaveLength(2);+ first.unmount();+ mount(f, <Workspace onBack={() => undefined} />);+ expect(screen.getByRole('button', { name: '项目 V1' })).toBeInTheDocument();+ const restored = within(await openDetails());+ expect(restored.getByText('已过期,非当前有效结果')).toBeInTheDocument();+ fireEvent.click(restored.getByRole('button', { name: '预览 V1' }));+ await waitFor(() => expect(restored.getByRole('img')).toHaveAttribute('src', 'blob:artifact'));+});++it('does not claim provenance or allow adoption for artifacts without a snapshot', async () => {+ const f = fixture();+ f.job.state.resultSnapshots = [];+ mount(f);+ const details = within(await openDetails());+ expect(details.getByText('未记录生成快照;无法确定 Action / Stage')).toBeInTheDocument();+ expect(details.getByRole('button', { name: '采用项目版本' })).toBeDisabled();+});++it('keeps the adopted version unchanged when the command fails', async () => {+ const f = fixture();+ f.applyAction.mockRejectedValueOnce(new Error('Revision conflict'));+ mount(f);+ const details = within(await openDetails());+ fireEvent.change(details.getByLabelText('浏览产物(不改变项目选择)'), { target: { value: 'artifact-1' } });+ fireEvent.click(details.getByRole('button', { name: '采用项目版本' }));+ await waitFor(() => expect(details.getByRole('alert')).toHaveTextContent('Revision conflict'));+ expect(f.job.state.resultVersion).toBe(2);+ expect(details.getByRole('button', { name: '采用项目版本' })).toBeEnabled();+});diff --git a/apps/web/src/features/dashboard/CreatorArtifactDetails.tsx b/apps/web/src/features/dashboard/CreatorArtifactDetails.tsxnew file mode 100644index 00000000..3a7c65bd--- /dev/null+++ b/apps/web/src/features/dashboard/CreatorArtifactDetails.tsx@@ -0,0 +1,205 @@+import { readCreatorResultSnapshots, type CreatorArtifact, type CreatorJob } from '@opencreator/protocol';+import { useEffect, useRef, useState } from 'react';+import { useLocalizedCopy } from '../../i18n/useLocalizedCopy.js';+import { creatorPanelAdapterFor } from './creator-panel-adapters.js';+import { useOptionalCreatorSession } from './creator-session-store.js';+import './creator-artifact-details.css';++export default function CreatorArtifactDetails() {+ const session = useOptionalCreatorSession();+ const l = useLocalizedCopy();+ const [open, setOpen] = useState(false);+ const [artifactId, setArtifactId] = useState('');+ const [compareId, setCompareId] = useState('');+ const [texts, setTexts] = useState<string[] | null>(null);+ const [error, setError] = useState('');+ const [pending, setPending] = useState(false);+ const pendingRef = useRef(false);+ const job = session?.job;+ const snapshots = readCreatorResultSnapshots(job?.state.resultSnapshots);+ const current = snapshots.find(snapshot => snapshot.version === job?.state.resultVersion)+ ?? snapshots.at(-1);+ const artifact = job?.artifacts.find(item => item.id === artifactId)+ ?? job?.artifacts.find(item => current?.artifactRefs[item.kind]?.includes(item.id))+ ?? job?.artifacts.at(-1);+ const versions = job?.artifacts.filter(item => (+ item.kind === artifact?.kind && item.scopeKey === artifact.scopeKey+ )) ?? [];+ const comparison = versions.find(item => item.id === compareId && item.id !== artifact?.id);+ const origin = snapshots.find(snapshot => snapshot.changedArtifactIds.includes(artifact?.id ?? ''));+ const projects = snapshots.filter(snapshot => snapshot.artifactRefs[artifact?.kind ?? '']?.includes(artifact?.id ?? ''));+ const [projectVersion, setProjectVersion] = useState<number>();+ const selectedProject = projects.find(snapshot => snapshot.version === projectVersion)+ ?? projects.at(-1);+ const isCurrent = artifact !== undefined && current?.artifactRefs[artifact.kind]?.includes(artifact.id);+ const stale = artifact?.status === 'stale' || current?.staleArtifactIds.includes(artifact?.id ?? '') === true;+ const busy = job?.status === 'running' || job?.stages.some(stage => ['queued', 'running'].includes(stage.status));+ // ponytail: positional comparison; insertions shift later highlights. Add alignment only if needed.+ const textLines = texts?.map(text => text.split('\n'));++ useEffect(() => {+ setTexts(null);+ setError('');+ if (!open || !artifact || !comparison || !session || !isText(artifact) || !isText(comparison)) return;+ let active = true;+ void Promise.all([artifact, comparison].map(async item => {+ const response = await session.openArtifact(item.id);+ if (!response.ok) throw new Error(`HTTP ${response.status}`);+ const text = await response.text();+ if (text.length > 200_000) throw new Error(l('文本超过 20 万字符,请下载后对比', 'Text exceeds 200,000 characters. Download it to compare.'));+ return text;+ })).then(values => { if (active) setTexts(values); })+ .catch(cause => { if (active) setError(cause instanceof Error ? cause.message : String(cause)); });+ return () => { active = false; };+ }, [open, artifact?.id, comparison?.id, session?.openArtifact, l]);++ if (!job || !artifact || !session) return null;+ const adapter = creatorPanelAdapterFor(job.templateId);+ const label = (item: CreatorArtifact) => `${fileName(item)} · V${item.version}`;++ async function adopt() {+ if (!session || !selectedProject || pendingRef.current) return;+ pendingRef.current = true;+ setPending(true);+ setError('');+ try {+ await session.applyAction({ action: 'select-result-version', input: { version: selectedProject.version } });+ } catch (cause) {+ setError(cause instanceof Error ? cause.message : String(cause));+ } finally {+ pendingRef.current = false;+ setPending(false);+ }+ }++ async function download(item: CreatorArtifact) {+ if (!session) return;+ setError('');+ try {+ const response = await session.openArtifact(item.id);+ if (!response.ok) throw new Error(`HTTP ${response.status}`);+ const url = URL.createObjectURL(await response.blob());+ const link = document.createElement('a');+ link.href = url;+ link.download = fileName(item);+ link.click();+ window.setTimeout(() => URL.revokeObjectURL(url), 0);+ } catch (cause) {+ setError(cause instanceof Error ? cause.message : String(cause));+ }+ }++ return (+ <details className="creator-artifact-details" onToggle={event => setOpen(event.currentTarget.open)}>+ <summary>{l('产物版本与来源', 'Artifact versions and sources')}</summary>+ {open ? <section aria-label={l('产物详情', 'Artifact details')}>+ <label>{l('浏览产物(不改变项目选择)', 'Browse artifacts (keeps project selection)')}+ <select value={artifact.id} onChange={event => { setArtifactId(event.target.value); setCompareId(''); setProjectVersion(undefined); }}>+ {[...job.artifacts].reverse().map(item => <option key={item.id} value={item.id}>{label(item)}</option>)}+ </select>+ </label>+ <dl>+ <dt>{l('类型 / 产物版本', 'Type / artifact version')}</dt><dd>{artifact.kind} · V{artifact.version}</dd>+ <dt>{l('创建时间', 'Created')}</dt><dd><time dateTime={artifact.createdAt}>{new Date(artifact.createdAt).toLocaleString()}</time></dd>+ <dt>{l('状态', 'Status')}</dt><dd>{stale ? l('已过期,非当前有效结果', 'Stale, not a current valid result') : artifact.status === 'completed' ? l('已完成', 'Completed') : artifact.status === 'draft' ? l('草稿', 'Draft') : l('技术预览', 'Technical preview')}</dd>+ <dt>{l('当前采用', 'Current selection')}</dt><dd>{current ? l(`项目 V${current.version}`, `Project V${current.version}`) : l('无项目快照', 'No project snapshot')}{isCurrent ? l(' · 包含此产物', ' · includes this artifact') : l(' · 未采用此产物', ' · does not include this artifact')}</dd>+ <dt>{l('生成来源', 'Generated by')}</dt><dd>{origin+ ? <>{l(`项目 V${origin.version}`, `Project V${origin.version}`)} · {origin.description || origin.action}{origin.stageId ? ` · ${adapter.stageLabel(origin.stageId, l)}` : ''} <small>({origin.action})</small></>+ : l('未记录生成快照;无法确定 Action / Stage', 'No generation snapshot recorded; Action / Stage unknown')}</dd>+ </dl>+ {stale ? <p role="status">{staleReason(job, artifact, l)}</p> : null}+ <h3>{l('上游来源', 'Upstream sources')}</h3>+ {artifact.sourceArtifactIds.length ? <ul>{artifact.sourceArtifactIds.map(id => {+ const source = job.artifacts.find(item => item.id === id);+ return <li key={id}>{source+ ? <button type="button" onClick={() => { setArtifactId(id); setCompareId(''); setProjectVersion(undefined); }}>{label(source)}{source.status === 'stale' ? l('(已过期)', ' (stale)') : ''}</button>+ : l(`来源记录缺失:${id}`, `Source record missing: ${id}`)}</li>;+ })}</ul> : <p>{l('未记录上游产物', 'No upstream artifacts recorded')}</p>}+ <label>{l('包含此产物的项目版本', 'Project versions containing this artifact')}+ <select value={selectedProject?.version ?? ''} disabled={!projects.length} onChange={event => setProjectVersion(Number(event.target.value))}>+ {!projects.length ? <option value="">{l('无快照,只可浏览和下载', 'No snapshot; browse and download only')}</option> : null}+ {projects.map(snapshot => <option key={snapshot.version} value={snapshot.version}>V{snapshot.version} · {snapshot.description}</option>)}+ </select>+ </label>+ <p>{l('采用整个项目结果版本;保留所有历史文件与过期状态,不更改生成设置。', 'Selects the whole project result version. Keeps history, stale status, and generation settings.')}</p>+ <button type="button" disabled={!selectedProject || selectedProject.version === current?.version || busy || pending} onClick={() => void adopt()}>{pending ? l('保存中…', 'Saving…') : l('采用项目版本', 'Use project version')}</button>+ {busy ? <p>{l('请等待当前阶段完成后切换', 'Wait for the active stage before switching')}</p> : null}+ <h3>{l('历史版本对比', 'Compare versions')}</h3>+ <label>{l('对比版本', 'Comparison version')}+ <select value={comparison?.id ?? ''} onChange={event => setCompareId(event.target.value)}>+ <option value="">{l('选择同类型历史产物', 'Choose a previous artifact of this type')}</option>+ {versions.filter(item => item.id !== artifact.id).map(item => <option key={item.id} value={item.id}>{label(item)}</option>)}+ </select>+ </label>+ <div className="creator-artifact-comparison">+ {[artifact, ...(comparison ? [comparison] : [])].map((item, index) => <div key={item.id}>+ <strong>{label(item)}</strong>+ <button type="button" disabled={!item.path} onClick={() => void download(item)}>{l('下载', 'Download')} V{item.version}</button>+ {!isText(item) ? <ArtifactMediaPreview artifact={item} /> : null}+ {textLines && comparison ? <pre aria-label={l(`版本 ${item.version} 文本`, `Version ${item.version} text`)}>{textLines[index]!.slice(0, 2000).map((line, lineIndex) => {+ const other = textLines[1 - index]!;+ return <span className={line === other[lineIndex] ? '' : 'is-changed'} key={lineIndex}>{lineIndex + 1} {line}{'\n'}</span>;+ })}</pre> : null}+ </div>)}+ </div>+ {comparison ? <p>{isText(artifact) && isText(comparison)+ ? l('按行号并排高亮不同文本,最多显示 2000 行;完整内容请下载。', 'Highlights differences at the same line number, up to 2,000 lines. Download for full content.')+ : l('媒体版本可并排预览或下载,不进行内容比较。', 'Preview or download media versions side by side; no content comparison.')}</p> : null}+ {error ? <p role="alert">{error}</p> : null}+ </section> : null}+ </details>+ );+}++function ArtifactMediaPreview({ artifact }: { artifact: CreatorArtifact }) {+ const session = useOptionalCreatorSession();+ const l = useLocalizedCopy();+ const [requested, setRequested] = useState(false);+ const [url, setUrl] = useState('');+ const [error, setError] = useState('');+ const extension = fileName(artifact).split('.').at(-1)?.toLowerCase() ?? '';+ const kind = /^(png|jpe?g|webp|gif|avif)$/.test(extension) ? 'image'+ : /^(mp3|wav|m4a|ogg|flac)$/.test(extension) ? 'audio'+ : /^(mp4|webm|mov)$/.test(extension) ? 'video' : null;+ useEffect(() => {+ if (!requested || !session) return;+ let active = true;+ let objectUrl = '';+ void session.openArtifact(artifact.id).then(async response => {+ if (!response.ok) throw new Error(`HTTP ${response.status}`);+ const blob = await response.blob();+ if (!active) return;+ objectUrl = URL.createObjectURL(blob);+ setUrl(objectUrl);+ }).catch(cause => { if (active) setError(String(cause)); });+ return () => { active = false; if (objectUrl) URL.revokeObjectURL(objectUrl); };+ }, [requested, artifact.id, session?.openArtifact]);+ if (!kind || !artifact.path) return null;+ return <>+ <button type="button" disabled={requested} onClick={() => setRequested(true)}>{l('预览', 'Preview')} V{artifact.version}</button>+ {url && kind === 'image' ? <img src={url} alt={fileName(artifact)} /> : null}+ {url && kind === 'audio' ? <audio src={url} controls aria-label={fileName(artifact)} /> : null}+ {url && kind === 'video' ? <video src={url} controls aria-label={fileName(artifact)} /> : null}+ {error ? <p role="alert">{error}</p> : null}+ </>;+}++function fileName(artifact: CreatorArtifact): string {+ return typeof artifact.metadata.fileName === 'string'+ ? artifact.metadata.fileName+ : artifact.path?.split(/[\\/]/).at(-1) || artifact.kind;+}++function isText(artifact: CreatorArtifact): boolean {+ return /\.(txt|md|srt|vtt|json|csv)$/i.test(fileName(artifact))+ || (typeof artifact.metadata.mimeType === 'string' && artifact.metadata.mimeType.startsWith('text/'));+}++function staleReason(job: CreatorJob, artifact: CreatorArtifact, l: (zh: string, en: string) => string): string {+ const sources = artifact.sourceArtifactIds.map(id => job.artifacts.find(item => item.id === id));+ if (sources.some(source => source === undefined)) return l('部分上游来源记录已缺失。', 'Some upstream source records are missing.');+ if (sources.some(source => source?.status === 'stale')) return l('上游产物已被标记为过期。', 'An upstream artifact is marked stale.');+ const snapshot = readCreatorResultSnapshots(job.state.resultSnapshots).find(item => item.staleArtifactIds.includes(artifact.id));+ if (snapshot) return l(`项目 V${snapshot.version} 已将此结果标记为过期:${snapshot.description}`, `Project V${snapshot.version} marked this result stale: ${snapshot.description}`);+ return l('已有记录将此结果标记为过期,未记录具体原因。', 'This result is marked stale; no specific reason was recorded.');+}diff --git a/apps/web/src/features/dashboard/CreatorCollaborationPanel.tsx b/apps/web/src/features/dashboard/CreatorCollaborationPanel.tsxindex 2803c4ad..6eb20d16 100644--- a/apps/web/src/features/dashboard/CreatorCollaborationPanel.tsx+++ b/apps/web/src/features/dashboard/CreatorCollaborationPanel.tsx@@ -29,6 +29,7 @@ import {type CreatorStageProgressView} from './creator-panel-adapters.js';import { useOptionalCreatorSession } from './creator-session-store.js';+import CreatorArtifactDetails from './CreatorArtifactDetails.js';export type CreatorPanelQuickAction = {id: string;@@ -228,6 +229,7 @@ export default function CreatorCollaborationPanel(props: {<small>{l('当前任务', 'Current task')}</small><strong>{props.currentIssue ?? props.contextSummary}</strong></span>+ <CreatorArtifactDetails /></div>{session === null ? (diff --git a/apps/web/src/features/dashboard/CreatorResultVersionMenu.tsx b/apps/web/src/features/dashboard/CreatorResultVersionMenu.tsxindex bba164eb..18bf2b26 100644--- a/apps/web/src/features/dashboard/CreatorResultVersionMenu.tsx+++ b/apps/web/src/features/dashboard/CreatorResultVersionMenu.tsx@@ -1,6 +1,8 @@import { useEffect, useId, useRef, useState } from 'react';import { Check, ChevronDown, CircleCheck } from 'lucide-react';import { useLocalizedCopy } from '../../i18n/useLocalizedCopy.js';+import { readCreatorResultSnapshots } from '@opencreator/protocol';+import { useOptionalCreatorSession } from './creator-session-store.js';export type CreatorResultVersionItem = {value: number;@@ -13,10 +15,37 @@ export default function CreatorResultVersionMenu(props: {onVersionChange(version: number): void;}) {const l = useLocalizedCopy();+ const session = useOptionalCreatorSession();+ const [error, setError] = useState('');+ const [pending, setPending] = useState(false);+ const pendingRef = useRef(false);+ const snapshots = readCreatorResultSnapshots(session?.job.state.resultSnapshots);+ const selected = snapshots.find(snapshot => snapshot.version === props.version);+ const stale = selected !== undefined && (selected.staleArtifactIds.length > 0 ||+ session?.job.artifacts.some(artifact => artifact.status === 'stale' && selected.artifactRefs[artifact.kind]?.includes(artifact.id)));const [historyOpen, setHistoryOpen] = useState(false);const versionMenuRef = useRef<HTMLDivElement>(null);const menuId = useId();+ async function select(version: number) {+ if (pendingRef.current) return;+ pendingRef.current = true;+ setPending(true);+ setError('');+ try {+ if (session && snapshots.some(snapshot => snapshot.version === version)) {+ await session.applyAction({ action: 'select-result-version', input: { version } });+ }+ props.onVersionChange(version);+ setHistoryOpen(false);+ } catch (cause) {+ setError(cause instanceof Error ? cause.message : String(cause));+ } finally {+ pendingRef.current = false;+ setPending(false);+ }+ }+useEffect(() => {if (!historyOpen) return;@@ -39,7 +68,7 @@ export default function CreatorResultVersionMenu(props: {aria-controls={menuId}onClick={() => setHistoryOpen(open => !open)}>- <CircleCheck size={15} strokeWidth={2} aria-hidden="true" />+ {!stale ? <CircleCheck size={15} strokeWidth={2} aria-hidden="true" /> : null}<span>{l(`项目 V${props.version}`, `Project V${props.version}`)}</span><ChevronDown className="video-result-version-chevron" size={15} strokeWidth={1.8} aria-hidden="true" /></button>@@ -51,10 +80,12 @@ export default function CreatorResultVersionMenu(props: {role="menuitem"aria-current={item.value === props.version ? 'true' : undefined}key={item.value}- onClick={() => {- props.onVersionChange(item.value);- setHistoryOpen(false);- }}+ disabled={pending || session?.job.stages.some(stage => ['queued', 'running'].includes(stage.status))+ || (session !== null && !snapshots.some(snapshot => snapshot.version === item.value))}+ title={session !== null && !snapshots.some(snapshot => snapshot.version === item.value)+ ? l('无项目快照,请在产物版本与来源中浏览或下载', 'No project snapshot. Browse or download in artifact details.')+ : undefined}+ onClick={() => void select(item.value)}><span><strong>{l(`项目 V${item.value}`, `Project V${item.value}`)}</strong>@@ -65,6 +96,8 @@ export default function CreatorResultVersionMenu(props: {))}</div>) : null}+ {stale ? <small role="status">{l('包含过期结果', 'Contains stale results')}</small> : null}+ {error ? <small role="alert">{error}</small> : null}</div>);}diff --git a/apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsx b/apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsxindex 14c5db6a..50e84976 100644--- a/apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsx+++ b/apps/web/src/features/dashboard/ImageGenerationWorkspace.test.tsx@@ -68,7 +68,7 @@ describe('ImageGenerationWorkspace', () => {expect(screen.queryByRole('textbox', { name: '提示词' })).not.toBeInTheDocument();});- it('opens an existing project on its latest generated version', async () => {+ it('opens an existing project on its persisted result version', async () => {const fixture = createFixture();const createdAt = fixture.currentJob().createdAt;const versionOne = imageArtifact(fixture.currentJob().id, 1, createdAt);@@ -93,10 +93,10 @@ describe('ImageGenerationWorkspace', () => {renderWorkspace(fixture, initialJob);expect(await screen.findByRole('heading', { name: '生成结果' })).toBeInTheDocument();- expect(screen.getByRole('button', { name: '项目 V2' })).toBeInTheDocument();+ expect(screen.getByRole('button', { name: '项目 V1' })).toBeInTheDocument();await waitFor(() => expect(fixture.openArtifact).toHaveBeenCalledWith(initialJob.id,- versionTwo.id+ versionOne.id));});diff --git a/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx b/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsxindex 7aa0132a..a27d0516 100644--- a/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx+++ b/apps/web/src/features/dashboard/ImageGenerationWorkspace.tsx@@ -78,7 +78,7 @@ export default function ImageGenerationWorkspace(props: {const [count, setCount] = useState(() => readCount(session?.state.candidateCount));const [referenceFile, setReferenceFile] = useState<File | null>(null);const [referencePreview, setReferencePreview] = useState('');- const [resultVersion, setResultVersion] = useState<number>();+ const resultVersion = session?.job.state.resultVersion;const [imageUrls, setImageUrls] = useState<Record<string, string>>({});const [previewError, setPreviewError] = useState('');const [error, setError] = useState('');@@ -120,10 +120,6 @@ export default function ImageGenerationWorkspace(props: {const currentReferenceName = referenceFile?.name?? readArtifactString(activeReferenceArtifact, 'fileName');- useEffect(() => {- if (latestVersion !== undefined) setResultVersion(latestVersion);- }, [latestVersion]);-useEffect(() => {if (session !== null && session.state.provider !== 'openai') {session.updateDraft(@@ -322,7 +318,6 @@ export default function ImageGenerationWorkspace(props: {}function selectVersion(version: number) {- setResultVersion(version);openStep(2);setNotice(l(`正在查看 V${version}`, `Viewing V${version}`));}diff --git a/apps/web/src/features/dashboard/StickmanVideoWorkspace.tsx b/apps/web/src/features/dashboard/StickmanVideoWorkspace.tsxindex c24126e2..20b3fc68 100644--- a/apps/web/src/features/dashboard/StickmanVideoWorkspace.tsx+++ b/apps/web/src/features/dashboard/StickmanVideoWorkspace.tsx@@ -149,7 +149,7 @@ export default function StickmanVideoWorkspace(props: {const { job, state } = session;const [activeStep, setActiveStep] = useState(0);const [notice, setNotice] = useState('');- const [selectedVersion, setSelectedVersion] = useState(0);+ const selectedVersion = typeof session?.job.state.resultVersion === 'number' ? session.job.state.resultVersion : 0;const [controlPending, setControlPending] = useState<'canceling' | 'resuming'>();const [ttsConfigurationStatus, setTtsConfigurationStatus] = useState<TtsConfigurationStatus>('loading');const [imageConfigurationStatus, setImageConfigurationStatus] = useState<ImageConfigurationStatus>('loading');@@ -332,7 +332,6 @@ export default function StickmanVideoWorkspace(props: {const previousVersion = observedSnapshotVersion.current;observedSnapshotVersion.current = latestSnapshot?.version;if (latestSnapshot === undefined) return;- setSelectedVersion(latestSnapshot.version);if (previousVersion !== latestSnapshot.version) {setActiveStep(current => current === 4 ? 5 : current);}@@ -844,7 +843,7 @@ export default function StickmanVideoWorkspace(props: {versions={snapshots.map(snapshot => ({ value: snapshot.version, description: snapshot.description }))}manifest={deliveryManifest}l={l}- onVersionChange={setSelectedVersion}+ onVersionChange={() => setActiveStep(5)}onOpen={artifact => void openArtifact(session.openArtifact, artifact)}onDownload={artifact => void downloadArtifact(session.openArtifact, artifact)}onBack={() => setActiveStep(4)}diff --git a/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsx b/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsxindex 3c3cfe2e..e5070b32 100644--- a/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsx+++ b/apps/web/src/features/dashboard/VideoGenerationWorkspace.test.tsx@@ -324,7 +324,10 @@ function renderWorkspace(<CreatorSessionProviderinitialJob={initialJob}service={{- applyAction: vi.fn(),+ applyAction: vi.fn(async (_id, request) => ({+ job: { ...initialJob, revision: initialJob.revision + 1, state: { ...initialJob.state, ...(request.action === 'select-result-version' ? { resultVersion: request.input.version } : request.input.patch) } },+ receipt: {}+ })),openArtifact: overrides.openArtifact ?? vi.fn(),runAgentTurn: vi.fn()} as never}diff --git a/apps/web/src/features/dashboard/VideoGenerationWorkspace.tsx b/apps/web/src/features/dashboard/VideoGenerationWorkspace.tsxindex 655c0064..79136e5f 100644--- a/apps/web/src/features/dashboard/VideoGenerationWorkspace.tsx+++ b/apps/web/src/features/dashboard/VideoGenerationWorkspace.tsx@@ -111,7 +111,7 @@ export default function VideoGenerationWorkspace(props: {const [duration, setDuration] = useState<VideoGenerationDuration>(() => (readDuration(session?.state.duration, readProvider(session?.state.provider))));- const [resultVersion, setResultVersion] = useState<number>();+ const resultVersion = session?.job.state.resultVersion;const [videoUrl, setVideoUrl] = useState('');const [previewError, setPreviewError] = useState('');const [error, setError] = useState('');@@ -185,10 +185,6 @@ export default function VideoGenerationWorkspace(props: {? l('正在准备任务', 'Preparing the task'): videoPhaseLabel(readString(latestStage.progress.phase), l);- useEffect(() => {- if (latestVersion !== undefined) setResultVersion(latestVersion);- }, [latestVersion]);-useEffect(() => {if (props.creatorServicesService === null || props.creatorServicesService === undefined) {return undefined;@@ -475,7 +471,6 @@ export default function VideoGenerationWorkspace(props: {}function selectVersion(version: number) {- setResultVersion(version);openStep(2);setNotice(l(`正在查看 V${version}`, `Viewing V${version}`));}diff --git a/apps/web/src/features/dashboard/VideoTranslationWorkspace.control.test.tsx b/apps/web/src/features/dashboard/VideoTranslationWorkspace.control.test.tsxindex cadc959c..7e411667 100644--- a/apps/web/src/features/dashboard/VideoTranslationWorkspace.control.test.tsx+++ b/apps/web/src/features/dashboard/VideoTranslationWorkspace.control.test.tsx@@ -372,7 +372,7 @@ describe('VideoTranslationWorkspace task controls', () => {))).toBe(true);});- it('opens an existing project on its latest completed version', async () => {+ it('opens an existing project on its persisted completed version', async () => {const artifacts = [subtitleArtifact(1, '第一版本字幕'),subtitleArtifact(2, '第二版本字幕')@@ -426,9 +426,9 @@ describe('VideoTranslationWorkspace task controls', () => {);expect(await screen.findByRole('heading', { name: '视频翻译项目' })).toBeInTheDocument();- expect(screen.getByRole('button', { name: '项目 V2' })).toBeInTheDocument();+ expect(screen.getByRole('button', { name: '项目 V1' })).toBeInTheDocument();expect(screen.getByRole('tab', { name: '生成物' })).toHaveAttribute('aria-selected', 'true');- expect(screen.getByText('target-subtitle-v2.srt')).toBeInTheDocument();+ expect(screen.getByText('target-subtitle-v1.srt')).toBeInTheDocument();expect(screen.queryByText('正在基于 V1 调整')).not.toBeInTheDocument();fireEvent.click(screen.getByRole('tab', { name: '配音' }));diff --git a/apps/web/src/features/dashboard/VideoTranslationWorkspace.tsx b/apps/web/src/features/dashboard/VideoTranslationWorkspace.tsxindex eeffbb97..614bcba2 100644--- a/apps/web/src/features/dashboard/VideoTranslationWorkspace.tsx+++ b/apps/web/src/features/dashboard/VideoTranslationWorkspace.tsx@@ -1370,11 +1370,13 @@ export default function VideoTranslationWorkspace(props: {latestVersion: latest?.value ?? null};setResultVersions(artifactVersions);+ const persistedVersion = artifactVersions.find(version => version.value === persisted.resultVersion);+ if (persistedVersion !== undefined) setResultVersion(persistedVersion.value);if (latest !== undefined) {if (!shouldRestoreLatestResult) return;setCurrentStep(3);setFurthestStep(3);- setResultVersion(latest.value);+ setResultVersion(persistedVersion?.value ?? latest.value);setDraftBaseVersion(latest.value);setResultTab('video');setWorkspacePhase('result');@@ -1457,7 +1459,6 @@ export default function VideoTranslationWorkspace(props: {currentStep,furthestStep,workspacePhase,- resultVersion: resultVersions.length > 0 ? resultVersion : null,latestResultVersion: resultVersions.at(-1)?.value ?? null,resultTab,resultVersions: serializeResultVersions(resultVersions),diff --git a/apps/web/src/features/dashboard/creator-artifact-details.css b/apps/web/src/features/dashboard/creator-artifact-details.cssnew file mode 100644index 00000000..37303e41--- /dev/null+++ b/apps/web/src/features/dashboard/creator-artifact-details.css@@ -0,0 +1,17 @@+.creator-artifact-details { grid-column: 1 / -1; min-width: 0; border-top: 1px solid var(--border); padding-top: 8px; font-size: 12px; line-height: 1.5; color: var(--text); }+.creator-artifact-details summary { cursor: pointer; font-weight: 600; }+.creator-artifact-details section { display: grid; gap: 10px; max-height: min(40vh, 380px); overflow: auto; padding-top: 12px; }+.creator-artifact-details label { display: grid; gap: 4px; }+.creator-artifact-details select { width: 100%; min-width: 0; padding: 6px; color: inherit; background: var(--surface, #fff); }+.creator-artifact-details dl { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 6px 12px; margin: 0; }+.creator-artifact-details dd { margin: 0; overflow-wrap: anywhere; }+.creator-artifact-details p, .creator-artifact-details h3 { margin: 0; font-size: 12px; }+.creator-artifact-details button { padding: 6px; cursor: pointer; border: 1px solid var(--border); border-radius: 4px; background: var(--surface-2); color: var(--text); }+.creator-artifact-details button:disabled { cursor: default; opacity: .55; }+.creator-artifact-comparison { display: grid; grid-template-columns: repeat(auto-fit, minmax(120px, 1fr)); gap: 10px; }+.creator-artifact-comparison > div { min-width: 0; display: grid; align-content: start; gap: 6px; }+.creator-artifact-comparison strong { overflow-wrap: anywhere; font-size: 12px; }+.creator-artifact-comparison img, .creator-artifact-comparison audio, .creator-artifact-comparison video { width: 100%; }+.creator-artifact-comparison pre { margin: 0; max-height: 300px; overflow: auto; font-size: 11px; white-space: pre-wrap; overflow-wrap: anywhere; }+.creator-artifact-comparison pre span { display: block; }+.creator-artifact-comparison .is-changed { background: #fff0b3; color: #3d3100; }diff --git a/apps/web/src/features/dashboard/creator-panel-adapters.ts b/apps/web/src/features/dashboard/creator-panel-adapters.tsindex 0c17a01a..019cfec8 100644--- a/apps/web/src/features/dashboard/creator-panel-adapters.ts+++ b/apps/web/src/features/dashboard/creator-panel-adapters.ts@@ -794,6 +794,9 @@ function normalizeCommonActivity() => string | null = () => null): NormalizedCreatorActivity | null {if (activity.action === 'create-job') return null;+ if (activity.action === 'select-result-version') {+ return { label: l(`选择了项目结果 V${activity.details.version}`, `Selected project result V${activity.details.version}`), fields: [] };+ }if (activity.action.startsWith('update-settings')) {const objectId = readString(activity.details.objectId) ?? '';const fields = objectIddiff --git a/docs/creator-artifact-versions.md b/docs/creator-artifact-versions.mdnew file mode 100644index 00000000..d6c8868d--- /dev/null+++ b/docs/creator-artifact-versions.md@@ -0,0 +1,17 @@+# Creator Artifact 版本与来源(第一版)++本实现基于 `origin/develop@1437396`;发布状态以合并和发行记录为准。+主线已有 Artifact、sourceArtifactIds、结果快照、历史结果菜单和文件接口。本次补充共享详情与持久化选择,不实现 DAG、自动恢复或媒体内容比较。++- `CreatorArtifactDetails` 位于唯一 `CreatorCollaborationPanel` 的任务上下文中,所有模板复用。+- `state.resultVersion` 仍是项目结果选择;详情内的产物/比较选择仅用于浏览,不作为第二套项目版本状态。+- `select-result-version` 由模板注册器统一提供,通过已有 REST / Agent Command Dispatcher 执行;同一事务保存新 Revision、Activity、Receipt。已有队列或运行阶段时拒绝切换。+- 命令选择整个项目结果快照,不修改生成设置、不启动 Stage、不修改 Artifact、旧快照或 stale 标记。图像、封面、视频、视频翻译和火柴人结果读取持久选择。+- 详情从 `changedArtifactIds` 读取生成快照,从 `sourceArtifactIds` 追踪上游。缺失来源或生成信息明确显示未知,不猜测 Stage。+- stale 原因仅显示上游 stale、缺失来源或快照失效记录。当前选中不等于当前有效。+- 同一项目内的历史文件继续通过鉴权后的 Artifact content 接口下载,包括未被快照引用的 stale 文件。无快照的旧产物不支持项目采用,只能浏览与下载。+- 文本按行号并排高亮,最多 20 万字符、显示 2000 行;插入行会使后续行高亮,不作智能对齐。图片、音频、视频使用原生预览并排展示。++验证:Daemon/Web 类型检查及构建、Dispatcher/API SQLite 重开持久化测试、公共组件测试、图像与封面复用测试、受影响工作区测试通过。真实 Chromium 的 Browser/Desktop Bridge 测试验证相同视口、文案、详情尺寸、Command 请求、刷新恢复、下载及预览。++未运行实际打包 Electron App 或包内 Web 哈希门禁;本次不是 Desktop 交付任务,不据此声明可发布或实际 App 已验收。无 Provider 执行,也未运行全量测试。原工作区字幕导出修改保留不动。