Skip to content
快速入门

快速入门 ​

TinyRobot AI助手 是一个运行在 Chrome / Edge 等 Chromium 浏览器中的 AI 扩展插件。它把大模型「装进」浏览器侧边栏:你用自然语言下达任务,AI 自动打开网页、阅读页面内容、点击与填写表单,完成跨页面的连续操作;同时它还能调用网页上已注册的原生 WebMCP 工具,把业务系统的能力直接交给 AI 使用。

除对话之外,扩展还内置了一批开箱即用的插件(AI 总结、Markdown 下载、DOM 元素抓取等),并在页面上提供悬浮球与右键菜单两个快捷入口;通过 WebSocket 桥接本地 CLI 后,侧边栏还能操作你本地的工作目录,完成生成 PPT、运行本地命令等任务。

它能做什么 ​

  • 网页自动操作:打开 / 切换 / 关闭标签页,读取页面内容,点击、填写、选择、滚动,完成多步骤任务。
  • 页面工具调用:自动发现并调用目标网页注册的原生 WebMCP 工具(document.modelContext),无需改造网站即可让 AI 使用业务能力。
  • 内置插件:右键 AI 总结、导出为 Markdown、DOM 元素选取、内容助手等,随开随用。
  • 快捷入口:任意网页上的悬浮球与右键菜单,一键唤起常用 AI 能力。
  • 本地协同:通过 WebSocket 连接本地 CLI(@opentiny/webmcp-cli),在侧边栏操作本地工作目录,例如生成 PPT、执行本地开发命令。
  • 账号与额度:注册登录后即可使用平台提供的免费 AI 额度,也可在「模型设置」中接入自有模型。

适用场景 ​

场景典型任务主要依赖
操作你的业务系统「打开控制台,查询昨天的告警并汇总」页面 WebMCP 工具、网页自动操作
适配第三方网站「在掘金搜索 WebMCP,总结前三篇文章」网页自动操作(web_page_operator)
通用网页处理总结文章、导出 Markdown、抓取元素样式信息内置插件、悬浮球、右键菜单
连接外部 AI 助手在 Claude Desktop / Cursor 中遥控浏览器CLI WebSocket 桥接
本地工作协同「在当前工作目录生成一份项目汇报 PPT」CLI WebSocket 桥接、本地工作空间

五分钟上手 ​

步骤一:安装扩展 ​

要求 Chromium 内核版本 >= 120(Chrome、Edge 等)。

  1. 下载扩展压缩包并解压到一个固定目录(安装后不要移动或删除该目录)。
  2. 打开 chrome://extensions/,开启右上角「开发者模式」。
  3. 点击「加载已解压的扩展程序」,选择刚才的解压目录。

完整步骤与截图见 安装指南。

步骤二:打开侧边栏 ​

点击浏览器工具栏上的 TinyRobot 图标即可展开侧边栏(建议先将图标「固定」到工具栏)。侧边栏是 AI 对话的主入口;打开任意网页后,页面右侧还会出现一个可拖动的悬浮球,作为页面内的快捷入口。

步骤三:注册登录,领取免费额度 ​

  1. 点击侧边栏左上角的菜单按钮展开会话栏,再点击会话栏左下角的「登录」,在登录页登录,或点击「注册」创建账号。
  2. 未登录时以游客身份使用平台模型,额度较少;登录后获得更多免费 AI 额度。
  3. 登录后在「个人中心 → 使用统计」中查看剩余额度与用量趋势;额度不足时对话区顶部会显示提醒与重置时间。

详见 注册与登录。

步骤四:发起第一次网页操作 ​

在对话框输入自然语言任务即可,例如:

打开 https://juejin.cn,搜索「WebMCP」,告诉我第一条结果的标题和摘要。

AI 会依次调用 browser_open_tab 打开网页、web_page_operator 阅读并操作页面,执行期间目标页面会出现操作遮罩与模拟光标。输入框上方的技能按钮(网页 / 视频 / 电子表格 / 可视化 / PPT)可快速切换任务类型。

步骤五:用悬浮球与右键菜单快速调用 ​

  • 悬浮球:点击展开快捷菜单(AI 对话、Markdown 下载等,已开启的插件会追加条目,如 DOM 元素选取、文章总结),按住可拖动位置,松手后自动吸附在侧边。
  • 右键菜单:选中文本或在空白处右键,选择「总结此内容」或「Markdown下载」。
  • DOM 元素选取:按 Alt+Shift+C(Mac:⌥⇧C)进入选区模式,点选元素后结构化信息复制到剪贴板,Esc 退出;默认仅在 localhost 与 127.0.0.1 生效,可在插件配置中扩充白名单。

