---
read_when:
    - می‌خواهید یک عامل، پنل‌های رابط کاربری کنترل را تقسیم کند، روی آن‌ها تمرکز کند، ببندد یا میان آن‌ها پیمایش کند
    - می‌خواهید یک عامل پنل‌های نوار کناری، ترمینال یا مرورگر را نمایش دهد یا پنهان کند
    - به قابلیت ui.command و قرارداد توزیع نیاز دارید
sidebarTitle: Screen
summary: به یک عامل اجازه دهید رابط کاربری متصل Control را تنظیم کند
title: صفحه‌نمایش
x-i18n:
    generated_at: "2026-07-27T15:56:24Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: df2215db96af29fa6b0db8abad79a0a2787a194dab6d00f9ef32f45521907ae1
    source_path: tools/screen.md
    workflow: 16
---

ابزار `screen` به عامل امکان می‌دهد رابط کاربری Control مبتنی بر مرورگر را چیدمان کند. این ابزار یک
سطح نوع‌دار برای چیدمان و پیمایش است، نه برای ثبت اسکرین‌شات یا خودکارسازی
مرورگر.

این ابزار فقط زمانی ارائه می‌شود که کلاینت مبدأ قابلیت
`ui-commands` را اعلام کند. هنگام اجرای ابزار نیز باید دست‌کم یک رابط کاربری Control دارای این قابلیت
متصل باشد؛ در غیر این صورت، Gateway مقدار `UNAVAILABLE` را برمی‌گرداند.

## کنش‌ها

| کنش                            | اثر                                     | ورودی‌های اختیاری                                |
| --------------------------------- | ------------------------------------------ | ---------------------------------------------- |
| `split_right`                     | پنل نشست هدف را به سمت راست تقسیم می‌کند | `sessionKey` (پیش‌فرض، نشست فعلی است) |
| `split_down`                      | پنل نشست هدف را به سمت پایین تقسیم می‌کند     | `sessionKey` (پیش‌فرض، نشست فعلی است) |
| `close_pane`                      | پنل نشست هدف را می‌بندد              | `sessionKey` (پیش‌فرض، نشست فعلی است) |
| `focus`                           | پنل نشست هدف را در کانون قرار می‌دهد              | `sessionKey` (پیش‌فرض، نشست فعلی است) |
| `navigate`                        | نشست هدف را باز می‌کند                    | `sessionKey` (پیش‌فرض، نشست فعلی است) |
| `sidebar_show` / `sidebar_hide`   | نوار کناری اصلی را نمایش می‌دهد یا پنهان می‌کند              | -                                              |
| `terminal_show` / `terminal_hide` | پنل پایانه اپراتور را نمایش می‌دهد یا پنهان می‌کند   | هنگام نمایش، `dock` (`bottom` یا `right`)      |
| `browser_show` / `browser_hide`   | پنل مرورگر را نمایش می‌دهد یا پنهان می‌کند             | هنگام نمایش، `dock` (`bottom` یا `right`)      |

پس از آنکه Gateway رویداد نوع‌دار `ui.command` را پخش کرد،
یک فرمان موفق مقدار `{ "ok": true }` را برمی‌گرداند.

## مسیریابی و امنیت

پروتکل v1 عمداً فرمان را به همه رابط‌های کاربری Control متصل که
`ui-commands` را اعلام می‌کنند می‌فرستد؛ فرمان یک زبانه مرورگر خاص را هدف قرار نمی‌دهد. این موضوع زمانی اهمیت دارد که
همان اپراتور چند داشبورد را باز نگه داشته باشد.

RPC مربوط به Gateway به `operator.write` نیاز دارد. این ابزار فقط می‌تواند وضعیت
نمایش را تغییر دهد: نمی‌تواند پیکسل‌ها را بخواند، اسکرین‌شات بگیرد، روی محتوای دلخواه
صفحه کلیک کند یا مجوزهای پنل‌های نشست و اپراتور
انتخاب‌شده را دور بزند.

## مرتبط

- [رابط کاربری Control](/fa/web/control-ui)
- [پروتکل Gateway](/fa/gateway/protocol#method-families)
- [ابزار مرورگر](/fa/tools/browser)