面板和停靠栏
停靠在当前页面旁边而不是替换当前页面的界面。
OpenClaw 系统维护¶
打开 设置 → Ask OpenClaw 以与系统设置和修复代理对话。要在当前页面旁边打开它,请单击侧边栏页脚中的 主页 并选择 Ask OpenClaw 选项卡,或使用 Ask OpenClaw 命令面板操作。完整页面和可停靠面板共享一个全机器范围的会话,其持久历史记录保存在 Gateway 上。关闭 UI 永远不会取消一个轮次;重新打开 Ask OpenClaw 会显示已完成的对话。面板停靠到右侧或底部,在浏览器配置文件中记住其位置和大小,并在完整页面打开时隐藏自身。
如果未配置 AI 提供商,Ask OpenClaw 会提供 连接 AI 提供商。如果已配置的运行时无法启动或验证,对话仍会显示,并带有实际错误和 重试。发送保持禁用,直到验证成功。重试会检查运行时,而不会重新发送你之前的消息或清除你的草稿。
引导建议可以在没有其他元素获得焦点时聚焦推荐答案。如果你已经聚焦输入框或其他控件,新到达的建议会保留你的键盘焦点在那里。
每条聊天消息都会携带你当前正在查看的 Control UI 页面,作为不可信的环境提示,因此诸如“配置此通道”或“为什么此页面为空?”之类的请求会针对你正在查看的页面进行解析。
引导式通道设置、工作区技能设置、网络搜索提供商设置和本地 Gateway 设置以托管向导的形式在聊天中运行。向导问题保留在对话中,秘密步骤会在浏览器中掩码输入,成功的基于配置的流程会被审计并重新验证。如果所选的网络搜索提供商需要安装插件且该安装失败,设置会停止并报告失败,而不是假装提供商已配置。
对于 Gateway 设置,输入 configure gateway 以选择端口、绑定地址、Token 或密码身份验证以及 Tailscale 暴露。在第一个问题之前,Web 界面会警告:应用已保存的设置需要重启,这可能会断开聊天或要求新的 Control UI 登录。向导仅更改配置;当你准备好应用时,输入 restart gateway。它仅管理本地 Gateway,因此远程模式更改仍保留在 openclaw onboard 或 openclaw configure 中。
输入 import memory 以将检测到的本地记忆复制到现有默认代理工作区。此流程不会更改配置或导入凭据或技能,无需重启 Gateway,并区分已确认的导入、没有可导入内容、提供商失败以及某些文件可能已被复制的失败。如果默认工作区不存在,请先完成引导。参见 导入助手记忆 了解更广泛的页面,该页面可以针对另一个代理或替换现有导入,并参见 openclaw setup 了解操作和审批契约。
在引导之外,此页面每次访问最多显示一个可关闭的事件徽章。它对常规 Gateway 流量保持静默,仅对报告配置重载器已禁用、已配置通道断开/降级、通道检查失败或通道凭据不可用的健康快照做出反应。只有当新事件更严重时,才会替换待处理徽章;关闭或使用该徽章会在此访问期间静默事件提示。点击徽章会将其诊断问题作为真实的 openclaw.chat 消息发送,因此转录会记录该请求,并且 OpenClaw 会执行诊断。引导永远不会显示这些事件徽章。
主页停靠面板¶
使用侧边栏页脚中的 主页 按钮,或在侧边栏折叠时工具栏中的 主页 按钮,以在当前页面旁边打开所选代理的主对话。在同一停靠面板中选择 Ask OpenClaw 选项卡,用于系统设置和修复。当同一主页对话已作为页面打开时,停靠面板保持隐藏,而不是显示两次。
你的主页草稿和附件会跟随页面与停靠面板之间的对话。仍在准备中的文件会保留其进度和移除操作,发送会等待准备完成。
主页可以在你的消息中包含一个有界的、引用的工作上下文引用。发送前,该引用遵循页面的代理、会话、标题和可见文件,而不仅仅是接收它的主页对话。你可以在发送前移除它。
已发送的消息会在你的文字下方显示 已附加上下文,而不是将生成的上下文作为消息文本显示。打开它以检查捕获的会话、页面、代理、工作区、文件或选择;技术详情 以 JSON 显示快照。快照在你发送时冻结,包括在队列和重试过程中。复制或编辑你的消息不会包含生成的引用。它仍然是引用数据,而不是访问另一个对话的指令或权限。没有记录附件的旧消息保持不变。
插件会话停靠面板¶
插件页面可以提供操作,以在页面旁边打开其对话。 它使用与主页相同的聊天窗格、草稿、附件、右侧或底部放置、 调整大小和关闭控件。打开它会替换主页、Ask OpenClaw 或另一个会话停靠面板。它在页面导航期间保持打开,并在同一对话作为聊天或仪表板页面打开时隐藏。关闭 不会留下任何打开的停靠面板。只读访问和会话错误遵循正常 聊天规则。插件可以包含有界的页面引用,发送后显示为 已附加上下文;它仍然是不可信的引用数据。
操作员终端¶
操作员终端默认启用;设置 gateway.terminal.enabled: false 以选择退出。终端需要 operator.admin 连接,并在活动代理工作区中打开主机 PTY。新选项卡跟随当前选中的聊天代理。
当终端被禁用或你的连接缺少管理员访问权限时,主终端页面会显示不可用通知和一个 新建会话 按钮,以返回输入框。
在 Linux 和 macOS 上,运行于 Bun 的 Gateway 仅在提供 Bun.Terminal.pause() 和 resume() 的构建中使用 Bun 的原生 PTY,而不需要 Node 运行时,例如同时包含 macOS 子进程退出修复的 OpenClaw Bun fork 构建。其他 Bun 版本使用 Node 辅助程序进行终端 I/O。请确保 Node 在 Gateway 的 PATH 中可用;OpenClaw 会跳过 Bun 的 node 垫片,如果 Node 可执行文件不可用,会产生带有安装指导的启动错误。Windows 继续使用 node-pty。参见 Bun 兼容性。
启用/禁用变更可热应用,无需重启 Gateway。禁用会关闭已附加、已分离和会话拥有的终端,并取消待处理的打开操作。重新启用后允许创建新会话;已关闭的会话不会恢复。重新加载 Control UI 页面以应用更新后的内容安全策略。
Warning
终端是无限制的主机 shell,并继承 Gateway 进程环境。在管理员操作员不应获得主机 shell 的部署中,使用 gateway.terminal.enabled: false 禁用它。OpenClaw 会拒绝为具有 sandbox.mode: "all" 的代理提供终端会话;将活动代理更改为该模式会关闭其现有和进行中的终端会话。
使用 Ctrl + 反引号 切换所选聊天窗格统一侧边面板中的 终端 标签页。你也可以从面板的 + 菜单打开 终端。共享面板可停靠到右侧或底部,随浏览器视口调整大小,可展开覆盖聊天窗格,并保留多个 shell 标签页。停靠区域仍可用于临时操作员 shell。从 新会话 启动原生 CLI,或在终端中打开 Claude Code 或 Codex 目录会话,会打开主终端页面,保留侧边栏和应用框架,同时替换输入框。有关 gateway.terminal.enabled 和可选的 gateway.terminal.shell 覆盖,请参见 Gateway 配置。
选中终端文本会自动复制。短暂的 已复制到剪贴板 提示会确认复制成功,而不会占用键盘焦点。如果剪贴板访问失败,则不会出现成功提示。
终端会话显示为聊天侧边面板标题中的标签页;在面板的 + 菜单中再次选择 终端 会打开另一个 shell,而会话、上传和停靠到底部操作位于标题中。移动到主区域的终端会保留自己的标签条。
统一面板还承载 浏览器、文件、审查、侧边聊天,以及依赖能力的 桌面 和 讨论 标签页。其打开或最小化状态、活动标签页、标签页顺序、宽度、停靠位置和展开状态会按会话保存在当前浏览器配置文件中,因此切换会话或重新加载会恢复每个会话自己的工作布局。没有保存面板布局的聊天对话不会继承另一个会话中打开的面板。拖动标签页可重新排序,关闭某个标签页而不会关闭其他工具,或使用面板关闭按钮最小化整个面板。
侧边面板分隔条在从左到右和从右到左布局中都会跟随指针和方向键方向。
聊天和每个工具都有自己命名的区域,用于辅助导航。将聊天与工具交换时,每个标签页仍与其自身内容保持关联,包括同一对话在多个分屏窗格中打开时。
已连接的 桌面 查看器在其标签页隐藏时保持连接 30 秒,因此快速切换到聊天再切回会恢复相同的桌面和尺寸模式。隐藏期间,输入和远程调整大小会暂停。30 秒后,查看器断开连接,重新打开时会重新连接。关闭桌面标签页、更改其会话或机器,或失去 Gateway 连接会立即释放它。在鼠标或触摸拖动期间隐藏桌面也会断开连接,以免按下的远程按钮残留。断开连接 会保持断开状态,直到你选择 重新连接。桌面在解析其来源并连接时使用一个居中的加载指示器。
打开聊天时,如果该浏览器标签页仍在运行,面板会自动显示分配给该确切会话的可用桌面,以及来自其最新成功浏览器工具结果的浏览器标签页。发现过程只读取现有资源:它从不启动浏览器、配置桌面或附加无关的全局或子会话资源。会话和清单事件,以及新的浏览器结果,会在聊天可见时刷新发现。没有显式会话元数据的资源仍可通过手动面板控件使用。
自动显示会复用现有面板,并让已选择的工具保持在前面。自动发现的标签页不会保存在布局中,包括在调整大小或停靠之后,因此重新加载会先重新验证资源再打开它。窄屏使用与手动打开的面板相同的底部停靠布局。最小化面板或关闭浏览器或桌面标签页会禁用当前浏览器配置文件中该会话的进一步自动显示,包括重新加载后;+ 菜单仍可手动打开它们。
经过所有者授权且未沙箱化的代理可以使用 terminal 工具列出、读取、调整大小或关闭操作员已从同一聊天会话的终端面板打开的终端。代理不能打开 shell,并且访问范围仍限于确切会话:代理无法检查或控制独立的操作员终端或属于另一个会话的终端。终端输入遵循有效的会话和主机执行权限策略:完全访问(full,或 YOLO)会立即发送;受保护(guarded)和工作区(workspace,包括仅接受或 Guardian 审查流程)需要针对该确切输入的一次性显式批准;只读(read-only)或 tools.exec.mode: "deny" 完全禁止输入。批准某一次输入绝不会授予对终端的无限制访问权限。
将一个或多个文件拖到活动终端,或使用回形针按钮选择文件。OpenClaw 会在拥有 PTY 的机器上暂存每个文件,并在光标处粘贴 shell 引用的绝对路径;它从不按 Enter 或执行输入。紧凑的批量指示器显示当前文件和已完成数量。取消会停止剩余批次而不粘贴路径;失败的传输会保持可见,以便你可以从该文件重试,而无需重新上传已完成的文件。选择 插入已上传路径,仅使用其已完成文件完成失败的批次,然后单独选择任何剩余文件。如果批次保持打开直到其早期上传可能已过期,请取消它并重新选择文件。
接受图像、PDF、归档文件和其他文件类型,每个文件最大 16 MiB。新上传必须满足每个暂存目录共享的 256 MiB 和 64 个文件限制,包括来自其他终端标签页和先前进程的文件。当达到任一限制时,请移动或删除已暂存文件,或等待清理,然后重试。现有未过期文件不会被驱逐以腾出空间,包括升级后保留在这些限制之上的上传文件。已暂存文件在 POSIX 主机上使用私有系统临时目录(目录模式 0700,文件模式 0600),或在 Windows 上使用位于用户配置文件 ACL 边界下的目录,并配有 24 小时清理计时器,因此请移动或复制任何需要保留的内容。
重命名已暂存文件或重试失败的清理,不会重启已安排的清理截止时间。
如果进程崩溃后暂存仍保持锁定,请在拥有该终端的机器上定位错误中命名的相对锁目录:对于本地终端,是 Gateway 主机;对于节点终端,是配对节点。在 Windows 上,请在运行该 Gateway 或节点主机的账户的主目录下解析它。在 POSIX 主机上,请在该进程的系统临时目录下解析它;请检查其服务环境,因为 TMPDIR、TMP 或 TEMP 可能与你的 shell 设置不同。然后停止所有使用该暂存根的 Gateway 和节点主机进程,仅删除命名的锁目录,并重启它们。这样会保留已暂存文件。不完整的锁记录永远不会自动清除,因为它无法证明另一个写入者已停止。
路径插入支持 PowerShell、cmd.exe 以及已识别的 POSIX shell(sh、Bash、Dash、Ash、Ksh、Zsh 和 Fish),包括 Windows 上的 Git Bash。其他 shell 覆盖会被拒绝,因为其引号规则无法安全推断;请在 WSL 中运行 Gateway,以使用原生 WSL 终端和 Linux 上传路径。包含 % 或 ! 的 cmd.exe 路径也会被拒绝,因为该 shell 即使在双引号内也会展开这些字符。
配对节点的 Codex、Claude Code、OpenCode 和 Pi 终端也支持上传路径插入,包括包含空格和撇号的 Windows 路径。插入的输入仍保持可编辑,并且永远不会自动提交。
在会话侧边栏中发现的 Claude Code 和 Codex 会话会在主终端页面中打开其原生 CLI。在 设置 › 聊天 中,将 在以下位置打开 Codex/Claude 线程 设置为 终端,使普通行点击打开 codex resume 或 claude --resume;默认仍为只读 OpenClaw 查看器。行的右键菜单或 kebab 菜单始终提供这两种选择,并且当该会话符合条件时,查看器标题栏会包含 在终端中打开。
旧版本已经排队的目录打开请求在升级后会在停靠区中完成一次。新请求使用主终端页面;该页面不会持久化目录打开意图。
资格按会话和按主机确定。Gateway 本地会话会在 Gateway 主机上启动由 provider 拥有的 resume 命令。配对节点会话会在拥有节点上启动允许列表中的 provider 命令,并仅中继该 PTY 的输出、输入和调整大小事件;这不会暴露通用节点 shell,也不会接受浏览器提供的命令。文件上传使用单独的、大小受限的 terminal.upload 节点命令,并保持绑定到已打开的终端会话。当该命令首次出现时,批准节点配对升级。未通告匹配的 terminal-resume 命令的节点(包括没有双工流式传输的嵌入式 worker 桥接)会保持查看器可用,并显示终端打开不可用;旧节点仍可以运行终端,但无法接收拖放的文件。
独立操作员会话(包括主终端页面和终端焦点展示)由连接拥有。离开主终端路由不会关闭其 PTY;返回其终端会话 URL 会重新附加它。主页面和停靠区保持独立的终端标签页。页面重新加载、笔记本睡眠或网络抖动会在 Gateway 上分离其中一个,而不是终止它,并且同一浏览器标签页在重新连接时重新附加,并回放最近的输出。分离的由连接拥有的会话会在 gateway.terminal.detachedSessionTimeoutSeconds 后被终止(默认 300 秒;0 恢复断开时终止)。附加这些会话之一仍然是 tmux 式接管。
以代码零正常退出的 shell 会自动关闭其终端标签页,包括在 logout、exit 或 EOF 之后。关闭最后一个终端标签页会关闭其面板,无论是停靠右侧还是底部,除非仍有其他工具标签页。非零退出、信号、断开连接和错误会保持可见以供检查。全屏终端在最后一个标签页关闭后仍保持其新建会话控件可用。
关闭正在连接的标签页会取消该打开或附加请求。其他标签页和排队请求仍保持可用,迟到的响应不会重新打开已取消的标签页或显示其错误。
从聊天会话的终端面板打开的对话拥有的会话不绑定到浏览器连接。terminal.attach 将每个浏览器添加为查看器而不取得所有权,关闭已建立的查看器标签页只会分离该浏览器。对话拥有的 PTY 会保留,直到精确会话 agent 关闭它们、其 shell 退出、会话被归档、策略禁用它们或 Gateway 关闭。terminal.list 将每个条目标记为连接拥有或 agent 拥有。
重置无痕会话会关闭其对话拥有的终端,并在删除会话前取消待处理的终端打开。
所有 Gateway 终端 PTY 都是进程本地的。Gateway 重启会结束它们; 新的进程启动后,PTY 会话及其滚动缓冲区不会被恢复。
位于 /terminal 的主终端页面也可作为 焦点展示 使用。iOS 和 Android 应用将此页面嵌入其终端屏幕中,复用已存储的 gateway 凭据;可用性遵循相同的 gateway.terminal.enabled 和 operator.admin 门控,并且当连接的 Gateway 不提供终端时,页面会显示通知。焦点展示会移除应用程序边框;它不会调用浏览器全屏。
终端字体¶
终端内置 JetBrains Mono 和 Symbols Nerd Font Mono,用于 Powerline 分隔符和标准 Nerd Font 图标。默认情况下无需安装字体或使用 第三方字体服务。
在 设置 → 外观 → 排版 → 终端字体 中,输入本地等宽字体族名称,例如
FiraCode Nerd Font Mono,或选择 使用默认。清空该字段即可重置。字体必须安装在运行浏览器的计算机上,而不是远程 Gateway 或 shell 主机。该设置仅保存在此浏览器中,并针对此 Gateway 生效;缺失的字体将回退到内置默认字体。更改会应用到已打开的终端,而无需重启其 shell,包括整页和聚焦终端视图。
编程连字(例如 => 的合并箭头)目前不受终端渲染器支持,即使使用支持连字的字体也是如此。
浏览器面板¶
让您的 Agent 执行“打开浏览器侧边栏”或“显示浏览器侧面板”以显示此面板。当 screen 工具可用时,Agent 会使用 browser_show(使用 browser_hide 隐藏它)。sidebar_show 和 sidebar_hide 则用于控制会话列表。打开浏览器面板不会创建或展开 浏览器仪表盘。
Control UI 在统一的 Chat 侧面板中提供了一个 Browser 选项卡,可在任何常规 Web 浏览器中渲染由 Gateway 控制的浏览器(即 Agent 通过 browser tool 驱动的那个浏览器)——无需原生 webview。当已连接的 Gateway 向 operator.admin 连接通告 browser.request 时,它会出现在面板的 + 菜单中;文件 中的地球仪操作可切换它。在常规 Web 浏览器中,当其面板选项卡已打开时再次选择 Browser,会创建另一个 Agent 浏览器选项卡。该面板显示实时屏幕投射,在流不可用时回退到截图,并提供选项卡、可编辑的 URL 栏、后退/前进/重新加载以及“在您的浏览器中打开”功能,同时会将点击、滚轮滚动和基本键入转发到远程页面。远程页面会跟随共享面板:打开它、调整其大小或切换选项卡时,会将远程浏览器视口调整为面板的可用空间,因此快照会填满面板,而不是按 Agent 上次使用的大小渲染。
当面板或浏览器仪表盘可见时,后续远程调整大小也会将页面重新同步到可用空间。隐藏的面板不会改动远程视口。如果浏览器无法满足请求的大小,且其报告的尺寸保持不变,则不会反复调整其大小。
浏览器选项卡直接显示在 Chat 侧面板标题中,URL 工具栏位于其下方。当启用自动获取 favicon 且图标可用时,每个选项卡都会显示其页面的 favicon。关闭最后一个浏览器选项卡后,浏览器面板仍会保持打开,以便您使用 + 创建另一个选项卡。当 Browser 选项卡移动到主区域时,其选项卡会显示在其自身工具栏上方。
当 Agent 浏览器预览刷新时,当前页面保持可见,工具栏中的重新加载图标会旋转。加载骨架仅在首个页面图像可用之前出现。如果刷新失败,面板会保留上一张图像,并在其上方显示错误。
若要粘贴到 Agent 浏览器选项卡或浏览器仪表盘中,请点击页面输入字段,在 macOS 上按 ⌘V,在 Windows/Linux 上按 Ctrl+V,或右键单击该字段并选择 粘贴。纯文本会插入到远程光标处,包括密码字段和框架内的字段。粘贴不会提交表单,也不会将您的剪贴板复制到 Gateway 的系统剪贴板。这需要受管理的浏览器;Chrome MCP 现有会话配置文件不支持此功能。
在 macOS 应用中,同一面板还承载 Mac 选项卡,由 WebKit 原生渲染,并与来自 Gateway 的 Agent 浏览器选项卡并列。Mac 选项卡无需 browser.request 即可使用;Agent 浏览器选项卡仍保留上述 Gateway 和 operator 访问要求。在仪表盘中点击的外部链接会在聊天侧面板中作为 Mac 选项卡打开,或在非聊天路由的 shell 级 Browser dock 中打开。当设置打开时,外部链接会在默认浏览器中打开,因为浏览器面板处于隐藏状态。Mac 选项卡具有选项卡条、URL 栏、后退/前进/重新加载/停止、在默认浏览器中打开以及关闭控件。Mac 选项卡显示页面自身的图标。Mac 选项卡属于打开它们的聊天会话:另一个会话会以其自己的空浏览器面板开始,返回时会恢复原始会话的选项卡。窗口会保留这些选项卡,直到它们被关闭或窗口结束。打开相同链接时,仅在该会话内复用其现有选项卡,包括重定向后保留的原始 URL。非聊天 Browser dock 拥有自己的选项卡。登录 Cookie 在窗口内保持共享。在链接打开期间选择另一个选项卡时,当打开请求完成后会保留您的选择。
会话级 Mac 选项卡要求 Mac 应用和由 Gateway 提供的 Control UI 都支持会话所有权。在分阶段升级期间,旧的应用/UI 组合会保留其现有的共享选项卡行为,以便浏览继续可用。在没有会话所有权的情况下创建的选项卡会保持窗口共享,直到关闭或窗口结束;一旦双方都更新,新选项卡就会变为会话级。
在 macOS 应用之外,请在 设置 → 基础设施 → 浏览器 下启用 在 Control UI 浏览器中打开链接,以将外部 HTTP(S) 链接路由到该面板中的新 Agent 浏览器选项卡。浏览器本地偏好设置默认关闭,并且仅在面板可用时显示。在 macOS 应用中它被隐藏,因为未修改的外部仪表盘链接会在设置之外作为 Mac 选项卡打开。发送旧版 inline 请求的旧 Control UI 捆绑包会打开默认浏览器。同源链接、标记为下载的链接、Shift/Alt 点击、文件/编辑器链接、电子邮件和电话链接、右键操作以及显式的“在您的浏览器中打开”操作均保持现有行为。
在 macOS 应用中,带修饰键的点击会在默认浏览器中打开链接;右键点击外部仪表盘链接,可选择在浏览器面板中打开、在默认浏览器中打开或复制链接。Mac 标签页中的新窗口链接会在打开者的会话中打开另一个 Mac 标签页,而指针触发的下载会移交给默认浏览器。不可显示的响应仅在指针触发的主框架导航时移交;其他不可显示的响应会被静默取消。
每个 Agent 浏览器标签页在就地导航和目标替换过程中都保持一个稳定的身份,因此其选中状态、键盘焦点、URL、页面快照和浏览器操作始终保持一致,即使 Gateway 以不同顺序返回标签页也是如此。
要保存已在面板中打开的资源,请点击铅笔和指针图标旁边的下载文件。下载过程中图标会变为旋转指示器,预览保持打开状态,工具栏下方不显示进度或成功消息。Mac 标签页会显示保存对话框,并使用该标签页已登录的浏览器会话。Agent 标签页使用其 Browser 配置文件的会话来保存所显示的资源,然后通过 Gateway 的认证媒体路由交付文件;仪表盘不会获取外部资源 URL。Agent 下载遵循 Browser 配置文件的下载支持和网络策略。远程浏览器节点传输保留现有的每文件 10 MiB 限制。如果下载失败,面板会显示错误,并提供在您的浏览器中打开作为替代选项。空白标签页和加载中的标签页无法下载。
Chromium 不会暴露原生下载重定向供策略检查。因此,具有默认网络策略、私有网络限制或主机名允许/阻止限制的 Agent 配置会在启动任何下载流量之前拒绝此工具栏操作。请改用在您的浏览器中打开来保存这些资源。此限制不影响 Mac 标签页及其原生保存对话框。
两种捕获模式会为 Agent 打包页面上下文。对于 Mac 标签页,任一模式都会捕获实时 WebKit 页面的单次快照。将已捕获的标签页导航到其他 URL 会退出捕获模式并恢复其实时视图:
- 注释(铅笔):在页面上手绘标注。发送到聊天会将笔画合成到屏幕截图中,并向活动聊天编辑器添加一张结构化注释卡片。该卡片会将生成的页面和区域上下文与图像一起保留,而不是将其插入到您的可编辑草稿中。
- 检查(指针):悬停可查看光标下的元素(选择器、可访问名称、角色、大小);点击可通过相同的卡片流程添加这些详细信息和高亮屏幕截图。移除注释卡片只会移除该图像及其生成的上下文,保留您的草稿和其他附件,并提供短暂的撤销。对于 Agent 浏览器标签页,检查、滚轮滚动和后退/前进需要
browser.evaluateEnabled(默认开启)。
一个编辑器最多接受四张浏览器注释卡片和总计 8,000 个字符的生成注释上下文。当达到任一限制时,浏览器面板会保留当前捕获,以便您可以移除一张卡片并重试;撤销也会保留该限制,而不是移除另一张卡片。
暂存的图像、文件、粘贴的图像、大段粘贴文本、浏览器注释和混合附件包即使经过路由更改、拆分窗格重新挂载、硬重新加载和应用重启,也仍会保留在其编辑器和会话中。新会话页面中描述的浏览器本地保留、范围和处置规则也适用于现有会话的编辑器。如果附件超过持久容量上限,当前标签页会保留它们并显示存储警告;文本在重启后仍可恢复,但这些附件无法恢复。如果浏览器完全拒绝存储,当前标签页会保留实时编辑器并显示相同的警告,但该草稿在重启后无法恢复。
GitHub 侧边面板¶
内置的 GitHub 插件 提供此阅读器及其悬停预览。它默认启用。禁用该插件会移除这些功能,并将 GitHub 链接保留为普通外部链接。其他插件可以通过 Plugin SDK 贡献相同的停靠式阅读器界面。
点击 GitHub issue、pull request 或 commit 链接,即可在对话旁的浏览器样式标签页中阅读相应内容。每个标签页都有 GitHub 图标、标题和关闭控件;地址栏和在 GitHub 上打开链接保持可见。从聊天中打开同一条目会选中其现有标签页。阅读器内的链接和在地址栏中输入的 URL 会在当前标签页中导航,并具有独立的后退和前进历史记录。+ 按钮会打开新标签页。最多十个标签页会保留在内存中,包括您切换标签页时已加载的文档。
打开或加载条目时,键盘焦点会保持在您正在输入的位置。+ 按钮会将焦点移到地址栏,以便您输入新的 URL。
阅读器显示描述、issue 和 pull request 的讨论评论、commit 评论、已发布的 PR 内联评论(包含文件/行号和 diff 上下文)以及可展开的文件 diff。评论时间戳会链接到其在 GitHub 上的来源。Markdown 图像和独立的 HTML 图像附件会内联显示;当图像无法加载时,完整尺寸的链接仍然可用。内联图像请求在可用时使用阅读器插件的匿名图像解析器;因此 GitHub 附件无需浏览器 CORS 头即可工作。没有图像解析器的阅读器使用匿名 CORS,并省略跨源凭据和引用来源。脚本和嵌入式应用小部件永远不会在这些文档中运行。
可调整大小的面板是只读的,并支持公开仓库。较长的讨论和大型补丁会被限制并标记为不完整。刷新会重新获取当前条目。在手机上,阅读器遵循共享面板的响应式布局和展开控件。使用在 GitHub 上打开可查看完整页面、私有仓库或执行诸如发表评论和合并等操作。在文档链接上使用 Cmd/Ctrl 点击和中键点击会保留正常的浏览器行为;中键点击标签页会将其关闭。未声明支持详情功能的连接会继续正常打开链接。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw