# 小狸 Pro-CLI 使用指南

## 快速上手

### 启动

```bash
# TUI 模式（默认）
python -m xiaoli

# CLI 模式
python -m xiaoli --cli

# 指定引擎
python -m xiaoli --engine ollama
```

### 基本操作

- **退出程序**: 输入 `/quit` 或 `Ctrl+C`
- **查看帮助**: 输入 `/help`
- **查看版本**: 输入 `/about`

---

## AI 引擎管理

### 切换引擎

```
/model ollama    # 切换到 Ollama 本地模型
/model mimo      # 切换到小米 MiMo
/model glm       # 切换到智谱 GLM
/model qwq       # 切换到 QwQ 深度思考
```

### 查看可用引擎

```
/engine list
```

---

## 聊天记录管理

| 命令 | 说明 |
|------|------|
| `/chat save <名称>` | 保存当前对话 |
| `/chat list` | 列出所有保存的对话 |
| `/chat open <名称>` | 加载历史对话 |

---

## 内置工具

小狸会根据你的自然语言描述自动选择合适的工具。以下是主要工具：

### 代码编辑器 (`code_editor`)

用于精准的代码编辑操作：

- **替换代码** — 指定文件和要替换的内容
- **批量编辑** — 一次修改多处
- **查看代码** — 按行号范围查看

### 代码搜索 (`code_search`)

用于理解和搜索代码库：

- **项目结构** — 查看目录树
- **搜索代码** — 按关键词搜索文件
- **符号提取** — 提取函数、类定义
- **代码统计** — 代码行数、文件数统计

### Git 操作 (`git_tools`)

- `status` — 查看状态
- `diff` — 查看变更
- `log` — 查看提交历史
- `commit <消息>` — 提交更改

### 文件管理 (`file_manager`)

| 操作 | 说明 |
|------|------|
| `list` | 列出目录内容 |
| `read <路径>` | 读取文件 |
| `write <路径> -c "内容"` | 写入文件 |
| `append <路径> -c "内容"` | 追加内容 |
| `delete <路径>` | 删除文件 |
| `mkdir <路径>` | 创建目录 |
| `copy <源> <目标>` | 复制文件 |
| `move <源> <目标>` | 移动文件 |
| `info <路径>` | 查看文件信息 |
| `tree` | 显示目录树 |

### 命令执行 (`cmd_executor`)

直接在沙箱中执行系统命令，支持超时控制。

### AI 搜索 (`ai_search`)

使用 AI 进行智能搜索和问答。

---

## 自然语言交互

你不需要记住命令格式，直接用自然语言描述需求即可：

```
"帮我看看 src/app.py 的第 10 到 20 行"
"搜索项目里所有用到 requests.get 的地方"
"提交代码，消息是修复登录bug"
"统计一下这个项目的代码量"
```

AI 会自动理解你的意图并调用合适的工具。

---

## 远程连接

### 启动 WebSocket 服务

```
/remote start <端口> <密码>
```

### 代理模式

```
/remote proxy <中继地址> <服务器密码> <本地端口> <本地密码>
```

---

## 使用技巧

1. **TUI 模式** — 默认启动 TUI 图形界面，体验更好；使用 `--cli` 切换到传统模式
2. **引擎选择** — 本地开发用 `ollama`，深度思考用 `qwq`，通用场景用 `mimo`
3. **代码编辑** — 描述需求即可，AI 会自动使用代码编辑器
4. **Git 工作流** — 自然语言描述，AI 自动执行 Git 操作
5. **插件扩展** — 可以自行开发插件，详见 [开发文档](开发文档/开发文档.md)

---

## 注意事项

- 文件操作大小限制为 50MB
- 代码执行在沙箱环境中，有超时限制
- 音频播放需要系统支持相应格式
- TUI 模式需要安装 `textual` 和 `rich`