Files
Pre_Seg_Server/doc
admin 8a9247075e feat: 完善 AI 分割与工作区标注闭环
功能增加:

- 将视频导入和生成帧拆成两个明确动作,项目库生成帧时选择 FPS,工作区不再自动触发拆帧。

- 为工作区新增调整多边形工具,支持选中 mask、拖动顶点、边中点插点、双击边界按位置插点,并保留多 polygon 子区域编辑。

- 打通 AI 页 SAM2/SAM3 结果到工作区的联动,生成 mask 后自动选中,可在右侧分类树换标签,并推送到工作区继续编辑。

- 增强 Dashboard WebSocket 连接状态与心跳,使用真实 onopen/onclose/onerror 状态驱动前端显示。

- 完善 SAM3 external worker 适配,支持 box prompt、semantic 请求级阈值和 video tracker 路径。

bugfix:

- 修复 SAM2 文本语义误走自动分割的问题,改为提示使用点提示或切换 SAM3。

- 修复 SAM2 多候选重叠显示的问题,点提示和 auto fallback 默认只采用最高分候选。

- 修复 SAM2 反向点看起来无效的问题,带负点时启用背景过滤,过滤为空时移除旧候选。

- 修复 SAM3 单个 2D mask 结果无法转 polygon、低阈值 semantic 返回被默认阈值吞掉的问题。

- 修复 AI 页 mask 未选中导致分类树无法修改 SAM2 结果标签的问题。

测试和文档:

- 补充 CanvasArea、AISegmentation、ProjectLibrary、VideoWorkspace、Dashboard、websocket 和 SAM engine/API 测试。

- 新增 backend/tests/test_sam2_engine.py,覆盖 SAM2 单候选请求和 auto fallback 行为。

- 更新 README、AGENTS 和 doc 需求/设计/接口/测试矩阵,按当前实现冻结功能状态。
2026-05-01 21:50:17 +08:00
..

项目文档索引

本目录用于记录当前代码库的真实状态、目标设计与实现差距。文档依据包括:

  • 根目录 Word 文档:语义分割系统构建方案.docx
  • 前端源码:src/App.tsxsrc/components/*.tsxsrc/lib/api.tssrc/store/useStore.ts
  • 后端源码:backend/main.pybackend/routers/*.pybackend/schemas.pybackend/models.py
  • 运行时 OpenAPIhttp://localhost:8000/openapi.json

文档结构

文档 内容
01-purpose-and-word-summary.md 为什么要做这个系统Word 方案中的目标,以及当前代码的落地程度
02-current-implementation-map.md 当前系统怎么运行,前后端、存储、数据流具体怎么串起来
03-frontend-element-audit.md 前端逐页面/逐元素审计真实可用、半可用、Mock/UI-only、接口不通
04-api-contracts.md 前端 API 封装、后端 FastAPI 接口、已完成对齐项和剩余接口问题
05-implementation-plan.md 后续要把 Mock 变成真实功能的建议实施顺序
06-fastapi-docs-explained.md http://192.168.3.11:8000/docs 是什么,怎么看和怎么用
07-current-requirements-freeze.md 当前版本需求冻结,测试以此为准
08-current-design-freeze.md 当前版本设计冻结,记录模块、数据流和接口边界
09-test-plan.md 需求到测试文件的覆盖矩阵和运行命令

状态标记

标记 含义
真实可用 已接真实前端状态或后端 API按当前代码能完成主要动作
部分可用 有真实数据或真实 UI但存在关键缺口例如只读、不能持久化、缺少错误处理
Mock / UI-only 只有展示或本地状态变化,没有真实业务效果
接口不通 前端调用和后端接口契约不一致,按当前代码大概率失败
目标设计 Word 方案中提出,但当前代码尚未实现