SuperAPI AI 工具集

zig-cli

编程与开发

查看项目

更新于 10-18 02:31

技能介绍

zig-cli 用于构建和维护生产可用的 Zig 命令行应用。按资料描述,其目标是生成单静态二进制(约 1MB)、零外部依赖,并可从任意平台交叉编译到 macOS、Linux 和 Windows。

主要能力通过子命令提供:bootstrap 从零搭建一个新的 Zig CLI 项目;openapi-update 依据 OpenAPI 规范重新生成 API 客户端;add-command <name> 向已有 Zig CLI 添加新的子命令;dist 为所有平台交叉编译发布二进制;help 显示可用子命令列表。不带子命令调用 /zig-cli 时显示帮助输出;未知子命令时列出可用子命令并停止。

使用 bootstrap 前需确认 zig version 返回 0.15.x 或更高,并准备项目目录。技能会询问应用名、一句话描述、初始子命令、是否需要按环境配置(~/.{app-name}.json)、是否包含 REST API 的 HTTP 客户端(若是则询问 base URL 与是否有 OpenAPI 规范)。随后按模板创建 build.zig、build.zig.zon、src/main.zig、src/help.zig、src/commands/<subcmd>.zig、justfile、install.sh、install.ps1、.gitignore、CLAUDE.md;需要配置时增加 src/config.zig 与 src/commands/configure.zig,需要 API 客户端时增加 src/generated.zig 与 src/table.zig。首次 zig build 会因指纹无效报错并提示正确值,更新 build.zig.zon 后重新构建,再运行 zig build test 与 zig build run -- --help 验证。

openapi-update 会查找 OpenAPI 规范路径(参数指定、项目根目录的 openapi.json/openapi.yaml、相邻 ../app/openapi.json,找不到则询问用户),必要时安装 openapi2zig,备份现有 src/generated.zig,生成后针对 Zig 0.15.2 手工修正函数名、嵌套类型、HTTP 客户端模式、ArrayList 与 JSON 写法,构建测试通过后删除备份,否则保留备份并报告错误。资料明确说明 openapi2zig 的原始输出不能在 Zig 0.15.2 上编译,必须修正。

add-command 要求项目已有 src/main.zig、src/help.zig 和 src/commands/,创建命令文件并在 main.zig 中添加导入、路由与帮助分派,在 help.zig 中添加帮助常量与根帮助列表,最后用 zig build && zig build test 验证;添加命令必须同时更新这三个文件。

dist 优先运行 justfile 中的 dist 配方,否则手动对 aarch64-macos、x86_64-macos、x86_64-linux、aarch64-linux、x86_64-windows、aarch64-windows 执行 ReleaseSafe 构建并复制到 dist,生成 checksums.txt 并报告二进制大小。

资料还列出 Zig 0.15.2+ 关键写法:使用 std.fs.File.stdout() 而非已移除的 std.io.getStdOut();使用无管理版 ArrayList 并逐个方法传入 allocator;用 std.fmt.allocPrint 配合 writeAll 输出;JSON 用 std.json.fmt 与 parseFromSlice;HTTP 用 std.http.Client.fetch();循环中的表格行需堆分配;main 签名为 pub fn main() !void;分配器用 std.heap.page_allocator;跨平台配置路径用 std.process.getEnvVarOwned 读取 HOME。帮助系统需为每个命令提供用法、标志、位置参数、行为说明、退出码和示例,以便 AI 编码代理阅读。资料未提供收费、价格或平台服务信息。