内容
<div align="center">
# 导航工具
### 开源浏览器代理，适用于本地AI自动化。
[](LICENSE)
[](https://www.chromium.org)
[](https://www.typescriptlang.org/)
[](https://go.dev/)
[](https://bun.sh/)
[](https://python.org)
[](https://github.com/rahulcvwebsitehosting/wayfinder)
**导航工具是一款开源、注重隐私的浏览器代理，由本地AI模型驱动。**
您的数据永远不会离开您的机器。您的模型在您的硬件上运行。您始终保持控制。
> **本地AI的工作原理：** 浏览器引擎（Chromium）不会在内部运行LLM。代理层 — 一个与浏览器一起运行的Bun/TypeScript服务器 — 连接到本地模型服务器，如Ollama或LM Studio，通过它们的API。LLM处理规划和推理；代理层通过Chrome DevTools协议执行浏览器操作。这意味着导航工具与您已经运行的任何模型服务器一起工作。
</div>
---
### 工作原理
```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#6366F1', 'primaryTextColor': '#fff', 'primaryBorderColor': '#4f46e5', 'lineColor': '#6366F1', 'secondaryColor': '#312e81', 'tertiaryColor': '#e0e7ff'}}}%%
flowchart LR
YOU([您]) --> WAY["导航工具
代理"]
WAY --> LOCAL["本地LLM
(Ollama / LM Studio)"]
WAY --> CLOUD["云LLM
(Claude / GPT / Gemini)"]
LOCAL --> PLAN[规划器]
CLOUD --> PLAN
PLAN --> BROWSER[浏览器操作]
BROWSER --> SITES[网站]
BROWSER --> RESULT[结果]
RESULT --> YOU
style YOU fill:#312e81,color:#fff
style WAY fill:#6366F1,color:#fff
style LOCAL fill:#4f46e5,color:#fff
style CLOUD fill:#818cf8,color:#fff
style PLAN fill:#6366F1,color:#fff
style BROWSER fill:#6366F1,color:#fff
```
---
## 为什么选择导航工具？
导航工具不是一款封闭的AI产品 — 它是一个**开源平台**，让您完全掌控：
| 优势 | 原因 |
|-----------|---------------|
| **开源** (AGPL-3.0) | 审计每行代码。没有黑盒。没有隐藏的遥测数据。 |
| **本地模型优先** | 运行Ollama、LM Studio或任何本地LLM。代理层连接到您的模型服务器 — 不依赖云API。 |
| **注重隐私** | 您的API密钥、浏览数据和对话记录保留在您的机器上。零数据收集。 |
| **可自行托管** | 在您自己的基础设施上部署代理服务器。完全自主。 |
| **自带密钥** | 使用任何LLM提供商 — 本地或云端。您选择。 |
| **无供应商锁定** | 随时更换模型。没有订阅、合同或强制升级。 |
---
## 快速入门
```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#6366F1', 'primaryTextColor': '#fff', 'primaryBorderColor': '#4f46e5', 'lineColor': '#a5b4fc', 'secondaryColor': '#1e1b4b', 'tertiaryColor': '#f5f3ff'}}}%%
flowchart LR
A[下载和安装] --> B[导入Chrome数据]
B --> C[添加您的API密钥]
C --> D[开始自动化]
style A fill:#6366F1,color:#fff
style B fill:#6366F1,color:#fff
style C fill:#6366F1,color:#fff
style D fill:#4f46e5,color:#fff
```
### 1. 下载
> **暂无预构建安装程序。** 该仓库包含完整的源代码。预构建二进制文件将在[发布页面](https://github.com/rahulcvwebsitehosting/wayfinder/releases)上提供，一旦发布第一个版本。
要从源代码构建，请参阅下面的[开发](#development)部分。
### 2. 导入您的Chrome数据（可选）
首次启动时会引导您导入Chrome的书签、密码、历史记录和扩展程序。所有数据都保留在本地。
### 3. 连接AI提供商
导航工具支持**自带密钥**。在设置中添加一个或多个提供商：
| 提供商 | 如何连接 |
|----------|---------------|
| **Claude (Anthropic)** | 从console.anthropic.com获取API密钥 |
| **OpenAI (GPT-4o, o3)** | 从platform.openai.com获取API密钥 |
| **Google Gemini** | 从aistudio.google.com获取API密钥 |
| **ChatGPT Pro/Plus** | OAuth登录 |
| **GitHub Copilot** | OAuth登录 |
| **Qwen Code** | OAuth登录 |
| **Azure OpenAI** | 端点 + API密钥 |
| **AWS Bedrock** | IAM凭证 |
| **OpenRouter** | API密钥 |
| **Ollama** | 本地运行，从设置中连接 |
| **LM Studio** | 本地运行，从设置中连接 |
### 4. 开始使用AI
按下`Cmd+K`（macOS）或`Ctrl+K`（Windows/Linux）以打开命令中心，或单击工具栏中的导航工具图标以打开AI聊天侧面板。
---
## 功能
```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#6366F1', 'primaryTextColor': '#fff', 'primaryBorderColor': '#4f46e5', 'lineColor': '#a5b4fc', 'secondaryColor': '#1e1b4b', 'tertiaryColor': '#f5f3ff'}}}%%
mindmap
root((导航工具))
AI代理
浏览和点击
填写表单
提取数据
自然语言
MCP服务器
Claude Code
Gemini CLI
Cursor
任意MCP客户端
视觉工作流
图形构建器
可重复
可定时
隐私
本地优先
无遥测数据
仅限您的密钥
浏览器
Chromium 148
垂直标签
广告拦截MV2
Chrome扩展程序
集成
Gmail, Slack
GitHub, Linear
Notion, Figma
40+ MCP应用
### 🤖 AI代理引擎
导航工具的核心。要求代理在浏览器中执行任何操作：
```
"查找GitHub上关于我的PR的所有未读邮件并总结它们"
"前往亚马逊，搜索100美元以下的机械键盘，并按评分排序"
"填写此职位申请表并使用我的保存的个人资料"
"监控此产品页面以获取价格下降并通知我"
```
代理使用**50+浏览器自动化工具** — 导航、点击、输入、滚动、提取、截图、下载 — 所有操作均自动组合。
### 🔌 MCP服务器
导航工具公开一个**模型上下文协议（MCP）服务器**，以便外部AI编码代理可以控制浏览器：
- **Claude Code**: `"在浏览器中运行测试套件"`
- **Gemini CLI**: `"截取我的应用程序的屏幕截图并查找CSS错误"`
- **Cursor**: `"调试此页面的控制台错误"`
安装方法：
```bash
# macOS / Linux
curl -fsSL https://github.com/rahulcvwebsitehosting/wayfinder/releases/latest/download/install.sh | bash
# Windows PowerShell
irm https://github.com/rahulcvwebsitehosting/wayfinder/releases/latest/download/install.ps1 | iex
```
然后运行`wayfinder-cli init`将其链接到您的浏览器。
### 🔁 视觉工作流
```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#6366F1', 'primaryTextColor': '#fff', 'primaryBorderColor': '#4f46e5', 'lineColor': '#a5b4fc', 'secondaryColor': '#1e1b4b', 'tertiaryColor': '#f5f3ff'}}}%%
flowchart TD
START([开始]) --> LOGIN[登录到仪表盘]
LOGIN --> EXPORT[导出报告]
EXPORT --> SAVE[保存到文件夹]
SAVE --> EMAIL[电子邮件总结]
EMAIL --> END([完成 ✓])
style START fill:#6366F1,color:#fff
style END fill:#4f46e5,color:#fff
```
构建可拖放的自动化工作流，运行于定时计划。不需要编码。
### 🧠 持久记忆
代理在对话之间记住上下文 — 您的偏好、过去的任务和重要信息会自动保留。
### 🧩 LLM中心
在任意网页上并排比较多个AI提供商的响应。
### 📂 协同工作（文件 + 浏览器）
将浏览器自动化与本地文件操作相结合 — 研究网页、将报告保存到文件夹、编辑文件 — 全部在一个工作流中。
### ⏰ 定时任务
让代理自动运行：
- "每天早上8点检查新的职位发布"
- "每天监控竞争对手的价格"
- "每周五生成一份周报"
### 🛡️ 隐私和广告拦截
- **uBlock Origin** 预安装
- **Manifest V2** 支持（比Chrome更强的广告拦截）
- **无遥测数据**，无跟踪，无数据收集
- 您的API密钥保留在您的机器上
### 📐 垂直标签
侧面板标签管理，即使打开100+个标签页也能保持有序。
### 🧩 扩展程序管理和MV2支持
导航工具支持开箱即用的所有Chrome扩展程序，但与Chrome不同，我们**积极保留Manifest V2** — 包括具有高级拦截功能的uBlock Origin，这些功能受到Google的MV3 API的限制。
**如何安装扩展程序：**
- **Chrome Web Store** — 直接从Chrome Web Store浏览和安装
- **加载CRX文件** — 通过`chrome://extensions`在开发者模式下从磁盘加载未打包的扩展程序
- **预安装包** — uBlock Origin随每个版本一起提供；其他捆绑扩展程序通过导航工具的内置扩展程序管理器在设置中管理
> **为什么MV2很重要：** Google的Manifest V3废除了`webRequest`拦截，这为真正的广告拦截器、隐私工具和安全扩展程序提供了支持。通过维护MV2支持，导航工具确保这些工具继续工作而不会受到影响。
---
## 比较
| | 导航工具 | Chrome | Brave |
|---|:---:|:---:|:---:|
| **开源** | ✅ | ❌ | ✅ |
| **本地模型优先** | ✅ | ❌ | ❌ |
| **注重隐私** | ✅ | ❌ | ✅ |
| **可自行托管** | ✅ | ❌ | ❌ |
| 构建的AI代理 | ✅ | ❌ | ❌ |
| MCP服务器 | ✅ | ❌ | ❌ |
| 视觉工作流 | ✅ | ❌ | ❌ |
| 自带密钥 | ✅ | ❌ | ✅ |
| 广告拦截（MV2） | ✅ | ❌ | ✅ |
| Chrome扩展程序兼容性 | ✅ | ✅ | ✅ |
**关键要点：** 导航工具是唯一一款开源浏览器代理，专门为本地AI而设计 — 您保留您的数据，您选择您的模型，您拥有整个堆栈。
---
## 架构
```mermaid
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#6366F1', 'primaryTextColor': '#fff', 'primaryBorderColor': '#4f46e5', 'lineColor': '#a5b4fc', 'secondaryColor': '#1e1b4b', 'tertiaryColor': '#f5f3ff'}}}%%
graph TB
subgraph BROWSER [浏览器 - Chromium 148]
CORE[Chromium核心引擎]
CDP[Chrome DevTools协议]
EXT_SYS[扩展程序系统]
LLM_CHAT[AI聊天侧面板]
LLM_HUB[LLM中心面板]
VERT[垂直标签页]
SETTINGS[导航工具设置]
end
subgraph AGENT [代理平台]
SERVER[Bun服务器]
MCP_SRV[MCP协议]
AGENT_LOOP[AI代理循环]
WORKFLOW[工作流引擎]
MEMORY[内存存储]
TOOLS[50+浏览器工具]
AUTH[提供商身份验证]
end
subgraph CLI [CLI工具]
WAY_CLI[wayfinder-cli - Go]
DEV_TOOL[开发工具链]
end
CORE <--> CDP
CDP <--> SERVER
EXT_SYS <--> AGENT_LOOP
SERVER <--> MCP_SRV
SERVER <--> AGENT_LOOP
AGENT_LOOP <--> TOOLS
AGENT_LOOP <--> WORKFLOW
AGENT_LOOP <--> MEMORY
SERVER <--> AUTH
WAY_CLI <--> MCP_SRV
DEV_TOOL <--> SERVER
subgraph EXTERNAL [外部]
AI[AI提供商]
CODE_AGENTS[Claude Code / Cursor]
WEB[网站和API]
end
AUTH <--> AI
MCP_SRV <--> CODE_AGENTS
CORE <--> WEB
style BROWSER fill:#4f46e5,color:#fff
style AGENT fill:#6366F1,color:#fff
style CLI fill:#818cf8,color:#fff
style EXTERNAL fill:#1e1b4b,color:#fff
```
### 仓库结构
```
wayfinder/
├── packages/wayfinder/ # Chromium 分支 + 构建系统
│ ├── chromium_patches/ # 适用于Chromium源代码的补丁
│ ├── build/ # Python构建CLI
│ ├── build_go/ # Go构建CLI（生产）
│ └── resources/ # 图标、权利声明、签名配置
│
└── packages/wayfinder-agent/ # 代理平台（TypeScript / Go）
├── apps/
│ ├── server/ # Bun服务器 - AI代理循环 + MCP
│ ├── agent/ # WXT浏览器扩展（React）
│ ├── cli/ # Go CLI工具
│ └── eval/ # 基准测试框架
│
└── packages/
├── agent-sdk/ # npm：@wayfinder/agent-sdk
├── cdp-protocol/ # CDP类型绑定
└── shared/ # 共享常量和类型
```
| 组件 | 语言 | 功能 |
|-----------|----------|-------------|
| `packages/wayfinder/` | C++，Python，Go | Chromium 分支 — 浏览器本身，带有补丁、构建系统和签名 |
| `apps/server/` | TypeScript (Bun) | MCP服务器 + AI代理循环 — 通过CDP连接到浏览器，运行代理，通过MCP公开工具 |
| `apps/agent/` | TypeScript (React, WXT) | 浏览器扩展 — 新标签页、侧面板聊天、引导、设置UI |
| `apps/cli/` | Go | CLI工具 — 从终端或AI编码代理控制导航工具 |
| `packages/agent-sdk/` | TypeScript | Node.js SDK，用于自然语言浏览器自动化 |
| `packages/cdp-protocol/` | TypeScript | 类型安全的Chrome DevTools协议绑定 |
| `packages/shared/` | TypeScript | 共享常量、提供商类型和公共代码 |
---
## 开发
### 前提条件
| 工具 | 版本 | 用途 |
|------|---------|---------|
| [Bun](https://bun.sh) | 1.3.6+ | 代理平台的JavaScript运行时 |
| [Go](https://go.dev) | 1.24+ | CLI工具 |
| [Python](https://python.org) | 3.12+ | Chromium构建系统 |
| [Node.js](https://nodejs.org) | — | 由Bun兼容工具使用 |
### 代理平台（TypeScript / Go）
```bash
# 克隆仓库
git clone https://github.com/rahulcvwebsitehosting/wayfinder.git
cd wayfinder
# 导航到代理平台
cd packages/wayfinder-agent
# 安装依赖
bun install
# 设置环境
cp .env.example .env
# 使用您的设置编辑.env
# 启动开发服务器
bun run dev:watch
```
这启动了代理服务器、MCP服务器和浏览器扩展，处于监视模式。
### 浏览器开发（C++ / Chromium）
从源代码构建浏览器需要完整的Chromium工具链（~100 GB磁盘，3-5小时）：
```bash
# 安装构建CLI
pip install -e packages/wayfinder/
# 准备Chromium源代码
python scripts/ci/setup_chromium.py \
--chromium-root /path/to/chromium_root \
--step checkout
python scripts/ci/setup_chromium.py \
--chromium-root /path/to/chromium_root \
--step sync
# 构建
wayfinder build \
--config build/config/release.windows.yaml \
--chromium-src /path/to/chromium_root/src
```
> 大多数贡献者专注于代理平台（TypeScript/Go）。浏览器开发仅在需要进行深入的Chromium级别更改时才需要。
---
## Chromium维护和更新策略
分叉Chromium是一项长期的承诺。以下是导航工具如何管理它：
**补丁系统：** 所有对Chromium的更改都存储在`chromium_patches/`中，以结构化的补丁文件形式组织，按功能层分类。补丁由构建CLI确定性地应用于干净的Chromium检查 — 没有永久的分支维护。
**重新编译策略：**
- 每个导航工具版本都固定一个特定的Chromium标签（例如`148.0.7778.97`）
- 当重新编译到新的Chromium版本时，补丁会通过构建系统重新应用
- 补丁冲突在应用时显示，而不是隐藏在合并提交中
- `series_patches`模块单独处理上游补丁（ungoogled-chromium等）和导航工具特定的补丁，使冲突解决更容易
**更新频率：**
- **安全补丁：** Chromium每月发布关键安全修复程序。每个新Chromium标签都会进行评估和包含。
- **功能更新：** 当上游改进与导航工具的路线图一致时，会采用新的Chromium版本。
- **扩展兼容性：** 监控Chromium的扩展程序API更改，以确保现有的补丁保持兼容。
**风险确认：** 维护Chromium分支意味着要跟上每一个CVE、API弃用和构建系统更改。这是提供真正独立浏览器所带来的已知成本。贡献和社区测试对于保持分支的健康至关重要。
---
## 下载预构建版本
预构建安装程序将在[发布页面](https://github.com/rahulcvwebsitehosting/wayfinder/releases)上提供。每个安装程序将包括：
- 完整的导航工具浏览器（Chromium 148）
- 内置的AI代理引擎
- MCP服务器
- uBlock Origin，具有MV2支持
- 所有预安装的扩展程序
在此期间，您可以直接运行代理平台，而无需构建Chromium（请参见[开发](#development)）。
---
## 常见问题
**我可以在本地模型的情况下完全离线运行导航工具吗？** 是的。连接Ollama或LM Studio，您永远不需要互联网连接来进行AI操作 — 只需浏览网站即可。
**导航工具真的是开源的吗？** 是的，AGPL-3.0。每一行代码都是公开的。没有专有组件，没有隐藏的遥测数据，没有后门。
**这与Browser Use或OpenAI Operator有何不同？** 那些是依赖云的SaaS产品。导航工具是一款可自行托管的开源浏览器代理，在您自己的硬件上运行，使用您自己的模型。
**我需要API密钥吗？** 仅在使用云提供商时需要。如果使用本地模型（Ollama，LM Studio），则不需要API密钥。
**我的数据会被发送到任何服务器吗？** 不会。您的API密钥、浏览数据和对话记录保留在您的机器上。网络请求仅限于您的LLM或您访问的网站。
**我可以使用Chrome扩展程序吗？** 是的。导航工具是Chromium分支，支持所有Chrome扩展程序。uBlock Origin预安装，具有MV2支持。
**我可以无头运行导航工具吗？** 是的。支持无头模式，用于自动化工作流和CI管道。使用`wayfinder-cli`以无头模式启动。
---
## 贡献
欢迎贡献！请参阅[CONTRIBUTING.md](CONTRIBUTING.md)获取详细指南。
- [报告错误](https://github.com/rahulcvwebsitehosting/wayfinder/issues/new)
- [请求功能](https://github.com/rahulcvwebsitehosting/wayfinder/issues/new)
- [提交拉取请求](https://github.com/rahulcvwebsitehosting/wayfinder/compare)
**贡献者快速入门：**
```bash
# 复刻仓库，然后：
git clone https://github.com/YOUR_USERNAME/wayfinder.git
cd wayfinder/packages/wayfinder-agent
bun install
bun run dev:watch
```
*注意：问题跟踪器和发布信息位于[github.com/rahulcvwebsitehosting/wayfinder](https://github.com/rahulcvwebsitehosting/wayfinder)。*
---
## 许可
**AGPL-3.0** — 参见[LICENSE](LICENSE)获取详细信息。
导航工具基于[Chromium](https://www.chromium.org/)，并整合了[ungoogled-chromium](https://github.com/ungoogled-software/ungoogled-chromium)的补丁。
---
<div align="center">
**本地AI自动化的开源浏览器代理。**
[开始使用](#快速入门) · [下载](#下载) · [贡献](#贡献) · [报告问题](https://github.com/rahulcvwebsitehosting/wayfinder/issues)
</div>
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器