🔥 iFlow-run - 为 iFlow CLI 打造的可视化会话管理工具

让 AI 编程助手的每一次对话都清晰可见、可追溯、可管理

你是否在使用 iFlow CLI 时遇到过这些问题:

  • 会话历史难以查找和回溯?
  • 想要回顾某次对话的完整上下文?
  • 需要区分和管理不同的项目会话?

iFlow-run 就是为你打造的解决方案!

:sparkles: 核心亮点

:bar_chart: 会话可视化管理

  • 项目与会话树形结构展示
  • 支持收藏、标签、高级筛选
  • 批量操作(删除)

:speech_balloon: 对话详情查看

  • 完整的用户消息、助手响应记录
  • 工具调用和工具结果展示
  • 支持 Markdown 渲染和代码高亮

:magnifying_glass_tilted_left: 高级筛选功能

  • 按模型、状态、标签筛选会话
  • 按消息类型筛选(用户/助手/工具调用)
  • 会话内关键词搜索

:label: 会话标签系统

  • 为会话添加自定义标签
  • 按标签快速定位会话
  • 标签颜色自定义

:artist_palette: 现代化 UI 设计

  • “Digital Currents” 设计语言
  • 暗色/亮色主题切换
  • 响应式布局,支持移动端

:rocket: 一键安装

npm install -g iflow-run
iflow-run

打开浏览器访问 http://localhost:3000,自动读取你的 iFlow CLI 会话数据!

:camera_with_flash: 功能一览

┌──────────┬──────────────────────────────────────────────┐
│ 功能 │ 描述 │
├──────────┼──────────────────────────────────────────────┤
│ 会话浏览 │ 完整的对话历史,支持 Markdown 渲染和代码高亮 │
│ 会话收藏 │ 收藏重要会话,置顶显示 │
│ 标签管理 │ 为会话添加标签,快速分类 │
│ 高级筛选 │ 按模型、状态、标签筛选 │
│ 批量删除 │ 一键清理多个会话 │
│ 环境追踪 │ 显示工作目录、Git 分支变更 │
│ 实时更新 │ WebSocket 监听会话变更 │
└──────────┴──────────────────────────────────────────────┘

:hammer_and_wrench: 技术栈

  • 后端:Node.js + Express + TypeScript
  • 前端:纯 HTML/CSS/JS(无框架依赖)
  • 实时更新:WebSocket

:package: 快速开始

全局安装

npm install -g iflow-run

启动服务

iflow-run

后台运行

iflow-run --daemon

指定端口

iflow-run --port=8080

:link: 相关链接


如果你也是 iFlow CLI 的用户,不妨试试 iFlow-run,让你的 AI 编程之旅更加高效!

欢迎 Star :star: 和反馈!

有点意思的项目. 我尝试一下. 一会来反馈

很严重的bug,当你拥有多个session在同一个目录下的情况下,删除多余的session,尝试触发project-open-iflow btn,会尝试打开已经删除的session,而且这并不适用于win10,自动打开的powershell我并无法正常直接使用

v1.4.1 (2026-03-08)

安全修复

  • :locked: 路径遍历漏洞修复 - 添加路径验证函数,防止攻击者通过 ../ 访问任意文件
  • :locked: 命令注入风险修复 - 将 exec 替换为 spawn,防止命令注入攻击

Bug 修复

  • :wrench: 打开 iflow 路径问题修复 -
    修复工作目录包含特殊字符(如空格、单引号等)时无法正确打开的问题
  • :wrench: Windows PowerShell 路径转义 - 使用 -LiteralPath 参数和单引号转义,正确处理特殊路径

安全增强

  • :shield: API 速率限制 - 添加速率限制中间件,API 请求限制为每 IP 每 15 分钟 200
    次,敏感操作限制为 20 次
  • :stopwatch: 请求超时机制 - 外部 AI API 请求添加超时机制(测试连接 10s,AI 对话/分析 60s)
  • :white_check_mark: 输入验证增强 - 完善批量操作和标签接口的输入验证,限制字符串长度和格式

技术细节

  • 新增 sanitizePathComponent() 函数验证路径组件安全性
  • 新增 buildSecureSessionPath() 和 buildSecureProjectPath() 函数构建安全路径
  • 新增 fetchWithTimeout() 函数实现带超时的 HTTP 请求
  • 新增内存速率限制中间件 rateLimitMiddleware()
  • 使用 path.resolve() 规范化工作目录路径
  • 跨平台路径转义:Windows (’ → ‘’),macOS/Linux (’ → ‘'’)

有没有人测试一下效果怎么样?

只接让iflow-cli装一下就好了.
```

GitHub - KeWen-Du/iflow-run · GitHub
clone到/ws/iflow-run下,并完成环境安装.

```

感觉还不错,不过不知道新版本是不是有bug,点击block折叠图标,有反馈,不过没有折叠起来.

chrome debug console, 也没看到错误信息.

是的 我也遇到了这个问题

直接让iflow修

https://github.com/KeWen-Du/iflow-run/issues/1

很好修复.

1.4.2 版本发布公告

iflow-run v1.4.2 发布公告

发布日期

2026年3月9日

更新内容

Bug 修复

  • 工具区块折叠问题修复 - 修复 Tool Call 和 Tool Result
    区块点击折叠箭头后无法折叠的问题 (Issue #1)

技术细节

  • 修正 .tool-call-content.tool-result-content 的 CSS 折叠逻辑
  • 将默认 max-height200px 改为 0,实现真正的折叠隐藏
  • 添加 overflow: hidden 确保内容在折叠时不可见
  • 展开状态添加 overflow-y: auto 支持长内容滚动
  • 过渡动画增加 padding 属性,折叠动画更流畅

安装更新

npm install -g iflow-run@latest

相关链接

感谢

感谢社区反馈,帮助我们发现问题并持续改进!

@10012181026 @10010033022 感谢大佬反馈

1 个赞

期待大佬更完美的版本 :grin:

v1.5.0 (2026-03-10) 发布公告

新功能

  • :control_knobs: API Key 来源选择器 - 支持从环境变量或自定义配置获取 API Key,界面显示对应的环境变量名提示
  • :memo: 提问改进建议 - AI 分析报告新增"提问改进建议",针对用户提问提供优化建议
  • :robot: AI 模型列表更新 - 支持心流开放平台所有模型,包括视觉模型、Kimi、Qwen、DeepSeek 等

Bug 修复

  • :wrench: 主题设置同步修复 - 修复主题切换按钮和设置面板之间状态不同步的问题
  • :wrench: API 连接测试修复 - 支持使用环境变量 API Key 进行连接测试
  • :wrench: API 响应验证增强 - 增加 HTTP 200 响应体的错误检测,提高测试准确性
  • :wrench: 异步函数调用修复 - 修复设置面板打开时 AI 配置可能未加载完成的问题

重构优化

  • :recycling_symbol: AI 配置简化 - 移除预设按钮,简化配置界面,环境变量方式成为默认推荐

技术细节

  • 新增 apiKeySource 字段支持环境变量/自定义配置切换
  • 新增 getApiKeyFromEnv() 函数从环境变量获取 API Key
  • 环境变量名:IFLOW_API_KEY(心流)、OPENAI_API_KEY(OpenAI)
  • AI 分析报告 prompt 增加提问改进建议生成逻辑

看起来不错

厉害

清理了旧的会话! 十分利害!!!

厉害:+1: