Bot Browser Buddy

机器人浏览器伙伴（BBB）

一个隐私优先、人工智能驱动的浏览器扩展，将多提供商LLM聊天、MCP协议集成和智能DOM自动化结合到一个跨浏览器工具中。

+--------------------+     +-------------------+     +-----------------+
|   Side Panel UI    || Background Worker || Content Script  |
| (Vue 3 + Tailwind) | port| (Message Hub)     | msg | (DOM Engine)    |
+--------------------+     +-------------------+     +-----------------+
                                |         |
                   +------------+         +----------+
                   v                                 v
          +----------------+               +------------------+
          | LLM Providers  |               | MCP Servers      |
          | Ollama (local) |               | Local (42069)    |
          | Claude         |               | Remote (OIDC)    |
          | ChatGPT        |               | 3rd-party (key)  |
          | Gemini         |               +------------------+
          | Grok           |
          +----------------+

特性

• 多提供商LLM聊天 --Ollama（本地，默认）、Claude、ChatGPT、Gemini和Grok，支持实时流媒体
• DOM自动化 --通过自然语言浏览网站、单击元素、填写表单、滚动到部分
• MCP客户端 -使用每个服务器身份验证（无/API密钥/OIDC）连接到本地、专用和第三方MCP服务器
• 情境感知辅助 --基于网站类别（购物、维基、新闻、博客、学术等）的主动建议
• 多标签研究 --打开背景选项卡，提取内容，将调查结果与来源归因合并
• 导出模式 --生成带有返回精确页面位置的深度链接的摘要
• 会话分支 --在任何消息中分叉聊天，探索替代方案，合并发现
• 离线优先 --脱机时具有本地Ollama+缓存页面的完整功能
• 隐私第一 --本地存储在IndexedDB中的所有数据。没有遥测。没有第三方数据共享。
• 跨浏览器 --通过WXT支持Chrome（Manifest V3）和Firefox

快速开始

先决条件

• 18+
• 9+
• （可选） 奥拉玛 在本地运行默认的本地LLM提供程序
• （可选） 码头工人 对于本地MCP服务器

安装

cd bot-browser-buddy
pnpm install

发展

# Chrome (opens browser with extension loaded)
pnpm dev

# Firefox
pnpm dev:firefox

生产建设

# Both browsers
./scripts/build.sh

# Or individually
pnpm build            # Chrome → .output/chrome-mv3/
pnpm build:firefox    # Firefox → .output/firefox-mv3/

加载扩展

铬：导航到 chrome://extensions/，启用“开发人员模式”，单击“加载解包”，选择 .output/chrome-mv3/.

火狐：导航到 about:debugging#/runtime/this-firefox，单击“加载临时加载项”，选择中的任何文件 .output/firefox-mv3/.

用法

键盘快捷键

聊天模式

打开侧面板，选择LLM提供者和模型，然后询问有关当前页面的问题：

• “这篇文章是关于什么的？”
• “导航到光盘部分”
• “在此网站上查找希捷硬盘”
• “总结要点”

辅助模式

在设置中启用“主动建议”。访问支持的站点时，浮动芯片会显示上下文感知操作：

导出模式

将来自多个来源的研究整合到一个具有深度链接的摘要中：

1. 在侧面板中切换到“导出”模式
2. 提出一个研究问题（例如，“比较希捷与WD 4TB硬盘”）
3. 代理打开背景选项卡，提取内容并显示结果
4. 导出为Markdown或JSON，并注明来源

自动导航

切换设置。当 开，代理直接导航。当 关闭 （默认），每次导航操作前都会看到一张确认卡。

LLM提供程序配置

在扩展选项页面中配置提供程序(right-click extension icon → Options).

API密钥存储在 browser.storage.local （浏览器在静止时加密）。

MCP服务器设置

本地MCP服务器（Docker）

FastMCP 2.0服务器用于本地开发：

cd docker
cp .env.template .env
# Edit .env if needed (defaults work for local dev)
docker compose up -d

服务器在端口上启动 42069 默认情况下没有身份验证。在扩展的MCP设置中配置它。

每服务器身份验证

每个MCP服务器都独立配置了三种身份验证方法之一：

OIDC使用 browser.identity.launchWebAuthFlow() 使用PKC。每个服务器都维护自己的令牌对，并自动刷新。

建筑

消息流

User input → Side Panel → (port) → Background Worker → Content Script
                                         |
                                    LLM Provider
                                         |
                                    Stream chunks
                                         |
                                    (port) → Side Panel → Render

数据存储

所有数据都通过Dexie.js本地存储在IndexedDB中：

隐私

• 所有数据都存储在本地，永远不会离开浏览器
• 无遥测或分析
• 隐身模式：无任何内容持续
• 可配置的数据保留（7/30/90天/永久）
• 一键清除所有数据
• 离线模式：所有内容都保留在设备上（本地Ollama+缓存页面）

项目结构

bot-browser-buddy/
├── src/
│   ├── entrypoints/
│   │   ├── background.ts          # Service worker: LLM routing, message hub
│   │   ├── content.ts             # DOM automation + page extraction
│   │   ├── sidepanel/App.vue      # Main chat UI
│   │   ├── popup/App.vue          # Quick-action popup
│   │   └── options/App.vue        # Settings page
│   ├── lib/
│   │   ├── providers/             # LLM adapters (ollama, anthropic, openai, google, xai)
│   │   ├── mcp/                   # MCP client, connection manager, OIDC
│   │   ├── automation/            # DOM engine, site detector, tab orchestrator
│   │   ├── storage/               # Dexie.js database, CRUD modules
│   │   ├── monetization/          # Feature gate stubs (all unlocked)
│   │   └── messages.ts            # Typed message definitions
│   └── utils/                     # Markdown rendering, deep links
├── docker/                        # Local MCP server (FastMCP 2.0, port 42069)
├── scripts/                       # Build, version, sign, release scripts
├── wiki-pages/                    # GitHub wiki content (8 pages)
├── .github/workflows/             # CI + release pipelines
├── wxt.config.ts
├── tailwind.config.ts
└── package.json

脚本

发展

添加新的LLM提供程序

1. 创建 src/lib/providers/.ts 实施 LLMProvider 接口
2. 将提供者ID添加到 ProviderId 输入 types.ts
3. 注册于 src/lib/providers/index.ts 工厂
4. 将默认模型添加到 getDefaultModel() 在 background.ts
5. 添加 ` 向提供商选择 sidepanel/App.vue`

添加新的MCP工具

对于本地Docker MCP服务器：

1. 在中创建新文件 docker/mcp-server/src/bbb_mcp/tools/
2. 在中注册该工具 main.py 使用 @mcp.tool() 装饰器
3. 重建： cd docker && docker compose up --build

类型检查

pnpm typecheck

测试

pnpm test         # Single run
pnpm test:watch   # Watch mode

版本控制

使用语义版本控制。唯一的真理来源是 package.json → version.WXT会自动读取清单。

./scripts/version.sh patch   # 0.1.0 → 0.1.1
./scripts/version.sh minor   # 0.1.0 → 0.2.0
./scripts/version.sh major   # 0.1.0 → 1.0.0

许可证

麻省理工学院