Files
Pre_Seg_Server/src/store/useStore.ts
admin 689a9ba283 feat: 建立 SAM2 标注闭环基线
- 打通工作区真实标注闭环:支持手工多边形、矩形、圆形、点区域和线段生成 mask,并可保存、回显、更新和删除后端 annotation。

- 增强 polygon 编辑器:支持顶点拖动、顶点删除、边中点插入、多 polygon 子区域选择编辑,以及区域合并和区域去除。

- 接入 GT mask 导入:后端支持二值/多类别 mask 拆分、contour 转 polygon、distance transform seed point,前端支持导入、回显和 seed point 拖动编辑。

- 完善导出能力:COCO JSON 导出对齐前端,PNG mask ZIP 同时包含单标注 mask、按 zIndex 融合的 semantic_frame 和 semantic_classes.json。

- 打通异步任务管理:新增任务取消、重试、失败详情接口与 Dashboard 控件,worker 支持取消状态检查并通过 Redis/WebSocket 推送 cancelled 事件。

- 对接 Dashboard 后端数据:概览统计、解析队列和实时流转记录从 FastAPI 聚合接口与 WebSocket 更新。

- 增强 AI 推理参数:前端发送 crop_to_prompt、auto_filter_background 和 min_score,后端支持点/框 prompt 局部裁剪推理、结果回映射和负向点/低分过滤。

- 接入 SAM3 基础设施:新增独立 Python 3.12 sam3 环境安装脚本、外部 worker helper、后端桥接和真实 Python/CUDA/包/HF checkpoint access 状态检测。

- 保留 SAM3 授权边界:当前官方 facebook/sam3 gated 权重未授权时状态接口会返回不可用,不伪装成可推理。

- 增强前端状态管理:新增 mask undo/redo 历史栈、AI 模型选择状态、保存状态 dirty/draft/saved 流转和项目状态归一化。

- 更新前端 API 封装:补充 annotation CRUD、GT mask import、mask ZIP export、task cancel/retry/detail、AI runtime status 和 prediction options。

- 更新 UI 控件:ToolsPalette、AISegmentation、VideoWorkspace 和 CanvasArea 接入真实操作、导入导出、撤销重做、任务控制和模型状态。

- 新增 polygon-clipping 依赖,用于前端区域 union/difference 几何运算。

- 完善后端 schemas/status/progress:补充 AI 模型外部状态字段、任务 cancelled 状态和进度事件 payload。

- 补充测试覆盖:新增后端任务控制、SAM3 桥接、GT mask、导出融合、AI options 测试;补充前端 Canvas、Dashboard、VideoWorkspace、ToolsPalette、API 和 store 测试。

- 更新 README、AGENTS 和 doc 文档:冻结当前需求/设计/测试计划,标注真实功能、剩余 Mock、SAM3 授权边界和后续实施顺序。
2026-05-01 15:26:25 +08:00

290 lines
7.7 KiB
TypeScript

