5.1 KiB
5.1 KiB
PageAgent 🤖🪄
纯 JS 实现的 GUI agent。使用自然语言操作你的 Web 应用。无须后端、客户端、浏览器插件。
🌐 English | 中文
✨ Features
- 🎯 轻松集成
- 🔐 端侧运行
- 🧠 HTML 脱水
- 💬 自然语言接口
- 🎨 HITL 交互界面
🗺️ Roadmap
👉 Roadmap
🚀 快速开始
快速体验 (Demo CDN)
最快的体验方式:
<script src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js" crossorigin="true"></script>
⚠️ 仅用于技术评估。 Demo 模型有速率限制和使用限制,生产环境请使用 NPM 方式。
| 位置 | URL |
|---|---|
| 全球 | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.demo.js |
| 中国 | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.demo.js |
NPM 安装(推荐)
npm install page-agent
import { PageAgent } from 'page-agent'
const agent = new PageAgent({
model: 'deepseek-chat',
baseURL: 'https://api.deepseek.com',
apiKey: 'YOUR_API_KEY',
language: 'zh-CN',
})
await agent.execute('点击登录按钮')
CDN 引入
适用于无法使用 NPM 的环境,用法与 NPM 一致:
<script src="https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.js" crossorigin="true"></script>
<script>
const agent = new PageAgent({
model: 'deepseek-chat',
baseURL: 'https://api.deepseek.com',
apiKey: 'YOUR_API_KEY',
})
await agent.execute('点击登录按钮')
</script>
| 位置 | URL |
|---|---|
| 全球 | https://cdn.jsdelivr.net/npm/@page-agent/cdn/dist/page-agent.js |
| 中国 | https://registry.npmmirror.com/@page-agent/cdn/latest/files/dist/page-agent.js |
🏗️ 架构设计
PageAgent adopts a simplified monorepo structure:
packages/
├── page-agent/ # AI agent (npm: page-agent)
├── llms/ # LLM 客户端 (npm: @page-agent/llms)
├── page-controller/ # DOM 操作 & 蒙层 & 模拟鼠标 (npm: @page-agent/page-controller)
├── ui/ # 面板 & i18n (npm: @page-agent/ui)
├── cdn/ # CDN IIFE builds (npm: @page-agent/cdn)
└── website/ # 文档站点
🤝 贡献
欢迎社区贡献!以下是参与方式:
开发环境
- Fork 项目仓库
- Clone or fork:
git clone https://github.com/alibaba/page-agent.git && cd page-agent - 安装依赖:
npm install - 启动开发:
npm start
贡献指南
👏 致谢
本项目基于以下优秀项目构建:
PageAgent 专为客户端网页增强设计,不是服务端自动化工具。
📄 许可证
MIT 许可证 - 详见 LICENSE 文件。
DOM processing components and prompt are derived from browser-use:
Browser Use
Copyright (c) 2024 Gregor Zunic
Licensed under the MIT License
Original browser-use project: <https://github.com/browser-use/browser-use>
We gratefully acknowledge the browser-use project and its contributors for their
excellent work on web automation and DOM interaction patterns that helped make
this project possible.
Third-party dependencies and their licenses can be found in the package.json
file and in the node_modules directory after installation.
⭐ 如果觉得 PageAgent 有用或有趣,请给项目点个星!
