菜单
arkcli +connect：将 arkcli 内嵌的 AI skills 安装到本机检测到的所有 AI Agent 中，支持安装、列出已支持 agent、卸载。当用户需要将 arkcli 能力同步到 Claude Code 等本地 agent 时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | arkcli-connect |
| version | 1.1.0 |
| description | arkcli +connect：将 arkcli 内嵌的 AI skills 安装到本机检测到的所有 AI Agent 中，支持安装、列出已支持 agent、卸载。当用户需要将 arkcli 能力同步到 Claude Code 等本地 agent 时使用。 |
| metadata | {"requires":{"bins":["arkcli"]},"cliHelp":"arkcli +connect --help"} |
前置： 先用 Read 读 ../arkcli-shared/SKILL.md 获取共享安全规则。
把 arkcli 内嵌的 skills 同步到本机 AI Agent（Claude Code、Cursor、Gemini CLI 等）的 skills 目录。纯本地文件操作，不需要认证。
| 调用 | 说明 |
|---|---|
arkcli +connect | 默认行为：安装到所有检测到的 agent |
arkcli +connect --path <skills-dir> | 安装到指定的本地 skills 目录（项目级 / 自定义路径），不扫描 agent、不改全局目录 |
arkcli +connect list | 只读：列出支持的 agent 与检测状态 |
arkcli +connect uninstall | 破坏性：从所有 agent 卸载 |
arkcli +connect uninstall --path <skills-dir> | 删除目标 skills 目录下所有 ark- / arkcli- 前缀目录或软链（含用户手工维护的同前缀条目），不扫描/修改其他 agent 目录 |
⚠️ 没有
+connect install/+connect setup/+connect sync/+connect remove等子命令；安装就是默认行为，不要凭直觉补 install。--path是 flag，不是子命令。
arkcli +connect，建议先 arkcli +connect list 预检arkcli +connect --path <skills-dir>，例如 arkcli +connect --path .claude/skills；--path 接收具体 skills 目录，不是项目根目录arkcli +connect list，不要顺手装arkcli +connect uninstall，先要求用户明确确认（破坏性，会按 ark- / arkcli- 前缀 rm -rf agent 目录下所有同前缀 skill）arkcli +connect uninstall --path <skills-dir>；只作用于该目录，但会删除其中所有 ark- / arkcli- 前缀目录或软链（含用户手工维护的同前缀条目）arkcli-auth，与 +connect 无关（+connect 不需要认证）arkcli-configarkcli-code-example / arkcli-chatark- / arkcli- 前缀的子目录（清掉历史遗留 skill，如已废弃的 ark-experience、arkcli-experience-video 等），再把当前内嵌 skill 写入--path <skills-dir> 是隔离安装：相对路径按当前 PWD 解析，绝对路径原样使用；只清理该目录下 ark- / arkcli- 前缀的目录或软链（含用户手工维护的同前缀条目），再复制当前内嵌 skill。它不扫描 agent、不清 legacy 私有目录、不删除 byted-ark-* conflicting skills、不 patch Claude/opencode 等 harness 配置byted-ark-seedance-skill / byted-ark-seedream-skill（按精确名匹配，不误伤其他 byted-*）。原因：它们的 description 带"推荐优先"+逐字触发词，会在"生图/生视频"意图上压过 arkcli +gen，且自身要独立 ark- API Key，赢了路由反而失败。移除后生成类意图统一落 arkcli +gen（用登录态 profile 凭证，跟视频一样能成）。日志显式打印 removed N conflicting (...)，非静默。要保留它们：arkcli +connect --keep-conflictinguninstall 同样按 ark- / arkcli- 前缀清理，不依赖"当前 binary 里有的 skill 名"——历史遗留同样能清掉~/.codex/skills(CODEX_HOME) 和共享的 ~/.agents/skills；Pi 同时扫 ~/.pi/agent/skills 和共享的 ~/.agents/skills。若两处都装 arkcli，会把每个 skill 列两遍或报同名冲突。因此 +connect 把 Codex / Pi 的 skill 都装进共享的 ~/.agents/skills(与 cline/warp 去重成一份)，靠 ~/.codex / ~/.pi/agent 目录存在来检出对应 agent；并在每次 +connect 时清掉 legacy 私有 skills 目录里的 arkcli(只清 arkcli/seed，gocli 等其它 skill 不动)。这样每个 arkcli skill 只出现一次list 只扫描本地文件系统，不写入、不联网、不需要认证npm install arkcli 时 postinstall 会自动跑 +connect：在能打开 /dev/tty 的交互式终端上直接把内嵌 skills 装到检测到的所有 agent，无需用户确认；CI / 非交互终端 / 拿不到 /dev/tty 一律静默跳过；想完全静音可设 ARKCLI_SKIP_POSTINSTALL=1详细行为、错误码、输出示例见 references/arkcli-connect.md。
arkcli doctor 诊断入口：用于火山方舟 Ark 报错、资源状态、用量配额、性能指标、错误码解释与修复建议；覆盖 doctor、doctor error、doctor infer-endpoint、doctor model、doctor metrics。用户给 Ark 错误码或错误 JSON、ep-xxx 接入点、模型名，问为什么报错、怎么修、状态/健康、用量/配额、限流、错误率、P99、Cache 命中率、接入点慢/挂、模型是否可用时使用；用户说诊断、体检、健康检查、排查、自助修复、看指标/监控也使用。模型名加失败、慢、超时、限流、异常、健康、配额等体检语义时走 doctor model，不因 seedream/seedance/生成视频关键词误触发 arkcli-gen。内容审核、敏感内容、PolicyViolation 等拦截诊断也归 doctor。安装、登录、profile、认证配置问题归 arkcli-shared 或 arkcli-auth。
火山方舟 Ark 图片/视频生成入口：用户要生图、画图、生成图片/视频、图生图、图生视频、参考图/视频/音频生成，或明确使用 seedream/seedance 创作新内容时使用 arkcli +gen。+gen 按当前 profile 的可用资源与模型 supported_params 生成；图片同步返回，视频提交后返回 task_id/status，需用 --wait 或 arkcli gen get/list 轮询并下载结果。反触发：用户问失败原因、失败率、模型健康、持续慢/超时/限流、配额是否够、内容审核/敏感内容/PolicyViolation 拦截怎么解决时，走 arkcli-doctor 的 doctor model 或 doctor error，不走本 skill。单条视频 queued/还在跑通常是异步任务未完成，仍用 gen get/list 查结果；跨任务统计性失败或持续异常才转 doctor。
arkcli helper:把 Claude Code / Codex / OpenCode / OpenClaw / Trae 配到火山方舟 Plan。用户说给当前或某个 Agent 配 MCP、豆包搜索、联网搜索、dataPro、OpenViking 时,用 `arkcli helper mcp`(只注入 MCP,不改 model);要连 model/provider 一起配用 `helper configure`;查状态用 `helper list`;移除注入用 `helper reset`。MCP 仅 Agent Plan 支持:个人版 agent-plan 配豆包搜索、dataPro、OpenViking 数据面/控制面;团队版 agent-plan-team 只配豆包搜索 + dataPro。Codex 支持 profile/global 配置范围;Trae 仅注 MCP,支持 `--scope project`。`helper supabase` 不是 MCP,用于安装 byted-supabase-cli + skill 并注入火山登录态。反触发:安装 arkcli skills → arkcli-connect;登录/401/鉴权 → arkcli-auth;生图生视频 → arkcli-gen。
arkcli 推理接入点**管理**能力：对**已有** Endpoint 做获取、列表、启动、停止、删除、更新（生命周期管理 + 启停 + 销毁）。优先使用产品命令 `arkcli infer endpoint ...`，而不是直接调用 Raw API。**反触发（重要）：用户说『创建/新建/create/部署/deploy 一个 endpoint/接入点』这类新建接入点的意图，一律走 arkcli-deploy（`+deploy`），不要用本 skill 的 `infer endpoint create`**；本 skill 的 `create` 仅用于脚本化 / CI / 需要无护栏的可预测 raw CRUD 行为（不做复用检查、不渲染示例）、且明确要绕过 +deploy 工作流护栏的场景。TTS/ASR/语音模型连 raw create 也不要引导，只能转 models search 说明 arkcli 不支持 Endpoint 创建。
ARK 套餐管理(Agent Plan / Coding Plan,个人版 + 企业版):查询持有 / 购买 / 续费 / 模型清单 / 轮换 APIKey,**以及企业版席位的全部管理操作**:列出席位(`plans team seat-list`)、给员工分配席位(`plans team seat-assign`)、查谁绑了哪个 seat、轮换席位 APIKey(`plans team rotate-apikey`)。命中关键词:套餐 / 买 / 续费 / 列席位 / 看 seat 绑定 / 谁绑了哪个 seat / 给员工分席位 / 解绑 / 团队席位 admin 视图 / 轮换 APIKey。**用量类问题(还剩多少额度 / 用了几成 / 每个 seat 用了多少)走 [arkcli-usage](../arkcli-usage/SKILL.md)。**动词路由:**列 / 绑 / 分 / 轮换 / 解绑** → 这里;**用 / 消耗 / 多少** → arkcli-usage。另含 harness-status:只读查看本机 AI Agent(claude-code/codex/opencode/openclaw/trae)上 Agent Plan 内置 MCP(豆包搜索/dataPro/OpenViking)装没装、key 就没就绪;命中:我的 MCP 装好了吗 / 查 MCP 安装状态 / 看 agent 上的 MCP / harness 状态。
arkcli 认证管理：交互式登录、Volc SSO 登录、查看状态、退出登录、生成 ARK API Key (apikey)、以及云开发机/CI 用 `arkcli init-volc` 从 VOLC_INIT_* 环境变量无交互引导 platform profile。0.1.16 起 SSO 登录走 Gate 1+2 自动绑定 Profile 切面 (type/region/project/owner_trn)；AK/SK login 通道暂关。当用户需要初始化凭证、排查鉴权问题、切换认证方式、生成或重选 ARK API Key、或在已注入凭证的环境无交互引导时使用。反触发：用户问 TTS/ASR/语音模型能力、接入或调用时，不要引导 `auth apikey`，只转 models search 说明 arkcli 当前仅支持广场发现。