@volcengine/ark-cli-linux-x64 1.0.47-prerelease.470d466f4848 → 1.0.48-prerelease.9a272fcf7076
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/bin/arkcli-linux-amd64 +2 -2
- package/manifest.json +16 -16
- package/package.json +1 -1
- package/skills/arkcli-agent/SKILL.md +2 -0
- package/skills/arkcli-agent/references/evals.md +9 -0
- package/skills/arkcli-agent/references/mcp-vault.md +46 -0
- package/skills/arkcli-helper/SKILL.md +1 -1
- package/skills/arkcli-helper/references/arkcli-helper.md +1 -1
package/bin/arkcli-linux-amd64
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
[diffend] Oversized file quarantined before diffing.
|
|
2
2
|
name: package/bin/arkcli-linux-amd64
|
|
3
|
-
size:
|
|
4
|
-
sha256:
|
|
3
|
+
size: 40210594 bytes
|
|
4
|
+
sha256: bba5fa86c5628176f7fb4e21d2f9f5194f3eff941566b360121178ca36e49a61
|
package/manifest.json
CHANGED
|
@@ -1,37 +1,37 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.0.
|
|
2
|
+
"version": "1.0.48-prerelease.9a272fcf7076",
|
|
3
3
|
"platforms": {
|
|
4
4
|
"darwin-amd64": {
|
|
5
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
6
|
-
"sha256": "
|
|
5
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/arkcli-1.0.48-prerelease.9a272fcf7076-darwin-amd64",
|
|
6
|
+
"sha256": "363196acbefe138d64f8fd82e77ffc6c9a2c37944e1b31d9d036a537322c84e1"
|
|
7
7
|
},
|
|
8
8
|
"darwin-arm64": {
|
|
9
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
10
|
-
"sha256": "
|
|
9
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/arkcli-1.0.48-prerelease.9a272fcf7076-darwin-arm64",
|
|
10
|
+
"sha256": "652c829cf31741f488b9cedf8b7af39ad3fc75370fa6006a0c5caea572cdfa6b"
|
|
11
11
|
},
|
|
12
12
|
"linux-amd64": {
|
|
13
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
14
|
-
"sha256": "
|
|
13
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/arkcli-1.0.48-prerelease.9a272fcf7076-linux-amd64",
|
|
14
|
+
"sha256": "bba5fa86c5628176f7fb4e21d2f9f5194f3eff941566b360121178ca36e49a61"
|
|
15
15
|
},
|
|
16
16
|
"linux-arm64": {
|
|
17
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
18
|
-
"sha256": "
|
|
17
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/arkcli-1.0.48-prerelease.9a272fcf7076-linux-arm64",
|
|
18
|
+
"sha256": "2486345b1c77235aa7f6e9722a099aaf70dd5266df2cb52ba4357e0c9d53d6e2"
|
|
19
19
|
},
|
|
20
20
|
"windows-amd64": {
|
|
21
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
22
|
-
"sha256": "
|
|
21
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/arkcli-1.0.48-prerelease.9a272fcf7076-windows-amd64.exe",
|
|
22
|
+
"sha256": "4185303e888337c145d1af4319c4faf2d4b854f6d0e1d1dd88074ad5de04f79e"
|
|
23
23
|
},
|
|
24
24
|
"windows-arm64": {
|
|
25
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
26
|
-
"sha256": "
|
|
25
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/arkcli-1.0.48-prerelease.9a272fcf7076-windows-arm64.exe",
|
|
26
|
+
"sha256": "b4c77d229571dda214ceb0d32aada3f62afa6da7ddf6910678c295ebd5682c70"
|
|
27
27
|
}
|
|
28
28
|
},
|
|
29
29
|
"skills": {
|
|
30
30
|
"primary": {
|
|
31
|
-
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.
|
|
32
|
-
"sha256": "
|
|
31
|
+
"url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.48-prerelease.9a272fcf7076/skills.tar.gz",
|
|
32
|
+
"sha256": "1fca86ef0f0f0c87cd4083d1c10566abfbd3109e5dc575e5780cc417f774998b",
|
|
33
33
|
"kind": "cdn"
|
|
34
34
|
},
|
|
35
|
-
"tag": "v1.0.
|
|
35
|
+
"tag": "v1.0.48-prerelease.9a272fcf7076"
|
|
36
36
|
}
|
|
37
37
|
}
|
package/package.json
CHANGED
|
@@ -92,6 +92,7 @@ Environment 还是 Session。用户提供明确 ID 时直接查对应资源,
|
|
|
92
92
|
| 管理 memory store / memories | `arkcli agent memory-store ...` | [`references/interfaces-gaps.md`](references/interfaces-gaps.md) |
|
|
93
93
|
| 整理会话记忆、创建或观察 Dream 任务(仅火山) | `arkcli agent dream create/list/get/cancel/wait` | [`references/dream.md`](references/dream.md) |
|
|
94
94
|
| 查询可挂载 MCP / 管理 Vault / Credential / MCP OAuth | `arkcli agent vault oauth-provider list` / `arkcli agent vault ...` / `arkcli agent +mcp-login ...` | [`references/mcp-vault.md`](references/mcp-vault.md) |
|
|
95
|
+
| 创建 ENV OAuth 凭证(火山) | 已有 token 用 `agent vault credentials create --auth-type env_oauth`;浏览器授权用 `agent vault env-oauth-flow create`,完成后查凭证确认 | [`references/mcp-vault.md`](references/mcp-vault.md) |
|
|
95
96
|
|
|
96
97
|
## 模型查询:主模型与工具模型
|
|
97
98
|
|
|
@@ -172,6 +173,7 @@ Environment 还是 Session。用户提供明确 ID 时直接查对应资源,
|
|
|
172
173
|
| `arkcli agent vault list/get/create/update/delete` | Vault CRUD |
|
|
173
174
|
| `arkcli agent vault oauth-provider list` | 查询后端已注册 MCP Provider;返回的 MCP server 信息可用于 Agent `--mcp-server` |
|
|
174
175
|
| `arkcli agent vault oauth-flow create` | 裸创建 Vault OAuth Flow,适合脚本自带 redirect URL |
|
|
176
|
+
| `arkcli agent vault env-oauth-flow create` | 火山 ENV OAuth:返回授权链接;授权回调成功后才创建凭证,不使用 MCP login |
|
|
175
177
|
| `arkcli agent vault credentials list/get/create/update/delete` | Credential CRUD |
|
|
176
178
|
| `arkcli agent +mcp-login` | 托管 MCP OAuth 登录:本地 callback + CreateVaultOAuthFlow + 等待 credential 创建 |
|
|
177
179
|
| `arkcli +chat <prompt>` | Responses API 快速对话;不要把它当 Managed Agent session 入口 |
|
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# arkcli-agent 2026-08 最小评估用例
|
|
2
2
|
|
|
3
|
+
## ENV OAuth 凭证(火山)
|
|
4
|
+
|
|
5
|
+
- 用户要求浏览器授权后将 token 注入 Skill:查询 `CredentialType=env_oauth` 的真实 provider,调用 `agent vault env-oauth-flow create`,不用 `+mcp-login`,不要求 MCP URL。
|
|
6
|
+
- 只返回 OAuthFlowId/RedirectUrl:告知用户仍需授权,完成后查 credentials 确认,不报告凭证已经可用,不重复创建 flow。
|
|
7
|
+
- 用户提供自定义 OAuth 应用:四件套与 provider-name 二选一;成功页 RedirectUrl 不等于上游 callback URI,URL 白名单错误交给用户/管理员处理,不编造地址重试。
|
|
8
|
+
- 已有 token:明确 `--auth-type env_oauth`,AccessToken/Refresh 用本地安全文件,不用 SecretValue,也不把 token 放进 metadata。
|
|
9
|
+
- 仅要求预览:叶子 `--dry-run` 无网络,ClientSecret/AccessToken/RefreshToken 不进入明文输出;预览不替代创建授权。
|
|
10
|
+
- 非当前产品:不推荐火山专属的 ENV OAuth flow 命令。
|
|
11
|
+
|
|
3
12
|
## Todo 配置决策
|
|
4
13
|
|
|
5
14
|
- 用户只要求给已有 Agent 添加 Todo:先 get,合并到多模态 toolset;新添该 toolset 时 DefaultConfig.Enabled=false,只启用 todo_write,不查询工具模型、不加 Models、不丢失基础工具。
|
|
@@ -46,6 +46,52 @@ arkcli agent vault credentials create <vault-id> \
|
|
|
46
46
|
|
|
47
47
|
这会写入 `Auth.Refresh`,其中 client secret 位于 `TokenEndpointAuth.ClientSecret`,由后端负责托管换签。也可以继续使用 `--auth @./credential.json` 透传完整对象;快捷参数会覆盖对象中同名字段。
|
|
48
48
|
|
|
49
|
+
## ENV OAuth(仅火山版)
|
|
50
|
+
|
|
51
|
+
ENV OAuth 将 OAuth access token 作为 `SecretName` 指定的环境变量注入沙箱;它不是 MCP OAuth,不需要 `McpServerUrl`,不要使用 `+mcp-login`。
|
|
52
|
+
|
|
53
|
+
### 用户需要浏览器授权
|
|
54
|
+
|
|
55
|
+
先通过 `agent vault oauth-provider list` 查询,选择 `CredentialType=env_oauth` 的 provider,使用返回的真实名称,不要用 MCP provider 名称替代。确认目标 Vault、权限 scope 和出网范围后发起:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
arkcli agent vault env-oauth-flow create \
|
|
59
|
+
--vault-id <vault-id> \
|
|
60
|
+
--display-name skill-oauth \
|
|
61
|
+
--provider-name <registered-env-oauth-provider-name> \
|
|
62
|
+
--secret-name SKILL_ACCESS_TOKEN \
|
|
63
|
+
--networking-type limited \
|
|
64
|
+
--allowed-host api.example.com \
|
|
65
|
+
--redirect-url <backend-allowed-business-success-url> \
|
|
66
|
+
--format json
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
- `--secret-name` 是沙箱环境变量名。`--networking-type limited` 配合真实目标域名的 `--allowed-host`;`unrestricted` 不传 host,不要为绕过校验扩大出网范围。
|
|
70
|
+
- `--redirect-url` 是**授权完成后的业务成功页**,须符合后端允许列表;不是上游 OAuth 应用登记的 callback URI,不要自行拼本地 callback。上游 callback 由后端配置。
|
|
71
|
+
- 预置模式传 `--provider-name`。自定义模式不传 provider-name,改为同时传 `--authorize-endpoint`、`--token-endpoint`、`--client-id`、`--client-secret @./client-secret.txt`;两种模式互斥。`--scope` 可选,`--source` 可标记调用来源。
|
|
72
|
+
- 支持 `--file <JSON/YAML路径>` 提供完整 TOP CamelCase 请求,flags 覆盖同名字段;不接受 `--file -`。支持叶子 `--dry-run`,只生成脱敏客户端计划,不能验证 provider、URL 白名单或权限。
|
|
73
|
+
- 返回 `Result.RedirectUrl` 和 `Result.OAuthFlowId` **只表示流程创建成功,不是凭证已创建**。请用户打开返回的授权链接;CLI 不自动启动浏览器或等待。用户完成后用 `agent vault credentials list <vault-id>` 确认新凭证,不因等待而重复创建流程。不打印 token 或 client secret。
|
|
74
|
+
- 授权被拒绝、超时或后端报错时保留原错误并停止,不偷偷改用手工 token 模式。
|
|
75
|
+
|
|
76
|
+
### 用户已有合法 token,需要直接保存
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
arkcli agent vault credentials create <vault-id> \
|
|
80
|
+
--display-name skill-oauth \
|
|
81
|
+
--auth-type env_oauth \
|
|
82
|
+
--secret-name SKILL_ACCESS_TOKEN \
|
|
83
|
+
--access-token @./access-token.txt \
|
|
84
|
+
--refresh-token @./refresh-token.txt \
|
|
85
|
+
--client-id <client-id> \
|
|
86
|
+
--client-secret @./client-secret.txt \
|
|
87
|
+
--token-endpoint https://example.com/oauth/token \
|
|
88
|
+
--networking-type limited \
|
|
89
|
+
--allowed-host api.example.com \
|
|
90
|
+
--format json
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`--provider-name` 可选;`--access-token` 写入 `Auth.AccessToken`,不是 `SecretValue`。刷新配置写入 `Auth.Refresh`,仅在用户确有对应配置时传入;没有 refresh token 不要伪造。更新使用 `credentials update <vault-id> <credential-id>`,支持相同参数。`--auth`/`--file` 也可提供完整 Auth;混用快捷字段时保留显式 `Auth.Type=env_oauth`。建议始终明确传 `--auth-type env_oauth`,避免和普通 ENV 混淆。
|
|
94
|
+
|
|
49
95
|
## OAuth MCP 登录
|
|
50
96
|
|
|
51
97
|
凭证必须与目标 provider 的服务语义匹配;不能为了让创建通过,把某服务的 Key 绑定到
|
|
@@ -104,7 +104,7 @@ arkcli helper configure <claude-code|codex|opencode|openclaw> \
|
|
|
104
104
|
|
|
105
105
|
Platform profile 只负责配置 Agent 的 model/provider:`model` 写为用户选择的 Endpoint ID,base URL 使用 Platform 的 `/api/v3`,协议继续由各 harness 保持现有行为(Chat 或 Responses)。
|
|
106
106
|
|
|
107
|
-
- 只展示**当前 SSO 子用户创建**、`Running`、模型被明确验证为**文本输出**的 Endpoint;VLM(图文输入、文本输出)可用。
|
|
107
|
+
- 只展示**当前 SSO 子用户创建**、`Running`、模型被明确验证为**文本输出**的 Endpoint;VLM(图文输入、文本输出)可用。Root 账户无子用户身份,不按创建者过滤,展示当前 project 下全部符合条件的 Endpoint。
|
|
108
108
|
- 生图、生视频、生 3D、音频、Embedding、内容生成或未知模型一律不展示,也不能通过 `--model` 绕过。
|
|
109
109
|
- Agent 配置中的 `model` 仍写 Endpoint ID;context window、max completion tokens、输入/输出模态按 Endpoint 绑定的基础模型名,复用 Agent Plan / Coding Plan 现有的 ArkModels 元数据富化规则(ArkModels 权威数据优先;查不到或字段为零时用内置 Plan 模型能力表兜底,仍未知才省略扩展字段并在 helper configure 输出中提示)。元数据查询失败同样 best-effort,不阻断已通过资格校验的 Endpoint。
|
|
110
110
|
- Hermes Agent 支持把 Platform Endpoint 写成 `volcengine-platform` model/provider;仍不支持 MCP 注入。
|
|
@@ -212,7 +212,7 @@ DSH model/provider 写入还遵循以下 ownership 规则:`settings.yaml` 使
|
|
|
212
212
|
|
|
213
213
|
## Platform Endpoint 配置
|
|
214
214
|
|
|
215
|
-
Platform profile 不使用 Plan 模型列表,而是从本人创建的 Endpoint
|
|
215
|
+
Platform profile 不使用 Plan 模型列表,而是从本人创建的 Endpoint 中选择(Root 账户无子用户身份,改为列当前 project 下全部符合条件的 Endpoint)。只允许 `Running` 且模型明确为文本输出的 Endpoint;VLM 可用,生图/生视频/生 3D/音频/Embedding/未知模型均拒绝。
|
|
216
216
|
|
|
217
217
|
```bash
|
|
218
218
|
arkcli helper configure codex \
|