# Claw CLI 模块 (claw-cli)

本模块实现了 Claw 应用程序的主要命令行界面 (CLI)。它提供了交互式的 REPL 环境和非交互式的命令执行功能。

## 概览

`claw-cli` 模块是整个项目的“胶水”，负责编排 `runtime`、`api`、`tools` 和 `plugins` 模块之间的交互。它捕获用户输入，管理应用程序状态，并以用户友好的格式渲染 AI 响应。

## 关键特性

- **交互式 REPL**：一个功能齐全的 Read-Eval-Print Loop，用于与 AI 对话，支持：
  - 通过 `rustyline` 实现多行输入和命令历史。
  - 实时的 Markdown 流式显示和代码语法高亮。
  - 为耗时的工具调用显示动态的加载动画 (Spinner) 和进度指示器。
- **子命令**：
  - `prompt`：运行单次 Prompt 并退出（单次模式）。
  - `login`/`logout`：处理与 Claw 平台的 OAuth 身份验证。
  - `init`：初始化新项目/仓库以配合 Claw 使用。
  - `resume`：恢复并继续之前的对话会话。
  - `agents`/`skills`：管理并发现可用的智能体和技能。
- **权限管理**：对工具执行权限的细粒度控制：
  - `read-only`：安全的分析模式。
  - `workspace-write`：允许在当前工作区内进行修改。
  - `danger-full-access`：高级任务的无限制访问。
- **OAuth 流程**：集成了本地 HTTP 服务器，无缝处理用户机器上的 OAuth 回调重定向。

## 实现逻辑

### 核心模块

- **`main.rs`**: 主要入口点。负责解析命令行参数、初始化环境，并调度到适当的操作（REPL 或子命令）。
- **`render/`**: 包含 `TerminalRenderer` 和 Markdown 流渲染逻辑。使用 `syntect` 进行语法高亮，并使用 `crossterm` 进行终端操作。
- **`input/`**: 处理用户输入捕获，包括对多行 Prompt 和斜杠命令 (Slash Command) 的特殊处理。
- **`init.rs`**: 处理项目级初始化和仓库设置。

### 交互循环流程

1. CLI 初始化 `ConversationRuntime` 并加载项目上下文。
2. 使用 `rustyline` 进入捕获用户输入的循环。
3. 检查用户输入是否为“斜杠命令”（如 `/compact`、`/model`）。
4. 普通 Prompt 通过 `runtime` 发送给 AI。
5. AI 事件（文本增量、工具调用）逐步渲染到终端。
6. 会话定期保存，以便将来可以恢复。

## 使用方法

主二进制程序名为 `claw`。

```bash
# 启动交互式 REPL
claw

# 运行单次 Prompt
claw prompt "解释一下这个项目的架构"

# 登录服务
claw login
```