用途：civitai-gen 是 Civitai 编排 Workflow API 的统一 CLI，用于文本生成图像、视频（11+ 引擎）、文本转语音、音乐生成（ACE Step 1.5）与语音转文字转录。所有生成类型共用同一工作流生命周期：submit（提交）、poll（轮询）、download（下载）。
主要能力：命令行包含 wait（提交+轮询+下载，默认阻塞式生成）、submit（即发即忘，返回工作流 ID，适合异步）、status（查看进度，--poll 实时更新）、download（按工作流 ID 获取已完成媒体）、cost（试算 buzz，whatif=true，消耗 0 buzz）、engines（列出视频引擎及实时状态）、tts、music、transcribe。
使用方式：需 Node.js 18+，将 CIVITAI_API_KEY 设为环境变量或放在技能目录的 .env（与 generate.mjs 同目录），可复制 .env.example。示例：node generate.mjs wait --prompt "A knight at sunset" -o ./out；视频 node generate.mjs wait --engine veo3 --prompt "A robot walking" -o ./out；语音 node generate.mjs tts --text "Hello world" --speaker serena -o ./out；音乐 node generate.mjs music --prompt "upbeat electronic dance track" -o ./out；转录 node generate.mjs transcribe --media-url "https://example.com/audio.mp3" -o ./out。多 --prompt 可并发；--bulk file.json 用于大批量；experiment.mjs 用于通配符与参数扫描。
模型选择：开放权重生态（SD1、SDXL、Pony、Illustrious、Flux.1/2、Qwen 等）需通过 Civitai MCP 搜索 checkpoint 与 LoRA 的 AIR URN，配合 --model/--resources；LoRA 基础模型须与 checkpoint 生态匹配。闭源 API 引擎（OpenAI、Google/Gemini、Seedream 等及全部视频/音频）只需引擎名。MCP 未连接可 claude mcp add --transport http civitai https://mcp.civitai.com/mcp；或用 curl -fsSL https://mcp.civitai.com/cli -o mcp-cli.mjs 后调用 search_models、get_model_version。
生成后发布：node generate.mjs wait --prompt "a red apple" -n 1 -o ./out 后执行 node mcp-cli.mjs post-image ./out/step_0-0.png --title "My apple"，可带 --detail、--nsfw、--draft、--json。视频/音频用 create_post。
限制：引擎可用性与参数会变动，需运行 node generate.mjs engines 查看实时列表并参考官方配方。视频每段约 500-2000+ buzz，建议先用 cost 预估。默认每提示生成 4 张图。生成输出的 remoteUrls[].url 为短期签名链接，建议使用本地文件发布。