ark-cli

项目详情摘要

Ark CLI 给你的 AI Agent 赋予火山方舟的全部能力** 火山方舟模型、生成、多模态理解、Plan、精调、部署、用量、账单和诊断能力，都可以通过 Ark CLI + Skills 交给 Claude Code、OpenCode、Codex 等本地 Agent 调用。 Ark CLI 能做什么 让你的 AI Agent 具备这些方舟能力，并能在复杂任务中组合调用： **模型调用**：文本对话、多模态输入、流式输出、多轮接续 **图片 / 视频生成**：Seedream 生图、Seedance 生视频，产物自动下载到本地 **多模态理解**：OCR、视频总结、语音转写、字幕打轴、文档字段抽取 **Plan 管理**：Agent Plan / Coding Plan 查询、购买、续费、团队席位管理 **Agent 接入**：安装 Ark Skills，配置 Harness / MCP，让本地 Agent 调用方舟能力 **模型生产**：精调任务、自定义模型、训练状态跟踪 **服务上线**：基础模型或自定义模型一键部署为 Endpoint **治理闭环**：Usage、Billing、Doctor、监控指标和错误码诊断 为什么需要 Ark CLI Ark CLI 不是让你记住更多命令，而是把火山方舟 MaaS 平台能力变成 Agent 可以调用的工具箱。 安装与初始化 无浏览器环境，例如远程开发机、CI 或 Agent 沙箱： 一次完整任务可以这样开始 你可以直接告诉 Agent 一个目标： Agent 可以通过 Ark CLI 串起完整流程： 用户描述目标，Agent 负责选择命令、调用方舟能力、汇总结果。 常用任务 选择并调用模型 开通和管理 Plan `plans buy` / `plans renew` 是计费操作，Ark CLI 会先展示协议和确认步骤，不会默认直接扣款。 接入方舟服务能力 `+connect` 安装 Ark Skills，让 Agent 知道有哪些方舟任务可以做。`helper` 配置 Harness / MCP / Plan，让 Agent 真正接上模型和工具能力。 `arkcli +connect uninstall` 会清理注入到本地 Agent 的 `ark-` / `arkcli-` 前缀 Skills，适合想恢复干净 Agent 环境、或担心 Skills 过多影响 Agent 路由时使用。它不会卸载 `arkcli` 命令本身。 生产模型 上线服务 管成本、状态和健康 `doctor` 默认是只读诊断，不会修改资源。需要修复时会通过确认流程执行。 命令入口 任务 | 命令 | 对话和多模态推理 | `arkcli +chat` | 图片 / 视频生成 | `arkcli +gen` | OCR、视频总结、语音转写、文档抽取 | `arkcli +understand` | 模型查询 | `arkcli models` | Plan / 套餐管理 | `arkcli plans` | Agent 接入和 Harness 配置 | `arkcli +connect`, `arkcli helper` | 精调任务 | `arkcli train finetune` | 一键部署 Endpoint | `arkcli +deploy` | Endpoint 管理 | `arkcli infer endpoint` | 用量查询 | `arkcli usage` | 账单查询 | `arkcli billing` | 诊断和自助排障 | `arkcli doctor` | 每个命令都自带帮助： 认证 推荐使用火山 SSO： 登录后 Ark CLI 会自动完成身份、profile 和 API Key 配置。你通常不需要手动复制密钥。 配置 更多 profile 管理能力可查看 `arkcli profile --help`。 AI Agent Skills 本仓库的 `skills/` 收录了 Ark CLI 内置的 Agent Skills。执行： Ark CLI 会把这些 Skills 安装到本机 Agent，使 Agent 能通过自然语言调用火山方舟能力，包括对话、多模态理解、图片视频生成、模