visionenginelisted
Install: claude install-skill vecai-dev/skills
# VisionEngine CLI
零依赖 Python CLI,把 VisionEngine 平台的 MCP 能力包装成命令。每条命令内部启动
`ve-*` 或 `npx -y @visionengine/<pkg>@latest` 的 stdio MCP server,通过 JSON-RPC 调用工具。
## 运行环境与自检
先跑:
```bash
python <skill>/scripts/ve.py env
```
确认 `python`、`node`、`npx`、各 MCP 的启动命令与 API Key 是否存在(只显示是否存在,不显示值)。
需要验证 MCP 协议与工具列表时:
```bash
python <skill>/scripts/ve.py env --probe
```
## API Key(平台授权 / 本地询问)
只使用一个环境变量 `VEC_AI_API_KEY`。CLI 缺 Key 时返回 `MISSING_API_KEY`。
- **VECSKILL 云端工作区(`render context` 的 `usage_type=skills`)**:不要向用户索要密钥原文。
用平台 AskUser 授权卡请求授权:只问一题,`header` 逐字为 `VEC_API_KEY_AUTH`,
`options` 至少给一项占位(平台会替换成固定的「同意授权(推荐)/ 不同意」)。
用户同意后平台会把 `VEC_AI_API_KEY` 写入当前项目根 `.env`;**本轮**在同一条 Bash 调用里
先 `set -a; . ./.env; set +a` 再执行命令,下一轮起平台自动注入。
- **本地 / VECONLINE**:缺 Key 时先向用户询问,并告诉用户可在
`https://www.visionengine-tech.com/keys` 获取;拿到后在该命令前设置环境变量重试:
```bash
VEC_AI_API_KEY=<用户的 Key> python <skill>/scripts/ve.py <原命令>
```
不要把 Key 写入文件、日志、命令输出或最终回复。CLI 会把它映射为各 MCP 的 `VEC_AI_API_KEY`,
不会打印、不会落盘。
## 先判定运行环境
React Remotion 渲染前必须先判断当前是本地、VECONLINE 还是 VECSKILL:
```bash
python <skill>/scripts/ve.py render context
```
| `usage_type` | 场景 | 渲染方式 | 产物位置 |
|---|---|---|---|
| `standalone` | 用户本地电脑 | 渲染 MCP + 文件桥接 | 远端 `out/`,下载到本地 |
| `veconline` | VECONLINE 云端 | 只用渲染 MCP | 工作区 `out/`,不下载 |
| `skills` | VECSKILL 云端 | 只用渲染 MCP | `artifact/{技能标识符}/`,不下载 |
判定依据:显式参数 > `VE_USAGE_TYPE` > 当前目录的 `sys-veconline` / `sys-skills` 路径 >
`.ve-workspace.json` > 默认 `standalone`。云端 VECSKILL 禁用会话 MCP,CLI 会自