iFlow CLI

1、写在开头

工具介绍

iFlow CLI

iFlow CLI 是一款先进的 AI Coding 工具，同时可以帮助你高效获取知识，无论是日常娱乐生活百科还是专业学术论文知识，都可以轻松解答，让你快速进入心流状态，让知识随心流动！

https://platform.iflow.cn/cli

核心亮点

• 免费开放：免费使用 Kimi K2、Qwen Coder、GLM 4.5 等顶尖 AI 模型。

• 灵活集成：支持将 iFlow CLI 集成到自己熟悉的开发工具，实现工作流程的自动化。

• 智能体生态：通过心流开放市场，快速扩展智能体，组建只属于你的AI团队。

• 自然语言交互：直接用日常对话来操作，无论是代码开发还是生活助理。

支持API调用

# BaseUrl
https://apis.iflow.cn/v1/chat/completions

Models | 心流开放平台

心流AI开放平台模型库

https://platform.iflow.cn/models

核心概念

• 支持4种运行模式：yolo模式（模型拥有最大权限，可执行任何操作）、接受编辑模式（模型仅拥有文件修改权限）、计划模式（先计划后执行）、默认模式（模型无权限）

• 升级subAgent功能：将CLI从通用助手转变为专家团队，提供更专业准确的建议。使用 /agent 查看更多预配置代理

• 升级task工具：有效压缩上下文长度，让CLI更彻底地完成您的任务。当上下文达到70%时自动压缩

• 集成心流开放市场：快速安装有用的MCP工具、Subagents、自定义指令和工作流

• 免费多模态模型使用：现在您也可以在CLI中粘贴图片了（Ctrl+V粘贴图片）

• 支持对话历史保存和回滚（iflow --resume 和 /chat 命令）

• 支持更多有用的终端命令（iflow -h 查看更多命令）

• VSCode插件支持

• 自动升级：iFlow CLI自动检测当前版本是否为最新版本

术语词汇表 | 心流开放平台

iFlow CLI 核心概念和术语定义

https://platform.iflow.cn/cli/glossary

• iFlow CLI 基础

• 命令系统

• 执行模式

• 交互模式

• 扩展系统
• MCP 相关
• 代理系统

• 功能特性
• 内存和状态
• 高级功能

• 配置和管理
• 配置文件
• 认证方式

2、安装使用

安装和配置

• Node.js 20+

• 4GB+ 内存

• 互联网连接

# 一键安装脚本，会安装全部所需依赖
bash -c "$(curl -fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"

# 已有Node.js 20+
npm i -g @iflow-ai/iflow-cli@latest

1. 访问 https://nodejs.org/zh-cn/download 下载最新的 Node.js 安装程序
2. 运行安装程序来安装 Node.js
3. 重启终端：CMD(Windows + r 输入cmd) 或 PowerShell
4. 运行 `npm install -g @iflow-ai/iflow-cli@latest` 来安装 iFlow CLI
5. 运行 `iflow` 来启动 iFlow CLI

心流开放平台 - 心流开放平台 | 心流开放平台

心流AI开放平台，用AI重塑研发范式，让每一位开发者体验沉浸、高效的创作流程

https://platform.iflow.cn/profile?tab=apiKey

iflow

• Login with iFlow 登录（推荐）

• 心流 API Key 登录

• OpenAI Compatible API

四种运行模式

• Yolo：模型拥有最高权限，执行操作零限制

• Accepting Edits：仅允许修改文件，安全可控

• Plan Mode：先规划任务步骤，再逐层执行

• Default：模型无任何权限

多模态处理

支持MCP拓展

// Sequential-Thinking
iflow mcp add-json -s user 'sequential-thinking' "{\"command\":\"npx\",\"args\":[\"-y\",\"@iflow-mcp/server-sequential-thinking@0.6.2\"]}"

// context7
iflow mcp add-json -s user 'context7' "{\"command\":\"npx\",\"args\":[\"-y\",\"@iflow-mcp/context7-mcp@1.0.0\"]}" 

// serena
iflow mcp add-json -s user 'serena' "{\"command\":\"python\",\"args\":[\"-m\",\"serena.mcp_server\"],\"env\":{\"INTELEPHENSE_LICENSE_KEY\":\"XXX\"}}" 

多智能体协作

Sub Command（指令）

Sub Agent（智能体）

Workflow（工作流）

项目根目录/
├── .iflow/                   # iFlow CLI配置和资源目录
│   ├── agents/               # 智能体配置文件夹
│   │   ├── agent1.md         # 具体的agent配置文件
│   │   └── agent2.md         # 更多agent配置
│   ├── commands/             # 自定义命令文件夹
│   │   ├── command1.md       # 具体的command实现
│   │   └── command2.md       # 更多command实现
│   ├── IFLOW.md              # 详细的工作流文档和配置
│   └── settings.json         # mcp相关配置
├── [项目文件夹]/               # 您的项目文件和代码
└── IFLOW.md                  # 工作流配置和说明文件

输入数据 → Workflow引擎 → 步骤编排 → 结果输出
    ↓           ↓           ↓          ↓
