[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92527":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":35,"discoverSource":36},92527,"ark-cli","volcengine\u002Fark-cli","volcengine","The fastest way to put Volcengine Ark in your terminal and your AI agent — go from prompt to generated   media, multimodal answer, or deployed endpoint in a single command, no API glue code.","",null,"Python",57,3,1,2,0,4,42.21,"Apache License 2.0",false,"main",[23,24,25,26,27,28,29,30,31,7],"ai-agent","ai-skills","ark","cli","doubao","llm","multimodal","text-to-image","text-to-video","2026-07-22 04:02:06","\u003Cdiv align=\"center\">\n\n# Ark CLI\n\n**给你的 AI Agent 赋予火山方舟的全部能力**\n\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@volcengine\u002Fark-cli?color=brightgreen&label=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@volcengine\u002Fark-cli)\n[![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache--2.0-blue)](.\u002FLICENSE)\n[![node](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D16-brightgreen)](https:\u002F\u002Fnodejs.org)\n\n火山方舟模型、生成、多模态理解、Plan、精调、部署、用量、账单和诊断能力，都可以通过 Ark CLI + Skills 交给 Claude Code、OpenCode、Codex 等本地 Agent 调用。\n\n```shell\nnpm i -g @volcengine\u002Fark-cli@latest\n```\n\n\u003C\u002Fdiv>\n\n---\n\n## Ark CLI 能做什么\n\n让你的 AI Agent 具备这些方舟能力，并能在复杂任务中组合调用：\n\n- **模型调用**：文本对话、多模态输入、流式输出、多轮接续\n- **图片 \u002F 视频生成**：Seedream 生图、Seedance 生视频，产物自动下载到本地\n- **多模态理解**：OCR、视频总结、语音转写、字幕打轴、文档字段抽取\n- **Plan 管理**：Agent Plan \u002F Coding Plan 查询、购买、续费、团队席位管理\n- **Agent 接入**：安装 Ark Skills，配置 Harness \u002F MCP，让本地 Agent 调用方舟能力\n- **模型生产**：精调任务、自定义模型、训练状态跟踪\n- **服务上线**：基础模型或自定义模型一键部署为 Endpoint\n- **治理闭环**：Usage、Billing、Doctor、监控指标和错误码诊断\n\n## 为什么需要 Ark CLI\n\nArk CLI 不是让你记住更多命令，而是把火山方舟 MaaS 平台能力变成 Agent 可以调用的工具箱。\n\n```text\n消费链路:\n选择模型\n  -> 开通 Plan 或部署模型\n  -> 接入本地 Agent \u002F Harness\n  -> 调用、理解、生成\n  -> 查看用量、账单、监控和诊断结果\n\n生产链路:\n准备数据\n  -> 创建精调任务\n  -> 得到自定义模型\n  -> 部署成 Endpoint\n  -> 回到消费链路继续使用\n```\n\n## 安装与初始化\n\n```shell\n# 1. 安装 CLI\nnpm i -g @volcengine\u002Fark-cli@latest\narkcli --version\n\n# 2. 登录火山方舟\narkcli auth login volc-sso\narkcli auth status\n\n# 3. 同步 Ark Skills 到本地 Agent\narkcli +connect\n```\n\n无浏览器环境，例如远程开发机、CI 或 Agent 沙箱：\n\n```shell\narkcli auth login --no-browser\narkcli auth login --no-browser --code \u003C授权码>\n```\n\n## 一次完整任务可以这样开始\n\n你可以直接告诉 Agent 一个目标：\n\n```text\n帮我选择一个适合图文理解的模型，配置到本地 Agent，\n然后用它总结一段视频，并告诉我本月用了多少 token。\n```\n\nAgent 可以通过 Ark CLI 串起完整流程：\n\n```text\narkcli models search\n  -> arkcli plans get \u002F arkcli plans model-list\n  -> arkcli +connect \u002F arkcli helper configure\n  -> arkcli +understand video-summary\n  -> arkcli usage stats \u002F arkcli billing list\n```\n\n用户描述目标，Agent 负责选择命令、调用方舟能力、汇总结果。\n\n## 常用任务\n\n### 选择并调用模型\n\n```shell\narkcli +chat \"总结一下 RAG 的核心思想\"\n\narkcli +chat --input @photo.jpg \"描述这张图片\"\n\narkcli +understand video-summary --input @demo.mp4 \"按章节总结这个视频\"\n\narkcli +gen \"生成一张未来城市海报\"\n```\n\n### 开通和管理 Plan\n\n```shell\n# 查看当前账号持有哪些套餐\narkcli plans get\n\n# 查看 Plan 支持哪些模型\narkcli plans model-list --plan agent-plan\n\n# 查看团队版席位\narkcli plans team seat-list --plan agent-plan-team\n\n# 查看本机 Agent 上 Plan 相关能力状态\narkcli plans harness-status\n\n# 购买或续费前先查看参数\narkcli plans buy --help\narkcli plans renew --help\n```\n\n`plans buy` \u002F `plans renew` 是计费操作，Ark CLI 会先展示协议和确认步骤，不会默认直接扣款。\n\n### 接入方舟服务能力\n\n`+connect` 安装 Ark Skills，让 Agent 知道有哪些方舟任务可以做。`helper` 配置 Harness \u002F MCP \u002F Plan，让 Agent 真正接上模型和工具能力。\n\n```shell\n# 查看会检测到哪些本地 Agent\narkcli +connect list\n\n# 安装 Ark Skills\narkcli +connect\n\n# 清理已注入的 Ark Skills\narkcli +connect uninstall\n\n# 查看 Harness \u002F Agent 配置状态\narkcli helper list\n\n# 给当前 Agent 注入 MCP 工具能力\narkcli helper mcp\n\n# 配置指定 Harness，并同步注入 MCP\narkcli helper configure codex --with-mcp\n```\n\n`arkcli +connect uninstall` 会清理注入到本地 Agent 的 `ark-` \u002F `arkcli-` 前缀 Skills，适合想恢复干净 Agent 环境、或担心 Skills 过多影响 Agent 路由时使用。它不会卸载 `arkcli` 命令本身。\n\n### 生产模型\n\n```shell\narkcli train finetune --help\narkcli train finetune capability get --model \u003Cmodel> --version \u003Cversion>\narkcli train finetune create --help\narkcli train finetune watch \u003Cjob-id>\n```\n\n### 上线服务\n\n```shell\narkcli +deploy --name my-endpoint --model doubao-seed-2-0-pro-260215 --dry-run\narkcli +deploy --name my-endpoint --model doubao-seed-2-0-pro-260215\narkcli infer endpoint list\narkcli infer endpoint get \u003Cendpoint-id>\n```\n\n### 管成本、状态和健康\n\n```shell\narkcli usage plan\narkcli usage stats --start 2026-07-01 --mine\narkcli billing list --start 2026-07\narkcli billing list --start 2026-07 --endpoint ep-xxx\n\narkcli doctor\narkcli doctor model \u003Cmodel-name>\narkcli doctor infer-endpoint \u003Cendpoint-id>\narkcli doctor metrics request.qpm\narkcli doctor error ContentRiskBlocked\n```\n\n`doctor` 默认是只读诊断，不会修改资源。需要修复时会通过确认流程执行。\n\n## 命令入口\n\n| 任务 | 命令 |\n|---|---|\n| 对话和多模态推理 | `arkcli +chat` |\n| 图片 \u002F 视频生成 | `arkcli +gen` |\n| OCR、视频总结、语音转写、文档抽取 | `arkcli +understand` |\n| 模型查询 | `arkcli models` |\n| Plan \u002F 套餐管理 | `arkcli plans` |\n| Agent 接入和 Harness 配置 | `arkcli +connect`, `arkcli helper` |\n| 精调任务 | `arkcli train finetune` |\n| 一键部署 Endpoint | `arkcli +deploy` |\n| Endpoint 管理 | `arkcli infer endpoint` |\n| 用量查询 | `arkcli usage` |\n| 账单查询 | `arkcli billing` |\n| 诊断和自助排障 | `arkcli doctor` |\n\n每个命令都自带帮助：\n\n```shell\narkcli +chat --help\narkcli +gen --help\narkcli +understand --help\narkcli +deploy --help\narkcli plans --help\narkcli doctor --help\n```\n\n## 认证\n\n推荐使用火山 SSO：\n\n```shell\narkcli auth login volc-sso\n```\n\n登录后 Ark CLI 会自动完成身份、profile 和 API Key 配置。你通常不需要手动复制密钥。\n\n```shell\narkcli auth status\narkcli auth apikey\narkcli auth logout\n```\n\n## 配置\n\n```shell\n# 查看当前 profile\narkcli profile show\n\n# 列出所有 profile\narkcli profile list\n\n# 切换 profile\narkcli profile use \u003Cprofile-name>\n```\n\n更多 profile 管理能力可查看 `arkcli profile --help`。\n\n## AI Agent Skills\n\n本仓库的 [`skills\u002F`](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002Fark-cli\u002Ftree\u002Fmain\u002Fskills) 收录了 Ark CLI 内置的 Agent Skills。执行：\n\n```shell\narkcli +connect\n```\n\nArk CLI 会把这些 Skills 安装到本机 Agent，使 Agent 能通过自然语言调用火山方舟能力，包括对话、多模态理解、图片视频生成、模型查询、Plan 管理、Endpoint 部署、精调、用量、账单和诊断。\n\n## 用户交流群\n\n扫码加入 Ark CLI 飞书用户交流群，获取使用答疑、问题排查、Bug 反馈和使用经验交流支持。你可以在群里咨询安装、登录、模型调用、Skill 使用、版本升级等问题，也欢迎反馈 GitHub Issues 中未覆盖的异常。\n\n请勿在群内发送 API Key、AK\u002FSK、Token 等敏感信息。对于可稳定复现的 Bug，建议同步提交 GitHub Issue，便于跟踪和修复。\n\n\u003Cimg src=\".\u002Fassets\u002Flark-user-group.png\" width=\"360\" alt=\"Ark CLI 飞书用户交流群二维码\" \u002F>\n\n## 链接\n\n- 火山方舟：\u003Chttps:\u002F\u002Fwww.volcengine.com\u002Fproduct\u002Fark>\n- npm：\u003Chttps:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@volcengine\u002Fark-cli>\n- GitHub Releases：\u003Chttps:\u002F\u002Fgithub.com\u002Fvolcengine\u002Fark-cli\u002Freleases>\n- 内置 Skills：\u003Chttps:\u002F\u002Fgithub.com\u002Fvolcengine\u002Fark-cli\u002Ftree\u002Fmain\u002Fskills>\n\n## Changelog\n\nRelease notes live in [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fvolcengine\u002Fark-cli\u002Freleases).\n\n## License\n\n[Apache-2.0](.\u002FLICENSE)\n","Ark CLI 是火山方舟（VolcEngine Ark）平台的命令行工具，旨在将方舟的多模态大模型能力（如文本对话、图文理解、文生图\u002F视频、模型精调与部署等）无缝集成至本地 AI Agent 工作流。它通过统一 CLI 接口封装模型调用、Plan 管理、Skills 注入、Endpoint 部署及用量监控等功能，支持无浏览器环境下的自动化接入，并与 Harness\u002FMCP 协议兼容。适用于需要快速构建企业级 AI Agent 应用、实现端到端模型消费与生产闭环的研发团队和 MLOps 工程师。","2026-07-09 02:30:14","CREATED_QUERY"]