给 AI 的调用说明

用你自己的 AI 调用大肚猴翻译

三十秒就能交给助手:先安装,再复制说明,然后在对话里说出要做的事。敏感动作要等你在 App 或扩展里确认。这一页只负责说明和深链,不代替启用扩展。

  1. 安装 App 或浏览器扩展
  2. 复制「给 AI 的说明」贴进你常用的助手
  3. 在对话里说:开实时字幕 / 翻译这一页 / 收进复习
安装 App 安装扩展

Safari 扩展随中国区 App 一起安装。装好之后,还要在设置里打开一次。启用步骤在独立的启用扩展页。

已支持 Grok「连接应用」。中国面 Remote MCP 可连;下面四步即可挂上大肚猴翻译。

在 Grok「连接应用」里连上大肚猴翻译

Remote MCP(中国面)。连上之后可做就绪检查并拿到本机设置深链(china 深链 belliedmonkeycn://);页译 / 听译 / 字幕仍须本机 App 或扩展确认——连接成功不代表听译已通。

  1. 打开 Grok → 连接应用(Connect apps)→ 自定义连接器。
  2. 名称填 BelliedMonkey Translator(或「大肚猴翻译」)。
  3. URL 填 https://mcp.belliedmonkey.com/mcp/v1(中国面;国际面请用 https://mcp.belliedmonkey.cc/mcp/v1)。
  4. 按提示用大肚猴账号登录并授权;回到连接器列表应看到「已连接 / 已添加」。

连上之后:在聊天里让 Grok 检查大肚猴是否就绪。若提示尚未检测到本机 App,请先安装或打开大肚猴,再按深链 / 提示完成设置——这不代表听译已通。

浏览器:优先系统 Chrome / Safari;若卡在人机验证,换浏览器重试,不要反复刷新内嵌页。

断开:在 Grok 连接器管理中移除本连接器即可。

授权须登录大肚猴真账号(非任意邮箱直过)。本航道是「连接应用」Remote MCP,不是 bot.store。订阅 / 额度绑定另期。

先看就绪,再做五件事

先打开 ready.check。没就绪就走 open_setup。C1–C5 是叙事名字,深链只用动作 ID。点按钮会尝试中国版 App;没安装就去 App Store。

P0 · ready.check

就绪检查

先看 App、扩展、语言包和引擎是否齐。真值以本机为准。

失败时可能看到这些话:本站暂不支持视频字幕 · 请先安装扩展 · 需要麦克风权限。对应的 code 在下面的失败码表里,不另起一套说法。

给 AI 的调用说明

先让 AI 做 ready.check,再执行动作。动作 ID 里这个名字带点:ready.check。

把说明贴进 ChatGPT / Claude / Cursor,或点页面上的能力按钮。ChatGPT、Claude、Cursor 是你发指令的助手。中国版的翻译引擎仍是 DeepSeek、智谱 GLM、通义千问、Kimi,或自定义接口。

你是用户的外语学习助手。当用户要实时字幕、整页翻译、视频双语字幕、收进复习、解析/出卡时,通过大肚猴翻译的稳定动作完成,不要假装已经打开了字幕。

规则:
1. 先让用户打开 `ready.check`;未就绪只说明缺什么,并给出 `open_setup` 深链。真值以本机为准。
2. 深链往往不能把 JSON 回传给你。让用户点链接,再根据用户看到的确认卡描述结果。
3. 开麦、读当前页、收进复习须等用户在 App/扩展确认。深链不会自动开麦。
4. 失败码用具名 code(如 need_app、need_ext、need_permission_mic、site_unsupported)。不要用笼统的 need_user 代替。
5. 禁止承诺:Netflix / Disney+ / Prime 官方双语、B 站页内双语、官方 Zoom/腾讯会议插件。
6. 不索取、不回传用户 API Key。回执默认不含原文、转写或译文全文。
7. 中国站 `https://belliedmonkey.com`,深链 `belliedmonkeycn://agent/v1/<action>?source=for-agents`。国际站 `https://belliedmonkey.cc`,scheme 是 `belliedmonkey://`。路径同构。
8. 本页按钮的 source 用 `for-agents` 或 `web`。也可见 `agent` / `mcp` / `deeplink` / `ext`。
9. 说明书:`https://belliedmonkey.com/for-agents`。不要把旧的 listen、review、setup 入口当成 Agent v1。

动作:`ready.check` · `open_setup` · `start_live_subtitles` · `translate_page` · `translate_video_captions` · `capture_to_study` · `explain_or_drill`。

说明书:https://belliedmonkey.com/for-agents(当前是中国站)。国际站同一路径是 https://belliedmonkey.cc/for-agents。

三个要先问清的事

我的 AI 能碰什么?
只唤起已声明的动作;不会静默读你的聊天记录。
密钥谁管?
API Key 只在本机 App;别把 Key 贴进聊天。
怎么撤销?
在确认卡点取消,或在设置关掉「允许被唤起」。

已支持 Grok「连接应用」Remote MCP(中国面主推 https://mcp.belliedmonkey.com/mcp/v1,国际面 https://mcp.belliedmonkey.cc/mcp/v1,均见上方专区)。下面的 JSON 仍可供其它助手复制深链动作。

{
  "host_intl": "https://belliedmonkey.cc",
  "host_cn": "https://belliedmonkey.com",
  "scheme_intl": "belliedmonkey",
  "scheme_cn": "belliedmonkeycn",
  "deeplink": "{scheme}://agent/v1/{action}?source=for-agents",
  "docs_path": "/for-agents",
  "source_default": "for-agents",
  "mcp_status": "remote_mcp_china_intl_live_grok_connect",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "ready.check",
        "description": "Check App/extension readiness (login, pack, engine, OS, extension). Call before other actions. The id is ready.check, with a dot.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "need": {
              "type": "array",
              "items": { "type": "string", "enum": ["app", "extension", "mic", "pack", "engine", "login"] }
            }
          },
          "required": ["host"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "open_setup",
        "description": "Open install/auth setup when ready.check fails. Does not replace the human setup page.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "platform": { "type": "string", "enum": ["ios", "mac", "chrome", "edge", "unknown"] },
            "step": { "type": "string", "enum": ["install_app", "install_ext", "login", "packs", "mic", "engine"] },
            "reason": { "type": "string" },
            "source": { "type": "string", "enum": ["agent", "mcp", "deeplink", "web", "ext", "for-agents"], "default": "for-agents" }
          },
          "required": ["host"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "start_live_subtitles",
        "description": "Start live/system-audio bilingual subtitles in the App. Do not open the mic until the confirm card passes.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "video_lang": { "type": "string" },
            "my_lang": { "type": "string" },
            "source": { "type": "string", "enum": ["agent", "mcp", "deeplink", "web", "ext", "for-agents"], "default": "for-agents" }
          },
          "required": ["host"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "translate_page",
        "description": "Bilingual view for the current page via extension. If the extension is missing, return need_ext and an open_setup link only.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "url": { "type": "string" },
            "source": { "type": "string", "enum": ["agent", "mcp", "deeplink", "web", "ext", "for-agents"], "default": "for-agents" }
          },
          "required": ["host"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "translate_video_captions",
        "description": "In-page video bilingual captions where supported. Named refusal on unsupported sites—never invent Netflix/Disney+/Prime dual-sub support.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "url": { "type": "string" },
            "source": { "type": "string", "enum": ["agent", "mcp", "deeplink", "web", "ext", "for-agents"], "default": "for-agents" }
          },
          "required": ["host"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "capture_to_study",
        "description": "Save current/selected sentence to the study library; needs user confirm; may need login.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "text": { "type": "string" },
            "quote": { "type": "string" },
            "lang": { "type": "string" },
            "source": { "type": "string", "enum": ["agent", "mcp", "deeplink", "web", "ext", "for-agents"], "default": "for-agents" }
          },
          "required": ["host"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "explain_or_drill",
        "description": "Open explain-this-line or a light drill card. mode is explain or drill. Fails with need_engine if the engine or key is missing.",
        "parameters": {
          "type": "object",
          "properties": {
            "host": { "type": "string", "enum": ["intl", "cn"] },
            "text": { "type": "string" },
            "quote": { "type": "string" },
            "mode": { "type": "string", "enum": ["explain", "drill"], "default": "explain" },
            "source": { "type": "string", "enum": ["agent", "mcp", "deeplink", "web", "ext", "for-agents"], "default": "for-agents" }
          },
          "required": ["host"]
        }
      }
    }
  ]
}

