# 文档 — Liu Terminal

> Liu Terminal 文档。了解如何安装、配置和使用适用于 macOS 的原生 AI 代理终端。

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

## 介绍

Liu 是一款面向 macOS 的原生终端，围绕 AI 辅助编码构建。它介于您与各类编程代理之间，让十个并行线程感觉如同一处。

## Liu 的用途

您打开终端，运行编码代理，然后十次会话之后，您已经记不清对谁在哪里说了什么。Liu 正是围绕这个问题构建的。

**代理优先工作流。** 并行运行 Claude Code、Codex、GitHub Copilot CLI、Cursor Agent、Amp、OpenCode、Crush、Factory Droid、Antigravity、Kimi、Qwen Code、Grok 和 Command Code。Liu 也识别独立的 Cline CLI 以及 Cline、Roo Code 和 Kilo Code 编辑器扩展。

- Translate-on-Tab + 语音提示 — 在提交前翻译当前提示，并将口述内容输入到聚焦面板。两者都可在设置中配置本地或托管后端。
- 代理历史记录 — 所有受支持 CLI 的磁盘会话存储，标准化后呈现在一个 Cmd+K 选择器中。可以本地恢复，或打开转录视图滚动查看用户/助手对话，无需启动代理。
- AI 创建主题 — ⌘ K → 创建主题。描述外观，您选择的本地代理会生成 JSON 主题，Liu 实时应用并将其保存到 ~/.config/Liu/themes/。
- 文件浏览器 + Markdown 查看器 — 在 Shell 旁边打开工作区；无需离开窗口即可在带样式的 MD 查看器中阅读 README、设计和代理笔记（包含图像）。
- 站点管理器 + 内置浏览器 — 注册最多 32 个本地项目、管理开发服务器，并在 macOS 的嵌入式 WebKit 视图中检查检测到的端口。
- 默认静音 — liu-notify 守护进程仅在代理真正需要您时才进行 TTS/桌面通知：按（代理、事件）进行工具感知路由、令牌桶限流、去重。

本地 PTY、标签页、分屏面板、命令面板、侧边栏、加密金库、SSH/SFTP/Mosh — 所有这些都作为底层基础存在。

## 发生了什么变化

Liu 曾以"SSH 客户端"为主打。该代码仍在代码树中且可运行，但不再是头版内容。当前的重点是其上的 AI 代理工具链；SSH/SFTP/Mosh 被保留连接，因为相同的 Session 抽象同时支持本地 PTY 和远程 Shell。

**正在积极重写。** 代理历史记录、AI 创建主题和 Markdown 查看器正在重写中。仓库中的当前代码可以工作，但磁盘格式和内部 API 预计会发生变化。如果您要提交涉及其中任何一个的 PR，请先创建一个 Issue。

## 平台

- **macOS** - 主要目标。Metal 渲染器，原生标签栏，liu-notify 使用 AVSpeechSynthesizer。
- **Linux** - 可构建和运行（X11、OpenGL 3.3、notify-send）。精致度较低。

## 下一步

- [安装](https://liu.software/zh/docs/install.md) - 在一分钟内从源代码构建。
- [快速入门](https://liu.software/zh/docs/quickstart.md) - 首次启动、金库、代理历史记录。
- [代理历史记录](https://liu.software/zh/docs/agent-history.md) - 头条页面；支持的工具和扫描工作原理。
- [文件浏览器](https://liu.software/zh/docs/file-browser.md) - 侧边栏树、SFTP、查看器与笔记图谱。
- [代码编辑器](https://liu.software/zh/docs/code-editor.md) - 资源管理器栏、语法高亮、查找/替换、状态栏与 git diff 停靠面板。
- [Markdown 查看器](https://liu.software/zh/docs/markdown.md) - 样式化 MD 渲染、库搜索与 Go to Heading。

[下一步 安装 →](https://liu.software/zh/docs/install.md)