GAME ASSETS
+资产导出
+逐帧透明 PNG、Sprite Sheet 与动画 JSON
+-
+
- 当前阶段 +
- {STAGE_LABELS[model.stage]} +
- 已确认首帧 +
- {model.firstFrames.length} 张 +
- 动作方向 +
- {plan.length} 组 +
- 逐帧原图 +
- + {plan.reduce((total, item) => total + item.frames.length, 0)} 张 + +
- 每行上限 +
- 8 帧 +
+ 当前有 {qualityIssueCount} 项质量问题，全部通过后才能导出 +
+ ) : null} + + {state.status === 'working' ? ( ++ {PHASE_LABELS[state.phase]} +
+ ) : state.status === 'failure' ? ( ++ 导出失败：{state.message} +
+ ) : state.status === 'success' ? ( +下载完成
+ ) : null} + + + {plan.length === 0 ?当前包含角色母版
: null} +- 导出能力待 PR #97 合并并完成资产字段接线 -
@@ -149,6 +140,7 @@ export function CharacterDetailPage() {+ 导出不可用：{result.error} +
+ ) + } + if (result.model === null || result.model.actions.length === 0) return null + return ( +
+
+ )
+}
+
function OutfitMaster({ character, outfit }: { character: Character; outfit: Outfit }) {
const name = characterName(character)
return (
diff --git a/frontend/src/pages/playtest/index.test.tsx b/frontend/src/pages/playtest/index.test.tsx
index d10daae6..e3a60a83 100644
--- a/frontend/src/pages/playtest/index.test.tsx
+++ b/frontend/src/pages/playtest/index.test.tsx
@@ -46,6 +46,7 @@ describe('PlaytestPage', () => {
expect(await screen.findByRole('heading', { name: '51 · 常态造型' })).toBeTruthy()
expect(screen.getByRole('button', { name: '绑定动作：呼吸待机' })).toBeTruthy()
expect(screen.getByRole('button', { name: '绑定动作：行走' })).toBeTruthy()
+ expect(screen.getByRole('button', { name: '导出Playtest 运行包' })).toBeTruthy()
})
it('plays frames in backend index order, not array order', async () => {
@@ -98,4 +99,26 @@ describe('PlaytestPage', () => {
expect(await screen.findByRole('heading', { name: '52 · 未命名造型' })).toBeTruthy()
expect(screen.getByText('暂无可播放帧')).toBeTruthy()
})
+
+ it('旧资产缺少角色母版时仍可试玩，但不显示无效导出入口', async () => {
+ const backend = createProjectAssetsBackend()
+ const fetchWithoutMaster: typeof globalThis.fetch = async (input, init) => {
+ const response = await backend.fetch(input, init)
+ if (new URL(new Request(input, init).url).pathname !== '/characters/51') return response
+ const body = (await response.json()) as {
+ data: {
+ reference_image_url: string | null
+ character_data: { outfits: Array<{ preview_url: string | null }> }
+ }
+ }
+ body.data.reference_image_url = null
+ body.data.character_data.outfits[0]!.preview_url = null
+ return new Response(JSON.stringify(body), { headers: { 'content-type': 'application/json' } })
+ }
+
+ renderPlaytest('/playtest/51/outfit-default', fetchWithoutMaster)
+
+ expect(await screen.findByRole('heading', { name: '51 · 常态造型' })).toBeTruthy()
+ expect(screen.queryByRole('button', { name: '导出Playtest 运行包' })).toBeNull()
+ })
})
diff --git a/frontend/src/pages/playtest/index.tsx b/frontend/src/pages/playtest/index.tsx
index 5e038fac..11024969 100644
--- a/frontend/src/pages/playtest/index.tsx
+++ b/frontend/src/pages/playtest/index.tsx
@@ -1,20 +1,30 @@
-import { useEffect, useState } from 'react'
+import { useEffect, useState, type ReactNode } from 'react'
import { useParams, useSearchParams } from 'react-router'
-import { characterApis, type Character } from '@/entities'
+import { characterApis, projectApis, type Character, type Project } from '@/entities'
import { ApiError } from '@/shared/api'
import { PlaytestWorkbench } from './workbench'
export { PlaytestEntryPage } from './entry'
+export interface PlaytestPageProps {
+ renderToolbar?(context: {
+ project: Project
+ character: Character
+ outfitId: string
+ initialActionId: string | null
+ }): ReactNode
+}
+
interface PageData {
character: Character | null
+ project: Project | null
error: string | null
loading: boolean
}
-const initialPageData: PageData = { character: null, error: null, loading: false }
+const initialPageData: PageData = { character: null, project: null, error: null, loading: false }
/**
* 后端把「角色不存在」表达成 HTTP 200 里的业务码 404，真正的传输失败才落在 status 上。
@@ -29,7 +39,7 @@ function isNotFoundError(error: unknown): boolean {
* 页面只读 Character，不写回资产树，也不参与生成与审核。
* 读不到角色时直接报错，不退回任何内置数据。
*/
-export function PlaytestPage() {
+export function PlaytestPage({ renderToolbar }: PlaytestPageProps = {}) {
const { characterId, outfitId } = useParams()
const [searchParams] = useSearchParams()
const initialActionId = searchParams.get('actionId')
@@ -40,19 +50,25 @@ export function PlaytestPage() {
let cancelled = false
setData({ ...initialPageData, loading: true })
- void characterApis.get(characterId).then(
- (character) => {
- if (!cancelled) setData({ character, error: null, loading: false })
- },
- (error: unknown) => {
- if (!cancelled) {
- setData({
- ...initialPageData,
- error: isNotFoundError(error) ? '角色不存在' : '角色读取失败',
- })
- }
- },
- )
+ void characterApis
+ .get(characterId)
+ .then(async (character) => ({
+ character,
+ project: await projectApis.get(character.projectId),
+ }))
+ .then(
+ ({ character, project }) => {
+ if (!cancelled) setData({ character, project, error: null, loading: false })
+ },
+ (error: unknown) => {
+ if (!cancelled) {
+ setData({
+ ...initialPageData,
+ error: isNotFoundError(error) ? '角色不存在' : '角色读取失败',
+ })
+ }
+ },
+ )
return () => {
cancelled = true
@@ -62,14 +78,22 @@ export function PlaytestPage() {
if (characterId === undefined || outfitId === undefined)
return A / D 或方向键操控角色
+
+
{/*
diff --git a/frontend/src/pages/playtest/workbench/minimal-workbench.test.tsx b/frontend/src/pages/playtest/workbench/minimal-workbench.test.tsx
index 0d0806eb..ba622fad 100644
--- a/frontend/src/pages/playtest/workbench/minimal-workbench.test.tsx
+++ b/frontend/src/pages/playtest/workbench/minimal-workbench.test.tsx
@@ -28,7 +28,7 @@ const character: Character = {
characterId: '51',
name: '常态造型',
description: null,
- previewUrl: null,
+ previewUrl: '/master.png',
actions: [
{
id: IDLE_ACTION_ID,
diff --git a/frontend/src/pages/project-detail/index.tsx b/frontend/src/pages/project-detail/index.tsx
index b1944dff..ee035143 100644
--- a/frontend/src/pages/project-detail/index.tsx
+++ b/frontend/src/pages/project-detail/index.tsx
@@ -158,7 +158,7 @@ export function ProjectDetailPage() {
data-route-transition={location.pathname}
className="route-transition min-h-full"
>
- A / D 或方向键操控角色
+ {toolbar} +
-
-
-
- CURRENT STATUS
-
- {status.title}
-
+
getActionFrames(): Promise
+ /** 按当前 Run 完成度装配统一导出包；角色母版尚未确认时返回 null。 */
+ getExportModel(): Promise
}
export interface QuickStartEntryService {
@@ -77,6 +81,7 @@ export interface CreateQuickStartServiceOptions {
workflowRunApis: WorkflowRunApis
generationApis: GenerationApis
prepareProject: PrepareQuickStartProject
+ projectApis?: Pick
characterApis?: CharacterApis
mediaApis?: QuickStartMediaApis
onAsyncError?: (error: Error) => void
@@ -90,6 +95,7 @@ export function createQuickStartService({
workflowRunApis,
generationApis,
prepareProject,
+ projectApis: exportProjectApis,
characterApis,
mediaApis,
onAsyncError = (error) => console.error('[quick-start] 异步工作流错误', error),
@@ -515,6 +521,30 @@ export function createQuickStartService({
}))
: []
},
+ async getExportModel() {
+ if (!characterApis || !exportProjectApis) return null
+ const info = getCharacterInfo(controller) ?? (await resolveCharacterInfo(controller))
+ if (!info) return null
+ const run = controller.getWorkflow()
+ const [project, character] = await Promise.all([
+ exportProjectApis.get(run.projectId),
+ characterApis.get(info.characterId),
+ ])
+ const generations = await Promise.all(
+ run.nodes
+ .filter((node) => node.type === 'action-full-frame' && !node.deletedAt)
+ .map((node) => controller.getGeneration(node.id, 'complete_animation')),
+ )
+ return createProgressiveExportModel({
+ project,
+ character,
+ outfitId: info.outfitId,
+ run,
+ generations: generations.filter(
+ (generation): generation is Generation => generation !== null,
+ ),
+ })
+ },
}
}
@@ -624,6 +654,7 @@ export function createRealQuickStartService({
workflowRunApis,
generationApis,
prepareProject: createAutoPrepareProject(projectApis),
+ projectApis,
characterApis,
mediaApis,
onAsyncError,
diff --git a/frontend/src/pages/workflow-editor/index.test.tsx b/frontend/src/pages/workflow-editor/index.test.tsx
index 609272c7..d1a14166 100644
--- a/frontend/src/pages/workflow-editor/index.test.tsx
+++ b/frontend/src/pages/workflow-editor/index.test.tsx
@@ -206,7 +206,13 @@ describe('WorkflowEditorPage real runtime boundary', () => {
})
const confirmCharacterTemplate = vi.fn(async (nodeId: string, imageUrl: string) => {
await session.controller.confirmCharacterTemplate(nodeId, imageUrl)
- return characterFixture()
+ const character = characterFixture()
+ return {
+ ...character,
+ outfits: character.outfits.map((outfit, index) =>
+ index === 0 ? { ...outfit, previewUrl: imageUrl } : outfit,
+ ),
+ }
})
session.confirmCharacterTemplate = confirmCharacterTemplate
defaultSessionLoader.mockResolvedValue(session)
@@ -221,6 +227,7 @@ describe('WorkflowEditorPage real runtime boundary', () => {
'https://assets.windup.test/character.png',
),
)
+ expect(await screen.findByRole('button', { name: '导出角色母版' })).toBeTruthy()
fireEvent.click(await screen.findByRole('button', { name: '添加动作分支' }))
expect((screen.getByRole('button', { name: '生成动作 ›' }) as HTMLButtonElement).disabled).toBe(
false,
diff --git a/frontend/src/pages/workflow-editor/index.tsx b/frontend/src/pages/workflow-editor/index.tsx
index ce34e4ed..4c2121f2 100644
--- a/frontend/src/pages/workflow-editor/index.tsx
+++ b/frontend/src/pages/workflow-editor/index.tsx
@@ -32,6 +32,7 @@ import {
type WorkflowRun,
} from '@/entities'
import type { WorkflowController } from '@/features/workflow-controller'
+import { createProgressiveExportModel, ExportButton } from '@/features/export-package'
import { createDefaultRealWorkflowEditorSession, type WorkflowEditorSession } from './runtime'
import './workflow-editor.css'
@@ -461,6 +462,24 @@ interface ProjectionInput {
runCommand(branchKey: string, command: () => Promise): void
}
+function NodeExportButton({ input, outfitId }: { input: ProjectionInput; outfitId: string }) {
+ if (!input.character) return null
+ try {
+ const model = createProgressiveExportModel({
+ project: input.project,
+ character: input.character,
+ outfitId,
+ run: input.run,
+ generations: Object.values(input.generations).filter(
+ (generation): generation is Generation => generation !== null,
+ ),
+ })
+ return 
身份已锁定
+ {outfit ?
+ {exportModel ? (
+
diff --git a/frontend/src/pages/quick-start/service.ts b/frontend/src/pages/quick-start/service.ts
index e6ad52bb..997ef947 100644
--- a/frontend/src/pages/quick-start/service.ts
+++ b/frontend/src/pages/quick-start/service.ts
@@ -8,6 +8,7 @@ import {
type Character,
type CharacterApis,
type GenerationApis,
+ type Generation,
type MediaReference,
type Project,
type ProjectApis,
@@ -18,6 +19,7 @@ import {
import { getApiAccessToken, recoverApiUnauthorized, resolveApiBaseUrl } from '@/shared/api'
import { createEventStreamSubscriber } from '@/shared/api/stream'
import { createWorkflowController, type WorkflowController } from '@/features/workflow-controller'
+import { createProgressiveExportModel, type ExportPackageModel } from '@/features/export-package'
/** 页面不直接拼接后端字段；只负责准备项目约束。 */
export type PrepareQuickStartProject = (
@@ -56,6 +58,8 @@ export interface QuickStartSession {
resolveCharacterInfo(): Promise<{ characterId: string; outfitId: string } | null>
getTemplateCandidates(): Promise
+
+
+
+ CURRENT STATUS
+
+ {status.title}
+
+
+ 
+
+ )
}
return
- {frames.map((frame, index) => (
- 
- ))}
+
+
)
}
@@ -1025,7 +1063,21 @@ function ReviewContent({ node, input }: { node: ReviewWorkflowNode; input: Proje
const branchKey = branchKeyOf(node, input)
const branchBusy = input.busyBranches.has(branchKey)
if (node.status === 'failed') return
+ {frames.map((frame, index) => (
+
+ ))}
+
+ {firstFrameNode ? (
+ 审核已通过
+ if (node.phase === 'completed') { + const fullFrame = findDependency(input.run, node, 'action-full-frame') + const method = fullFrame + ? findDependency(input.run, fullFrame, 'action-generation-method') + : null + const firstFrame = method ? findDependency(input.run, method, 'action-first-frame') : null + return ( +
+
+ )
+ }
if (node.status !== 'active') return 审核已通过
+ {firstFrame ? ( +