终端使用

本章介绍终端本身：输入/输出、终端内搜索、复制/粘贴与图片处理、vopen 命令、Windows 上的 shell 选择，以及会话录制。

1. 基础知识

终端会话就是一个真正的 shell（macOS / Linux 使用系统默认 shell；Windows 默认为 cmd，也可切换——参见 §5）。工作目录默认为项目根目录，可在会话编辑界面中更改；其中的“启动命令”会在每次会话启动时自动执行（例如 pnpm dev）。

输入延迟经过特殊设计：当屏幕上同时显示大量内容时，输入操作会优先处理，后台标签页的刷新速度会降低，从而确保前景内容始终能即时响应你的按键操作。如果切换标签页后文本界面出现异常，可在面板标题栏中点击重绘按钮来强制重新绘制界面。

2. 终端内搜索（⌘F）

可在当前终端的滚动历史中搜索，并通过“下一个”/“上一个”按钮进行导航：

若需在多个会话及历史记录中搜索，请使用全局搜索功能（⌘⇧F）——详见界面与会话管理 §8。

3. 复制与粘贴

• 先选中要操作的内容；上下文菜单会提供复制/粘贴选项，常规的⌘C / ⌘V 快捷键同样有效。
• 在那些能够捕获鼠标的 TUI 程序（如 vim、htop）中，拖动时按住 Option/Alt 键即可强制进行普通文本选择。

图像粘贴用于向智能体传递图片：将截图或图片文件粘贴或拖入终端后，VelaTerm 会把图片写入临时位置，并将其文件路径输入终端——这正是 Claude 等 CLI 工具需要的形式。可在设置中选择“作为文件上传”（始终生成明确路径）或“使用智能体默认设置”；“自动清理已粘贴的图像”会定期删除临时图片，也可点击“立即清理”。

4. vopen：从终端打开文件和页面

每个会话的 PATH 都包含三个小型命令（无需安装）：vopen、vspawn、vspawn-tree。这些是终端命令；在 Claude 对话内部使用的同名 / 技能则是另一套入口，需要通过“设置”▸“常规”中的 Vela Skills 开关启用。vopen 会将内容发送到中间面板：

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

完整的文档标签页功能（双模式编辑、查找与替换、PDF 导出）：文档与浏览器标签页。通过 vspawn 创建子会话：会话创建与 Git 协作。

5. shell 选择（仅限 Windows）

在 Windows 中，终端会话可以通过“新建”子菜单、会话编辑表单的下拉列表，或右键点击“Shell ▸”来明确选择 shell——可以是 PowerShell、pwsh、cmd 或 Git Bash——正在运行的会话会在重启时应用此更改。设置 ▸ 终端 ▸ “默认 shell”可设置新会话的默认值。

关于内置的 Git Bash：完整安装包包含完整版（带 Git、SSH、Perl）；精简安装包只含核心组件，缺少命令时会提示按需下载完整版（也可右键点击“下载完整 Git Bash”）。智能体会话不受影响——它们始终使用 PowerShell。

macOS / Linux 没有 shell 选择功能；会话会使用系统默认的 shell（$SHELL）。

6. 会话录制

“设置”▸“高级”▸“录制会话日志”（默认关闭）。启用后，终端内容会从会话开始时记录到本地文件中（每个会话上限为 50 MB）。这会带来两个好处：

• 已归档的会话可以完整还原终端的原始界面；
• 全局搜索功能可以查找纯终端输出内容（智能体对话无需录制，因为有文字记录）。

当会话被删除时，对应的录制文件也会被清除。

7. 常用快捷键

macOS 使用默认设置；在 Windows / Linux 环境下，需将 ⌘ 替换为 Ctrl+Alt（有少数例外情况——请查看设置页面）。除 ⌘1–9 以及字体大小相关快捷键外，其余所有快捷键都可在设置 ▸ 快捷键中重新绑定。