能力速览 ​

浏览器与页面工具 ​

工具作用
browser_open_tab打开新标签页并加入工作区
browser_list_tabs / browser_switch_tab / browser_close_tab列出、切换、关闭工作区标签页
web_page_operator网页子 Agent:接收自然语言指令,在目标页面自主完成多步操作
page-agent-tool(页面注入)页面级原子操作:browserState、searchTree、click、fill、select、hover、scroll、executeJavascript

TIP

web_page_operator 只能操作 http(s) 网页。若当前是空白页或 chrome:// 等浏览器内部页,AI 会先调用 browser_open_tab 打开网页再继续。

页面原生 WebMCP 工具 ​

如果目标网页已通过标准 WebMCP API(或 @opentiny/next-sdk 的 document.modelContext.registerTool / registerPageAgentTool)注册了工具,扩展会自动发现并代理给模型,AI 可以像调用内置工具一样调用它们。为页面接入工具的方法见 WebMCP-SDK 快速开始。

自定义 WebMCP 脚本 ​

不想改动网站源码?在「配置页 → WebMCP 管理」中编写脚本,按域名匹配规则注入目标页面并注册工具,即可为任意网站补充 AI 能力。

内置插件一览 ​

插件入口默认状态
悬浮助手页面悬浮球常驻,不可关闭
核心工作区 / 核心技能 / 网页 MCP 代理 / 网页代理 Agent / 用户自定义 MCP 脚本内核能力,无独立入口常驻,不可关闭
右键 AI 总结右键菜单「总结此内容」开启
导出为 Markdown右键菜单、悬浮球开启
DOM 元素选取悬浮球、快捷键关闭
内容助手(文章总结、帮写)悬浮球、右键菜单关闭
CLI WebSocket 桥接侧边栏桥接状态徽章关闭

业务插件均可在「配置页 → 功能管理」中按域名开启或关闭,详见 功能管理。

连接本地 CLI(可选) ​

通过本地 WebSocket 桥接(127.0.0.1:18999),扩展可以与本地 CLI 双向协同:侧边栏让 AI 在你的本地工作目录执行命令,外部 Agent 也能遥控浏览器。

  1. 准备 Node.js 环境,在「配置页 → 功能管理」中开启「CLI WebSocket 桥接」。
  2. 将鼠标移到侧边栏顶部的 WS 待连接 徽章上,点击复制CLI设置命令,在终端执行(形如 npx @opentiny/webmcp-cli@latest --mode wxt token set <Token>)。
  3. 徽章变为 WS 已连接 后,用输入区的工作空间按钮为当前会话绑定本地文件夹;不绑定时在默认隔离目录中执行。
  4. 在对话中下达本地任务,例如「在当前工作目录生成一份项目周报 PPT」或「运行 npm run dev 并把报错贴给我」。

完整的连接、工作空间与命令安全说明见 CLI WebSocket 桥接。

安全提示

CLI 桥接会在本地执行 shell 命令,请仅在受信任的开发环境开启,并妥善保管 Token。

反向使用:把 CLI 作为 MCP Server 接入 Claude Desktop、Cursor 等宿主,即可在这些工具中遥控你的浏览器:

json
{
  "mcpServers": {
    "tiny-robot": {
      "command": "npx",
      "args": ["-y", "@opentiny/webmcp-cli@latest", "--mode", "wxt", "mcp"]
    }
  }
}

常用入口 ​

入口位置用途
侧边栏工具栏 TinyRobot 图标AI 对话、任务执行、会话管理
悬浮球网页右侧,可拖动快捷唤起 AI 对话与插件能力
右键菜单网页选中文本 / 空白处右键AI 总结、Markdown 下载
个人中心侧边栏头像登录注册、使用统计、设置、退出
配置页个人中心 → 设置(独立标签页)功能管理、模型设置、悬浮球设置、Skill 管理、WebMCP 管理、数据管理

常见问题 ​

  • 悬浮球或右键菜单没出现:确认对应插件已在「功能管理」中开启;悬浮球还需检查「悬浮球设置」中的站点黑名单;配置修改后刷新页面。
  • 提示「未连接到本地 CLI 桥接服务」:先在桥接徽章中复制 CLI 设置命令并在终端执行,确认徽章变为 WS 已连接。详见 CLI WebSocket 桥接。
  • AI 提示找不到可操作的网页:当前标签页是空白页或浏览器内部页,先让它打开一个 http(s) 网页。
  • 额度用完了:在「使用统计」查看重置时间;或在「模型设置」中配置自有模型继续使用。

下一步 ​