[用户请求] → [流程解析] → [组件调用] → [结果聚合]
             ↓           ↓
         [Agent执行] → [Command执行] → [MCP工具调用]

Serena - 编码代理工具包

• Token 效率低下与成本高昂

• 代码理解准确性不足

• 大型项目导航困难

• 跨会话任务延续性差

安装

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或使用Homebrew
brew install uv

# 安装完验证 (输出版本uv版本号说明安装成功)
uv --version

git clone https://github.com/oraios/serena.git
cd serena
uv run serena start-mcp-server

# 也可以执行下面这个一步到位的命令
uv --from git+https://github.com/oraios/serena serena start-mcp-server

iflow mcp add serena -- \
  uv --from git+https://github.com/oraios/serena \
  serena start-mcp-server \
  --dirctionary "安装路径" \
  --project "$(pwd)"

# 激活项目
activate_project

• project.yml：项目级配置文件

• cache：语言服务器缓存

• memories：项目记忆文件夹

建立预索引

规则prompt

1. 完整模式

2. 嵌入模式
让客户端调用 Serena 的 initial_instructions 或 get_mcp_instructions 工具，自动注入 prompt。

# CLAUDE.md 顶部添加

(Serena integration)
Use the Serena MCP Server connected to this workspace.
If you haven't yet read Serena’s internal instructions, run the tool:
`read Serena’s initial instructions` (or invoke `/mcp__serena__initial_instructions`)
to load its coding rules and usage policies.

# Codex/Cursor 等
You are connected to a running Serena MCP Server providing semantic code tools.
Always prefer Serena’s tools for reading, editing, and searching code.
Read Serena’s initial instructions via the MCP tool `initial_instructions` before first use.

工具列表

• 代码结构与语义工具：核心，用于定位、浏览、分析符号级结构，基于 LSP 提供语义理解。
• get_symbols_overview：获取文件内顶层符号 (函数、类、变量等) 概览。
• find_symbol：根据名称路径 (name_path) 查找符号定义，可选包含 body。
• find_referencing_symbols：查找某符号的引用 (调用/依赖) 位置。
• search_for_pattern：按正则或关键字模式搜索代码片段。
• find_file：按文件名/路径模式搜索文件。
• list_dir：列出目录内容 (非递归) 。
• read_file：读取文件或片段内容。

• 语义编辑工具：symbol-safe 编辑，基于 LSP 的 "符号粒度" 安全改动，避免乱改。
• replace_symbol_body：替换指定符号 (函数/类等) 的实现部分。
• rename_symbol：重命名符号 (自动更新引用) 。
• insert_before_symbol / insert_after_symbol：在某个符号定义前/后插入代码。
• replace_in_file / replace_regex：在文件内按文本/正则进行替换。
• replace_lines：按行号范围替换。

• 项目与上下文管理工具：用于激活项目、预索引、调整上下文、切换模式等。
• activate_project：激活/注册当前项目 (生成 .serena/project.yml) 。
• project_index：构建符号索引 (加速大项目) 。
• switch_modes：动态切换行为模式，如：planning、editing、interactive、one-shot 等。
• list_modes：查看当前启用模式。
• get_context / set_context：获取/切换上下文类型 (IDE、Agent、Desktop 等) 。
• initial_instructions：输出 Serena 的系统提示 (可供客户端加载) 。
• get_config / set_config：查看/修改 Serena 配置。

• 记忆与长期状态工具：管理 .serena/memories/ 下的知识文件，实现跨会话持久化。
• list_memories：列出所有记忆文件 (名称、描述) 。
• read_memory：读取指定记忆内容。
• write_memory：写入新的记忆 (自动生成文件) 。
• delete_memory：删除记忆。
• prepare_for_new_conversation：生成会话摘要记忆 (衔接新会话) 。

• 辅助与执行类工具：扩展功能，支持命令执行、任务跟踪、系统监控等。
• execute_shell_command：运行 shell 命令 (如测试、构建等) 。
• list_recent_shell_commands：查看最近执行的命令。
• record_tool_usage_stats：记录工具调用统计 (用于 Dashboard) 。
• open_dashboard：打开 Web Dashboard。
• think_about_task_adherence：自检任务是否偏离目标。
• think_about_whether_you_are_done：判断任务是否完成。
• think_about_collected_information：整理当前上下文信息。

• 扩展工具 / 可选插件工具
• onboarding：进行项目初次导览 (收集结构信息写入记忆) 。
• help / list_tools：显示可用工具与参数。
• project_info：汇总当前项目状态 (索引状态、配置路径等) 。
• system_summary：导出系统诊断信息。

3、引用

心流开放平台 - 心流开放平台 | 心流开放平台

心流AI开放平台，用AI重塑研发范式，让每一位开发者体验沉浸、高效的创作流程

https://platform.iflow.cn/

【每天一个必装MCP】Serena - 编码代理工具包 · 语雀

官方仓库oraios/serena是什么？LLM (大...

https://www.yuque.com/coderpig/qoh77g/zktqd1h1g4cw8gt0#tawSw