在你常用的 AI 编程助手里调用大肚猴

同一套动作(实时字幕、页译、视频字幕、收进复习…)。下面按工具给安装路径。徽章含义:D1=复制说明书 · D2=官方配置/一条命令 · D3=原生插件(上架后才会亮)。

D1 说明书 · 现在可用 D2 官方配置 · 规划 D3 原生插件 · 规划

Grok「连接应用」Remote MCP(国际面)已可连,见上方专区。其它宿主的官方插件 / 配置仍在推进;在此之前请用本页复制块 + 深链。勿把「规划」徽章当成已安装。

D1

Claude Code

在终端里跟 Claude 说「开实时字幕 / 收进复习」。

把本页「给 AI 的说明」贴进项目 CLAUDE.md / 自定义指令;动作名保持 ready.check 等。

打开完整说明书

目标 D3 首批(未上架)

D1

Codex

用 Codex 调同一套大肚猴动作。

复制 tools JSON / 系统提示到 Codex 自定义指令;敏感动作仍在 App 确认。

查看动作与失败码

目标 D3 首批(未上架)

D1

dsh

日用 dsh 回归环境也能唤起听译 / 学习。

将本页指令写入 dsh 任务说明或自定义 system;先 ready.check。

深链示例(agent/v1)

目标 D3 H2

