@volcengine/ark-cli 0.1.17 → 0.1.18-beta.1c18e5b
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +82 -16
- package/manifest.json +16 -20
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,29 +1,95 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
# Ark CLI
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**火山方舟（Volcengine Ark）官方命令行工具**
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
7
|
+
在终端里一句话**对话 · 生图 · 生视频 · 多模态理解 · 部署模型** —— 还能把这些能力一键装进你的 AI Agent。
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/@volcengine/ark-cli)
|
|
10
|
+
[](./LICENSE)
|
|
11
|
+
[](https://nodejs.org)
|
|
12
|
+
|
|
13
|
+
```shell
|
|
14
|
+
npm i -g @volcengine/ark-cli
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
</div>
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## ✨ 一分钟感受
|
|
22
|
+
|
|
23
|
+
```shell
|
|
24
|
+
# 对话推理
|
|
25
|
+
arkcli +chat "用一句话解释什么是 RAG"
|
|
26
|
+
|
|
27
|
+
# 文生图 —— 产物自动下载并打开
|
|
28
|
+
arkcli +gen "赛博朋克风格的城市夜景，霓虹灯，雨夜"
|
|
29
|
+
|
|
30
|
+
# 看看现在能用哪些模型
|
|
31
|
+
arkcli models list
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
生视频、图生图、语音转写、文档抽取、视频总结、模型部署…… 都是一条命令的事。
|
|
35
|
+
|
|
36
|
+
## 为什么用它
|
|
37
|
+
|
|
38
|
+
- 🚀 **一条命令，不写代码**：生图 / 对话 / 转写 / 部署，终端直接出结果，不用翻 SDK、不用搭环境。
|
|
39
|
+
- 🎨 **图片 + 视频 + 多模态全覆盖**：Seedream 生图、Seedance 生视频，OCR / 视觉定位 / 视频总结 / 语音转写一站式。
|
|
40
|
+
- 🤖 **装进你的 AI Agent**：一句 `arkcli +connect`，把上面所有能力作为 Skill 注入 Claude Code / OpenCode，让 Agent 用自然语言直接驱动火山方舟。
|
|
41
|
+
- 🔌 **一套工具多种场景**：platform / agent-plan / coding-plan 多 profile，一致体验、随手切换。
|
|
42
|
+
|
|
43
|
+
## 能做什么
|
|
44
|
+
|
|
45
|
+
| 能力 | 命令 | 说明 |
|
|
46
|
+
|------|------|------|
|
|
47
|
+
| 💬 对话推理 | `arkcli +chat` | 多模态对话（文本 / 图片 / 视频 / 音频），流式输出、多轮接续 |
|
|
48
|
+
| 🎨 生图生视频 | `arkcli +gen` | Seedream 文生图 / 图生图、Seedance 文生视频 / 图生视频，产物自动下载 |
|
|
49
|
+
| 🔍 多模态理解 | `arkcli +understand` | OCR、视觉定位（框选）、文档抽取、视频总结、语音转写 / 翻译、字幕打轴 |
|
|
50
|
+
| 🚀 部署模型 | `arkcli +deploy` · `arkcli infer endpoint` | 一键把模型部署成在线推理接入点（Endpoint） |
|
|
51
|
+
| 📋 模型 / 用量 / 账单 | `arkcli models` · `arkcli usage` · `arkcli billing` | 查公共基础模型、推理用量、结算账单 |
|
|
52
|
+
| 🤖 注入 AI Agent | `arkcli +connect` | 把上面这些能力作为 Skill 装进本机的 AI Agent |
|
|
53
|
+
|
|
54
|
+
> 每个命令都自带 `--help`，例如 `arkcli +gen --help`。
|
|
55
|
+
|
|
56
|
+
## 快速开始
|
|
57
|
+
|
|
58
|
+
**环境要求**：Node.js ≥ 16（自带 npm / npx）·支持 macOS / Linux / Windows（arm64 / amd64）
|
|
59
|
+
|
|
60
|
+
```shell
|
|
61
|
+
# 1. 安装
|
|
62
|
+
npm config set registry https://registry.npmjs.org/
|
|
63
|
+
npm i -g @volcengine/ark-cli@latest
|
|
64
|
+
arkcli --version
|
|
65
|
+
|
|
66
|
+
# 2. 登录（火山引擎 SSO，运行后在浏览器完成授权）
|
|
67
|
+
arkcli auth login volc-sso
|
|
68
|
+
arkcli auth status
|
|
69
|
+
|
|
70
|
+
# 3. 上手
|
|
71
|
+
arkcli +chat "你好，介绍下你自己"
|
|
9
72
|
```
|
|
10
73
|
|
|
11
|
-
|
|
74
|
+
> **无浏览器环境**（CI / 远程开发机 / Agent 沙箱）：`arkcli auth login --no-browser`，在任意设备完成授权后用 `--code <码>` 粘回。
|
|
12
75
|
|
|
13
|
-
##
|
|
76
|
+
## 把能力装进你的 AI Agent
|
|
14
77
|
|
|
15
|
-
```
|
|
16
|
-
arkcli
|
|
78
|
+
```shell
|
|
79
|
+
arkcli +connect
|
|
17
80
|
```
|
|
18
81
|
|
|
19
|
-
|
|
82
|
+
`+connect` 会自动检测本机的 AI Agent（Claude Code / OpenCode 等）并安装 Ark Skills。装好后，你在 Agent 里用**自然语言**就能驱动上面所有能力——“帮我生成一张图”“把这段录音转写成文字”“把某个模型部署成 Endpoint”。
|
|
83
|
+
|
|
84
|
+
## 浏览内置 Skills
|
|
85
|
+
|
|
86
|
+
本仓库的 [`skills/`](https://github.com/volcengine/ark-cli/tree/main/skills) 收录了 arkcli 全部内置 AI Agent Skills（对话 / 生成 / 理解 / 部署 / 模型 / 用量 / 账单 / 套餐 …），每个都是一份可读的 `SKILL.md`。`arkcli +connect` 装进你 Agent 的就是它们。
|
|
87
|
+
|
|
88
|
+
## 链接
|
|
20
89
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
| macOS | arm64 / x64 |
|
|
24
|
-
| Linux | arm64 / x64 |
|
|
25
|
-
| Windows | arm64 / x64 |
|
|
90
|
+
- 🌋 火山方舟控制台 & 文档：<https://www.volcengine.com/product/ark>
|
|
91
|
+
- 📦 npm：<https://www.npmjs.com/package/@volcengine/ark-cli>
|
|
26
92
|
|
|
27
|
-
##
|
|
93
|
+
## License
|
|
28
94
|
|
|
29
95
|
[Apache-2.0](./LICENSE)
|
package/manifest.json
CHANGED
|
@@ -1,41 +1,37 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.1.
|
|
2
|
+
"version": "0.1.18-beta.1c18e5b",
|
|
3
3
|
"platforms": {
|
|
4
4
|
"darwin-amd64": {
|
|
5
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
6
|
-
"sha256": "
|
|
5
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/arkcli-0.1.18-beta.1c18e5b-darwin-amd64",
|
|
6
|
+
"sha256": "17adfe961031cf8a9c79e454f35732b6265f3207ceca77b5f03f4b9f9ff49ba5"
|
|
7
7
|
},
|
|
8
8
|
"darwin-arm64": {
|
|
9
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
10
|
-
"sha256": "
|
|
9
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/arkcli-0.1.18-beta.1c18e5b-darwin-arm64",
|
|
10
|
+
"sha256": "502e6b68d203d87a9d229d61165139489b8b368ba09c982622cbb2c6db194959"
|
|
11
11
|
},
|
|
12
12
|
"linux-amd64": {
|
|
13
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
14
|
-
"sha256": "
|
|
13
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/arkcli-0.1.18-beta.1c18e5b-linux-amd64",
|
|
14
|
+
"sha256": "9ab350dd23b67f66e9bdc98093bb72285436361424ab5a37647842b41bc01851"
|
|
15
15
|
},
|
|
16
16
|
"linux-arm64": {
|
|
17
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
18
|
-
"sha256": "
|
|
17
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/arkcli-0.1.18-beta.1c18e5b-linux-arm64",
|
|
18
|
+
"sha256": "66c4339523de94c31dfbef06f63e3941e74cfd2634324ad3d5c4ebeac58123b7"
|
|
19
19
|
},
|
|
20
20
|
"windows-amd64": {
|
|
21
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
22
|
-
"sha256": "
|
|
21
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/arkcli-0.1.18-beta.1c18e5b-windows-amd64.exe",
|
|
22
|
+
"sha256": "5610415eafe49747ba1ae1922ee716ab76ab834c2aa90c77a1b3e92d050587f0"
|
|
23
23
|
},
|
|
24
24
|
"windows-arm64": {
|
|
25
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
26
|
-
"sha256": "
|
|
25
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/arkcli-0.1.18-beta.1c18e5b-windows-arm64.exe",
|
|
26
|
+
"sha256": "7dbd84f2fbbda8def096ee510222e77ac62cdde4af00b0df9acf835440bfc3d4"
|
|
27
27
|
}
|
|
28
28
|
},
|
|
29
29
|
"skills": {
|
|
30
30
|
"primary": {
|
|
31
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/
|
|
32
|
-
"sha256": "
|
|
31
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/dev/0.1.18-beta.1c18e5b/skills.tar.gz",
|
|
32
|
+
"sha256": "1703c039d12f6609a1d7c9542756272bba7332ec2439e509578c4a967e93b618",
|
|
33
33
|
"kind": "cdn"
|
|
34
34
|
},
|
|
35
|
-
"tag": "v0.1.
|
|
36
|
-
"fallback": {
|
|
37
|
-
"url": "https://github.com/volcengine/ark-cli/archive/refs/tags/v0.1.17.tar.gz",
|
|
38
|
-
"kind": "github"
|
|
39
|
-
}
|
|
35
|
+
"tag": "v0.1.18-beta.1c18e5b"
|
|
40
36
|
}
|
|
41
37
|
}
|