feat(review): 审查阶段对齐绘图区分辨率 + 放大取证闭环

发现的缺口:maximized_drawing_area 原先只包住取证循环,审查阶段没被包住 →
LLM 在受控子循环里 zoom + 截图拿到的是未最大化的 2110x462(正是上一轮刚解决的
低分辨率问题,在最需要放大看细节的审查阶段又出现了);且审查中的 zoom 不复位视口,
跑完把用户的 CAD 留在最后一次放大处。

改动:
1. __main__.run_review:把 maximized_drawing_area 从「只包取证」扩到「包取证 + 审查」
   (两者都要截图);report/annotate 留在 with 之外。
2. phases/review.py:新增 _VIEW_TOOLS;review_frame 拆成外壳 + _review_frame,
   外壳 try/finally 里仅当确实动过视口才复位到该图框整幅视图
   (zoom_to_window(win, margin=0.02))。纯查结构化数据的路径不受影响。
3. checklist.build_system_prompt:把「可调用只读工具」改写成明确的放大取证协议——
   截图看不清时用 zoom_to_window(坐标由图框/实体 bbox 算)或 zoom_to_entity,
   再 get_viewport_screenshot 复核;并约束不要为看图而反复放大。

次生问题(同轮修复):_MAX_OBS_IMAGES 原为硬编码 3,而模型一轮内会发 8 次截图 →
拍了 8 张只回灌 3 张。改为配置项 REVIEW_OBS_IMAGES(默认 6),并把预算耗尽的占位
文案改成明确告知模型「不要再请求截图,请给出结论」。

实测(真实图纸 1 图框,新增 verify_review_maximized.py):取证与审查两阶段窗口均为
[-4,-2,3444,1442](最大化态),结束精确还原 [68,0,2316,960],三项全 PASS;
子循环里 LLM 连发 8 组 zoom_to_window + get_viewport_screenshot,提示词生效。
pytest 304 passed。
This commit is contained in:
gjm committed 2026-10-16 18:55:31 +08:00
1 parent 931a430ba4
commit e8140f2bc5
11 files changed
+320 -40

No files matched your search

+7 -2
View File
@@ -53,8 +53,13 @@ def build_system_prompt(checklist, *, allow_tools=True):
if allow_tools:
lines += [
"你可以调用**只读**取证工具进一步确认细节(例如放大局部、查实体详情、查重复实体)。",
"当结构化数据不足以判断时,先调用工具取证,再下结论。",
"你可以调用**只读**取证工具进一步确认细节;**不要凭猜测下结论**:",
" - **截图里的文字/标注/细节看不清时**:用 `zoom_to_window` 放大该区域"
"(窗口坐标用图框 bbox 或实体 bbox 计算,可适当留边距),"
"再 `get_viewport_screenshot` 复核;已知 handle 时也可直接 `zoom_to_entity` 放大该实体。",
" - 结构化数据不足以判断时:用 `get_entity_detail` / `find_duplicate_entities` /"
" `find_zero_length` / `get_layers` 等查证后再下结论。",
" - 放大截图是**复核手段**:确认清楚后即写入结论,不要为看图而反复放大。",
"",
]