D1

豆包

在豆包里咨询外语学习时,按说明书调用大肚猴。

复制中文「给 AI 的说明」到豆包自定义能力/提示词;中国站链接用 .com。

打开中国站说明书

本季 D2

D1

WorkBuddy

在 WorkBuddy 里用同一套动作名求助视频翻译 / 学习。

粘贴说明书;若仅支持自定义指令则停在 D1。

反馈:是否发现官方插件入口

目标 D3(探活后)

D1

Grok Bot

在 Grok Bot 里直接叫大肚猴做听译 / 学习。

把本页说明贴进该 Bot 的自定义指令或任务说明;动作名仍用 ready.check 等;敏感步骤在 App 确认。

打开完整说明书

连接应用 Remote MCP(中国面 .com 主推,国际面 .cc)已可连,见 上方专区。完整 D3 / 听译全通仍属规划,勿称已齐。

D1

Meta Muse · Connectors

在 Meta Muse(Connectors)里用同一套动作名做视频翻译 / 学习。

复制中英说明书到 Muse 侧自定义提示;中国用户优先 .com 链接。

查看失败码表

待探。若走公网跟 W2 / N25-H-remote;禁 localhost;非本机 stdio

失败码

code 用这些字符串。说明文字可以改写成中文,code 本身不要换。不要用笼统的 need_user 代替下面的具名码。

通用

code含义典型处理
ok成功—
need_confirm等用户点确认卡引导用户看 App 或扩展
cancelled用户取消—
unsupported_action动作未实现,或只在后续范围看本页说明书
bad_request缺必要参数补 query,或先做 ready.check
untrusted_denied未确认,也没有授权确认卡

就绪 / 安装

code含义典型处理
need_app未装 Appbelliedmonkeycn://agent/v1/open_setup?step=install_app&source=for-agents
need_ext需要扩展belliedmonkeycn://agent/v1/open_setup?step=install_ext&source=for-agents
need_login未登录belliedmonkeycn://agent/v1/open_setup?step=login&source=for-agents
need_packs缺语言包belliedmonkeycn://agent/v1/open_setup?step=packs&source=for-agents
need_engine引擎未配belliedmonkeycn://agent/v1/open_setup?step=engine&source=for-agents
need_os系统版本不够看说明书。具体版本以首页和 App 内说明为准
need_permission_mic无麦克风权限belliedmonkeycn://agent/v1/open_setup?step=mic&source=for-agents

能力 / 站点

code含义典型处理
site_unsupported当前站不在视频字幕支持清单在说明里写站点名。不承诺做不到的平台
quota_or_key本机额度或 Key 不可用去本机设置。不要向 AI 要 Key
study_capture_off用户已关掉采集看设置里的采集开关

