[IAB] Agent 创建的标签固定 1280×720 视口，非 16:9 窗格被黑边框死，建议默认继承窗格尺寸
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 45/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- typescript
- 領域
- desktop
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
环境
- 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 建标签即套用该常量。注释表明这是刻意设计（给自动化一个确定性逻辑视口），但显示层没有做适配，导致逻辑视口的宽高比直接变成视觉上的黑边框死。
与官方文档矛盾
- 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。 - 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，但显示层二选一：
- agent 标签默认继承窗格逻辑尺寸（与用户手开标签行为一致）；或
- 保持固定逻辑视口，但渲染时按窗格比例 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.
- 主要言語
- Python
- スター
- 103
- フォーク
- 78
- PR マージ指標
- 30日以内にマージされた PR はありません
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
zai-org/zcode-plugins のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
zai-org/zcode-plugins#107 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
zai-org/zcode-plugins#106 ·
メンテナーはふだん 1 日以内に返信
-
video-agent-kit (0.4.3): hooks invoke python3, which doesn't exist on Windows — SessionStart/UserPromptSubmit/Stop hooks fail on every trigger対応中かも @dvd233 が 28 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
zai-org/zcode-plugins#14 ·
メンテナーはふだん 1 日以内に返信
-
難易度 3/5 1〜2日 初心者へのやさしさ 74/100
zai-org/zcode-plugins#109 ·
メンテナーはふだん 1 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 18/100
zai-org/zcode-plugins#105 · リアクション 1 件 ·
メンテナーはふだん 1 日以内に返信
zai-org/zcode-plugins の issue をすべて見る
似ている issue
-
Uninstall guide omits the CloudWatch log groups AWS CodeBuild creates for useCodeBuild pipelinesオープンbug documentation
難易度 1/5 1〜3時間 初心者へのやさしさ 88/100
awslabs/visual-asset-management-system#552 ·
メンテナーはふだん 1 日以内に返信
-
netbox status: needs triage type: documentation
難易度 1/5 1時間未満 初心者へのやさしさ 76/100
netbox-community/netbox#23460 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
awslabs/threat-composer#362 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
ansys/pyansys-common-mcp#213 ·
メンテナーはふだん 3 日以内に返信