arkcli-deploy
arkcli +deploy
前置: 先用 Read 读 ../arkcli-shared/SKILL.md 获取共享认证/配置/写操作守卫规则。
新增 flag --set-default <modality>: 部署成功后自动把新 endpoint 设为 active profile 该 modality (text / image / video) 的默认资源。仅在 --dry-run 之外 + 用户明确传 modality 时生效;失败仅 stderr warn,不阻断部署主流程。详见 ../arkcli-shared/references/profile-defaults.md。
写操作 + 计费:+deploy 创建在线推理 Endpoint 是真实写操作,会产生计费资源。任何执行前必须先 --dry-run 或与用户显式确认,即使用户语气紧急。
模型开通是独立计费写动作,非交互环境一律不自动开通:若目标基础模型尚未开通,+deploy 会触发"开通模型"(账号级计费写)。在 agent / CI / 管道这类非 TTY 环境,开通被硬拒——--yes 也不放行(--yes 只在真人交互终端里用于跳过 [y/N])。命中时 CLI 返回 model_activation_required + console 链接,你必须结束本轮、把"开通(计费)"这件事连同链接交还给真人,由真人在交互终端确认或在网页 console 开通。严禁自己补 --yes / echo Y / 设 ARKCLI_ALLOW_HEADLESS_ACTIVATION 替用户开通——你打印一句"请确认"然后同一轮自己加 --yes 跑掉,等于没问。ARKCLI_ALLOW_HEADLESS_ACTIVATION=1 只留给真·无人值守自动化(CI 流水线),不是 agent 该设的。--dry-run 预演永不开通。
实名前置(开通类硬闸门):+deploy 会触发开通模型,第一步先 arkcli auth status 读 volc_sso.identity.verified——false 即停并把实名页 https://console.volcengine.com/user/authentication/detail/ 贴给用户、暂停等待(详见 ../arkcli-auth/references/realname-gate.md)。不要先试 +deploy、撞到 model-id 无效 / 模型未开通报错再回头查实名——那些报错会把你带偏。
语音模型硬边界:TTS / ASR / 配音 / 朗读 / 播客 / 音色设计 / 实时语音交互,或模型名命中 doubao-seed-tts-*、doubao-seed-asr-*、seedasr-* 时,不要执行 +deploy。这些模型在 arkcli 当前只支持 models search 做广场发现;不能创建 Endpoint,也不能通过开通模型绕过。
示例代码:+deploy 创建后自动渲染 + 独立命令 +code-example
两条路径都可用,都走 OpenTOP OpenGetSampleCode: