VelaTerm 用户手册
这是 VelaTerm 用户手册。新用户建议按顺序阅读前四章，其余章节可按需查阅。
阅读顺序
| # | 章节 | 主要内容 | 适用读者 |
|---|---|---|---|
| 1 | 入门指南 | 安装、添加项目、打开第一个终端和第一个智能体会话、窗口概览 | 所有新用户，建议从这里开始 |
| 2 | 界面与会话管理 | 窗口布局、项目树及其菜单、集合、标记、标签页与后台标签页、分屏与平铺、状态筛选、归档、全局搜索、保存工作空间 | 所有用户 |
| 3 | AI 智能体会话 | 支持的十四种智能体及其功能差异、状态点与通知、恢复对话、导入与分叉对话、权限、预设、安装引导、信息面板 | 使用 AI 编程智能体的用户 |
| 4 | 会话视图 | 在终端视图与会话视图之间切换、智能体工作时发送消息（排队、插话、中断）、模型、推理强度与权限控件、图片、命令、回退、后台任务、用量上限重置后自动继续、登录 | Claude Code、Codex、OpenCode、Pi 和 OMP 的用户 |
| 5 | 会话派生与 Git 协作 | 用 vspawn 派生子会话、确认卡片、工作树、Git 菜单与图形化合并 | 需要多个智能体并行工作的用户 |
| 6 | 规划与执行 | 规划会话与执行会话的工作流、将工作拆分为多个分别验收的任务、目录模式、跟踪进度 | 需要规划和验收的较大任务 |
| 7 | 会话命令 | 十个内置命令（vspawn、vspawn-tree、vopen、vrefer、vsearch、vstat、vtell、vrun、vkb、vflow）、包括 vask 在内的 Vela 技能，以及 vela shell 命令的参考说明 | 供用户和脚本查阅 |
| 8 | 终端使用 | 终端基础、终端内搜索、复制与粘贴、图片粘贴、命令补全提示、内置命令与 vrun 后台命令、Windows 上的 Shell 选择、会话录制、渲染器选项、常用快捷键 | 所有用户 |
| 9 | 命令补全提示 | 普通终端中基于 shell 自身补全定义的提示：设置与操作、支持的 shell、集成的加载方式、Windows 上的现状、限制 | macOS 和 Linux 上的终端用户 |
| 10 | 文档与浏览器标签页 | 文档标签页（打开文件、Markdown 编辑器、编辑与保存、新建文档与导出 PDF）、桌面版中的浏览器标签页，以及各类标签页如何共存 | 按需查阅 |
| 11 | 本地知识库 | 将 Markdown 文件夹用作知识库：打开或新建知识库、导入文件和文件夹、编写和整理笔记、搜索、链接、从会话知识库复制、存储 | 记笔记与整理文档 |
| 12 | 会话知识库 | 从会话中整理知识、整理记录、浏览和维护条目、已归档会话、与代码图谱的关联 | 需要保留智能体工作中的决策与经验的用户 |
| 13 | 代码图谱与知识库 | 为项目代码建立索引、查看符号及其关系、关联与复核知识条目、在会话中查询、数据存放位置（实验性功能） | 代码探索 |
| 14 | 代码审计 | 使用 Codex 或 Claude Code 对项目进行安全审计：模型与思考程度、Codex Security 集成、审计范围、报告、导出（实验性功能） | 安全审查 |
| 15 | 设置与快捷键 | 八类设置中的每一项、默认快捷键及其修改方法、新建智能体会话选择器 | 参考资料 |
| 16 | 远程开发与管理 | 让其他设备使用本机的远程访问、通过 SSH（包括 Windows 主机及镜像远端桌面版）、URL 或账号连接其他机器、通过 VelaTerm 账号共享（实验性功能）、文件传输、在手机上使用 VelaTerm、断开连接及断开后保留的内容、安全 | 远程与移动端使用 |
如需了解各版本的变更内容，请查看变更日志。
需要先了解的四个概念
- 项目树中的每个智能体会话都是一段持续进行的对话。关闭后再打开，对话会接着进行。如需开始新的对话，请新建一个会话。
- 标签页的行为与浏览器类似。默认情况下，打开智能体会话会复用当前标签页，离开的标签页在后台继续运行。关闭标签页会结束其中的进程，即便如此，智能体对话之后仍可恢复。
- 同一段对话，两种视图。Claude Code、Codex、OpenCode、Pi 和 OMP 既可以在会话视图中运行，也可以在各自的终端界面中运行。切换视图后，仍是同一段对话。
- 归档不等于删除。将已完成的工作归档，可以让项目树保持整洁。已归档的会话仍可在知识库中查看，并可随时恢复或导出。
关于截图
本手册的截图均在含演示数据的开发环境中截取，使用英文界面（产品默认语言）和深色主题。部分截图早于近期的界面调整，例如右栏的「知识库」标签页、「反馈」按钮以及「会话视图」设置类别；截图与正文不一致时，以正文描述的当前版本为准。账号用量数据、路径等细节均为示例值。