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 授权边界和后续实施顺序。

src/test/setup.tsx

@@ -32,24 +32,69 @@ function makeStageEvent(x = 120, y = 80) {
 }
 
 vi.mock('react-konva', () => ({
-  Stage: ({ children, onClick, onMouseDown, onMouseUp, onMouseMove, onWheel }: any) => (
+  Stage: ({ children, onClick, onMouseDown, onMouseUp, onMouseMove, onWheel }: any) => {
+    const coords = (event: React.MouseEvent<HTMLDivElement>, fallbackX: number, fallbackY: number) => ({
+      x: event.clientX || fallbackX,
+      y: event.clientY || fallbackY,
+    });
+    return (
     <div
       data-testid="konva-stage"
-      onClick={() => onClick?.(makeStageEvent())}
-      onMouseDown={() => onMouseDown?.(makeStageEvent())}
-      onMouseUp={() => onMouseUp?.(makeStageEvent(260, 200))}
-      onMouseMove={() => onMouseMove?.(makeStageEvent(180, 120))}
+      onClick={(event) => {
+        const point = coords(event, 120, 80);
+        onClick?.(makeStageEvent(point.x, point.y));
+      }}
+      onMouseDown={(event) => {
+        const point = coords(event, 120, 80);
+        onMouseDown?.(makeStageEvent(point.x, point.y));
+      }}
+      onMouseUp={(event) => {
+        const point = coords(event, 260, 200);
+        onMouseUp?.(makeStageEvent(point.x, point.y));
+      }}
+      onMouseMove={(event) => {
+        const point = coords(event, 180, 120);
+        onMouseMove?.(makeStageEvent(point.x, point.y));
+      }}
       onWheel={() => onWheel?.(makeStageEvent())}
     >
       {children}
     </div>
-  ),
+    );
+  },
   Layer: ({ children }: any) => <div data-testid="konva-layer">{children}</div>,
   Group: ({ children }: any) => <div data-testid="konva-group">{children}</div>,
   Image: ({ image }: any) => <img data-testid="konva-image" alt="" src={image?.src || ''} />,
-  Circle: (props: any) => <span data-testid="konva-circle" data-fill={props.fill} />,
+  Circle: (props: any) => (
+    <span
+      data-testid="konva-circle"
+      data-fill={props.fill}
+      data-x={props.x}
+      data-y={props.y}
+      onClick={() => props.onClick?.({ cancelBubble: false })}
+      onMouseUp={(event: React.MouseEvent<HTMLSpanElement>) => props.onDragEnd?.({
+        target: {
+          x: () => event.clientX || props.x || 0,
+          y: () => event.clientY || props.y || 0,
+        },
+      })}
+      onDragEnd={(event: React.DragEvent<HTMLSpanElement>) => props.onDragEnd?.({
+        target: {
+          x: () => event.clientX || props.x || 0,
+          y: () => event.clientY || props.y || 0,
+        },
+      })}
+    />
+  ),
   Rect: (props: any) => <span data-testid="konva-rect" data-width={props.width} />,
-  Path: (props: any) => <span data-testid="konva-path" data-path={props.data} data-fill={props.fill} />,
+  Path: (props: any) => (
+    <span
+      data-testid="konva-path"
+      data-path={props.data}
+      data-fill={props.fill}
+      onClick={() => props.onClick?.({ cancelBubble: false })}
+    />
+  ),
 }));
 
 vi.mock('use-image', () => ({

src/test/storeTestUtils.ts

@@ -13,6 +13,8 @@ export function resetStore() {
     currentFrameIndex: 0,
     annotations: [],
     masks: [],
+    maskHistory: [],
+    maskFuture: [],
     templates: [],
     activeTemplateId: null,
     activeClassId: null,