mcfly下载 - mcfly源码下载

mcfly

其他源码

v0.9.2

下载

寻求共同维护者：这些天我没有太多时间来维护这个项目。如果有人愿意加入并成为共同维护者，我们将不胜感激！

McFly - 浏览您的 shell 历史

McFly 使用智能搜索引擎替换默认的ctrl-r shell 历史搜索，该搜索引擎会考虑您的工作目录和最近执行的命令的上下文。 McFly 的建议通过小型神经网络实时进行优先级排序。

TL;DR：升级后的ctrl-r ，其中历史结果对您现在正在做的事情有意义。

特征

重新绑定ctrl-r以调出全屏反向历史搜索，优先使用小型神经网络。
增强 shell 历史记录以跟踪 SQLite 数据库中的命令退出状态、时间戳和执行目录。
还维护您正常的 shell 历史文件，以便您可以随时停止使用 McFly。
全程支持 Unicode。
包括一个简单的操作，可以从 McFly 数据库和 shell 历史文件中清除任何历史记录项。
旨在将来可扩展为其他 shell。
用 Rust 编写，因此快速且安全。
搜索时，您可以键入%来匹配任意数量的字符。

优先顺序

McFly 的主要功能是由实时运行的小型神经网络提供支持的智能命令优先级。我们的目标是让您想要运行的命令始终成为最重要的建议之一。

在建议命令时，McFly 会考虑：

您运行命令的目录。您将来可能会在同一目录中运行该命令。
您在该命令之前键入了哪些命令（例如，命令的执行上下文）。
您运行该命令的频率。
您上次运行该命令的时间。
如果您之前在 McFly 中选择过该命令。
命令的历史退出状态。您可能不想运行旧的失败命令。

安装

使用 Homebrew 安装（在 macOS 或 Linux 上）

安装mcfly ：
```
brew install mcfly
```
将以下内容添加到~/.bashrc 、 ~/.zshrc或~/.config/fish/config.fish文件的末尾：
重击：
```
 eval " $( mcfly init bash ) "
```
兹什：
```
 eval " $( mcfly init zsh ) "
```
鱼：
```
mcfly init fish | source
```
跑步. ~/.bashrc / . ~/.zshrc / source ~/.config/fish/config.fish或重新启动终端模拟器。

使用 Homebrew 卸载

删除mcfly ：
```
brew uninstall mcfly
```
删除添加到~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish的行。

使用 MacPorts 安装（在 macOS 上）

更新端口树
```
sudo port selfupdate
```
安装mcfly ：
```
sudo port install mcfly
```
根据需要将以下内容添加到~/.bashrc 、 ~/.zshrc或~/.config/fish/config.fish文件的末尾：
重击：
```
 eval " $( mcfly init bash ) "
```
兹什：
```
 eval " $( mcfly init zsh ) "
```
鱼：
```
mcfly init fish | source
```
跑步. ~/.bashrc / . ~/.zshrc / source ~/.config/fish/config.fish或重新启动终端模拟器。

使用 MacPorts 卸载

删除mcfly ：
```
sudo port uninstall mcfly
```
删除添加到~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish的行。

使用我们的安装脚本进行安装（macOS 或 Linux）

curl -LSfs https://raw.githubusercontent.com/cantino/mcfly/master/ci/install.sh | sh -s -- --git cantino/mcfly （或者，如果当前用户没有编辑 /usr/local/bin 的权限，则使用sudo sh -s 。）
分别将以下内容添加到~/.bashrc 、 ~/.zshrc或~/.config/fish/config.fish文件的末尾：
重击：
```
 eval " $( mcfly init bash ) "
```
兹什：
```
 eval " $( mcfly init zsh ) "
```
鱼：
```
mcfly init fish | source
```
跑步. ~/.bashrc / . ~/.zshrc / source ~/.config/fish/config.fish或重新启动终端模拟器。

从 GitHub 手动安装（macOS 或 Linux）

从 GitHub 下载最新版本。
安装到$PATH中的某个位置。（例如，您可以在~/bin创建一个目录，将mcfly复制到此位置，然后将export PATH="$PATH:$HOME/bin"添加到.bashrc / .zshrc ，或运行set -Ua fish_user_paths "$HOME/bin"用于鱼。）
分别将以下内容添加到~/.bashrc 、 ~/.zshrc或~/.config/fish/config.fish的末尾：
重击：
```
 eval " $( mcfly init bash ) "
```
兹什：
```
 eval " $( mcfly init zsh ) "
```
鱼：
```
mcfly init fish | source
```
跑步. ~/.bashrc / . ~/.zshrc / source ~/.config/fish/config.fish或重新启动终端模拟器。

从源手动安装（macOS、Linux 或 Windows）

安装 Rust 1.40 或更高版本
运行git clone https://github.com/cantino/mcfly并cd mcfly
运行cargo install --path .
确保~/.cargo/bin在您的$PATH中。