import { create } from 'zustand';
export interface Project {
id: string;
name: string;
description?: string;
status: 'pending' | 'parsing' | 'ready' | 'error';
fps?: string;
frames?: number;
thumbnail?: string;
thumbnail_url?: string;
video_path?: string;
source_type?: string;
original_fps?: number;
parse_fps?: number;
createdAt?: string;
updatedAt?: string;
}
export type AiModelId = 'sam2' | 'sam3';
export interface Frame {
id: string;
projectId: string;
index: number;
url: string;
width: number;
height: number;
timestamp?: string;
}
export interface Annotation {
id: string;
frameId: string;
type: 'polygon' | 'rectangle' | 'circle' | 'point' | 'mask';
points: number[];
label: string;
color: string;
zIndex?: number;
confidence?: number;
metadata?: Record<string, unknown>;
}
export interface Mask {
id: string;
frameId: string;
annotationId?: string;
templateId?: string;
classId?: string;
className?: string;
classZIndex?: number;
saveStatus?: 'draft' | 'saved' | 'dirty' | 'saving' | 'error';
saved?: boolean;
pathData: string;
label: string;
color: string;
opacity?: number;
segmentation?: number[][];
points?: number[][];
bbox?: [number, number, number, number];
area?: number;
metadata?: Record<string, unknown>;
}
export interface Template {
id: string;
name: string;
description?: string;
classes: TemplateClass[];
rules?: TemplateRule[];
createdAt?: string;
updatedAt?: string;
}
export interface TemplateClass {
id: string;
name: string;
color: string;
zIndex: number;
category?: string;
description?: string;
}
export interface TemplateRule {
id: string;
name: string;
sourceKey: string;
targetKey: string;
operation: string;
}
export interface AppState {
// Auth
isAuthenticated: boolean;
token: string | null;
login: (token: string) => void;
logout: () => void;
// Projects
projects: Project[];
currentProject: Project | null;
setProjects: (projects: Project[]) => void;
setCurrentProject: (project: Project | null) => void;
addProject: (project: Project) => void;
updateProject: (project: Project) => void;
// Workspace
activeModule: string;
activeTool: string;
aiModel: AiModelId;
frames: Frame[];
currentFrameIndex: number;
annotations: Annotation[];
masks: Mask[];
maskHistory: Mask[][];
maskFuture: Mask[][];
setActiveModule: (module: string) => void;
setActiveTool: (tool: string) => void;
setAiModel: (model: AiModelId) => void;
setFrames: (frames: Frame[]) => void;
setCurrentFrame: (index: number) => void;
addAnnotation: (annotation: Annotation) => void;
addMask: (mask: Mask) => void;
updateMask: (id: string, updates: Partial<Mask>) => void;
setMasks: (masks: Mask[]) => void;
clearMasks: () => void;
undoMasks: () => void;
redoMasks: () => void;
removeAnnotation: (id: string) => void;
// Templates
templates: Template[];
activeTemplateId: string | null;
activeClassId: string | null;
activeClass: TemplateClass | null;
setTemplates: (templates: Template[]) => void;
setActiveTemplateId: (id: string | null) => void;
setActiveClassId: (id: string | null) => void;
setActiveClass: (templateClass: TemplateClass | null) => void;
addTemplate: (template: Template) => void;
updateTemplate: (template: Template) => void;
removeTemplate: (id: string) => void;
// UI
isLoading: boolean;
error: string | null;
setLoading: (loading: boolean) => void;
setError: (error: string | null) => void;
}
export const useStore = create<AppState>((set) => ({
// Auth
isAuthenticated: false,
token: null,
login: (token: string) => {
localStorage.setItem('token', token);
set({ isAuthenticated: true, token });
},
logout: () => {
localStorage.removeItem('token');
set({
isAuthenticated: false,
token: null,
currentProject: null,
projects: [],
templates: [],
frames: [],
annotations: [],
masks: [],
maskHistory: [],
maskFuture: [],
activeTemplateId: null,
activeClassId: null,
activeClass: null,
});
},
// Projects
projects: [],
currentProject: null,
setProjects: (projects: Project[]) => set({ projects }),
setCurrentProject: (currentProject: Project | null) => set({ currentProject }),
addProject: (project: Project) =>
set((state) => ({ projects: [project, ...state.projects] })),
updateProject: (project: Project) =>
set((state) => ({
projects: state.projects.map((p) => (p.id === project.id ? project : p)),
})),
// Workspace
activeModule: 'workspace',
activeTool: 'move',
aiModel: 'sam2',
frames: [],
currentFrameIndex: 0,
annotations: [],
masks: [],
maskHistory: [],
maskFuture: [],
setActiveModule: (activeModule: string) => set({ activeModule }),
setActiveTool: (activeTool: string) => set({ activeTool }),
setAiModel: (aiModel: AiModelId) => set({ aiModel }),
setFrames: (frames: Frame[]) => set({ frames }),
setCurrentFrame: (currentFrameIndex: number) => set({ currentFrameIndex }),
addAnnotation: (annotation: Annotation) =>
set((state) => ({ annotations: [...state.annotations, annotation] })),
addMask: (mask: Mask) =>
set((state) => ({
masks: [...state.masks, mask],
maskHistory: [...state.maskHistory, state.masks],
maskFuture: [],
})),
updateMask: (id: string, updates: Partial<Mask>) =>
set((state) => ({
masks: state.masks.map((mask) => (mask.id === id ? { ...mask, ...updates } : mask)),
maskHistory: [...state.maskHistory, state.masks],
maskFuture: [],
})),
setMasks: (masks: Mask[]) =>
set((state) => {
const isInitialHydration = state.masks.length === 0
&& state.maskHistory.length === 0
&& state.maskFuture.length === 0;
return {
masks,
maskHistory: isInitialHydration ? [] : [...state.maskHistory, state.masks],
maskFuture: [],
};
}),
clearMasks: () =>
set((state) => ({
masks: [],
maskHistory: [...state.maskHistory, state.masks],
maskFuture: [],
})),
undoMasks: () =>
set((state) => {
if (state.maskHistory.length === 0) return state;
const previous = state.maskHistory[state.maskHistory.length - 1];
return {
masks: previous,
maskHistory: state.maskHistory.slice(0, -1),
maskFuture: [state.masks, ...state.maskFuture],
};
}),
redoMasks: () =>
set((state) => {
if (state.maskFuture.length === 0) return state;
const [next, ...rest] = state.maskFuture;
return {
masks: next,
maskHistory: [...state.maskHistory, state.masks],
maskFuture: rest,
};
}),
removeAnnotation: (id: string) =>
set((state) => ({
annotations: state.annotations.filter((a) => a.id !== id),
})),
// Templates
templates: [],
activeTemplateId: null,
activeClassId: null,
activeClass: null,
setTemplates: (templates: Template[]) => set({ templates }),
setActiveTemplateId: (activeTemplateId: string | null) => set({ activeTemplateId }),
setActiveClassId: (activeClassId: string | null) => set({ activeClassId }),
setActiveClass: (activeClass: TemplateClass | null) => set({
activeClass,
activeClassId: activeClass?.id || null,
}),
addTemplate: (template: Template) =>
set((state) => ({ templates: [...state.templates, template] })),
updateTemplate: (template: Template) =>
set((state) => ({
templates: state.templates.map((t) => (t.id === template.id ? template : t)),
})),
removeTemplate: (id: string) =>
set((state) => ({
templates: state.templates.filter((t) => t.id !== id),
})),
// UI
isLoading: false,
error: null,
setLoading: (isLoading: boolean) => set({ isLoading }),
setError: (error: string | null) => set({ error }),
}));