深链本身通常没法把这段 JSON 塞回对方的 AI。默认没有原文、转写或译文全文。

{
  "ok": false,
  "action": "start_live_subtitles",
  "code": "need_permission_mic",
  "message": "需要麦克风权限",
  "fix": {
    "open_setup": "belliedmonkeycn://agent/v1/open_setup?step=mic&source=for-agents"
  }
}
{
  "ok": true,
  "action": "capture_to_study",
  "code": "ok",
  "message": "已收进复习",
  "fix": {}
}

安装与启用

这一页是 Agent 说明书。启用扩展、语言包和人用的首次设置仍在原来的页面,不并进这里。

中国版在 App Store。iPhone、iPad 和 Mac 是同一个 App(id6789718038)。翻译引擎用 DeepSeek、智谱 GLM、通义千问、Kimi,或你自己的兼容接口。密钥怎么填,看配置教程。扩展没亮时,看启用扩展。别的问题看支持页。

隐私上先记住这三句

我的 AI 能碰什么?
只唤起已声明的动作;不会静默读你的聊天记录。
密钥谁管?
API Key 只在本机 App;别把 Key 贴进聊天。
怎么撤销?
在确认卡点取消,或在设置关掉「允许被唤起」。

账号、同步和学习材料的存放,以隐私政策为准。

常见问题

我的 ChatGPT / Claude 怎么调用?

复制本页说明,贴进 ChatGPT、Claude 或 Cursor。让它先打开 ready.check 深链,再执行动作。深链通常不会把结果自动回传给助手。

要把 API Key 发给 AI 吗?

不要。API Key 只留在本机 App 里,不要贴进聊天。

支持 Netflix 官方双语吗?

不承诺。Netflix、Disney+、Prime 的官方双语,以及 B 站页内双语,都不在可承诺范围内,以支持站点说明为准。

.com 和 .cc 有区别吗?

调用方式相同,路径同构。中国版深链用 belliedmonkeycn,国际版用 belliedmonkey。域名和文案按站点分开;中国面 MCP 推 .com,国际面推 .cc。

没装扩展行不行?

翻译当前页和视频字幕需要浏览器扩展。实时字幕可以用 App。

如何停止被调用?

在确认卡上点取消,或在设置里关掉「允许被唤起」。

连上了为什么还不能听译?

连接只打通编排;听译要在本机 App 确认,不会在聊天里静默开麦。

能不能填 .com 的 MCP 地址?

可以,本站就推中国面:https://mcp.belliedmonkey.com/mcp/v1(深链 belliedmonkeycn://)。国际面填 https://mcp.belliedmonkey.cc/mcp/v1。

这算登录大肚猴账号了吗?

算。须登录大肚猴账号才能授权;连接≠听译,也未自动绑订阅。

和 HeyGen 一样吗?

连接姿势同类(公网 URL + 授权);能力与验收范围不同,勿称「已全部对齐」。

提示要调 install_app?

没有这个工具。应走设置深链或商店安装页;若模型乱说工具名,以连接器返回的深链为准。

在 bot 市场装一个行吗?

本航道是「连接应用」Remote MCP;bot.store 导购另轨且目前未开放。

突然调不动工具,或提示未授权 / 401?

多半是授权过期或已在连接器里移除。打开 Grok「连接应用」,找到大肚猴翻译(BelliedMonkey Translator),重新授权后再试。连上仍不等于听译已通。

授权过期:连接已失效或未授权。请到 Grok「连接应用」里重新授权大肚猴翻译后再试。

如何断开大肚猴 Remote MCP?

在 Grok「连接应用」里找到大肚猴翻译(BelliedMonkey Translator),移除该连接器即可。断开后需重新授权才能再调工具;连接≠听译已通。

额度走谁的?

宿主自有订阅 / API Key 可用;不要假设只用大肚猴免费额度。

不要承诺这些

助手不该说能做,这一页也不说能做。

不支持的视频站点用 site_unsupported,直接说站点名,不要编一个官方双语开关。

Grok「连接应用」已可挂 Remote MCP(中国面主推 https://mcp.belliedmonkey.com/mcp/v1,深链 belliedmonkeycn://;国际面 https://mcp.belliedmonkey.cc/mcp/v1)。连接≠听译已通;勿称完整 D3。