分别将以下内容添加到~/.bashrc 、 ~/.zshrc 、 ~/.config/fish/config.fish或 powershell $PROFILE的末尾：

重击：

 eval " $( mcfly init bash ) "

兹什：

 eval " $( mcfly init zsh ) "

鱼：

mcfly init fish | source

Powershell 核心 (pwsh)

 Invoke-Expression - Command $ (mcfly init powershell | out-string )

跑步. ~/.bashrc / . ~/.zshrc / source ~/.config/fish/config.fish / . $PROFILE或重新启动终端模拟器。

通过 Zinit 安装

将以下代码添加到您的 zshrc 中。

zinit ice lucid wait " 0a " from " gh-r " as " program " atload ' eval "$(mcfly init zsh)" '
zinit light cantino/mcfly

它将下载 mfly 并为您安装。
$(mcfly init zsh)将在提示后执行

iTerm2

为了避免 McFly 的 UI 弄乱 iTerm2 中的回滚历史记录，请确保未选中此选项：

iterm2 UI 说明

转储历史记录

McFly 可以将命令历史记录转储到stdout中。

例如：

mcfly dump --since ' 2023-01-01 ' --before ' 2023-09-12 09:15:30 '

会将2023-01-01 00:00:00.0到2023-09-12 09:15:30 （不包括）之间运行的命令转储为json 。您也可以通过--format csv将csv指定为转储格式。

转储命令中的每个项目都有以下字段：

cmd ：运行命令。
when_run ：命令在本地时区运行的时间。

您可以转储所有命令历史记录而不带任何参数：

mcfly dump

时间戳格式

McFly 通过chrono-systemd-time解析时间戳，这是 systemd.time 的非严格实现，但有以下例外：

时间单位必须伴随所有时间跨度值。
不支持时区后缀。
不支持工作日前缀。

McFly 用户只需要了解不允许在时间戳中指定时区。 McFly 将始终使用您当地的时区。

有关更多详细信息，请参阅chrono-systemd-time文档。

正则表达式

Dump支持使用正则表达式过滤命令。正则表达式语法遵循 crate 正则表达式。

例如：

mcfly dump -r ' ^cargo run '

将转储所有命令前缀与cargo run 。

您可以同时使用-r/--regex和时间选项。

例如：

mcfly dump -r ' ^cargo run ' --since ' 2023-09-12 09:15:30 '

将转储自2023-09-12 09:15:30以来cargo run的所有命令前缀。

设置

可以通过环境变量设置许多设置。要设置设置，您应该将以下代码段添加到~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish 。

灯光模式

要交换在灯光终端中使用的颜色方案，请设置环境变量MCFLY_LIGHT 。

bash/zsh：

 export MCFLY_LIGHT=TRUE

鱼：

 set -gx MCFLY_LIGHT TRUE

电源外壳：

 $ env: MCFLY_LIGHT = " TRUE "

提示：在 macOS 上，您可以使用以下代码片段根据系统范围的设置配置配色方案：

bash/zsh：

 if [[ " $( defaults read -g AppleInterfaceStyle 2 & > /dev/null ) " != " Dark " ]] ; then
    export MCFLY_LIGHT=TRUE
fi

VIM 密钥方案

默认情况下，Mcfly 使用受emacs启发的按键方案。如果您想切换到vim启发的按键方案，请设置环境变量MCFLY_KEY_SCHEME 。

bash/zsh：

 export MCFLY_KEY_SCHEME=vim

鱼：

 set -gx MCFLY_KEY_SCHEME vim

电源外壳：

 $ env: MCFLY_KEY_SCHEME = " vim "

模糊搜索

要启用模糊搜索，请将MCFLY_FUZZY设置为整数。 0 为关闭；数字越大，比赛越短。到目前为止，2-5 范围内的值可以获得良好的结果；尝试一些并报告最适合您的！

bash/zsh：

 export MCFLY_FUZZY=2

鱼：

 set -gx MCFLY_FUZZY 2

电源外壳：

 $ env: MCFLY_FUZZY = 2

结果计数

要更改显示的最大结果数，请设置MCFLY_RESULTS （默认值：10）。

bash/zsh：

 export MCFLY_RESULTS=50

鱼：

 set -gx MCFLY_RESULTS 50

电源外壳：

 $ env: MCFLY_RESULTS = 50

删除而不确认

要删除而不确认，请将MCFLY_DELETE_WITHOUT_CONFIRM设置为 true。

bash/zsh：

 export MCFLY_DELETE_WITHOUT_CONFIRM=true

鱼：

 set -gx MCFLY_DELETE_WITHOUT_CONFIRM true

电源外壳：

 $ env: MCFLY_DELETE_WITHOUT_CONFIRM = " true "

界面视图

要更改界面视图，请设置MCFLY_INTERFACE_VIEW （默认值： TOP ）。可用选项： TOP和BOTTOM

