# 快速入门 — Liu Terminal

> Liu Terminal 快速入门指南。几分钟内即可开始使用标签页、分屏、会话和 AI 代理。

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

从全新构建到您的第一次 AI 会话恢复，不到五分钟。本页介绍黄金路径；更深入的内容请参阅“指南”部分。

## 1 - 首次启动

启动 ./build/Liu。第一个窗口会在您的家目录中打开一个本地 PTY。如果是从 Finder 启动，Liu 会在子进程中执行 chdir($HOME)，避免新标签页打开在 / 中。

按 ⌘, 打开设置。在任何其他操作之前，值得先设置主题和字体。

## 2 - 解锁金库

主机、密钥和代码片段存放在加密金库中（SQLite + AES-256-GCM，密钥经 PBKDF2-HMAC-SHA256 派生）。首次打开智能金库（⌘ ⇧ V）时 Liu 会要求口令——仅属于您，无恢复流程。解锁/锁定时敏感内存由 crypto\_secure\_zero 擦除。

解锁后金库在会话期间保持打开。可通过命令面板手动锁定（⌘ K → Vault: Lock Now），或由 config.json 中的 vault\_auto\_lock\_minutes 处理空闲超时。

## 3 - 打开代理历史记录

按 ⌘ K 并选择“代理历史记录”。Liu 会遍历所有已安装 AI CLI 的磁盘会话存储，将条目标准化为统一列表，并在一个选择器中显示。输入内容可按代码片段、工具或工作目录进行模糊匹配。

在条目上按 ↵ 可在新标签页中本地恢复会话。或按 ⌘ ↵ 打开转录视图 —— 无需启动代理即可滚动查看用户/助手对话。

在项目内部打开选择器，它会自动过滤到该目录。从 $HOME 打开，它会显示磁盘上的所有内容。

**支持的代理工作流**

Liu 目前识别 Claude Code、Codex、GitHub Copilot CLI、Cursor Agent、Amp、OpenCode、Crush、Factory Droid、Antigravity、Kimi、Qwen Code、Grok 和 Command Code。独立 Cline CLI 以及 Cline、Roo Code 和 Kilo Code 编辑器扩展同样受支持。

[查看完整集成表 →](https://liu.software/zh/docs/agent-history.md)

## 4 - 使用 AI 生成主题

⌘ K → 创建主题。描述您想要的外观，选择代理，Liu 会将提示传递给本地 CLI。返回的 JSON 经过验证，实时应用并保存到 ~/.config/Liu/themes/。

## 5 - 分屏、搜索、切换

- ⌘ D / ⌘ ⇧ D —— 水平或垂直分割当前面板。
- ⌘ F —— 在回滚中搜索。
- ⌘ K —— 涵盖命令、主机、代码片段、主题和代理会话的模糊面板。
- ⌃ \` —— Quake 模式启用时的默认全局热键。

## 6 - 下一步去哪里

- [代理历史记录](https://liu.software/zh/docs/agent-history.md) - 完整工具表和扫描工作原理。
- [主题](https://liu.software/zh/docs/themes.md) - AI 创建主题流程 + 编写自己的 JSON 主题。
- [快捷键](https://liu.software/zh/docs/keys.md) - 完整快捷键参考。

[下一步 主题 →](https://liu.software/zh/docs/themes.md)