SuperAPI AI 工具集

source-observe

设计与创作

查看项目

更新于 10-16 02:35

技能介绍

用途:在建筑摄影或扫描 RGB 图像中编目、标注可见施工内容,尤其适用于配准之前,或基础模型可能被替换的场景。目标是建立有边界、可链接来源的清单,使其在没有房屋坐标系时仍然可用。

主要能力:读取 source-observations.md 中的观察、身份、端点和放置记录;进行模型选择,包括视觉审查所需的实际图像能力;选择连贯的摄影范围并检查原始图像;保留源字节、提取来源以及显示像素与原生像素的映射。

使用方式:对原生捕获帧,从声明的源清单中以程序方式推导序号并记录索引基准;Polycam 使用 polycam.capture_inventory(root)["frame_ids"]。验证每个不可变帧 ID 到原生序号的映射,保持联系表/显示位置分离,不要从叙述或联系标签复制原生序号。对从视频派生的静帧,绑定实际写出的帧:记录呈现时间戳、时基、解码帧索引和精确的原生像素/裁剪映射。不要将最后记录的 showinfo 条目选为输出帧;优先使用直接输出索引/PTS 绑定,并用独立已知提取进行验证。在单输出且无下游帧选择、丢弃或时间戳变化的管线中,第一个发出的 showinfo n=0 记录是相关绑定,此规则不适用于任意滤镜图。

记录可见构件面、管道/电缆跨度、箱体、配件和候选硬件为单独标识的观察。区分可见事实、暂定分类、端点含义和当前存续状态。

从存储的像素标记生成带注释的源图。当源是独立 JPEG 或 PNG 且记录符合文档约定时,使用 scripts/observations.py;需要放大审查精确作者像素时添加 --coordinate-inspections。将整源图作为方向和上下文,然后打开每个生成的原生尺度断言裁剪图,确认完整标记位于所声称的构件上。使用可选的未标记/定位坐标图检查精确顶点,但不要将其视为物理分类。验证其生成的显示坐标等于原始审查选择;对已记录为原生的直立选择进行往返只能证明内部一致性。对每个折线端点,检查其专用裁剪图,并确认作者端点类型和基准与可见过渡匹配。

记录已检查的断言裁剪路径和哈希、标记状态和发现,以及每个端点裁剪路径/哈希、检查状态、类型和发现。最终化器可以绑定显式的每标记和每端点图像审查决定;绝不要从作者标签、成功渲染、坐标重放或统一自动通过循环中合成已检查/已接受状态或发现。当特征或过渡模糊时,保持观察待定。纠正错位标记,将不支持的端点含义降级为未知或注释边界,重新生成到新目录并重复审查,然后才能使用观察支持身份或几何。

仅在有明确对应证据时,将观察链接到有界物理特征或组。记录施工状态差异和遮挡以及匹配;分别评估捕获时间顺序和当前存续。将后续深度测量、配准和候选放置保留在单独引用的记录中。

限制:有用的清单可以没有深度、没有物理尺寸、没有已接受的放置。在这些问题未解决时,继续支持的观察工作。推进到各自证据阶段时使用 depth-inspect、scan-register 和 blender-reconstruct。