BRAVO 百楼图网图则搜索下载

要解决的问题

香港屋宇署的 BRAVO（Building Records Access and Viewing On-line）系统提供楼宇图则的在线检索，但自动化这件事并不顺手：登录是多步流程，地址搜索依赖 jQuery UI 自动补全，图则预览走 Daeja ViewONE viewer，而 viewer 界面经常弹出 Lost connection to the server，很容易被误判为接口已失效。截图抓全图分辨率不够，逐级缩放再拼回又只能拿到可见区域的瓦片。

技能如何工作

• 多步登录：使用 playwright-cli 依次走完从 /login 到 /home 的完整流程。注意 agent-browser 不适用，元素交互存在问题。
• 地址补全搜索：主页 位置 输入框必须用 type 逐字输入来触发自动补全下拉，fill 命令不会触发；直接调 API 因 Daeja 鉴权不可行，goto 内部页面则直接断掉会话。
• 结果导航：按 檔案編號 定位结果行，点击该行 圖則 按钮，图则列表会在新标签页打开，用 tab-select 切过去。
• 瓦片接口抓高清图：从 inspection 页的瓦片请求里提取 tw/th 基准分辨率和 auth token，按缩放系数构造瓦片 URL，一次请求返回整张图纸的单张 PNG。大图在 page.evaluate() 里分块做 base64，Python 端解码后用 Pillow 合并成 PDF。

适用边界与注意点

• auth token 对每次 inspection 页面加载都唯一，每张图都要重新提取。
• 不同图纸的基准分辨率（tw×th）可能不同，缩放系数需据此计算。
• 任何缩放级别下截 canvas 都只能拿到可见瓦片。
• fit-to-window 能拿全图，但只有 96 DPI 基准分辨率。
• 会话内导航要用 history.back() 或标签页切换，不要 goto 内部 URL。