| name | arkcli-config |
| version | 1.1.0 |
| description | arkcli 本地配置管理。0.1.16 起 profile 类操作请优先使用 `arkcli profile <subcmd>`（init/list/show/switch/delete 已 deprecated）；本 skill 仍可处理 `arkcli config reset` 与历史 yaml 排障。 |
| metadata | {"requires":{"bins":["arkcli"]},"cliHelp":"arkcli config --help"} |
arkcli config
⚠️ 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，禁止上来直接改配置。
唤起信号（When To Trigger）
- 用户提到：
profile、base-url、region、api-key、ARK_PROFILE/ARK_API_KEY/ARK_BASE_URL/ARK_REGION 覆盖混乱
- 用户现象：同一条业务命令“打到了错误环境/错误 base URL/错误账号”，怀疑是配置来源不一致
- 用户目标：初始化/更新 profile、切换默认 profile、重置本地配置文件
反唤起信号（When NOT To Trigger）
- 用户要解决的是“未登录/401/鉴权失败/没有权限”：先走
arkcli auth status，必要时转 ../arkcli-auth/SKILL.md
- 用户目标是业务功能（models/+chat/+gen/+deploy/usage 等）：不要停留在 config，排除配置后回到原任务
适用场景
- 初始化或更新 profile
- 查看当前解析后的配置
- 切换默认 profile
- 删除单个 profile 或重置整个本地配置
- 排查为什么业务命令连到了错误环境、错误账号或错误 base URL
Agent 快速执行顺序
- 不确定当前生效配置时，先用
arkcli profile show（旧 arkcli config show 已 deprecated）
- 不确定有哪些 profile 时，先用
arkcli profile list
- 切换默认 profile：
arkcli profile use <name>
- 创建 profile：
arkcli profile create --type=...（详见 arkcli-profile 子树，本 skill 不重复）
arkcli config reset 是破坏性操作（清整个本地配置文件），必须确认用户意图
配置归因（优先级）
arkcli 的解析优先级（从高到低）：
- Profile 选择:
--profile flag > ARK_PROFILE 环境变量 > config.yaml 的 default_profile > 第一个 type=platform 的 profile > "default" sentinel
- 其它字段: 全局 flags（
--api-key/--base-url/--region） > 环境变量（ARK_API_KEY/ARK_BASE_URL/ARK_REGION） > profile 配置 > identity store > .env fallback（仅无 identity 绑定时）
排障时要明确”是谁覆盖了谁”，不要直接猜测。
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/...，避免使用 ~。
核心规则
- 本 skill 负责解释“为什么命令打到了错误环境/错误账号/错误 base URL”，并兼容历史
config init/list/show/switch/delete 命令排障语义
- 配置排障优先
arkcli profile show，不要一上来就改配置
- profile 写操作（create / use / set-default / delete）走
arkcli profile 子树
arkcli config reset 是唯一保留的 config 写操作（整个本地配置文件清空，超出单 profile 范围）
Guard Checklist（必做）
- 只读优先：先
arkcli profile show --format json，再 arkcli profile list --format json
- 写操作确认：
profile use/delete 与 config reset 执行前必须复述影响范围并征得确认
- 全量清理提醒：
arkcli config reset 删除 config.yaml/config.json，不会清理 $HOME/.arkcli/.env（token）或 identity store；要清理凭证请用 arkcli auth logout
与其他 skill 的串联
命令一览
| 命令 | 说明 | 状态 |
|---|
arkcli config reset | 删除整个本地配置文件（保留） | ✅ 活跃 |
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 |
参考
