j-cli 12.9.17

A fast CLI tool for alias management, daily reports, and productivity
## 概述

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 等)
- **任务管理**:Task 和 Todo 工具管理复杂任务
- **计划模式**:先探索代码库再制定计划

### 计划模式

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

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

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

### 工具权限配置

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

```yaml
permissions:
  allow_all: false
  allow:
    - Read
    - Grep
    - Glob
  deny:
    - Bash
    - Write
```

## 远程控制

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