Zeus CLI / TUI

Zeus 的命令行界面和终端用户界面，使用 React + Ink 构建。

特性

• 🖥️ 丰富的 TUI 界面，类似 GUI 的终端体验
• 💬 Agent 对话，支持 SSE 流式响应
• 📋 会话管理（创建、切换、删除）
• 📚 知识库集成（选择、RAG 检索）
• ⚙️ 配置管理（API Key、Endpoint、Model）
• ⌨️ 快捷键支持

安装

cd apps/cli
pnpm install
pnpm build

使用

启动 TUI

# 直接启动交互式 TUI
node dist/index.js

# 或者使用 dev 模式（热重载）
pnpm dev

CLI 命令

# 显示帮助
zeus --help

# 快速提问（不进入 TUI）
zeus ask "How to use browser tools?"

# 配置管理
zeus config show
zeus config set api-key <your-api-key>
zeus config set endpoint http://localhost:3000

# 会话管理
zeus sessions list
zeus sessions delete <session-id>

# 知识库
zeus kb list
zeus kb search <kb-id> <query>

快捷键

| 快捷键 | 功能 | |--------|------| | Tab | 打开/关闭菜单 | | Ctrl+N | 新建会话 | | Ctrl+S | 会话列表 | | Ctrl+K | 知识库选择 | | Ctrl+, | 设置 | | ? | 帮助 | | Esc | 返回/取消 | | Ctrl+C | 退出 |

配置

配置文件存储在 ~/.config/zeus-cli/config.json

{
  "apiEndpoint": "http://localhost:3000",
  "apiKey": "your-api-key",
  "defaultModel": "claude-3.5-sonnet"
}

开发

# 开发模式（热重载）
pnpm dev

# 类型检查
pnpm typecheck

# 构建
pnpm build

技术栈

• Ink - React for CLI
• Commander - CLI 命令解析
• Zustand - 状态管理
• Conf - 配置存储

项目结构

apps/cli/
├── src/
│   ├── index.tsx          # 入口文件
│   ├── cli.ts             # CLI 命令定义
│   ├── api/               # API 客户端
│   │   ├── client.ts      # HTTP 客户端
│   │   ├── agent.ts       # Agent API
│   │   ├── session.ts     # 会话 API
│   │   ├── knowledge-base.ts
│   │   └── project.ts
│   ├── components/        # UI 组件
│   │   ├── App.tsx        # 主应用
│   │   ├── Chat.tsx       # 聊天界面
│   │   ├── SessionList.tsx
│   │   ├── KnowledgeBase.tsx
│   │   ├── Settings.tsx
│   │   ├── Help.tsx
│   │   └── common/        # 通用组件
│   ├── store/             # 状态管理
│   │   ├── chatStore.ts
│   │   └── uiStore.ts
│   └── utils/             # 工具函数
│       └── config.ts      # 配置管理
├── package.json
└── tsconfig.json