菜单
arkcli 本地配置管理。处理 profile 配置归因、update.mode 的 notify/automatic/disabled 策略、config reset 与历史 yaml 排障；profile 类操作优先使用 `arkcli profile <subcmd>`。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/volcengine/ark-cli --skill arkcli-config命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
使用 ArkCLI 创建、校验、查询、更新、删除、版本化和下载 Dataset。用户提到 Dataset、数据集、ds-*、dsv-*、训练集/验证集复用、数据格式校验或把 Dataset 接入精调任务时使用。
使用 ArkCLI 创建、查询和管理模型精调训练任务，并从训练指标选择最佳 step、导出训练产物为 custom model、衔接模型仓库与推理部署。任何包含精调任务 ID（`mcj-*`）的查询、查不到原因诊断、日志、trajectory、状态或生命周期操作都应使用本 skill；也适用于选择训练方法、查询精调价格和超参数、创建任务及导出部署。本 skill 不负责数据集管理。
arkcli helper：为 Claude Code / Codex / OpenCode / OpenClaw / Hermes 配置火山方舟 Plan 或 Platform Endpoint 的 model/provider，或给支持的 Agent（含 MCP-only Trae）配置 Harness 工具。真人 TTY 运行 `arkcli helper` 可选择模型和 Harness 能力；`helper mcp` 默认保持整组 Agent Plan MCP 行为，传 `--capability datapro|web-search|agent-memory` 只配单项，传 `--capability cua` 只给目标 Agent 安装云电脑 Skill；连 model/provider 一起配置用 `helper configure`，查状态用 `helper list`，移除用 `helper reset`。Agent Plan / Team 还支持专业数据集、豆包搜索、Agent 记忆、AI Native 应用开发底座、Agent 进化与 routing.v1 强制检索路由；上下文出现 ARKCLI ROUTING ENFORCEMENT / routing.v1，或用户要求在豆包搜索、DataPro、OpenViking、Supabase 之间强制分流时也使用本 Skill：调用这四类受管 Provider 前先提交 Route Plan，再调用唯一授权 Provider；原生 WebSearch/WebFetch/WebExtract 位于路由管理范围之外。Platform 只允许本人创建、Running、已验证为文本输出的 Endpoint，不配置 MCP、Supabase 或强制路由。豆包搜索配置成功后默认关闭目标客户端原生 WebSearch；传 `--keep-native-websearch` 可保留，并可用 `helper reset` 完整恢复 ArkCLI 配置。
正在显示 SKILL.md
| name | arkcli-config |
| version | 1.2.0 |
| description | arkcli 本地配置管理。处理 profile 配置归因、update.mode 的 automatic/disabled 策略、config reset 与历史 yaml 排障；profile 类操作优先使用 `arkcli profile <subcmd>`。 |
| metadata | {"requires":{"bins":["arkcli"]},"cliHelp":"arkcli config --help"} |
⚠️ 0.1.16 起命令树迁移：arkcli config init/list/show/switch/delete 已标记 deprecated，请改用 arkcli profile create/list/show/use/delete（行为一致 + 新增 profile 切面字段 type/project/owner_trn/available_api_keys）。arkcli config reset 保留（清整个本地状态，超出单 profile）。0.2.x 删除全部已 deprecated 子命令。
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md，其中包含认证闸门、命令选择顺序与共享安全规则
CRITICAL — 配置类写操作前必须确认用户意图；只读排障优先 list/show，禁止上来直接改配置。
profile、base-url、api-key 覆盖混乱，或仍在使用已删除的全局 --region/--project-namearkcli auth status，必要时转 ../arkcli-auth/SKILL.mdarkcli profile show（旧 arkcli config show 已 deprecated）arkcli profile listarkcli profile use <name>arkcli profile create --type=...（详见 arkcli-profile 子树，本 skill 不重复）arkcli config reset 是破坏性操作（清整个本地配置文件），必须确认用户意图arkcli config set update.mode automatic|disabledarkcli 的解析优先级（从高到低）：
--profile flag > ARK_PROFILE 环境变量 > config.yaml 的 default_profile > 第一个 type=platform 的 profile > "default" sentinel--api-key > ARK_API_KEY > profile > 同 identity store > 产品 .env 兼容值--base-url > ARK_BASE_URL > profile 自定义值 > 按 Profile 的 Region/Type 派生 > 默认值ARK_REGION / ARK_PROJECT_NAME 不再覆盖运行时--api-key/--base-url 仅供数据面命令使用。无 Profile 时必须成对提供；覆盖 Base URL 时也必须显式提供 API Key。控制面/本地命令显式收到这两个 flag 会 fail-fast。
排障时要明确”是谁覆盖了谁”，不要直接猜测。
0.1.16 修正：
--profile现在优先于ARK_PROFILE（对齐 CLI 行业惯例 flag > env > config）。0.1.15 及更早版本是 env > flag，与本规则相反。
为保证 Agent 的输出可被机器稳定判分，回答里必须出现以下字面量片段（原样输出，不要改写）：
只读排障show/list--profile > ARK_PROFILE > default_profile > "default"同时，路径展示一律使用 $HOME/...，避免使用 ~。
config init/list/show/switch/delete 命令排障语义arkcli profile show，不要一上来就改配置arkcli profile 子树arkcli config reset 负责全量清理；arkcli config set update.mode <mode> 只写更新策略。不要用它写任意 YAML 路径。arkcli profile show --format json，再 arkcli profile list --format jsonprofile use/delete 与 config reset 执行前必须复述影响范围并征得确认arkcli config reset 删除 config.yaml/config.json，不会清理 $HOME/.arkcli/.env（token）或 identity store；要清理凭证请用 arkcli auth logoutarkcli-profile（推荐）或继续看本 skill 的兼容映射--profile、--base-url、API Key 来源或 Profile 的 Region/Project 不一致时，先转到这里../arkcli-auth/SKILL.md 或 ../arkcli-api-explorer/SKILL.md| 命令 | 说明 | 状态 |
|---|---|---|
arkcli config reset | 删除整个本地配置文件（保留） | ✅ 活跃 |
arkcli config set update.mode automatic | 显式为当前 exact install 启用 automatic；手工重装后也用它恢复授权 | ✅ 活跃 |
arkcli config set update.mode disabled | 关闭静默自动安装，保留隐式版本检查、更新提示和手工 update | ✅ 活跃 |
arkcli profile show [--profile <name>] | 查看解析后配置或指定 profile | ✅ 替代 config show |
arkcli profile list | 列出所有 profile（含 type/region/project 切面） | ✅ 替代 config list |
arkcli profile use <name> | 切换默认 profile | ✅ 替代 config switch |
arkcli profile delete <name> | 删除单个 profile | ✅ 替代 config delete |
arkcli profile create --type=... | 创建 profile（替代旧 config init） | ✅ 替代 config init |
arkcli config init/list/show/switch/delete | 旧子命令，0.2.x 移除 | ⚠️ deprecated |
公开模式只有 automatic 和 disabled。disabled 保留隐式版本检查和更新提示，但绝不静默安装；显式 arkcli update 和 arkcli update --check 也始终可用。缺失 update.mode 和历史配置中的 notify 对外都按 disabled 处理，历史配置中的 notify 继续按 disabled 兼容读取，但不得再建议用户设置 notify。
Windows、macOS、Linux 的 fail-closed transaction 与六个产品/平台生产 gate 均已开启。普通 npm postinstall 绝不直接创建 active mutation consent，也不立即更新；只有能证明“此前没有产品状态目录”的 stable 全局 npm 新安装才创建绑定 exact install 的惰性 pending evidence。首次运行和环境变量本身不能绕过后续宽限与 exact consent。
只有能证明“此前没有产品状态目录”的 stable 全局 npm 新安装才默认写入 automatic。postinstall 只创建绑定当前 exact install 的惰性 pending evidence，不创建 active consent：
AI Skill、CI、非 TTY、Client Preview、config、update 和内部维护命令都不消耗 enrollment，也不调度 automatic。更新成功后，下一次成功的人工业务命令只在 stderr 显示一次 旧版本 -> 新版本 结果，不修改 stdout 或业务退出码。
手工 npm 重装、降级、安装身份变化或 --ignore-scripts 安装后，如果当前 exact install 没有对应 pending/consent，automatic 必须暂停，不得沿用旧安装授权。恢复时由用户明确执行 arkcli config set update.mode automatic；长期锁定版本使用：
arkcli config set update.mode disabled
npm i @volcengine/ark-cli@<exact-version> -g --registry https://registry.npmjs.org
新机器首次安装历史版本时，先对安装命令设置 ARKCLI_NO_UPDATE_NOTIFIER=1，安装后再写入持久 disabled。disabled 位于 $HOME/.arkcli/config.yaml，npm 重装不能覆盖。arkcli config reset 会尽力撤销 exact consent 后再清配置，不会把用户自动放回 automatic。