# QuickPilot浏览器助手

**Repository Path**: codekpy/quick-pilot-browser-assistant

## Basic Information

- **Project Name**: QuickPilot浏览器助手
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuickPilot - AI 浏览器操作助手

基于 Chrome 扩展 + Python 鼠标轨迹拟合的 AI 驱动浏览器自动化工具。

## 项目架构

```
quick-pilot-browser-assistant/
├── browser-extension/     # Chrome 浏览器插件 (TypeScript + pnpm)
│   ├── src/
│   │   ├── background/    # Service Worker
│   │   ├── content/       # Content Script
│   │   ├── popup/         # 弹窗 UI
│   │   ├── options/       # 配置页面
│   │   ├── chat/          # 聊天会话页面
│   │   └── tools/         # 浏览器操作工具集
│   ├── public/
│   ├── package.json
│   └── .npmrc             # 国内镜像源
├── mouse-tracker/         # 鼠标轨迹拟合程序 (Python + PySide6)
│   ├── src/
│   │   ├── ui/            # PySide6 交互界面
│   │   ├── recorder/      # 轨迹录制模块
│   │   ├── analyzer/      # 参数分析拟合模块
│   │   └── exporter/      # 参数导出模块
│   └── requirements.txt
├── LICENSE                # Apache 2.0
└── README.md
```

## 功能特性

### Chrome 浏览器插件
- **AI 驱动**: 支持 OpenAI 和 Anthropic 协议，通过自然语言操控浏览器
- **丰富工具集**: 标签页管理、页面导航、内容查找、XPath 操作、元素操作、滚动、截图、执行 JS 等
- **类人操作**: 集成鼠标轨迹参数，AI 操作模拟真实人类行为
- **聊天会话**: 多会话管理，流式输出，可打断
- **HTTP API**: 开放 RESTful API，支持外部 AI 系统调用
- **安全审批**: 敏感工具调用需用户确认

### 鼠标轨迹拟合程序
- **多场景录制**: 直线/曲线移动、点击、拖拽、右键菜单
- **参数分析**: 提取抖动、速度、曲线、偏移量等特征
- **一键导出**: 生成 JSON 参数文件供插件使用

## 快速开始

### 浏览器插件

```bash
cd browser-extension
pnpm install
pnpm build
```

在 Chrome 中加载 `browser-extension/dist` 目录即可。

### 鼠标轨迹程序

```bash
cd mouse-tracker
python -m venv venv
# Windows: venv\Scripts\activate
pip install -r requirements.txt
python src/main.py
```

## 开源协议

Apache License 2.0