bash/zsh：

 export MCFLY_INTERFACE_VIEW=BOTTOM

鱼：

 set -gx MCFLY_INTERFACE_VIEW BOTTOM

电源外壳：

 $ env: MCFLY_INTERFACE_VIEW = " BOTTOM "

禁用菜单界面

要禁用菜单界面，请设置环境变量MCFLY_DISABLE_MENU 。

bash/zsh：

 export MCFLY_DISABLE_MENU=TRUE

鱼：

 set -gx MCFLY_DISABLE_MENU TRUE

电源外壳：

 $ env: MCFLY_DISABLE_MENU = true

结果排序

要更改显示结果的排序，请设置MCFLY_RESULTS_SORT （默认值：RANK）。可能的值RANK和LAST_RUN

bash/zsh：

 export MCFLY_RESULTS_SORT=LAST_RUN

鱼：

 set -gx MCFLY_RESULTS_SORT LAST_RUN

电源外壳：

 $ env: MCFLY_RESULTS_SORT = " LAST_RUN "

自定义提示

要更改提示，请设置MCFLY_PROMPT （默认值： $ ）。

bash/zsh：

 export MCFLY_PROMPT= " ❯ "

鱼：

 set -gx MCFLY_PROMPT " ❯ "

电源外壳：

 $ env: MCFLY_PROMPT = " > "

请注意，仅允许使用单字符提示。将MCFLY_PROMPT设置为"<str>"会将其重置为默认提示符。

数据库位置

McFly 将其 SQLite 数据库存储在操作系统的标准位置。在 OS X 上，它位于~/Library/Application Support/McFly ，在 Linux 上，它位于$XDG_DATA_DIR/mcfly/history.db （默认为~/.local/share/mcfly/history.db ），在 Windows 上，它是%LOCALAPPDATA%McFlydatahistory.db 。对于旧版支持，如果~/.mcfly/存在，则使用它。

启动慢

如果您有一个非常大的历史数据库，并且您注意到 McFly 启动缓慢，您可以将MCFLY_HISTORY_LIMIT设置为 10000 之类的值，以限制搜索时考虑的记录数量。在此示例中，McFly 将仅搜索最新的 10,000 个条目。

巴什·蒂奥科斯蒂

从 Linux 内核版本 6.2 开始，某些系统已禁用 TIOCSTI（McFly 之前使用它来写入所选命令）。 McFly 通过使用两个“虚拟”键绑定来解决此问题，默认为ctrl-x 1和ctrl-x 2 。如果您将其中任何一个用于其他目的，则可以分别将MCFLY_BASH_SEARCH_KEYBINDING和MCFLY_BASH_ACCEPT_LINE_KEYBINDING设置为您不使用的内容。如果您希望使用旧版 TIOCSTI 行为，可以通过在系统上将sysctl变量dev.tty.legacy_tiocsti设置为1并将MCFLY_BASH_USE_TIOCSTI bash 变量设置为1来启用它。

历史时间格式

McFly 目前不解析或使用HISTTIMEFORMAT 。

未来可能的功能

将截屏视频添加到自述文件中。
了解常用命令选项并在建议 UI 中自动完成它们？
当提出模板匹配字符串时，对命令行参数进行排序。
可能的优先级改进：
- 交叉验证和显式训练集选择。
- 学习命令嵌入

发展

贡献

鼓励贡献和错误修复！但是，我们可能不会合并那些显着增加复杂性超出维护项目所需的 PR。如果您有疑问，请随时提出问题并询问。

运行测试

cargo test

发布（@cantino 的注释）

编辑Cargo.toml并更改版本。
编辑 CHANGELOG.txt
运行cargo clippy和cargo fmt 。
重新编译（ cargo build ）和测试（ cargo test ）
git add -p
git ci -m 'Bumping to vx.x.x'
git tag vx.xx
git push origin head --tags
让构建完成。
在 Github 上编辑新版本。
cargo publish
TBD：更新 homebrew-core 公式 https://github.com/Homebrew/homebrew-core/blob/master/Formula/m/mcfly.rb

老的：

编辑pkg/brew/mcfly.rb并更新版本和 SHA。（ shasum -a 256 ... ）
也编辑../homebrew-mcfly/pkg/brew/mcfly.rb 。
cp pkg/brew/mcfly.rb ../homebrew-mcfly/pkg/brew/mcfly.rb
与diff ../homebrew-mcfly/pkg/brew/mcfly.rb ../mcfly/pkg/brew/mcfly.rb ; diff ../homebrew-mcfly/HomebrewFormula/mcfly.rb ../mcfly/HomebrewFormula/mcfly.rb
git add -p && git ci -m 'Update homebrew' && git push
cd ../homebrew-mcfly && git add -p && git ci -m 'Update homebrew' && git push && cd ../mcfly

展开

附加信息

版本 v0.9.2
类型其他源码
更新时间 2024-12-24
大小 238.35KB
来自于 Github