交互模式

功能概述：iFlow CLI 提供多种灵活的交互方式，支持文本输入、图片处理、文件引用和智能多模态处理。

学习时间：10-15分钟

前置要求：已安装并配置iFlow CLI，了解基本命令行操作

什么是交互模式

交互模式是iFlow CLI 的核心功能，它允许用户通过多种方式与AI进行自然的对话和协作。系统支持文本、图片、文件引用等多种输入形式，并提供智能的多模态处理能力，让任何模型都能"理解"图片内容。

核心特点

特点	说明	平台支持
多种输入方式	文本、图片、文件引用等多种输入形式	全平台
智能多模态处理	让任何模型都能"理解"图片内容	全平台
自动内容检测	智能识别并处理不同类型的输入内容	全平台
大文本优化	自动处理长文本，优化界面显示	全平台
实时响应	实时处理用户输入，无需等待	全平台

工作原理

输入处理流程

用户输入 → 内容类型检测 → 预处理 → 模型适配 → AI响应
    ↓
[文本/图片/文件] → [自动识别] → [格式优化] → [多模态处理] → [生成回复]

智能适配机制

文本输入：直接传递给AI模型处理
图片输入：自动检测模型能力，必要时生成图片描述
文件引用：读取文件内容并整合到对话上下文
混合输入：智能组合不同类型的输入内容

详细功能说明

文本输入

单行文本

直接在命令行界面输入您的问题或指令：

> 帮我优化这个React组件的性能

多行文本输入

支持多种方式输入多行文本：

