Gogh官方API入口是根目录下的gogh.sh脚本,支持--apply等命令非交互式部署主题;installs/目录下各.sh文件即“插件”,可直接执行或通过gogh.sh调用。

想直接接入Gogh主题管理能力到自己的脚本或工具中,绕过交互式菜单,需要找到官方提供的开发者API入口和插件安装触发点——不是下载zip包解压,也不是手动改JSON文件,而是调用Gogh项目内建的可执行接口。
Gogh官方开发者API入口
官方API入口是项目根目录下的gogh.sh脚本本身,它既是交互式启动器,也是功能完备的命令行API网关。
运行./gogh.sh --help可查看所有支持的开发者参数,包括--list、--apply、--export、--validate等。
【必须确保当前工作目录为Gogh项目根目录】,否则--apply dracula.sh等命令会因找不到installs/dracula.sh而失败。
非交互式应用指定主题的完整命令链为:cd Gogh → ./gogh.sh --apply dracula.sh。该命令会跳过菜单,直接执行installs/dracula.sh中的颜色写入逻辑,并自动适配当前终端类型(如gnome-terminal或alacritty)。
Gogh插件安装入口
Gogh本身不提供传统意义上的“插件”安装机制,但其installs/子目录即为实际的主题部署入口。
每个.sh文件(如dracula.sh、github-dark.sh)都是独立可执行的主题安装脚本,它们就是Gogh的“插件”实体。
方法一:直接执行安装脚本
进入installs/目录后,运行bash dracula.sh即可立即部署Dracula主题,无需依赖gogh.sh主程序。
方法二:通过主程序调用安装脚本./gogh.sh dracula.sh——这种写法等价于./gogh.sh --apply dracula.sh,是官方文档明确支持的简写形式。
注意:installs/目录下的脚本**不校验执行权限**,部分系统需先运行chmod +x dracula.sh再执行,否则提示Permission denied。