用户手册

文档与浏览器标签页

中栏的标签页不只有终端。本章介绍另外两类标签页:文档标签页(内置的 Markdown 与代码编辑器)和浏览器标签页(内嵌网页)。它们与会话标签页共用标签栏,打开会话时不会替换它们。

1. 文档标签页

1.1 打开方式

以下操作会打开文档标签页:

  • 在任意会话中运行 vopen <file>(在「设置 ▸ 通用」中安装「Vela 技能」后,Claude Code 中的 /vopen 技能也能实现同样的效果);
  • 在右栏的「文件」标签页中双击文件,或选择「在编辑器中打开」;
  • 在知识库中打开笔记(见本地知识库);
  • 点击标签栏右端的「新建文档」。

打开的视图取决于文件类型:

类型视图
md / markdown / mdxMarkdown 编辑器,提供「所见即所得」「源码模式」和「对照模式」;默认以所见即所得模式打开
图片(png、jpg、jpeg、gif、webp、svg、bmp、ico、avif)图片查看器,提供「适应窗口」和「1:1」
其他文件代码编辑器,根据文件名选择语法高亮

用 vopen 打开的 Markdown 文档

1.2 Markdown 编辑器

  • 所见即所得模式下,编辑时看到的就是最终显示的效果。输入 / 可打开插入菜单(标题、列表、任务列表、引用、代码块、表格、数学公式、图片和分割线)。用围栏标记的 mermaid 代码块会在代码块下方渲染为图表。
  • 源码模式按文件实际存储的内容显示文本(包括 YAML front matter),并提供 Markdown 语法高亮。
  • 对照模式将所见即所得和源码并排显示,编辑任意一侧时,两侧都会保持同步。
  • ⌘/(Windows 和 Linux 上为 Ctrl+/)可在所见即所得和源码模式之间切换。仅切换模式而不编辑,不会改动文件。
  • 将图片粘贴或拖入已保存的文档时,图片会存放到文档旁的 assets 文件夹中,并插入指向它的相对链接。

1.3 编辑与保存

  • 按 ⌘S 或点击「保存」按钮即可将文件写入磁盘。标签页上的圆点表示有未保存的修改。
  • 当前文档每两秒检查一次磁盘。如果其他程序修改了该文件,会出现一个横幅,提供「重新加载」和「忽略」;如果你同时也有未保存的编辑,重新加载按钮会显示为「重新加载(丢弃我的修改)」。如果在你开始编辑后磁盘上的文件发生了变化,保存时会先弹出「保存冲突」对话框请你确认,然后才会覆盖文件。
  • 关闭有未保存修改的标签页时,会要求你选择「保存并关闭」「不保存关闭」或「取消」。
  • ⌘F 会打开搜索栏,提供查找、替换、全部替换和「区分大小写」;在各种模式下用法相同。
  • 「侧栏」按钮会显示文档的「大纲」及其所在文件夹的「目录树」;点击其中的文件即可打开。侧栏的宽度可以调整。
  • 大于 10 MB 的文件以只读方式打开,且只显示前 10 MB,以免保存时截断文件的其余部分。
  • 右键点击文档标签页,除常规的关闭操作外,还提供「刷新文件」;Markdown 文档还提供「导出 PDF」。

1.4 新建文档与导出 PDF

  • 「新建文档」会打开一个空白草稿,它尚未保存到磁盘,也不会出现在项目树中。首次保存时会询问存放位置:桌面版使用系统的“另存为”对话框,浏览器客户端和远程连接窗口则显示一个“另存为”对话框,用于选择运行会话的那台机器上的位置。语法高亮会根据所选的文件名确定。右键点击草稿的标签页,还可以选择「保存到磁盘…」。
  • 「导出 PDF」会将 Markdown 文档转换为矢量 PDF,自动分页并嵌入中日韩字体。桌面版会询问保存位置;浏览器客户端则直接下载该文件。

2. 浏览器标签页(仅限桌面版)

浏览器标签页在 VelaTerm 中显示真实的网页,便于把文档、issue 页面或本地预览放在会话旁边。浏览器标签页仅在桌面版中可用,浏览器客户端、远程连接窗口和移动端布局中均不提供。

打开浏览器标签页:

  • 标签栏右端的「内置浏览器」按钮;
  • 快捷键 ⌘⇧B;
  • 在会话中运行 vopen <URL>;
  • 左栏中项目或分组右键菜单里的「新建浏览器页面」。

工具栏:「后退」「前进」「刷新」(页面加载时为「停止加载」)、地址栏(「输入网址或搜索词」;输入的内容不是网址时,会用 Google 搜索)、「在系统浏览器中打开」,以及包含 ChatGPT、Claude、Gemini 和 Google 的「快速访问」栏。

两种形式:

  • 浏览器标签页:通过上述按钮、⌘⇧B 或 vopen <URL> 打开。它不会保存在项目树中,重启后不再保留。
  • 浏览器页面节点:通过「新建浏览器页面」创建。它是项目树中的一个节点,会记住自己的地址,重启后依然存在。

在新窗口中打开的链接:当网页在新窗口中打开链接时(例如 target="_blank" 链接),VelaTerm 会在新的浏览器标签页中打开它。

独立页面:标签栏右端的「游戏中心」按钮会以独立页面的形式打开 VelaTerm 游戏中心。独立页面没有地址栏和快速访问栏,只有「后退」「前进」和「刷新」;在其中打开的链接会留在同一个标签页中。

安全边界:内嵌网页被视为普通的外部网站。它不会获得 VelaTerm 的任何权限或凭据,并且只能打开 http 和 https 地址。

3. 各类标签页如何共存

  • 会话、文档和浏览器标签页共用一个标签栏,⌘1–9 可以在所有这些标签页之间切换。
  • 从项目树中打开会话时,只会复用会话标签页;文档和浏览器标签页永远不会被替换。
  • 文档和浏览器标签页不能分屏。⌘W 会直接关闭它们(有未保存修改的文档会先询问)。