方法	操作	说明
反斜杠换行	`\` + `Enter`	快速创建多行输入
Shift + Enter	`Shift` + `Enter`	终端配置后可用

示例：

> 请帮我实现一个用户管理系统，包括：\
用户注册和登录功能
用户信息的增删改查
权限管理
数据持久化

图片处理

支持的图片格式

格式	扩展名	说明
PNG	.png	高质量图片，支持透明度
JPEG	.jpg, .jpeg	压缩图片格式
GIF	.gif	支持动图
WebP	.webp	现代图片格式
BMP	.bmp	位图格式

图片输入方式

截图粘贴

平台	截图快捷键	粘贴快捷键
macOS	`Cmd + Shift + 4`	`Control + V`
Linux	`PrtScn` 或其他	`Alt + V`
Windows	`PrtScn` 或其他	`Alt + V`

操作步骤：

使用系统截图工具截取需要分析的屏幕区域
在iFlow CLI 中按快捷键粘贴
系统自动生成图片占位符并处理

文件粘贴

在文件管理器中复制图片文件
在CLI中使用粘贴快捷键
全平台支持图片文件粘贴

粘贴后显示效果：

> [Pasted image #1] 这个界面有什么问题？

需要注意的是，原生终端、iTerm 终端以及 IDE 内置终端会强制过滤掉图片的粘贴事件，导致使用平台的原生粘贴快捷键时无法粘贴图片（比如 macOS 使用 Cmd + V 粘贴图片无效），此时可以使用 Ctrl + V 或 Shift + Ctrl + V 绕过这个过滤来粘贴图片。

图片处理示例

> [Pasted image #1] 请分析这个用户界面的设计问题
> [Pasted image #2] 这两个界面布局哪个更好？
> 帮我根据 [Pasted image #1] 这个设计稿写出对应的CSS代码

大文本处理

自动检测规则

检测项	阈值	处理方式
长文本粘贴	>800字符或 >10行	生成文本占位符
长内容显示	>900字符	截断显示优化
占位符格式	-	`[Pasted text #X +Y lines]`

界面优化特性

视觉简洁：避免长文本在终端中造成滚屏混乱
内容完整：虽然显示被优化，但模型仍能获得完整的原始文本
智能截断：显示前5行和最后5行（行数不超但字数超过阈值时，只显示前400个字符和最后400个字符），中间内容隐藏
标识清晰：占位符明确标识文本块的行数，便于识别内容规模

使用示例

> 请帮我重构这段代码：[Pasted text #1 +45 lines]
> 分析这个日志文件中的错误：[Pasted text #2 +120 lines]

操作流程

复制大量文本内容到剪贴板
在CLI中按 Ctrl/Cmd + V
系统自动生成占位符并保存原始内容
继续输入您的问题或指令

粘贴性能优化配置

在部分 Windows 系统中，剪贴板操作存在性能问题，表现为粘贴文本或图片文件响应缓慢（部分耗时超过 1000ms，而 macOS 和 Linux 系统通常在 100ms 以内）。这主要由于 Windows 系统通过 PowerShell 读取剪贴板内容的性能限制。

性能对比

操作系统	平均粘贴耗时	极端粘贴耗时	性能表现
Windows	300-600ms	>1000ms	部分机型可能存在性能问题
macOS	<100ms	<100ms	性能良好
Linux	<100ms	<100ms	性能良好

解决方案

针对受影响的 Windows 用户，系统提供了跳过剪贴板读取的配置选项：

pasteFromClipboard（布尔值）：
- 描述： 控制是否通过剪贴板读取来处理粘贴操作。启用时提供多行文本粘贴优化、图片文件粘贴和截图粘贴功能
- 默认值： true（使用剪贴板读取机制）
- 示例：
```
"pasteFromClipboard": false
```

使用注意事项

适用场景： 仅建议粘贴性能受影响的 Windows 用户配置此参数
功能限制： 设置为 false 后，将失去多行文本优化、图片文件粘贴和截图粘贴功能
终端兼容性： 设置为 false 后，现代终端（如 Windows Terminal 或 IDE 内置终端）会大幅提升普通文本的粘贴速度（<100ms）；但是在传统 Windows 控制台（如 cmd.exe、PowerShell）中配置为 false 会导致无法粘贴任何内容，因为这些终端不支持 bracketed paste 机制。

文件引用

引用方式

类型	语法	示例
单个文件	`@文件路径`	`@src/App.tsx`
目录引用	`@目录路径`	`@src/components`
多文件	空格分隔	`@file1.ts @file2.ts`

使用示例

单文件引用

> 帮我优化 @src/components/UserProfile.tsx 这个组件
> 请解释 @docs/api.md 中的API设计思路

目录引用

> 分析 @src/utils 目录下的工具函数
> 重构 @src/components 目录的组件结构

多文件引用

> 比较 @src/old-component.tsx 和 @src/new-component.tsx 的区别
> 根据 @package.json 和 @tsconfig.json 配置优化项目结构

智能多模态处理

核心特性

iFlow CLI 的独特之处在于其智能多模态处理机制，让任何模型都能"看懂"图片。

工作原理

自动图片描述生成

步骤	操作	说明
1	模型能力检测	检测主模型是否支持多模态
2	多模态调用	不支持时自动调用多模态模型
3	描述生成	生成详细的图片描述信息
4	内容整合	将描述传递给主模型处理

描述内容包括

整体布局和构图
主要对象和位置关系
颜色信息和视觉特征
文字内容（完整转录）
背景环境和细节特征

注册配置

心流AI方式登录

项目	说明
推荐选择	系统提供的模型都经过优化
自动处理	自动使用 `qwen-vl-max` 生成图片描述
配置需求	无需手动配置，完全自动化

OpenAI兼容方式登录

配置项	说明	必需
主模型名称	指定主要使用的模型	是
多模态模型	用于图片描述生成	否
跳过配置	直接发送给主模型	否

性能说明

项目	说明
优势	让所有模型都具备图片理解能力
注意	非多模态模型处理图片速度稍慢（因为需要先生成图片描述再输入给主模型理解）
建议	频繁多模态需求建议直接使用多模态模型

键盘快捷键

基础快捷键

功能	快捷键	说明
取消操作	`Ctrl/Cmd + C`	取消当前输入或生成
退出程序	`Ctrl/Cmd + D`	退出CLI会话
清屏	`Ctrl/Cmd + L`	清空终端屏幕
历史命令	`↑/↓`	浏览命令历史

输入相关

功能	快捷键	说明
粘贴内容	`Ctrl/Cmd + V`	自动检测图片、文本
多行输入	`\` + `Enter`	反斜杠换行
多行输入	`Shift/Option + Enter`	根据终端配置

Vim模式

使用 /vim 命令启用后支持：

操作	按键	说明
光标移动	`h/j/k/l`	左/下/上/右
删除行	`dd`	删除当前行
删除字符	`x`	删除当前字符

使用示例

常见场景

UI设计分析

> [Pasted image #1] 请分析这个登录页面的用户体验问题

代码调试

> [Pasted image #1] 这个错误截图显示的问题如何解决？

文件分析

> 请分析 @src/components/Header.tsx 的性能问题并提供优化建议

复杂问题

> 请帮我实现一个用户管理系统，包括：\
用户注册和登录功能
用户信息的增删改查
权限管理
数据持久化

最佳实践

图片使用技巧

UI设计分析：截图界面后询问设计改进建议
代码调试：粘贴错误截图快速定位问题
文档理解：上传图表、流程图等复杂图像内容
比较分析：同时粘贴多张图片进行对比

文本处理优化

大文件处理：利用自动占位符功能处理长代码或日志
结构化询问：使用多行输入组织复杂问题
上下文引用：结合 @ 文件引用提供完整上下文

模型选择建议

纯文本任务：使用文本模型即可，速度更快
偶尔图片需求：继续使用文本模型，自动处理图片
频繁多模态：选择多模态模型以获得最佳体验

故障排除

常见问题及解决方案

问题	可能原因	解决方案
图片粘贴失败	格式不支持或剪贴板无数据	检查图片格式，重新截图或复制
文件引用无效	路径错误或文件不存在	确认文件路径正确且文件可访问
多行输入异常	终端配置问题	尝试不同的换行快捷键组合
多模态处理错误	模型配置不正确	检查模型支持情况和配置
大文本上传失败	内容过大或网络问题	分段上传或检查网络连接

诊断步骤

权限检查
- 确认系统允许CLI访问剪贴板
- 检查文件读取权限
网络连接
- 确认网络连接正常（多模态处理需要API调用）
- 检查防火墙设置
配置验证
- 查看错误提示信息
- 根据提示调整操作
- 重启CLI确保配置生效

平台兼容性

平台	支持情况	注意事项
Windows	完全支持	注意路径分隔符
macOS	完全支持	系统权限可能需要授权
Linux	完全支持	依赖系统剪贴板工具

什么是交互模式​

核心特点​

工作原理​

输入处理流程​

智能适配机制​

详细功能说明​

文本输入​

单行文本​

多行文本输入​

图片处理​

支持的图片格式​

图片输入方式​

图片处理示例​

大文本处理​

自动检测规则​

界面优化特性​

使用示例​

操作流程​

粘贴性能优化配置​

文件引用​

引用方式​

使用示例​

智能多模态处理​

核心特性​

工作原理​

注册配置​

性能说明​

键盘快捷键​

基础快捷键​

输入相关​

Vim模式​

使用示例​

常见场景​

UI设计分析​

代码调试​

文件分析​

复杂问题​

最佳实践​

图片使用技巧​

文本处理优化​

模型选择建议​

故障排除​

常见问题及解决方案​

诊断步骤​

平台兼容性​

什么是交互模式

核心特点

工作原理

输入处理流程

智能适配机制

详细功能说明

文本输入

单行文本

多行文本输入

图片处理

支持的图片格式

图片输入方式

图片处理示例

大文本处理

自动检测规则

界面优化特性

使用示例

操作流程

粘贴性能优化配置

文件引用

引用方式

使用示例

智能多模态处理

核心特性

工作原理

注册配置

性能说明

键盘快捷键

基础快捷键

输入相关

Vim模式

使用示例

常见场景

UI设计分析

代码调试

文件分析

复杂问题

最佳实践

图片使用技巧

文本处理优化

模型选择建议

故障排除

常见问题及解决方案

诊断步骤

平台兼容性