
1. **终端 CLI 命令**（shell 中运行 `iflow` + 子命令 / flags）
2. **常用全局 Flags**（适用于启动时）
3. **交互 TUI 内 Slash 命令**（进入 `iflow` 后输入 `/` 触发，可模糊搜索）

### 1. 终端 CLI 命令（iflow [flags] 或 iflow [prompt]）

| 命令示例                        | 主要作用                                   | 典型用法示例                                      | 备注                  |
|--------------------------------|--------------------------------------------|---------------------------------------------------|-----------------------|
| `iflow`                        | 启动交互式 TUI / REPL 会话                 | `iflow` 或 `iflow "帮我写个 REST API"`            | 最常用入口            |
| `iflow "你的任务"`              | 带初始提示启动交互会话                     | `iflow "分析这个项目结构"`                        | 快速开始              |
| `iflow --help` / `iflow -h`    | 显示完整帮助与所有 flags                   | `iflow --help`                                    | 查看子命令与选项      |
| `iflow -v` / `iflow --version` | 查看当前版本                               | `iflow -v`                                        | 检查更新              |
| `iflow update`                 | 检查并更新到最新版                         | `iflow update`                                    | 自动升级              |

**常用全局 Flags**（加在 `iflow` 后）

| Flag                           | 缩写 | 作用                                          | 示例                                           |
|--------------------------------|------|-----------------------------------------------|------------------------------------------------|
| `--model <model>`              | -m   | 指定模型（qwen3-coder / kimi-k2 / deepseek-v3 等） | `-m qwen3-coder`                               |
| `--yolo`                       | —    | 启用 YOLO 模式（全自动、无需逐个确认，危险）   | `--yolo` 或 shift+tab 切换                     |
| `--debug`                      | -d   | 开启调试日志                                  | `--debug`                                      |
| `--port <number>`              | —    | 指定 headless 服务器端口（用于 ACP/MCP）      | `--port 8090`                                  |
| `--experimental-acp`           | —    | 开启实验性 Agent Communication Protocol    | 用于 SDK 集成                                  |

### 2. 交互模式内 Slash 命令（输入 / 后出现，可上下箭头浏览 / 搜索）

| Slash 命令              | 主要作用                                      | 常用场景 / 备注                              |
|-------------------------|-----------------------------------------------|----------------------------------------------|
| `/help`                 | 显示所有 slash 命令 + 快捷键                  | 随时查看，必备                               |
| `/init`                 | 扫描当前项目，分析结构/依赖/架构，生成记忆    | 新项目必跑，类似 /init in Claude Code        |
| `/clear`                | 清空当前对话历史 + 上下文，从零开始           | 切换新任务                                   |
| `/exit` / `/quit`       | 退出 iFlow CLI                                | 结束会话                                     |
| `/model` / `/models`    | 切换或查看当前模型                            | 切换 Qwen / Kimi / DeepSeek 等               |
| `/language`             | 切换界面语言（zh-CN / en-US）                 | 中英文切换                                   |
| `/update`               | 检查并更新 CLI 到最新版本                     | 在 TUI 内升级                                |
| `/undo` / `/redo`       | 撤销/重做上一步文件变更                       | 安全回滚                                     |
| `/cost` / `/stats`      | 显示 token 消耗、费用估算（虽免费但显示使用） | 监控上下文长度                               |
| `/compact`              | 压缩对话历史，节省 token                      | 长会话优化                                   |
| `/agent` / `$agent-name`| 切换 / 调用 SubAgent（$explore-agent 等）     | 多角色协作（如 explorer / coder / reviewer） |
| `/mcp`                  | 管理 MCP 服务器（添加/查看/切换）             | ctrl+t 查看，连接外部工具/知识源             |
| `/commands`             | 查看/重载自定义 slash 命令                    | 自定义后 reload                              |
| `/tools`                | 查看/配置工具权限（shell / edit / read 等）   | 调试 agent 能力                              |
| `/share`                | 生成会话分享链接                              | 分享给团队或调试                             |
| `!命令`                 | 直接执行系统 shell 命令（如 !ls -la）         | 混合使用系统命令                             |

**补充说明**（2026 年 3 月最新情况）：
- 官方最权威文档：https://platform.iflow.cn/cli/quickstart + https://platform.iflow.cn/cli/examples/slash-commands（斜杠命令详解）
- 安装方式（macOS/Linux 推荐一键）：
  ```bash
  bash -c "$(curl -fsSL https://cloud.iflow.cn/iflow-cli/install.sh)"
  # 或 npm 全局安装
  npm install -g @iflow-ai/iflow-cli@latest
  ```
- 首次运行会引导登录/选模型（支持免费国内大模型，无需 API key 烦恼）
- YOLO 模式（全自动）默认开启，shift + tab 切换；ctrl + y 禁用确认
- 自定义 slash 命令：放在项目 `.iflow/commands/` 或全局目录，支持 Markdown 定义
- VS Code 插件：搜索 "iFlow CLI" 安装，可在侧边栏直接呼出
- GitHub Actions 集成：用 iflow-ai/iflow-cli-action@v2 在 PR/issue 中自动化

快速查看本地帮助：
```bash
iflow --help          # CLI flags
# 进入交互后
/help                 # slash 命令列表
```
