Fabric 怎么为 Zsh、Bash、Fish 安装 Shell 补全让 fabric-ai 也能触发 Tab 补全【免费下载链接】FabricFabric is an open-source framework for augmenting humans using AI. It provides a modular system for solving specific problems using a crowdsourced set of AI prompts that can be used anywhere.项目地址: https://gitcode.com/GitHub_Trending/fa/Fabric如果 Fabric 的 Go 版 CLI 已经装好、命令在 PATH 里可以执行但输入fabric -p或fabric -m时按 Tab 没有任何候选项说明系统还没有加载 Fabric 提供的补全文件。Fabric 仓库自带 Zsh、Bash、Fish 三个补全文件 和一个自动安装脚本 setup-completions.sh本条路径的目标就是把对应 Shell 的补全文件装到系统能找到的位置并让fabric和fabric-ai两种命令名都能触发 Tab 补全。先确认前提条件自动脚本通过command -v检测命令名它只识别两种情况fabric已安装或fabric-ai已安装两者都不存在时脚本直接报错退出Neither fabric nor fabric-ai command found in PATH。所以运行任何安装步骤前先确认当前 shell 里能执行fabric或fabric-ai。路径一一条命令自动安装无需克隆仓库文档给出的自动安装方式是直接把脚本拉下来执行curl -fsSL https://raw.githubusercontent.com/danielmiessler/Fabric/refs/heads/main/completions/setup-completions.sh | sh这条命令会把远端脚本交给sh执行脚本会向 shell 补全目录写入文件权限不足时尝试用sudo兜底。如果你不想一上来就改动系统可以先用 dry-run 模式它只打印将要执行的命令不做任何修改curl -fsSL https://raw.githubusercontent.com/danielmiessler/Fabric/refs/heads/main/completions/setup-completions.sh | sh -s -- --dry-run脚本执行时会依次做这几件事来自 docs/Shell-Completions.md检测装的是fabric还是fabric-ai从$SHELL环境变量检测当前 shellzsh、bash 或 fishZsh 下读取你现有的$fpath目录其他 shell 使用标准补全目录把补全文件按命令名写入fabric-ai会直接写成_fabric-ai、fabric-ai.bash、fabric-ai.fish之类的文件名结束时打印启用提示。如果本地没有补全文件比如就是curl这种用法脚本会从 GitHub 自动下载三个补全文件。也可以用环境变量覆盖下载源FABRIC_COMPLETIONS_BASE_URLhttps://raw.githubusercontent.com/danielmiessler/Fabric/refs/heads/main/completions \ sh -c $(curl -fsSL https://raw.githubusercontent.com/danielmiessler/Fabric/refs/heads/main/completions/setup-completions.sh)路径二从克隆的仓库运行安装脚本如果你本地已经有 Fabric 仓库直接运行仓库内的脚本即可它优先使用同目录下的补全文件# 正式安装 ./completions/setup-completions.sh # 或先看它将做什么 ./completions/setup-completions.sh --dry-run输出末尾出现Shell completion setup completed!和You can now use tab completion with the fabric 或 fabric-ai command.说明安装完成。手动安装Zsh、Bash、Fish 分别怎么做自动脚本失败或你想精确控制安装位置时按 docs/Shell-Completions.md 的手动步骤操作。以下命令中的completions/...路径都相对于 Fabric 仓库根目录。Zsh把补全文件复制到$fpath中的目录。系统级安装需要sudo会写入/usr/local/share/zsh/site-functions/sudo cp completions/_fabric /usr/local/share/zsh/site-functions/关键步骤如果二进制装成了fabric-ai必须建一个符号链接否则fabric-ai按 Tab 无反应sudo ln -s /usr/local/share/zsh/site-functions/_fabric /usr/local/share/zsh/site-functions/_fabric-ai重启 shell或重载补全autoload -U compinit compinit补全文件 completions/_fabric 第一行的#compdef fabric fabric-ai声明它同时绑定两个命令名链接建好后两个命令都能补全。Bash复制到标准补全目录。系统级用sudo写入/etc/bash_completion.d/用户级写入~/.local/share/bash-completion/completions/# 系统级安装 sudo cp completions/fabric.bash /etc/bash_completion.d/ # 或用户级安装 mkdir -p ~/.local/share/bash-completion/completions/ cp completions/fabric.bash ~/.local/share/bash-completion/completions/fabricfabric-ai的符号链接与安装级别对应# 系统级 sudo ln -s /etc/bash_completion.d/fabric.bash /etc/bash_completion.d/fabric-ai.bash # 或用户级 ln -s ~/.local/share/bash-completion/completions/fabric ~/.local/share/bash-completion/completions/fabric-ai重启 shell 或重新加载source ~/.bashrcFishFish 只写用户目录不需要sudo也不需要重启mkdir -p ~/.config/fish/completions cp completions/fabric.fish ~/.config/fish/completions/fabric-ai的符号链接ln -s ~/.config/fish/completions/fabric.fish ~/.config/fish/completions/fabric-ai.fish文档说明 Fish 会自动加载补全文件无需重启。可选替代路径直接在 shell 配置文件里 source不想复制文件时可以在 shell 配置文件里直接 source 补全文件路径需要替换成你实际的仓库位置Zsh在~/.zshrc中添加source /path/to/fabric/completions/_fabricBash在~/.bashrc中添加source /path/to/fabric/completions/fabric.bashFish文档建议优先使用上面的文件安装方式另有一条用户级 Zsh 变体来自 README不写系统目录而是复制到~/.zsh/completions并在~/.zshrc的compinit之前把它加进$fpathmkdir -p ~/.zsh/completions cp completions/_fabric ~/.zsh/completions/ echo fpath(~/.zsh/completions $fpath) ~/.zshrc echo autoload -Uz compinit compinit ~/.zshrc验证与排查判断是否生效按文档给出的方式处理安装后重启 shellZsh/Bash 可用autoload -U compinit compinit或source ~/.bashrc代替重启Fish 不需要重启。输入fabric -p或fabric -m后按 Tab应能列出模式patterns和模型models候选项。补全列表是动态生成的completions/_fabric、completions/fabric.bash 都会实时调用fabric --listpatterns --shell-complete-list、--listmodels --shell-complete-list等命令获取当前资源所以候选项始终跟随你的 Fabric 安装状态。按 Tab 无反应时对照文档的排查清单确认补全文件权限正常Zsh 下确认补全目录确实在$fpath里如果重命名过 fabric 二进制确认已按上文创建对应符号链接最后重启一次 shell 确保补全被加载。安装完成后Tab 可补全的范围包括-p/--pattern/--readpattern的 patterns、-m/--model的模型、-V/--vendor的厂商、contexts、sessions、strategies、extensions、--voice的 Gemini TTS 音色、--transcribe-model的转录模型以及--thinking、--debug、--image-size、--image-quality、--image-background的固定取值、附件/输出等文件路径还有所有命令行 flag。【免费下载链接】FabricFabric is an open-source framework for augmenting humans using AI. It provides a modular system for solving specific problems using a crowdsourced set of AI prompts that can be used anywhere.项目地址: https://gitcode.com/GitHub_Trending/fa/Fabric创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
