CLI Channel

xbot 的终端交互界面，基于 Bubble Tea TUI 框架构建。不只是聊天窗口——是一个完整的 Agent 工作台。

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/CjiW/xbot/master/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/CjiW/xbot/master/scripts/install.ps1 | iex

xbot-cli                # 交互模式 — 完整 TUI
xbot-cli "your prompt"  # 单次执行
echo "prompt" | xbot-cli # 管道模式

首次运行自动进入配置引导，支持 OpenAI / Anthropic / 任何 OpenAI 兼容 API。

Token 级别的流式渲染——每一帧都实时更新，带闪烁光标效果。工具调用进度内联显示，推理/思考链直接可见。

渲染架构： 三级缓存系统确保高性能——流式消息只重新渲染当前行，历史消息完全跳过。即使在密集的工具调用场景下也能保持流畅。

每个 SubAgent 角色获得基于名称哈希的唯一颜色。进度面板以树状结构展示正在运行的 Agent，带波浪动画和实时计时。

管理多个 API Key / Provider，随时切换：

• Ctrl+P — 快速切换订阅（Quick Switch 面板）
• Ctrl+N — 循环切换模型
• /settings — 完整设置面板，添加/删除/重命名订阅

模型分级（SubAgent 成本优化）：

通过 /settings 为每个等级分配不同模型，SubAgent 根据任务类型自动选用。

/rewind 回退到任意历史轮次。不只是对话上下文——文件也会恢复到当时的 checkpoint 状态。

回滚完成后显示恢复/创建/删除的文件清单。

Agent 处理中？继续打字。消息自动排队，Agent 完成后按顺序发送。

📬 2 queued  — ↑ recall · Esc cancel

通过 /settings 或 Ctrl+N 切换。所有主题均为暗色终端优化。

完整 glamour 渲染：代码块、表格、列表、标题。Mermaid 图表自动转换为 ASCII art。

长时间运行的命令自动转入后台。按 ^ 打开管理面板——查看日志、终止任务。

Agent 调用 AskUser 工具时，自动弹出交互面板：

• 多题切换（←→ / Tab）
• 选项高亮 + 空格/回车选择
• 自由文本输入
• “Other” 自定义选项

输入 @ 触发文件路径补全（Tab 循环 / Enter 确认）。引用的文件作为附件随消息发送。

/search 进入搜索模式，大小写不敏感匹配历史消息。↑↓ 导航结果，自动滚动到匹配位置。

支持 3 种语言：中文（默认）、English、日本語。通过 /settings 切换。所有 UI 文本、设置面板、帮助信息均完整翻译。

CLI 使用 ~/.xbot/config.json 管理配置。首次运行自动引导创建。

┌──────────────────────────────────────────────────────────────────┐
│  🤖 xbot CLI                              Enter 发送 | Esc 退出  │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│                      消息显示区域 (Viewport)                      │
│              支持 Markdown / Mermaid / 语法高亮渲染                │
│                                                                  │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │ 🤖 Assistant                                         14:30 │  │
│  │                                                          │  │
│  │  # Iteration 1                                           │  │
│  │    ✓ Read main.go (12ms)                                 │  │
│  │    ◉ Grep "func main" (running...)                       │  │
│  │                                                          │  │
│  │  Stream content here...▋                                 │  │
│  │    ├── 🎨 code-reviewer (running...)                     │  │
│  │    └── 🔍 explore (done)                                 │  │
│  └────────────────────────────────────────────────────────────┘  │
│                                                                  │
├──────────────────────────────────────────────────────────────────┤
│  ✓ Ready                                          [1 task 1 ag] │
├──────────────────────────────────────────────────────────────────┤
│  💬 ┃ Input message...                                           │
│     ┃                                                            │
└──────────────────────────────────────────────────────────────────┘

CLI 使用 ~/.xbot/config.json 管理配置，首次运行自动引导创建。

{
  "llm": {
    "provider": "openai",
    "api_key": "sk-xxx",
    "base_url": "https://api.openai.com/v1",
    "model": "gpt-4o"
  },
  "sandbox": {
    "mode": "none"
  },
  "agent": {
    "memory_provider": "flat"
  }
}

通过 /settings 或直接编辑 ~/.xbot/config.json 修改。

1. 确保终端支持 256 色：echo $TERM（应为 xterm-256color 或类似）
2. 尝试设置环境变量：export TERM=xterm-256color
3. 使用现代终端模拟器（如 iTerm2、Alacritty、Windows Terminal）

1. 确保终端字体支持中文（如 Nerd Font、Sarasa Mono）
2. 检查系统 locale 设置：locale

1. 检查状态栏是否显示「思考中…」— 此时输入框暂时禁用
2. 按 Ctrl+C 强制退出后重新启动
3. 检查 LLM API 是否正常响应

1. 确保终端窗口足够宽（建议 80 列以上）
2. 尝试调整终端字体大小