thefuckplus 命令错误纠正插件

远古命令纠正插件 thefuck 应该很多人都不陌生了，我以前也一直在用，不过它有时候会补错命令，而且部分场景下不太聪明，并且因为它停更很多年了，很多新软件的规则没有更新，所以我就找 Cursor 许愿了一下搞了个 thefuckplus

和原版 thefuck 走的完全不同的技术路线，thefuckplus 直接接入了 OpenAI 兼容的大模型，利用 AI 结合上下文、退出码、当前路径下的文件来生成正确命令，虽然速度可能不如原版 thefuck （也只是慢个零点几秒，感知不强），但准确得多。而且支持自然语言转命令的功能，有时候一下子想不起来某个命令，可以直接打字生成。

项目地址： https://github.com/kasuganosoras/thefuckplus

功能特性

• 文件读取功能： 启用时（默认启用），模型可以调用当前工作目录下的 read_file / list_dir —— 例如，在 npm run build 因实际脚本为 build:h5 而失败后，读取 package.json 文件。


• 安全性： 候选命令会针对破坏性风险进行评分（模型 + 本地启发式评估）。具有风险的命令会显示警告图标 ⚠。敏感文件（.env、密钥、凭据等）将被默认拦截，除非你主动选择开启。


• 首次运行： 如果未配置 AI ，系统将自动启动 thefuckplus configure 配置向导。

快速安装

git clone https://github.com/kasuganosoras/thefuckplus.git

cd thefuckplus

./scripts/install.sh

source ~/.zshrc

thefuckplus configure

oh-my-zsh 用户

go install github.com/kasuganosoras/thefuckplus/cmd/thefuckplus@latest



git clone https://github.com/kasuganosoras/thefuckplus.git \

  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/thefuckplus

在 ~/.zshrc 中启用插件：

plugins=(... thefuckplus)

确保 ~/.local/bin（或你的 GOBIN 路径）已添加到 PATH 环境变量中[cite: 1]。

手动安装

git clone https://github.com/kasuganosoras/thefuckplus.git

cd thefuckplus

go build -o ~/.local/bin/thefuckplus ./cmd/thefuckplus

echo 'source ~/path/to/thefuckplus/thefuckplus.plugin.zsh' >> ~/.zshrc

配置说明

thefuckplus configure

配置文件路径：~/.config/thefuckplus/config.yaml

provider: openai          # openai | deepseek | custom

api_key: "sk-..."

base_url: "https://api.openai.com/v1"

model: "gpt-4o-mini"

execute_mode: confirm     # confirm | execute

max_candidates: 5

timeout_sec: 30

agent:

  enabled: true

  max_rounds: 4

  max_file_bytes: 32768

  max_list_entries: 100

  allow_sensitive: false  # 设置为 true 以允许读取 .env / 密钥（仍限制在当前工作目录内）

  extra_allow: []         # 例如 [".env.example"]

  extra_deny: []          # 额外的拒绝匹配规则（优先级最高）

也许有人会问，为什么不用 Agent ？这个项目的初衷其实并不是为了替代 Agent ，它只是用来解决日常终端操作时不小心输错命令，或者临时想不起来某个命令的时候用，而不必打开其他软件，就是这么简单的一个功能而已。

感谢使用，如果有任何问题或者建议可以评论区告诉我~