SuperAPI AI 工具集

zp

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:zp 是 Zed 项目启动器,用于在三种后端上打开与管理开发项目:local(macOS 本地,路径 ~/github/owner/name)、container(Apple Container,需 macOS 26+)、sprite(Fly.io 远程 VM)。三者均遵循 ~/github/owner/name 路径约定,新机器会用 dotfiles 自动引导。

主要能力:打开已有项目;当 --machine 指定的机器不存在时,自动创建机器、引导 dotfiles、克隆仓库并打开,全程非交互。后端为 ~/.local/bin/zp-backends/ 下的插件式 shell 脚本,各自实现 backend_available、backend_list、backend_create、backend_start、backend_ensure_ssh、backend_exec。停止的容器会自动启动,Sprites 连接时自动唤醒。

使用方式:命令格式 zp [owner/name | name] [--backend local|container|sprite] [--machine <name>] [--org <org>]。程序化调用时应提供全部参数以避免 TTY 提示,例如 zp owner/name --backend container --machine dev(打开已有项目)、zp owner/name --backend container --machine new-machine-name(创建并克隆)、zp owner/name --backend local、zp owner/name --backend sprite --machine mysprite。交互式命令依赖 TTY 与 fzf,如单独运行 zp 浏览全部项目,zp gitlake 按键名搜索,zp --backend container 浏览指定后端。

适用场景:跨本地、容器与远程 VM 一致地管理项目;为项目快速创建全新环境;通过 backend_exec 在机器上列出项目(如 container exec dev bash -c "find /home/klundstedt/github -mindepth 2 -maxdepth 2 -type d 2>/dev/null")。克隆的仓库若缺少 AGENTS.md,可建议使用 /bootstrap-project 技能补充代理上下文。

限制:--backend local 不支持 --machine,二者组合为错误;路径中的 GitHub owner 与操作系统用户不同;容器后端需 macOS 26+;交互式 fzf 功能仅在终端可用;具体定价与其它平台支持情况暂未提供。