Files
Pre_Seg_Server/doc
admin b6a276cb8d feat: 完善工作区交互提示与后端属性分析
功能新增:
- 新增 POST /api/ai/analyze-mask 后端接口,基于 mask polygon、bbox、points 和 score 返回置信度来源、面积、拓扑锚点和后端分析提示。
- 前端新增 analyzeMask API 封装,并在本体检查面板读取选中 mask 的后端几何属性和重新提取拓扑锚点结果。
- 右侧语义分类树点击分类时,会给当前选中 mask 换标签、更新 class 元数据,并将选中 mask 移到前端渲染最上层,方便继续编辑。
- 分割工作区画布新增上下文操作提示,覆盖多边形 Enter 完成、Esc 取消、首节点闭合、拖拽图形、点区域、SAM 点/框提示、区域合并/去除选择顺序和多边形编辑。
- AI 智能分割画布新增正向点、反向点、边界框选和视口控制的上下文提示。
- 自动传播交互收敛为参考帧加起止帧范围加单个“自动传播”按钮,默认使用当前参考帧全部 mask 作为 seed。
- 时间轴改为用浅蓝色进度条区段标记自动传播生成的帧,而不是已编辑帧竖线提示。

Bugfix:
- AI 分割页无当前帧时移除外部演示背景图,改为明确空状态提示,避免误以为外部图片可参与真实推理。
- 工具栏魔法棒文案改为“打开 AI 智能分割”,避免误导为直接触发 SAM 推理。
- Canvas 底部当前图层信息改为显示真实选中 mask 标签和 annotation id,不再使用固定占位文本。
- 已保存标注回显时保留 mask metadata 中的传播来源、score 等字段,供时间轴和属性面板识别。
- 清理 server.ts 中遗留的 /api/login、/api/projects、/api/templates 内存 mock API,避免和 FastAPI 真实后端混淆。

测试:
- 补充 analyze-mask 后端测试,覆盖后端几何属性和锚点返回。
- 补充 api.analyzeMask 前端契约测试,覆盖 normalized polygon、bbox、points 和 extract_skeleton payload。
- 补充本体面板测试,覆盖后端属性读取、自定义分类写回后端模板、选中 mask 换标签和置顶显示。
- 补充 Canvas 测试,覆盖上下文提示、多边形完成提示、布尔选择顺序提示、当前图层真实显示和编辑优先级。
- 补充 AI 分割测试,覆盖无帧空状态和提示工具上下文提示。
- 更新 Konva 测试 mock,支持拖动过程、stroke/dash/fillRule 等渲染断言。

文档:
- 更新 README 和 AGENTS,说明 server.ts 不再保留业务 mock API。
- 更新 doc/02、doc/03、doc/04、doc/05、doc/07、doc/08、doc/09,记录后端属性分析、分类置顶显示、上下文提示、自动传播按钮、传播帧标记、测试覆盖和当前剩余限制。
2026-05-02 02:10:37 +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 方案中提出,但当前代码尚未实现