VMEG 媒体翻译

通过 VMEG 远程 MCP（https://www.vmeg.ai/api/mcp）调用 vmeg_* 工具。

认证方式

选择其一（详见 [references/oauth.md](references/oauth.md)）：

• OAuth — 客户端中通过浏览器登录并选择项目（推荐个人用户使用）
• API Key — Authorization: Bearer vmeg_sk_xxx（推荐用于脚本或自动化场景）

指令优先级

1. MCP 服务器指令（最高优先级） — 连接后自动注入。必须严格遵循；不得由本技能覆盖。
2. 本技能说明 — 包括启用时机、连接前提、平台文档指引、安装/故障排查入口。
3. references/tools.md — 仅当用户询问可用工具或功能时阅读（快速参考，不包含参数详情）。
4. install / setup / oauth / README — 仅当用户询问安装、OAuth、API Key 或 MCP 连接失败问题时阅读。

平台检测与文档路由（代理必须阅读）

1. 从运行时环境检测当前平台（例如：Cursor → cursor；Claude Code → claude-code；OpenClaw → openclaw）。若不确定，请询问用户；不要猜测。
2. 仅阅读一个设置文件：references/setup-{platform}.md（见下表）。不要读取所有 setup-*.md 文件。
3. MCP UI 操作 — 不应依赖本技能中硬编码的快捷键或菜单路径。应：

- 在当前代理的命令面板 / 设置中搜索 MCP 或 Model Context Protocol

- 或查阅对应平台的官方文档 / 内置帮助（如 Cursor 中的 cursor-guide；OpenClaw 控制界面 /settings/mcp）

- 可选地阅读用户的本地 MCP 配置文件（如 ~/.cursor/mcp.json，~/.openclaw/openclaw.json）以验证配置

1. VMEG 特定内容（接口地址、OAuth/API Key、配置示例、预签名上传）：请阅读当前平台的设置文件 + [setup-common.md](references/setup-common.md) + [oauth.md](references/oauth.md)

前置条件

远程 MCP 必须已正确配置且工具可用。如果无法调用 vmeg_* 工具，请不要猜测业务参数；请按上述指引阅读设置和认证文档，并引导用户在当前平台的 MCP 设置中完成连接。

编码代理补充（当 MCP 指令未覆盖时作为备用方案）

当用户提供本地视频/音频的绝对路径（推荐使用 OAuth 预签名上传）时：

1. 使用该路径；不要扫描整个文件系统
2. 计算文件 MD5（使用 md5sum 或 certutil -hashfile）
3. 调用 vmeg_initiate_material_upload（传入 fileHash 和 extName）
4. 若未去重：执行 curl -X PUT --upload-file @/path/to/file.ext "<presignedPutUrl>"（不携带 VMEG Bearer）
5. 调用 vmeg_complete_material_upload；使用返回的 materialId 作为创建任务工具的输入

API Key 替代方案：一次性调用 curl -F 发送到 /api/mcp/material/upload（Bearer 为 vmeg_sk_...）

何时阅读哪份文档