Files
Pre_Seg_Server/doc
admin 4c1d3dba73 feat: 完善 mask 编辑、传播平滑与开发重启闭环
功能增加:

- 新增后端 /api/ai/smooth-mask 接口,对当前 mask polygon 执行 Chaikin 边缘平滑,并返回 polygon、bbox、area 与拓扑锚点。

- 在右侧实例属性面板加入边缘平滑强度和应用边缘平滑操作,应用后将 mask 标记为 draft/dirty,并通过正常保存链路落库。

- 保存标注与传播 seed 时保留 geometry_smoothing 元数据,自动传播 forward/backward 结果保存前应用同一平滑参数。

- 自动传播 seed signature 纳入平滑参数,修改平滑强度后会触发旧同源传播结果清理并重新传播。

- 支持跨帧跟随同一传播链 mask,AI 推送回工作区时保留当前帧视角。

Bugfix:

- 修复中间帧向前传播时旧 forward/backward 同物体结果未被清理导致双重 mask 的问题。

- 修复 propagation worker 写入目标帧前只按旧方向清理导致 backward 重传残留的问题。

- 修复多边形顶点拖拽和编辑后画布视口异常移动的问题,并补充拖拽状态回写。

- 修复实例属性标题跟随全局 active class 而不是当前 mask label 的问题,并移除后端模型置信度展示。

开发与部署:

- 新增 restart_dev_services.sh,使用 setsid 独立后台重启 FastAPI、Celery 和前端,写入 pid/log 文件并做 3000/8000 健康检查。

- 明确后端或 Celery 相关改动完成后需要运行重启脚本,保证运行态加载最新代码。

测试与文档:

- 补充后端 smooth-mask、传播平滑 metadata、seed signature、传播去重方向覆盖等测试。

- 补充前端 OntologyInspector、VideoWorkspace、CanvasArea 和 api 契约测试,覆盖边缘平滑、传播参数、跨帧选区跟随和画布编辑行为。

- 更新 README、AGENTS、安装文档、前端元素审计、需求冻结、设计冻结和测试计划,记录当前真实行为与重启要求。
2026-05-02 17:04:02 +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 方案中提出,但当前代码尚未实现