如在使用过程中发现需求或者缺陷，欢迎在iFlow 讨论区建帖，与我们一同交流！
1、安装、升级与卸载问题
如何安装？
解决方案：iFlow CLI 快速开始https://platform.iflow.cn/cli/quickstart
怎么在 docker 成功安装 iFlow？
解决方案：docker 的 DOCKER FILE 文件里面写一下安装脚本就可以了
iFlow 可以安装在 fish 吗？脚本只适配了 bash
解决方案：目前的策略是执行安装时按照用的 shell 自动适配。所以如果要支持 fish，可以先切换到 fish 再重新执行安装。如果已经安装，那么把 source “$HOME/.nvm/nvm.sh” 加入 fish 配置文件即可
海外安装是否需要切换 npm？
解决方案：不需要
iFlow CLI 如何升级？
解决方案：打开终端会自动升级，或者重新跑一下命令
npm install -g @iflow-ai/iflow-cli to update
自动升级失败怎么解决？
解决方案：运行 npm i -g @iflow-aiiflow-aiiflow-aiiflow-aiiflow-aiiflow-aiiflow-aiiflow-ai/iflow-cli to update
遇到升级失败，可能是网络问题，退出重试一下即可。
自动升级失败，手动更新也失败怎么办？
解决方案：
（1）n@iflow-aim unins@iflow-aiiflow-aiall -g @iflow-aiiflow-aiiflow-aiiflow-aiiflow-aiiflow-aiiflow-aiiflow-ai/iflow-cli
（2）which iflow ，rm 路径执行一下看看还有没有iflow@iflow-ai令
- 重新@iflow-aiiflow-a@iflow-ai行安装命令 n@iflow-aiiflow-aim i -g @iflow-ai/iflow-cli
已经利用覆盖升级命令了，但没有成功升级？
解决方案：先卸载旧版本，再安装新版本
如何删除、卸载？
解决方案：npm uninstall -g @iflow-ai/iflow-cli
2、Key 问题
如何申请 iFlow 的APIKey？
解决方案：登录心流内网官网，点击右上角头像->我的账户，复制 APIKey 即可
如何更换 key？
解决方案：上述位置点击重置
为什么 key 不生效？
解决方案：检查是否粘贴成功，复制错误等
如何验证我的 key 有没有问题？
解决方案：配置完成后输入你好，看是否会回复
3、启动、中断、回退问题
运行中断如何恢复？类似 continue/resume 功能
解决方案：可以在进入对话后，通过输入框输入**/chat** 指令来实现。例如，输入 /chat save 描述，这样就能看到保存的列表，从而恢复之前的环境。
每次退出前需要先 save 才行是吗，否则会直接丢失？
解决方案：目前看是的。已经将自动save加入研发清单。
出现问题是否可以回退？
解决方案：不能，建议您只在当前目录下执行，风险比较小。
4、配置问题
配置不生效应该怎么办？
解决方案：~/.iflow/settings.json 查看这个配置文件是否配置成功且保存，检查是否在安装目录下
~代表用户目录，Windows电脑代表 C://Users/用户名
支持哪些配置？
解决方案：所有配置可以查看官方文档：https://platform.iflow.cn/cli/configuration/settings
怎样取消模型工作时的等待加载信息让给界面更清爽？
在setting.json中直接修改配置：accessibility
5、指令问题
command not found: iflow，本地安装后没有 iFlow 命令是什么原因？
解决方案：
mac用户，iflow 命令会默认安装到当前使用的默认 shell 下面。比如你当前默认的 shell 是 bash，则会安装到bash 下。
不过对于zsh用户，可能需要手动设置。
默认会安装到 ~/.npm-global/bin 目录下，将这个目录设置到 shell 的 PATH 里面即可。
下面列举几个shell：
Fish：修改~/.config/fish/config.fish文件，追加 fish_add_path $HOME/.local/bin
Bash：修改~/.bashrc, 追加 export PATH=“$HOME/.npm-global/bin:$PATH”
Zsh：修改~/.zshrc， 追加 export PATH=“$HOME/.npm-global/bin:$PATH”
以上注意双引号
或者用命令执行：
bash需要执行:
echo "PATH=~/.npm-global/bin:$PATH" >> ~/.bash_profile
source ~/.bash_profile
zsh需要执行:
echo "PATH=~/.npm-global/bin:$PATH" >> ~/.zshrc
source ~/.zshrc
6、模型问题
心流支持哪些模型？
解决方案：
-
TBSTARS系列
-
DeepSeek系列
-
QWen3系列。
-
具体可查询心流开放平台，地址：https://platform.iflow.cn/docs/api-mode
是否支持自定义模型？
解决方案：支持
心流支持多模态的模型吗？
解决方案：支持
如何确定当前使用的模型？
解决方案：输入/about查看信息或在输入框右下角查看模型
模型无法生成答案？
解决方案：等待重试
7、Agent 相关问题
如何在本地添加自定义 Agent？
解决方案：参考https://platform.iflow.cn/cli/examples/subagent
SubAgent 的用法？
参考文档：https://platform.iflow.cn/cli/examples/subagent
/agents online 能找到一些现成的 agent，直接安装就可以用
哪个 SubAgent 重构项目的能力最强？
解决方案：针对不同项目，agent 的适用性不太一样，可以从开放市场找一下关联的 subagent 试一下，记得多提交 git，方便回滚：https://platform.iflow.cn/agents
SubAgent 是手动指定 Agent 调用，还是说会根据我的自然语言描述，程序自动会去调用 Agent？
解决方案：现在要明确指定，在输入框，或者 IFLOW.md 说明工作流
大模型可以使用 AIHubMix 的代理吗?
解决方案：支持 OpenAI 协议的就可以。 不过心流开放平台有免费的 LLM 可以使用
8、MCP 相关问题
更多问题欢迎查看： MCP 连接问题排查指南
iflow cli 能够自己配置 MCP server 吗？
解决方案：参考https://platform.iflow.cn/cli/examples/mcp
可以先修改 ~/.iflow/settings.json 添加一下
mcp 配置文件在哪个目录下？
解决方案： ~/.iflow/settings.json
iflow 默认的 mcp 调用异常是什么原因？
"text": "E\n \"error\": \"Invalid
thoughtNumber: must be a number\", \n \"status\":
\"failed\"\n}"
解决方案：模型输出的工具参数有问题，忽略
9、终端、环境问题
是否支持终端多模态（图片可视化）？
解决方案：支持多模态能力（需要使用多模态模型），但暂不支持图片可视化
iFlow 路径位置？
解决方案：可以查看官方文档-文件存储位置和分级设计：https://platform.iflow.cn/cli/configuration/iflow
10、IDE 集成类
如何集成 IDE（IDEA or VSCode）？
解决方案：https://platform.iflow.cn/cli/features/ide
IDE 工具，比如复制 log 文件，能让其以附件文件提交吗？
解决方案：可以手动编辑保存成文件，然后通过 @ 符号来引用
可以嵌套在 vscode 和 cursor 里吗？
解决方案：可以，安装一次，在其它 IDE 工具，都可以直接调用，非插件安装的方式，cursor 也是VS Code系列
IDE 里打开显示 no ide servers available to connect
解决方案：需要安装一下插件
11、操作技巧问题
可以让 iFlow 去读钉钉文档吗？
解决方案：理论上有这种工具，只是需要外接。
iFlow CLI 是不是限制了上下文长度？
解决方案：是的，不同模型有不同的上下文长度。
YOLO mode 是什么？
解决方案：自动化执行，不需要人类确认
重要文件 AI 不要乱改，等确认后再修改？
解决方案：建议重要的文件修改，退出 yolo 模式，通过 ctrl + y 或者shift + Tab 可以切换yolo的开关
如何开启 WebSearch？
解@一下入反斜杠方案：使用iF@一下入反斜杠ow登录默认就会有@一下入反斜@一下入反斜杠eb search
在ter@一下入反斜杠inal中，如@一下入反斜杠在输入时换行？
解决方案： @一下入反斜杠\@一下后@一下下ent@一下r 键换@一下一下，或@一下使@一下一下opt@一下@一下一下n@一@一下下一下+@一@一下e@一下t@一下一下一@一下@一@一下一下@一下换行
@一下@@一下下@一@一下@一下@一下 @一@一下li 如@@一下下下批@一下@一下行 tas@一下**，@一下@一下 c@一下下一下aud**@一下 @一下试一@一下p@一下一下@一下一下令内容@一下方式@一下
解决@一@一下试案@一下iflow @一下p
@一下@一下试@@一下下low 如@一下@一下速定@一下一个文件的命令？类似 Qwen
解决方案：@一下试 @一下
api @一下用每天有次数限制吗？
解决方案：没有 就是qps@一下一下有限制 只能开一个并发
只能访问 c 盘吗？能不能给他其他盘的权限？
解决方案：切换到其他盘后启动iflow就可以
iFlow 在执行清理文件的时候，如何知道哪些是系统文件？
解决方案：可以尝试先探讨不执行，“如果我要你清理缓存，你会怎么清理，清理什么”
想通过 iFlow 去自动通过 Chrome 打开一个网页，然后等待网页加载完成后自动点击某一个按钮？
解决方案：接入 MCP 实现功能，可以尝试一下 playwright，可以在 MCP 市场下载：https://platform.iflow.cn/mcp
是否可以用 Ollama？不用 api？
解决方案：Ollama 是本地部署的，提供 OpenAI 协议接口出来就可以
如何让 AI 直接接管我的电脑帮我做一些事情呢？
解决方案：不太建议直接让 AI 接管您的 root，可以尝试通过指令让他处理一些文件整理或者创意性的工作
如何让 qwen3 coder 的上下文变为官方宣传的 1M 长度，通过 iflow 如何实现？
解决方案：不可实现，1M 上下文的是闭源的模型。开源的只有 256K
PPT 生成可以用提示词指定语言吗？
解决方案：可以使用提示词，也可以用 MCP，可以在开放市场上找一个 PPT 生成的 MCP，安装后使用
能不能让执行过程中的 todo 记录下来?
解决方案：可以告诉CLI让他把 todo 写到文件中
一个 api 只能用在一个客户端上吗?
解决方案：只有一个并发，可以用在多个客户端上
每次从 cmd 调用 iFlow 太麻烦，怎么解决？
解决方案：自己写个批处理脚本，保存为 xx.bat，脚本格式 utf-8
API 可不可以使用硅基流动平台？
解决方案：可以
怎么查看之前的对话历史记录？
解决方案：iflow -r
iflow cli 有没有什么优雅切换同一个验证方式下模型的命令？
解决方案：输入/model选择模型
执行任意操作是在指定工作空间还是可以在指定操作系统任务地方，权限如何控制？
解决方案：目前iFlow CLI工作的范围仅限于当前设置的目录。超出范围会要求用户确认。如果是YOLO模式，推荐以sandbox模式启动。比如: iflow --sandbox
项目可以配置在 Termux 中吗？
解决方案：可以
Linux 是 deb 系的，Fedora 能不能用？
解决方案：可以
可以理解或生成视频吗？
解决方案：本身不能，可以通过 MCP 支持
VS插件连接不上
VS插件连接不上，可能有两个原因，一个是VS的版本号要大于103. 另外一个原因是iflow cli打开的当前文件夹路径，和vs code的文件夹路径不一致导致。新版的VS插件，可以在这里找：VS Code
12、其他问题
闪屏问题
一旦运行中使用了task，或者用到了sub agent，屏幕就会不断闪烁。
屏幕窗口过小，也有可能不断闪烁。
这个是已知问题，原因是因为构建的样式超过了窗口大小，导致底层不断在刷新屏幕，正在解决。
临时缓解方式：
-
将终端字体调整小一点
-
将屏幕放大，最好是全屏
Token 用量怎么看？是准确的吗？
解决方案：/stats model ，是准确的。
windows复制粘贴问题
解决方案：
检查windows终端是不是normal的模式，切换成insert的模式试试看。
另外，右键终端，选择属性，查看复制的选项。
也可以尝试使用Ctrl + X 打开外部编辑器，在外部编辑器里面进行复制粘贴操作。
执行过程中长时间无输出？
解决方案：可以尝试更换描述重新生成内容
限流有什么解决办法吗？
解决方案：目前没有解决办法，我们对于个人的api key会限制一个并发。
直接给文件操作权限是否不太安全？
解决方案：iFlow CLI 只有当前目录的访问权限，不建议在系统目录下执行，如 windows 下的 system32 文件夹，或者 mac 下的 home 目录
iFlow 会拿我的代码做训练或者存储我的代码吗？
解决方案：不会，团队绝对不会拿用户的代码仓库且无法存储，但是模型调用记录会存储，用于模型能力提升
iFlow 是否有开源？
解决方案：目前还没有开源，还需要进一步打磨，等时机成熟会开源，敬请期待
iFlow 读取的文件和信息会不会上传到外部服务器或者分享给第三方？
解决方案：不会
可以让 iFlow 部署 github 上的开源项目吗？
解决方案：本地能拉到，是可以的
beta 跟原来的是共存吗，还是安装后原来的版本变成了 beta？
解决方案：beta版本是我们的最新版本，如果想体验最新版本可以使用beta
在外部连 vpn 用心流 api，好像网不太好，在等 api上花比较多的时间？
解决方案：外网不用连接 VPN 进来的，切换外网心流就好了
Qwen3-Coder-Preview 和 Qwen3-Coder 的差别？
解决方案：暂无差别，都指向 Qwen3-Coder
13、常见报错
Invalid API key: Please run /login
解决方案：这是老版本会出现的问题，升级到新版本，已经修复
npm error network
解决方案：npm i -g @iflow-ai/iflow-cli --registry=https://registry.npmmirror.com
npm-prefix. js 不是内部或外部命令，也不是可运行的程序
解决方案：https://vibex.iflow.cn/t/topic/38
Windows 上执行 npm install -g 报错 cannot find module ./with-temp-dir.js
解决方案：https://vibex.iflow.cn/t/topic/37
npm : 无法加载文件 npm.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies
解决方案：https://vibex.iflow.cn/t/topic/36
在问问题的时候遇到 Error，怎么解决?
解决方案：正常现象，不需要过多干预
用了一段时间开始有 429 错误？
解决方案：触发了限流。稍等，看看能不能重试成功。
Error: File content (398.3KB) exceeds maximum allowed size (256KB). Please use offset and limit parameters to read specific portions of the file, or use the GrepTool to search for specific content.
解决方案：这个报错正常，AI 会自己意识到，然后换工具
Error: Found 2 matches of the string to replace, but replace_all is false. To replace all occurrences, set replace_all to true. To replace only one occurrence, please provide more context to uniquely identify the instance. String: response.OK(“no samples”, c)
解决方案：模型调工具参数有问题，只能让模型自己改了，建议重试
Error: InputValidationError: Write failed due to the following issues:The required parameter ‘file_path’ is missing The required parameter ‘content’ is missing
解决方案：模型调用工具没有传参数，只能重试不然就得等模型自己开窍了
[API Error: generate data error: Cannot convert argument to a ByteString because the character at index 9 has a value of 9608 which is greater than 255.
解决方案：因为输入包含了特殊字符，清空内容重输入
API Error: generate data error: fetch failed]。查看配置原来是：我复制的的token，直接在iflow启动过程中配置好以后，配置文件中前面几个字符被encode了.
解决方案：可能是操作系统的问题，可以先手动vim ~/.iflow/settings.json后再粘贴一下key。
如在使用过程中发现需求或者缺陷，欢迎在iFlow 讨论区建帖，与我们一同交流！