Files
Pre_Seg_Server/doc
admin 4899c8a08a feat: 完善分割工作区交互与传播去重
功能增加:点击 Canvas mask 后,右侧语义分类树会按 classId/className/label 自动匹配分类,并滚动聚焦到对应分类按钮。

功能增加:工作区新增按起止帧批量清空片段遮罩,复用传播范围输入,范围内已保存标注走 DELETE /api/ai/annotations/{id},本地 draft mask 同步移除。

功能增加:右侧语义分类树上方新增工作区 mask 透明度滑杆,写入 Zustand maskPreviewOpacity,Canvas mask 预览按该值渲染并保留选中加亮反馈。

功能增加:视频处理进度条记录最近自动传播区间,使用不同色系深浅渐变提示最近处理片段。

功能增加:工作区自动传播前会先保存 draft/dirty seed mask,使用稳定后端 source_annotation_id 入队,减少二次传播重复结果。

Bugfix:后端传播任务对旧临时 seed id、不同 SAM 2.1 权重结果做兼容清理;相同 seed 和相同权重才跳过,否则先删旧自动传播标注再重传。

Bugfix:修复 polygon 顶点拖拽结束后触发 Stage 平移导致画布中心偏移的问题,并补充测试环境对 drag target 的模拟。

Bugfix:工具提示会在数秒后自动隐藏,避免创建多边形/矩形等提示长期遮挡画布。

UI 调整:移除右侧面板顶部‘本体论与属性分类管理树’说明栏,减少无效占位。

UI 调整:左侧工具栏和右侧语义面板使用低对比 seg-scrollbar;左侧工具栏外扩滚动条槽位,避免滚动条挤占图标列。

UI 调整:工作区模型状态徽标改为紧凑显示,减少与传播权重选择重复;传播权重下拉改成深色背景和青色文字,避免灰底白字不可读。

UI 调整:缩略图状态框固定优先级,当前帧、人工/AI 标注帧、自动传播帧可用外框/内框组合同时表达。

测试:补充 VideoWorkspace、CanvasArea、FrameTimeline、OntologyInspector、ToolsPalette、useStore 和后端 test_ai 覆盖新增交互、传播去重、批量清空、透明度、滚动条和 UI 状态。

文档:同步更新 README、AGENTS 和 doc/03、doc/04、doc/07、doc/08、doc/09,记录当前功能、接口契约、需求设计冻结和测试覆盖。
2026-05-02 06:45:47 +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 需求到测试文件的覆盖矩阵和运行命令
10-installation.md 系统安装部署指南,覆盖 PostgreSQL、Redis、MinIO、后端、Celery、前端和 SAM 2.1 权重

状态标记

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