任务详情
3D部件表面分区标注任务说明书
一、任务概述
1.1 任务目标
本任务目标是对 STP/STEP 三维部件模型中的表面进行自动分区和颜色标注。程序需要根据表面的几何形状、空间位置、边界关系和相邻关系，把同一类或同一结构区域的面合并为一个区域，并输出可检查、可追溯、可供后续程序调用的数据。
本任务只使用通用 3D 几何语言描述，不要求乙方理解具体加工行业术语。乙方重点完成“看懂模型表面形状、识别区域边界、输出清晰标注结果”。
1.2 目标需求
? 能够读取 STP/STEP 格式的三维实体模型，提取模型中的面、边、边界环和相邻关系。
? 能够识别并标注大平面、底面、外侧面、台阶面、圆柱孔、长槽、凹腔、凸起、圆角、自由曲面等常见表面区域。
? 同一连续区域不能被拆成大量零散小面；应根据共面、曲率连续、共边相邻等关系进行区域合并。
? 对无法稳定判断的区域，不强行归类，应统一标为“待人工复核”，并说明原因。
二、任务详细要求
2.1 任务输入
? 输入文件：单个或多个 STP/STEP 三维部件模型。
? 模型来源不限，可由常见 3D/CAD 软件导出。
? 模型中可能存在面方向反向、碎小面较多、孔洞内边界较多、局部面没有明显分割线等情况。
2.2 任务输出
? 彩色 STP/STEP 文件：在三维模型中用不同颜色标记不同表面区域，便于直接打开检查。
? 结构化数据文件：建议输出 JSON，至少包含 region_id、face_ids、class_name、color、confidence、bbox、classification_reason。
? 检查报告：输出 HTML 或图片报告，包含区域统计、颜色图例、三维总览图、局部截图和待复核区域说明。
? 运行日志：记录输入文件、识别数量、异常信息和主要参数，便于排查问题。
2.8 任务交付物
? 三维表面分区算法源码，开发语言 Python，代码需有必要中文注释。
? 命令行运行入口，支持输入模型路径、输出目录和配置文件路径。
? 参数配置文件，至少包含面积阈值、角度容差、曲率容差、区域合并距离、置信度阈值等。
? 彩色 STP/STEP 输出模块、JSON 输出模块、检查报告输出模块。
? 使用说明文档，包括安装方式、运行方式、输出文件说明、颜色说明、常见问题处理方式。
? 不少于 3 个样例模型的测试结果；若甲方提供真实样例，应以甲方样例为主要验收依据。
三、任务验收要求
3.1 任务指标
验收项 指标要求
大平面、底面、外侧面 检出率 ≥ 98%，不得被其他局部结构覆盖
圆柱孔、长槽、凹腔、凸起 主要结构检出率 ≥ 95%，同一结构需正确分组
圆角 / 过渡面 主要过渡区域检出率 ≥ 90%，与圆柱孔、长槽误分率 ≤ 5%
自由曲面 / 复杂曲面 明显自由曲面区域检出率 ≥ 90%，可接受低置信度复核
待复核区域 必须输出复核原因，不能只给灰色结果
结构化数据 JSON 中 face_id、region_id、class_name、confidence 信息完整
3.2 验收方式
由甲方提供若干 STP/STEP 样例模型，乙方运行程序并输出彩色模型、JSON 数据和检查报告。甲方在三维软件中核对颜色标注，并抽检 JSON 中的 face_ids、class_name、confidence 和 classification_reason。 文档下载
3D部件表面分区标注任务说明书(1).docx
