# Vessel Browser

> 仓库地址：https://github.com/unmodeled-tyler/vessel-browser
> 作者/组织：unmodeled-tyler (Tyler Williams)
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
一个基于 Chromium/Electron 的 AI-native 浏览器，采用"agent 驾驶、人类监督"的设计哲学，通过 MCP 协议为 Hermes Agent 提供持久化 web 自动化运行时。

## 项目定位与架构
Vessel 颠覆了传统浏览器自动化的范式——不是在人用浏览器上叠加自动化，而是从头为 agent 操作优化，人类作为 supervisor 介入。核心架构基于 Electron 40 + SolidJS + TypeScript，构建工具为 electron-vite + Vite。

Main Process 负责 tab 管理（WebContentsView）、agent runtime、MCP server 托管、AI provider 实现、credential vault 加密和 session 持久化。Renderer 层（SolidJS）处理 Chrome UI、command bar、sidebar（Supervisor/Bookmarks/Checkpoints/Chat/Automate tabs）和 agent transcript overlay。IPC 通过 contextBridge 实现类型安全通信。

MCP server（默认端口 3100）暴露浏览器控制能力，支持 Hermes Agent 和 OpenClaw 等外部 agent。

## 关键技术特性
- **Agent-first 设计**：named session 管理（cookie/localStorage 持久化）、page highlight 系统、structured page visibility reporting
- **人类监督层**：live browser UI、supervisor sidebar、agent transcript dock、command bar
- **MCP 工具集**：导航/交互、bookmarks、highlights、workflow tracking、sessions、memory（Premium）、credentials（Premium）
- **多 AI 提供者**：Anthropic、OpenAI、Ollama、llama.cpp、Mistral、xAI、Gemini、OpenRouter
- **Premium 功能**：Agent Credential Vault（加密+TOTP 2FA）、table extraction、Obsidian vault 集成（$5.99/月）

## 设计亮点与创新
"Agent 驾驶、人类监督"的设计哲学在 browser automation 领域是范式创新。Supervisor sidebar + agent transcript dock 提供了透明的 agent 行为可见性。110px chrome 的 content-forward UI 设计也体现了 agent-first 思维。workflow flow tracking 支持 step-by-step 进度监控。

## 局限性与风险
Linux 最成熟，macOS 可从源码构建，Windows 支持不明确。明确声明"不做安全保证"。Premium 功能需订阅。设计面向持久化 agent workflow，不适合 stateless/headless 操作。llama.cpp 最低需要 16KB context（推荐 32KB）。

## 与生态系统的关联
通过 MCP 协议与 Hermes Agent 集成，是 agent 访问 web 的专用运行时。与 hermes-android（移动端控制）互补，Vessel 覆盖桌面 web 场景。可搭配 hermes-workspace 使用——workspace 管理 agent，Vessel 执行 web 任务。