Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[IAB] Agent 创建的标签固定 1280×720 视口，非 16:9 窗格被黑边框死，建议默认继承窗格尺寸

Đang mở
  • Có gì không ổn?
#110 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
45/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
desktop

Hướng nghiên cứu

Start by reading packages/shared/src/browser-use/command-metadata.ts and the agent tab creation path that applies DEFAULT_AGENT_BROWSER_VIEWPORT; compare it with the free-size path for user-opened tabs. Check docs/viewport.md and control-browser/SKILL.md for the stated viewport behavior. Done when agent-created tabs adapt to the pane as proposed while screenshots retain a deterministic 1280×720 fallback.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

环境
  • ZCode Desktop（macOS arm64，darwin 27.0.0）
  • browser-use 插件 v0.5.1（官方内置）
现象

在 ZCode 内置浏览器（IAB）里：

  • 用户手动打开的标签：free-size，视口跟随窗格尺寸，拖动分隔条实时自适应 ✅
  • agent 通过 browser-use tabs.new() 创建的标签：一律固定 1280×720（16:9），在非 16:9 的窗格（实测 1186×984）中上下出现大片黑边，且不随窗格拖动变化 ❌

同一面板、同一会话内两种来源的标签行为不一致，用户观感是"面板比例被写死了"。

根因（源码已定位）

packages/shared/src/browser-use/command-metadata.ts:

/** Agent 创建或打开的新页面使用的固定逻辑 viewport；不属于人类浏览器显示偏好。 */
export const DEFAULT_AGENT_BROWSER_VIEWPORT = {
  width: 1280,
  height: 720,
} as const;

agent 建标签即套用该常量。注释表明这是刻意设计（给自动化一个确定性逻辑视口），但显示层没有做适配，导致逻辑视口的宽高比直接变成视觉上的黑边框死。

与官方文档矛盾
  1. browser-use 插件自带文档 docs/viewport.md："Use an explicit viewport only for responsive or device-size testing. Otherwise keep the normal IAB viewport." —— 正常 IAB 视口恰恰不是 1280×720。
  2. browser-use skill 文档（control-browser/SKILL.md）："IAB automatically opens the target tab in free-size mode" —— 实际 agent 建的标签并非 free-size。
影响
  • agent 打开页面给用户看（调研结果、仓库、文档）是该插件的核心日常场景，黑边观感差；
  • 现有 workaround 是 agent 每次 setViewportSize() 对齐窗格实测尺寸，但那是固定值，用户拖动窗格后即失配，需反复手动对齐；
  • tab.close() 后重开仍会回到 1280×720，无法从外部根治。
建议

保留 1280×720 作为截图/自动化的确定性 fallback，但显示层二选一：

  1. agent 标签默认继承窗格逻辑尺寸（与用户手开标签行为一致）；或
  2. 保持固定逻辑视口，但渲染时按窗格比例 fit（避免黑边），仅 screenshot 走 1280×720 逻辑坐标。
备注

ZCode 主仓库（zai-org/ZCode）issues 已关闭，故投递至本仓库，烦请维护者转交对应团队。如需更多实测数据（视口读数、页面 innerWidth/innerHeight 对照）可随时补充。

TL;DR: Tabs created by the agent via browser-use get a hardcoded 1280×720 logical viewport (DEFAULT_AGENT_BROWSER_VIEWPORT), which letterboxes the pane at any non-16:9 size, while user-opened tabs are free-size. Suggest inheriting the pane's logical size by default (or fit-rendering) and keeping 1280×720 only as the deterministic screenshot fallback.

Ngôn ngữ chính
Python
Star
103
Fork
78
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của zai-org/zcode-plugins

Tất cả issue của zai-org/zcode-plugins

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.