# aibrowser

**Repository Path**: lyramilk/aibrowser

## Basic Information

- **Project Name**: aibrowser
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Browser + MCP 开发文档

本仓库用于实现一个“可被 AI 查询与操作的浏览器调试系统”，核心特征如下：

- 启动 MCP 服务时可拉起或附着 Chrome。
- 用户在浏览器中手动浏览到目标页面。
- AI 通过 MCP 查询当前页面状态（DOM、脚本、网络、控制台等）并可按权限执行动作。
- 默认只读，写操作需要确认。
- 页面切换不导致会话中断，但需要明确上下文绑定策略。

## 文档目录

- [系统架构](docs/01-architecture.md)
- [MCP 接口规范](docs/02-mcp-api-spec.md)
- [工作流与状态管理](docs/03-workflow-and-state.md)
- [安全与合规](docs/04-security-and-compliance.md)
- [里程碑与验收标准](docs/05-milestones-and-acceptance.md)
- [快速启动指南](docs/06-quickstart.md)

## 当前建议技术栈

- Runtime: Node.js 20+
- Browser control: Playwright + Chrome DevTools Protocol (CDP)
- MCP Server: TypeScript + @modelcontextprotocol/sdk
- Storage/Index: SQLite + 本地文件缓存
- Chat UI: React + TypeScript + WebSocket

## 核心设计原则

1. 全量可观测，不全量上送：浏览器状态尽量采集完整，但给模型的上下文必须按需检索与分块。
2. 读写分权：查询工具默认开放，动作工具默认审批。
3. 会话稳定优先：以 tabId 为主键管理上下文，切页仅切换上下文不终止任务。
4. 可审计：所有工具调用、页面变更、动作确认都可追踪。