终端 TUI（zagens-tui）
zagens-tui 是 Zagens 的全屏终端 UI — ratatui 三栏 Agent 外壳，与桌面应用共用 Kernel V3 引擎与 SQLite 会话存储。
v0.8.0 起在 Windows、macOS、Linux 发布。适合不想用 Tauri 桌面、或当前平台仅提供 CLI/TUI 二进制时使用。
不同于桌面 Code 工作区内的内嵌 xterm 终端 — 后者是 WebView + PTY 面板；
zagens-tui是独立可执行文件。
布局
| 区域 | 作用 |
|---|---|
| 左侧栏 | 会话列表 — 切换线程；--fresh 新建工作区会话 |
| 中间 | 流式 transcript（助手、思考/THK、工具卡片）+ composer + 活动跑马灯 |
| 右侧 inspector | 文件、diff、checklist、子 Agent、MCP — i 切换 |
| LHT 下 pane | 目标、计划阶段、checklist 门禁 — l 切换 |
主题（cool-blue、dracula-tint、high-contrast 等）保存在 ~/.zagens/tui-layout.toml。
安装
预编译（推荐）： 从 GitHub Releases 下载与桌面 zip、zagens CLI 同页的 zagens-tui 二进制。
源码构建（需 Rust）：
cargo build -p zagens-cli --features tui --bin zagens-tui --release
./target/release/zagens-tui
首次运行有引导流程（欢迎、API Key、默认任务类型） — 与桌面共用 ~/.zagens/settings.toml。可用 --skip-onboarding 跳过。
快速开始
zagens-tui # 恢复上次工作区会话
zagens-tui --fresh # 新会话
zagens-tui --skip-onboarding
API Key 可通过引导、/api-key、/login 或 ~/.zagens/config.toml（与 CLI 共用）配置。
Composer 要点
| 输入 | 行为 |
|---|---|
| Enter | 助手流式输出时 → 排队下一条；工具/等待间隙 → steer（CodeWhale 风格） |
| Ctrl+Enter | 流式期间强制 steer |
| ↑（空 composer） | 拉回最后一条排队消息编辑 |
| Shift+Enter | 多行输入换行 |
Slash 命令： /model（/m）、/lht、/locale / /language、/api-key、/key、/login、/logout。
审批： 弹窗 + 底部策略循环（Ctrl+A），与桌面四档工具审批概念一致。
i18n： 读取 ~/.zagens/settings.toml 的 locale — auto、en、ja、zh-Hans、pt-BR；运行时可用 /locale 切换。
与桌面 / CLI 对比
| 桌面 | zagens-tui |
zagens CLI |
|
|---|---|---|---|
| UI | WebView 面板、diff、replay | 全屏 TUI | 纯终端文本 |
| Runtime | 本地 sidecar | 进程内 | 进程内 |
| 引擎 | Kernel V3 | Kernel V3 | Kernel V3 |
| 办公模式 | 支持 | 支持任务类型 | 无界面 / 有限 |
| 适合 | Windows 日常编码 + 办公 | 全平台终端优先 | CI 单次、serve --http |
zagens-tui 不提供 exec、serve、doctor 等子命令 — 请用 zagens 二进制。
限制
- 鼠标滚轮可选：
--mouse-capture - 调试终端嵌入：
--no-alt-screen - Windows 仍有桌面安装包；macOS/Linux 用户通常使用 TUI + CLI
相关：Kernel V3 · Headless CLI · 安装指引 · LHT 概览