Files
page-agent/README-zh.md
2026-01-14 17:27:35 +08:00

5.1 KiB

PageAgent 🤖🪄

banner

npm version License: MIT TypeScript Downloads Bundle Size GitHub stars

纯 JS 实现的 GUI agent。使用自然语言操作你的 Web 应用。无须后端、客户端、浏览器插件。

🌐 English | 中文

👉 🚀 Demo | 📖 Documentation


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/             # 文档站点

🤝 贡献

欢迎社区贡献!以下是参与方式:

开发环境

  1. Fork 项目仓库
  2. Clone or fork: git clone https://github.com/alibaba/page-agent.git && cd page-agent
  3. 安装依赖: npm install
  4. 启动开发: 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 有用或有趣,请给项目点个星!