Files
makelore/shared/image-workspace.ts
brother7 15b17775cb 完善 AI 设计资产预览与视频首帧选择
需求:生成图片需要支持大图查看和本地下载;制作视频时需要从当前项目作品选择首帧,或上传本地图片。

实现:新增首帧选择弹窗、JPEG/PNG/WebP 有界上传、附件 Asset ID 透传、Main 到服务端 multipart 转发,并保留上传失败重试与私有图片下载链路。

验证:相关 57 项单测、TypeScript 类型检查、目标 ESLint 和 Vite 生产构建全部通过。
2026-08-06 11:31:47 +08:00

170 lines
4.3 KiB
TypeScript

export const IMAGE_WORKSPACE_UNAVAILABLE_CODE = 'IMAGE_WORKSPACE_UNAVAILABLE';
export const IMAGE_WORKSPACE_UNAVAILABLE_MESSAGE = 'AI 设计暂不可用';
export const IMAGE_WORKSPACE_API_PATH = '/api/works/image-workspace';
export type DesignMedium = 'image' | 'video';
export type DesignWorkspacePhase = 'shaping' | 'awaiting_confirmation' | 'blocked';
export type DesignTaskStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
export type DesignQuoteStatus = 'active' | 'consumed' | 'expired' | 'superseded';
export type DesignCapabilities = {
conversation: boolean;
generation: boolean;
image: boolean;
video: boolean;
};
export type DesignBrief = {
version: number;
status: 'draft' | 'ready' | 'confirmed';
medium: DesignMedium | null;
summary: string;
ready: boolean;
missingDecision: string | null;
};
export type DesignGenerationQuote = {
quoteId: string;
status: DesignQuoteStatus;
medium: DesignMedium;
briefVersion: number;
briefSummary: string;
quotedDesignPoints: number;
expiresAt: string;
};
export type DesignMessage = {
id: string;
role: 'user' | 'assistant';
kind: 'user' | 'reply' | 'choice' | 'confirmation' | 'safety_redirect' | 'failure';
text: string;
quickReplies: string[];
generationQuote: DesignGenerationQuote | null;
turnRevision: number;
createdAt: string;
};
export type DesignWorkspaceSummary = {
workspaceId: string;
title: string;
turnRevision: number;
viewRevision: number;
phase: DesignWorkspacePhase;
brief: DesignBrief;
updatedAt: string;
};
export type DesignWorkspace = DesignWorkspaceSummary & {
messages: DesignMessage[];
};
export type DesignAsset = {
assetId: string;
workspaceId: string;
mediaType: DesignMedium;
mimeType: string;
width: number;
height: number;
durationMilliseconds: number | null;
createdAt: string;
contentPath: string;
};
export type DesignAssetSaveResult = {
status: 'saved' | 'cancelled';
};
export type DesignImageUploadMimeType = 'image/jpeg' | 'image/png' | 'image/webp';
export type DesignAssetUploadInput = {
workspaceId: string;
fileName: string;
mimeType: DesignImageUploadMimeType;
bytes: Uint8Array;
};
export type DesignGenerationTask = {
taskId: string;
workspaceId: string;
medium: DesignMedium;
status: DesignTaskStatus;
briefVersion: number;
briefSummary: string;
quoteId: string | null;
quotedDesignPoints: number | null;
failureCode: string | null;
resultAssets: DesignAsset[];
createdAt: string;
updatedAt: string;
};
export type DesignGenerationTaskUpdatedEvent = {
id: string;
type: 'design.generation_task.updated';
workspaceId: string;
workspaceViewRevision: number;
generationTask: DesignGenerationTask;
};
export type DesignGenerationTasksSnapshotEvent = {
id: string;
type: 'design.generation_tasks.snapshot';
workspaceId: string;
workspaceViewRevision: number;
workspace: DesignWorkspace;
generationTasks: DesignGenerationTask[];
};
export type DesignAssistantDeltaEvent = {
id: string;
type: 'design.assistant.delta';
workspaceId: string;
clientTurnId: string;
turnRevision: number;
chunkIndex: number;
delta: string;
};
export type DesignWorkspaceEvent =
| DesignGenerationTaskUpdatedEvent
| DesignGenerationTasksSnapshotEvent
| DesignAssistantDeltaEvent;
export type DesignWorkspaceBootstrap = {
capabilities: DesignCapabilities;
workspaces: DesignWorkspaceSummary[];
};
export type DesignCreateWorkspaceInput = {
clientWorkspaceId: string;
title: string;
};
export type DesignRenameWorkspaceInput = {
workspaceId: string;
title: string;
};
export type DesignSubmitMessageInput = {
workspaceId: string;
clientTurnId: string;
expectedTurnRevision: number;
message: string;
attachmentAssetIds?: string[];
};
export type DesignConfirmGenerationInput = {
workspaceId: string;
clientTurnId: string;
expectedTurnRevision: number;
quoteId: string;
};
export function designAssetContentPath(workspaceId: string, assetId: string): string {
return `${IMAGE_WORKSPACE_API_PATH}/workspaces/${encodeURIComponent(workspaceId)}/assets/${encodeURIComponent(assetId)}/content`;
}
export function designAssetDownloadPath(workspaceId: string, assetId: string): string {
return `${IMAGE_WORKSPACE_API_PATH}/workspaces/${encodeURIComponent(workspaceId)}/assets/${encodeURIComponent(assetId)}/download`;
}