McFly: 智能化的Shell历史搜索工具

RayRay
McFly命令行工具历史搜索Shell智能搜索Github开源项目

McFly简介

McFly是一款创新的Shell历史搜索工具,旨在彻底改变用户与命令行历史交互的方式。它使用智能算法和机器学习技术来优化搜索结果,让用户能够更快速、更精准地找到所需的历史命令。

McFly截图

McFly的核心功能是替换默认的ctrl-r反向历史搜索,提供一个全屏的搜索界面。它不仅考虑命令本身,还会分析命令执行的上下文,如工作目录、最近执行的命令等因素,通过一个小型神经网络实时对搜索结果进行优先级排序。这意味着McFly可以为用户当前的工作场景提供最相关的历史命令建议。

McFly的主要特性

  1. 智能搜索: 使用神经网络实时优化搜索结果的优先级。

  2. 上下文感知: 考虑工作目录和最近执行的命令来提供更相关的建议。

  3. 增强的历史记录: 在SQLite数据库中跟踪命令的退出状态、时间戳和执行目录。

  4. 兼容性: 保留原有的Shell历史文件,随时可以停用McFly。

  5. Unicode支持: 全面支持Unicode字符。

  6. 历史清理: 提供简单的操作来从McFly数据库和Shell历史文件中删除特定项。

  7. 可扩展性: 设计上考虑了未来对其他Shell的扩展支持。

  8. 高性能: 使用Rust语言编写,确保快速和安全的执行。

  9. 模糊搜索: 支持使用%通配符匹配任意数量的字符。

安装McFly

McFly提供了多种安装方式,以适应不同用户的需求:

使用Homebrew安装(macOS或Linux)

  1. 运行以下命令安装McFly:

    brew install mcfly
    
  2. 根据你使用的Shell,在相应的配置文件(~/.bashrc, ~/.zshrc, 或 ~/.config/fish/config.fish)末尾添加以下内容:

    Bash:

    eval "$(mcfly init bash)"

    Zsh:

    eval "$(mcfly init zsh)"

    Fish:

    mcfly init fish | source
  3. 重新加载配置文件或重启终端。

手动从GitHub安装(macOS或Linux)

  1. GitHub Releases页面下载最新版本。

  2. 将McFly可执行文件安装到$PATH中的某个位置。

  3. 按照上述方法在Shell配置文件中添加初始化命令。

从源码安装(跨平台)

  1. 安装Rust 1.40或更高版本。

  2. 克隆McFly仓库并进入目录:

    git clone https://github.com/cantino/mcfly && cd mcfly
    
  3. 运行cargo install --path .

  4. 确保~/.cargo/bin在你的$PATH中。

  5. 在Shell配置文件中添加初始化命令。

使用McFly

安装并配置McFly后,它会自动替换默认的ctrl-r搜索功能。当你按下ctrl-r,McFly的全屏界面会出现,显示与你当前工作相关的命令建议。

基本操作

  • 输入搜索词来筛选历史命令。
  • 使用上下箭头键在结果中导航。
  • 按Enter执行选中的命令。
  • 按Esc退出McFly界面。

高级技巧

  1. 模糊搜索: 使用%作为通配符来匹配任意字符。

  2. 上下文相关搜索: McFly会优先显示与当前工作目录相关的命令。

  3. 智能排序: 常用命令和最近使用的命令会获得更高的优先级。

  4. 删除历史: 使用McFly提供的功能可以轻松删除不想保留的历史记录。

配置McFly

McFly提供了多个环境变量来自定义其行为:

  1. 轻色主题: 设置MCFLY_LIGHT=TRUE启用适合浅色终端的配色方案。

  2. VIM按键方案: 设置MCFLY_KEY_SCHEME=vim使用vim风格的按键绑定。

  3. 模糊搜索: 设置MCFLY_FUZZY为非零整数启用模糊搜索,数值越大匹配越宽松。

  4. 结果数量: 通过MCFLY_RESULTS设置最大显示结果数(默认为10)。

  5. 界面位置: 设置MCFLY_INTERFACE_VIEW=BOTTOM将界面移到底部显示。

  6. 禁用菜单界面: 设置MCFLY_DISABLE_MENU=TRUE以禁用菜单界面。

  7. 结果排序: 使用MCFLY_RESULTS_SORT=LAST_RUN按最后运行时间排序结果。

  8. 自定义提示符: 通过MCFLY_PROMPT设置自定义提示符(默认为$)。

McFly的工作原理

McFly的核心是其智能优先级系统,它考虑多个因素来决定命令的相关性:

  • 命令执行的目录
  • 命令的执行上下文(之前运行的命令)
  • 命令的使用频率
  • 命令最后执行的时间
  • 用户是否在McFly中选择过该命令
  • 命令的历史退出状态

这些因素被输入到一个小型神经网络中,实时计算每个命令的优先级分数。这确保了最相关和最有用的命令总是出现在建议列表的顶部。

