用途：面向 ZStack 控制平面工作，包括工作区开通、部署失败排查、实时日志、Fly 资源、域名/DNS、遥测以及 API 驱动的自动化部署。默认在 /Users/idanbeck/zerg-stack/zstack 目录下工作，除非任务指定其他仓库。
主要能力与用法：优先使用 ZStack API 而非直接改数据库。认证时设置 ZSTACK_BASE_URL 与 ZSTACK_COOKIE，用 curl 登录 /api/auth/login 并保存 cookie，再用 /api/auth/me 验证会话。可通过 /api/workspaces、/api/workspaces/<slug>、/api/envs/<id> 读取工作区与环境，通过 /api/envs/<id>/resources、/domains、/telemetry 读取资源、域名与遥测。部署调试时用 /api/deploys 查询近期部署，读取 /api/deploys/<id>，并用 /api/deploys/<id>/stream?after=0 流式查看日志；诊断顺序为先看 deploy.status、error、branch、commit、release，再看最后 200 行日志定位首个致命错误，判断是应用部署失败、机器启动但健康检查失败还是控制面状态过期，并对比 zstack.yaml 与目标仓库的 fly.toml、Dockerfile、包文件、迁移文档；Fly 应用还需对比 API 资源与 fly status、fly logs、fly machines list、fly volumes list。重试部署可向 /api/envs/<id>/deploy 发送 branch 触发，随后流式跟踪返回的 deploy id 直到成功或失败。
安全与限制：不要打印 API token、会话 cookie 或提供商凭据；curl cookie 使用 /private/tmp/zstack-cookie.txt 并在会话间覆盖；fly 本地找不到认证时，在同一条命令中传入来自 ~/.fly/config.yml 的 FLY_ACCESS_TOKEN 且不要回显；更改线上基础设施前确认目标工作区、环境、分支和提供商应用。资料未提供收费、价格、平台支持范围等更多信息。