SuperAPI AI 工具集

zsh-path-skill

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:该技能用于在 zsh 中管理 PATH 环境变量,解决已安装工具无法被找到、PATH 条目需要新增与整理、shell 启动与 PATH 相关的故障排查,以及版本管理器(nvm、pyenv、rbenv)配置等场景。

主要能力:检查当前 PATH 并逐条列出,使用 which、command -v、type -a 定位命令;检测失效或重复的 PATH 条目;给出常用工具的 PATH 配置示例,包括 Bun、NVM、Python 虚拟环境、Rust/Cargo、Go、Homebrew(Intel 与 Apple Silicon)以及用户本地 bin 目录;并说明 PATH 从左到右查找、先匹配先命中的顺序规则。

使用方式:资料给出一系列可直接执行的诊断与验证命令,例如 echo $PATH | tr ':' '\n' 列出条目、echo $PATH | tr ':' '\n' | sort | uniq -d 查找重复、echo $PATH | tr ':' '\n' | while read p; do [[ -d "$p" ]] || echo "MISSING: $p"; done 检查缺失目录;修改后使用 source ~/.zshrc 或 exec $SHELL 重新加载,并用 which bun && bun --version 等方式验证。文件组织建议将团队共享配置放入 .zshrc,将机器专属配置放入 .zshrc.local。

适用场景:安装新工具后出现“command not found”、PATH 修改未生效、shell 启动钩子报错、PATH 条目重复,以及需要为项目特定 bin、本地 bin、版本管理器、包管理器与系统路径规划优先顺序时。

限制:资料说明本技能是指导性文档而非可执行程序,未提供版本、许可、依赖或收费信息,这些暂未提供;Bun、NVM、Cargo、Go、Homebrew 等工具的安装方式与具体版本支持情况不在资料范围内,需自行参照各工具官方文档。