# 应用内浏览器 — Liu Terminal

> Liu Terminal 应用内浏览器。内嵌 macOS 原生 WebView，支持本地服务器预览、元素选择器及连接错误时 Ask Agent（询问代理）集成。

URL: https://liu.software/zh/docs/browser/  
Language: zh  
Updated: 2026-10-17

## 内置浏览器

在 macOS 上嵌入 WKWebView，用于在终端旁进行 localhost 和常规网页预览——支持元素选择以及连接错误时向智能体提问（Ask Agent）。

## 打开浏览器

- 命令面板 → Browser（新建浏览器标签页；最多支持 BROWSER\_MAX\_TABS = 4 个）。
- Browser Split Right / Left / Below / Above —— 将 WebView 放置在终端分屏的旁边或下方。
- 当开发服务器在线时，可通过站点管理器（Site Manager）打开。

主开关：config.json 中的 browser\_enabled（默认值为 true）。系统会记住上一个 URL 和最多 8 个最近访问记录，以便快速重新打开。

平台说明：嵌入式 WebKit 视图是 macOS 功能。Linux 构建保留浏览器 API 存根，因此不提供浏览器标签页和 WebView 分屏。

## 导航

地址栏、后退/前进、重新加载——在应用沙盒内运行的标准 WebKit 行为。非常适合在智能体在相邻终端分屏编辑代码的同时验证用户界面（UI）。

## 选择元素 (Select Element)

命令面板 → Select Element 激活选择模式。在实时页面上点击某个节点，Liu 将捕获其选择器、标签名、文本、大小和 HTML，并将其作为上下文插入到智能体提示词中。Attach Element 可重新发送上一次选择。无需截图。

## 连接错误时询问智能体 (Ask Agent)

如果页面加载失败（例如开发服务器宕机、连接被拒绝），错误界面可以将日志和环境上下文发送给您的编码智能体，以便它定位修复并重新启动服务器。

[下一步 Markdown 预览器 →](https://liu.software/zh/docs/markdown.md)