VMEG 媒体翻译
通过 VMEG Remote MCP（https://www.vmeg.ai/api/mcp）调用 vmeg_* 工具。
认证
支持两种方式（二选一，见 references/oauth.md）：
- OAuth：客户端浏览器登录 VMEG 并选择项目（推荐个人用户）
- API Key：
Authorization: Bearer vmeg_sk_xxx（推荐脚本/自动化）
指令优先级
- MCP server instructions（最高） — 连接 MCP 后，客户端会自动注入服务端下发的全局指导。严格遵循，不要用本 Skill 覆盖或重复解释。
- 本 Skill — 仅补充：何时启用、连接前置条件、IDE 文档路由、安装排障入口。
- references/tools.md — 仅回答「有哪些工具 / 能做什么」时阅读（用途速查，不含参数细节）。
- setup / oauth / README — 仅在用户询问安装、OAuth、API Key、MCP 连接失败时阅读。
IDE 检测与文档路由（Agent 必读）
- 判断当前 IDE：从运行环境推断（例如在 Cursor 中运行 →
cursor；Claude Code →claude-code）。无法判断时询问用户，不要猜测。 - 只读一份 setup：
references/setup-{当前IDE}.md（映射见下表）。禁止通读全部setup-*.md。 - IDE 界面操作：MCP 设置入口、快捷键、菜单路径 不要使用本 Skill 里可能过期的硬编码。应：
- 在当前 IDE 用 Command Palette / 设置搜索「MCP」或「Model Context Protocol」
- 或查阅该 IDE 官方文档 / 内置帮助（如 Cursor 可用 cursor-guide）
- 必要时读取用户本机 MCP 配置文件（如~/.cursor/mcp.json）确认是否已配置 - VMEG 特有内容（端点、OAuth/API Key、
mcp.json示例、预签名上传）：读当前 IDE 的 setup 文件 + setup-common.md + oauth.md。
| 当前 IDE | 读取 |
|---|---|
| Cursor | setup-cursor.md |
| Claude Code | setup-claude-code.md |
| Windsurf | setup-windsurf.md |
| Codex | setup-codex.md |
| Gemini CLI | setup-gemini-cli.md |
| Antigravity | setup-antigravity.md |
| QoderWork | setup-qoderwork.md |
| WorkBuddy | setup-workbuddy.md |
前置条件
用户必须已配置 Remote MCP 且工具可用。若 vmeg_* 工具不可调用，不要猜测业务参数；按上方路由读 setup + oauth，并引导用户在当前 IDE 的 MCP 设置中完成连接。
Coding Agent 补充（MCP instructions 未覆盖时的兜底）
本地 IDE 用户提供视频/音频绝对路径时（OAuth 推荐预签名上传）：
- 使用该路径，不要全盘搜索文件系统
- 计算文件 MD5（
md5sum/certutil -hashfile） - 调用
vmeg_initiate_material_upload（fileHash+extName） - 若未去重：
curl -X PUT --upload-file @/path/to/file.ext "<presignedPutUrl>"（无需 VMEG Bearer） - 调用
vmeg_complete_material_upload，用返回的materialId建任务
API Key 备选：一次 curl -F 到 /api/mcp/material/upload（Bearer vmeg_sk_...）
文档读取规则
| 场景 | 做什么 |
|---|---|
| 翻译、素材、任务、编辑、导出 | 遵循 MCP server instructions + 调用 MCP 工具 |
| 用户问有哪些工具 / VMEG 能做什么 | 读 tools.md 概览；具体调用仍以 instructions 为准 |
| MCP 未连接 / 认证失败 / 如何安装 | 按 IDE 路由读对应 setup-*.md + setup-common.md + oauth.md |
| 日常业务 | 不要读 setup / oauth / README / tools.md |