性能考虑

McFly使用SQLite数据库存储增强的历史记录,这可能会导致大型历史数据库的启动速度变慢。如果遇到这种情况,可以通过设置MCFLY_HISTORY_LIMIT来限制考虑的记录数量,例如:

export MCFLY_HISTORY_LIMIT=10000

这将限制McFly只搜索最新的10,000条记录。

未来展望

McFly的开发团队有许多令人兴奋的想法来进一步改进这个工具:

  • 学习常用的命令选项并在建议UI中自动完成它们。
  • 对命令行参数进行排序以改进模板匹配。
  • 通过交叉验证和显式训练集选择来改进优先级系统。
  • 学习命令嵌入(embeddings)以更好地理解命令之间的关系。

参与McFly开发

McFly是一个开源项目,欢迎社区贡献。如果你有兴趣参与开发,可以通过以下方式贡献:

  1. GitHub仓库上提交问题或功能请求。
  2. 提交Pull Requests来修复bug或添加新功能。
  3. 改进文档或添加使用教程。

在提交大型PR之前,建议先开一个issue讨论你的想法,以确保它符合项目的方向和复杂度要求。

结语

McFly代表了命令行工具的未来发展方向。通过结合人工智能和用户体验设计,它为日常的Shell操作带来了前所未有的效率提升。无论你是经验丰富的命令行用户,还是刚刚开始探索终端的新手,McFly都能为你的工作流程带来显著的改进。

随着持续的开发和社区贡献,我们可以期待McFly在未来变得更加强大和智能。如果你还没有尝试过McFly,现在就是一个很好的机会来体验这个革命性的工具,让你的命令行操作更加高效和愉快。

🚀 立即安装McFly,开启你的智能Shell之旅吧!

编辑推荐精选

音述AI

音述AI

全球首个AI音乐社区

音述AI是全球首个AI音乐社区,致力让每个人都能用音乐表达自我。音述AI提供零门槛AI创作工具,独创GETI法则帮助用户精准定义音乐风格,AI润色功能支持自动优化作品质感。音述AI支持交流讨论、二次创作与价值变现。针对中文用户的语言习惯与文化背景进行专门优化,支持国风融合、C-pop等本土音乐标签,让技术更好地承载人文表达。

QoderWork

QoderWork

阿里Qoder团队推出的桌面端AI智能体

QoderWork 是阿里推出的本地优先桌面 AI 智能体,适配 macOS14+/Windows10+,以自然语言交互实现文件管理、数据分析、AI 视觉生成、浏览器自动化等办公任务,自主拆解执行复杂工作流,数据本地运行零上传,技能市场可无限扩展,是高效的 Agentic 生产力办公助手。

lynote.ai

lynote.ai

一站式搞定所有学习需求

不再被海量信息淹没,开始真正理解知识。Lynote 可摘要 YouTube 视频、PDF、文章等内容。即时创建笔记,检测 AI 内容并下载资料,将您的学习效率提升 10 倍。

AniShort

AniShort

为AI短剧协作而生

专为AI短剧协作而生的AniShort正式发布,深度重构AI短剧全流程生产模式,整合创意策划、制作执行、实时协作、在线审片、资产复用等全链路功能,独创无限画布、双轨并行工业化工作流与Ani智能体助手,集成多款主流AI大模型,破解素材零散、版本混乱、沟通低效等行业痛点,助力3人团队效率提升800%,打造标准化、可追溯的AI短剧量产体系,是AI短剧团队协同创作、提升制作效率的核心工具。

seedancetwo2.0

seedancetwo2.0

能听懂你表达的视频模型

Seedance two是基于seedance2.0的中国大模型,支持图像、视频、音频、文本四种模态输入,表达方式更丰富,生成也更可控。

nano-banana纳米香蕉中文站

nano-banana纳米香蕉中文站

国内直接访问,限时3折

输入简单文字,生成想要的图片,纳米香蕉中文站基于 Google 模型的 AI 图片生成网站,支持文字生图、图生图。官网价格限时3折活动

扣子-AI办公

扣子-AI办公

职场AI,就用扣子

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

堆友

堆友

多风格AI绘画神器

堆友平台由阿里巴巴设计团队创建,作为一款AI驱动的设计工具,专为设计师提供一站式增长服务。功能覆盖海量3D素材、AI绘画、实时渲染以及专业抠图,显著提升设计品质和效率。平台不仅提供工具,还是一个促进创意交流和个人发展的空间,界面友好,适合所有级别的设计师和创意工作者。

图像生成AI工具AI反应堆AI工具箱AI绘画GOAI艺术字堆友相机AI图像热门
码上飞

码上飞

零代码AI应用开发平台

零代码AI应用开发平台,用户只需一句话简单描述需求,AI能自动生成小程序、APP或H5网页应用,无需编写代码。

Vora

Vora

免费创建高清无水印Sora视频

Vora是一个免费创建高清无水印Sora视频的AI工具

下拉加载更多