🚀 快速开始
⚠️ 安装前准备
在安装 iFlow CLI 之前，请确保您的系统已满足以下要求：
- 已安装 Node.js 16+ 或 Python 3.8+
- 具备基本的命令行操作能力
- 稳定的网络连接用于下载依赖
✅ 一键安装命令
如果您已满足上述要求，可以直接使用以下命令安装：
# 使用 npm 安装（推荐）
npm install -g @iflow/cli
# 或使用 pip 安装
pip install iflow-cli
📋 详细安装步骤
1
安装 Node.js 或 Python
Windows 系统需要先安装运行环境：
# 方法一：安装 Node.js（推荐）
# 访问 https://nodejs.org 下载最新 LTS 版本
# 安装时勾选 "Add to PATH"
# 方法二：安装 Python
# 访问 https://python.org 下载 Python 3.8+
# 安装时勾选 "Add Python to PATH"
验证安装：
# Node.js 验证
node --version
npm --version
# Python 验证
python --version
pip --version
2
安装 iFlow CLI
# 使用 npm 安装（推荐）
npm install -g @iflow/cli
# 或使用 pip 安装
pip install iflow-cli
权限问题
如果遇到权限错误，请以管理员身份运行命令提示符。
3
配置 iFlow CLI
# 初始化配置
iflow init
# 配置工作空间
iflow workspace create my-workspace
1
安装 Node.js 或 Python
macOS 用户可以使用 Homebrew 安装：
# 安装 Node.js（推荐）
brew install node
# 或安装 Python
brew install python@3.9
验证安装：
# Node.js 验证
node --version
npm --version
# Python 验证
python3 --version
pip3 --version
2
安装 iFlow CLI
# 使用 npm 安装（推荐）
npm install -g @iflow/cli
# 或使用 pip3 安装
pip3 install iflow-cli
如果遇到权限问题，使用 sudo：
sudo npm install -g @iflow/cli
3
配置 iFlow CLI
# 初始化配置
iflow init
# 配置工作空间
iflow workspace create my-workspace
1
安装 Node.js 或 Python
使用包管理器安装运行环境：
# Ubuntu/Debian - 安装 Node.js（推荐）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或安装 Python
sudo apt update
sudo apt install python3 python3-pip
2
安装 iFlow CLI
# 使用 npm 安装（推荐）
sudo npm install -g @iflow/cli
# 或使用 pip3 安装
pip3 install iflow-cli
3
配置 iFlow CLI
# 初始化配置
iflow init
# 配置工作空间
iflow workspace create my-workspace
✅ 验证安装
测试 iFlow CLI
运行以下命令验证安装是否成功：
# 检查版本
iflow --version
# 查看帮助信息
iflow --help
# 测试基本功能
iflow status
成功标志
如果您看到 iFlow CLI 的版本信息和状态，说明安装配置成功！
🛠️ 常用功能介绍
工作空间管理
使用 iFlow CLI 管理您的工作空间：
# 创建新工作空间
iflow workspace create my-project
# 切换工作空间
iflow workspace switch my-project
# 列出所有工作空间
iflow workspace list
工作流管理
# 创建工作流
iflow flow create my-workflow
# 运行工作流
iflow flow run my-workflow
# 查看工作流状态
iflow flow status
任务管理
# 创建任务
iflow task create "任务描述"
# 查看任务列表
iflow task list
# 完成任务
iflow task complete task-id
❓ 常见问题解答
安装时出现权限错误怎么办？
+
Windows：以管理员身份运行命令提示符
macOS/Linux：使用 sudo 命令或配置用户环境
# 配置 npm 用户安装
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
iFlow CLI 有哪些常用命令？
+
# 工作空间管理
iflow workspace create/switch/list
# 工作流管理
iflow flow create/run/status
# 任务管理
iflow task create/list/complete
# 配置管理
iflow config set/get/list
如何更新 iFlow CLI？
+
# 使用 npm 更新
npm update -g @iflow/cli
# 使用 pip 更新
pip install --upgrade iflow-cli
如何配置自定义工作流？
+
# 创建工作流配置文件
iflow flow init my-workflow
# 编辑工作流配置
iflow flow edit my-workflow
# 验证工作流配置
iflow flow validate my-workflow
工作流配置文件通常位于：~/.iflow/flows/
iFlow CLI 支持哪些操作系统？
+
iFlow CLI 支持以下操作系统：
- Windows 10/11
- macOS 10.15+
- Ubuntu 18.04+
- CentOS 7+
- 其他主流 Linux 发行版
如何备份和恢复工作空间？
+
# 备份工作空间
iflow workspace export my-workspace --output backup.json
# 恢复工作空间
iflow workspace import backup.json --name restored-workspace