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

先看就绪，再做五件事

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

给 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 贴进聊天。

怎么撤销？

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

{
  "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": "planned_N25_W2_not_shipped",
  "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 原生插件 · 规划

深链示例

中国版统一是 belliedmonkeycn://agent/v1/<action>?source=for-agents。国际版只换 scheme 为 belliedmonkey://，这一页的按钮不打开国际版。

点「试着打开」会唤起中国版 App。大约一秒后如果页面还在，就打开 App Store（id6789718038）。旧的 listen、review、setup 入口仍是原来的意思，不要拿来冒充下面这些动作。

source=for-agents 表示从这页的说明或按钮来。source=web 表示从本站网页按钮去商店或设置。两者都算这一页的归因。

失败码

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

通用

就绪 / 安装

能力 / 站点

深链本身通常没法把这段 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。域名和文案按站点分开。

没装扩展行不行？

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

如何停止被调用？

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

不要承诺这些

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

• Netflix / Disney+ / Prime 官方双语
• B 站页内双语
• 官方 Zoom / 腾讯会议插件

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