## 概述

AI 对话系统，支持多模型、上下文引用和 Agent 自主执行。

## 启动对话

```bash
j chat              # 进入 TUI 对话界面
j chat "你好"       # 快速提问并打印回复
j chat -c           # 延续上一个会话
j chat --session <id>  # 恢复指定会话
```

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Enter` | 发送消息 |
| `Esc` | 取消响应/退出 |
| `Ctrl+Y` | 复制最后一条 AI 回复 |
| `Ctrl+B` | 消息浏览模式 |
| `Ctrl+G` | 打开日志窗口 |
| `Ctrl+O` | 展开/折叠工具详情 |
| `Ctrl+E` | 打开配置界面 |
| `F1` 或 `?` | 显示帮助 |

## 斜杠命令

在输入框中输入 `/` 触发斜杠命令：

| 命令 | 功能 |
|------|------|
| `/copy` | 复制最后一条 AI 回复 |
| `/log` | 打开日志窗口 |
| `/browse` | 浏览历史消息 |
| `/config` | 打开配置界面 |
| `/model` | 切换模型 |
| `/archive` | 归档当前对话 |

## 上下文引用

输入框中以 `@` 触发补全：

```
@skill:<name>       # 引用技能
@command:<name>     # 引用自定义命令
@file:<path>        # 引用文件内容（支持图片）
```

## Agent 能力

AI 对话内置 Agent 能力，可自主规划并执行多步骤任务：

- **自主推理**：AI 规划并执行多步任务
- **工具集成**：自动使用可用工具（Read、Write、Bash/PowerShell 等）
- **任务管理**：Task 和 Todo 工具管理复杂任务
- **计划模式**：先探索代码库再制定计划

### 可用工具

| 工具 | macOS / Linux | Windows | 描述 |
|------|:---:|:---:|------|
| Read | ✅ | ✅ | 读取文件 |
| Write | ✅ | ✅ | 写入文件 |
| Edit | ✅ | ✅ | 编辑文件 |
| Glob | ✅ | ✅ | 文件名搜索 |
| Grep | ✅ | ✅ | 内容搜索 |
| Bash | ✅ | ❌ | Shell 命令执行 |
| PowerShell | ❌ | ✅ | PowerShell 命令执行 |
| WebFetch | ✅ | ✅ | 网页抓取 |
| WebSearch | ✅ | ✅ | 网页搜索 |
| ComputerUse | ✅ | ❌ | 屏幕截图与操作 |
| Browser | ✅ | ✅ | 浏览器自动化 |

### 计划模式

对于复杂任务，可先进入计划模式探索代码库：

```
分析这个项目的架构并设计重构方案

# AI 会：
1. 进入计划模式（只读工具可用）
2. 探索代码库结构
3. 生成详细计划
4. 提交计划等待用户确认
```

### 工具权限配置

在项目根目录创建 `.jcli/permissions.yaml`：

```yaml
permissions:
  allow_all: false
  allow:
    - Read
    - Grep
    - Glob
  deny:
    - Bash          # macOS / Linux
    - PowerShell    # Windows
    - Write
```

## 远程控制

```bash
j chat --remote     # 启用远程控制（手机扫码）
j chat --remote --port 9390  # 指定端口
```
